@lobu/core 2.8.0

package/dist/__tests__/fixtures/mock-redis.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Unified in-memory Redis mock for testing.
+ *
+ * Replaces three duplicated implementations:
+ *   - MockRedisClient in gateway setup.ts
+ *   - FakeRedis in system-message-limiter.test.ts
+ *   - queue mock getRedisClient
+ *
+ * Supports string, set, list, and hash operations with TTL tracking.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockRedisClient = void 0;
+class MockRedisClient {
+    constructor() {
+        this.store = new Map();
+        this.sets = new Map();
+        this.lists = new Map();
+        this.currentTime = Date.now();
+    }
+    // --- String operations ---
+    async exists(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return 0;
+        if (entry.ttl && entry.ttl < this.currentTime) {
+            this.store.delete(key);
+            return 0;
+        }
+        return 1;
+    }
+    async get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        if (entry.ttl && entry.ttl < this.currentTime) {
+            this.store.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    /**
+     * ioredis-compatible set with optional EX / NX flags.
+     * Supports: set(key, value), set(key, value, "EX", sec), set(key, value, "EX", sec, "NX")
+     */
+    async set(key, value, exTokenOrTtl, exSeconds, mode) {
+        // NX check must be synchronous to avoid TOCTOU race
+        if (mode === "NX") {
+            const entry = this.store.get(key);
+            const alive = entry && (!entry.ttl || entry.ttl >= this.currentTime);
+            if (alive)
+                return null;
+        }
+        let ttl;
+        if (exTokenOrTtl === "EX" && typeof exSeconds === "number") {
+            ttl = this.currentTime + exSeconds * 1000;
+        }
+        else if (typeof exTokenOrTtl === "number") {
+            ttl = this.currentTime + exTokenOrTtl * 1000;
+        }
+        this.store.set(key, { value, ttl });
+        return "OK";
+    }
+    async setex(key, ttlSeconds, value) {
+        const ttl = this.currentTime + ttlSeconds * 1000;
+        this.store.set(key, { value, ttl });
+    }
+    async incr(key) {
+        const current = await this.get(key);
+        const nextValue = (current ? Number.parseInt(current, 10) : 0) + 1;
+        const entry = this.store.get(key);
+        this.store.set(key, {
+            value: String(nextValue),
+            ttl: entry?.ttl,
+        });
+        return nextValue;
+    }
+    async del(...keys) {
+        let deleted = 0;
+        for (const key of keys) {
+            const existed = this.store.has(key) || this.sets.has(key) || this.lists.has(key);
+            this.store.delete(key);
+            this.sets.delete(key);
+            this.lists.delete(key);
+            if (existed)
+                deleted++;
+        }
+        return deleted;
+    }
+    async getdel(key) {
+        const value = await this.get(key);
+        if (value !== null) {
+            await this.del(key);
+        }
+        return value;
+    }
+    async expire(key, seconds) {
+        if (this.store.has(key)) {
+            const entry = this.store.get(key);
+            entry.ttl = this.currentTime + seconds * 1000;
+            return 1;
+        }
+        return 0;
+    }
+    async ttl(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return -2;
+        if (!entry.ttl)
+            return -1;
+        if (entry.ttl < this.currentTime) {
+            this.store.delete(key);
+            return -2;
+        }
+        return Math.max(0, Math.ceil((entry.ttl - this.currentTime) / 1000));
+    }
+    // --- Set operations ---
+    async sadd(key, ...members) {
+        if (!this.sets.has(key))
+            this.sets.set(key, new Set());
+        const set = this.sets.get(key);
+        let added = 0;
+        for (const m of members) {
+            if (!set.has(m)) {
+                set.add(m);
+                added++;
+            }
+        }
+        return added;
+    }
+    async srem(key, ...members) {
+        const set = this.sets.get(key);
+        if (!set)
+            return 0;
+        let removed = 0;
+        for (const m of members) {
+            if (set.delete(m))
+                removed++;
+        }
+        return removed;
+    }
+    async smembers(key) {
+        const set = this.sets.get(key);
+        return set ? Array.from(set) : [];
+    }
+    async sismember(key, member) {
+        const set = this.sets.get(key);
+        return set?.has(member) ? 1 : 0;
+    }
+    // --- List operations ---
+    async rpush(key, ...values) {
+        if (!this.lists.has(key))
+            this.lists.set(key, []);
+        const list = this.lists.get(key);
+        list.push(...values);
+        return list.length;
+    }
+    async lrange(key, start, stop) {
+        const list = this.lists.get(key);
+        if (!list)
+            return [];
+        const end = stop === -1 ? list.length : stop + 1;
+        return list.slice(start, end);
+    }
+    // --- Scan ---
+    async scan(_cursor, ...args) {
+        // Extract pattern from args: "MATCH", pattern, "COUNT", count
+        let pattern = "*";
+        for (let i = 0; i < args.length - 1; i++) {
+            if (String(args[i]).toUpperCase() === "MATCH") {
+                pattern = String(args[i + 1]);
+                break;
+            }
+        }
+        const allKeys = new Set();
+        for (const key of this.store.keys())
+            allKeys.add(key);
+        for (const key of this.sets.keys())
+            allKeys.add(key);
+        for (const key of this.lists.keys())
+            allKeys.add(key);
+        const matching = [];
+        for (const key of allKeys) {
+            if (pattern === "*") {
+                matching.push(key);
+            }
+            else if (pattern.endsWith("*")) {
+                const prefix = pattern.slice(0, -1);
+                if (key.startsWith(prefix))
+                    matching.push(key);
+            }
+            else if (key === pattern) {
+                matching.push(key);
+            }
+        }
+        return ["0", matching];
+    }
+    // --- Batch get ---
+    async mget(...keys) {
+        return Promise.all(keys.map((key) => this.get(key)));
+    }
+    // --- Watch / Unwatch (no-ops) ---
+    async watch(..._keys) {
+        return "OK";
+    }
+    async unwatch() {
+        return "OK";
+    }
+    // --- Multi ---
+    multi() {
+        const pending = [];
+        const self = this;
+        const chain = {
+            set(key, value) {
+                pending.push({ key, value });
+                return chain;
+            },
+            async exec() {
+                const results = [];
+                for (const op of pending) {
+                    self.store.set(op.key, { value: op.value });
+                    results.push([null, "OK"]);
+                }
+                return results;
+            },
+        };
+        return chain;
+    }
+    // --- Pipeline ---
+    pipeline() {
+        const ops = [];
+        const self = this;
+        const chain = {
+            setex(key, ttl, value) {
+                ops.push(() => self.setex(key, ttl, value));
+                return chain;
+            },
+            del(...keys) {
+                ops.push(() => self.del(...keys));
+                return chain;
+            },
+            async exec() {
+                const results = [];
+                for (const op of ops) {
+                    const result = await op();
+                    results.push([null, result ?? "OK"]);
+                }
+                return results;
+            },
+        };
+        return chain;
+    }
+    // --- Test helpers ---
+    advanceTime(ms) {
+        this.currentTime += ms;
+    }
+    has(key) {
+        return this.store.has(key);
+    }
+    clear() {
+        this.store.clear();
+        this.sets.clear();
+        this.lists.clear();
+    }
+}
+exports.MockRedisClient = MockRedisClient;
+//# sourceMappingURL=mock-redis.js.map

package/dist/__tests__/fixtures/mock-redis.js.map

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

package/dist/__tests__/retry.test.d.ts

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

package/dist/__tests__/retry.test.d.ts.map

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

package/dist/__tests__/retry.test.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const retry_1 = require("../utils/retry");
+(0, bun_test_1.describe)("retryWithBackoff", () => {
+    (0, bun_test_1.test)("returns result on first success", async () => {
+        const fn = (0, bun_test_1.mock)(() => Promise.resolve("ok"));
+        const result = await (0, retry_1.retryWithBackoff)(fn);
+        (0, bun_test_1.expect)(result).toBe("ok");
+        (0, bun_test_1.expect)(fn).toHaveBeenCalledTimes(1);
+    });
+    (0, bun_test_1.test)("retries on failure and returns on eventual success", async () => {
+        let attempt = 0;
+        const fn = (0, bun_test_1.mock)(async () => {
+            attempt++;
+            if (attempt < 3)
+                throw new Error(`fail ${attempt}`);
+            return "success";
+        });
+        const result = await (0, retry_1.retryWithBackoff)(fn, {
+            maxRetries: 3,
+            baseDelay: 0,
+        });
+        (0, bun_test_1.expect)(result).toBe("success");
+        (0, bun_test_1.expect)(fn).toHaveBeenCalledTimes(3);
+    });
+    (0, bun_test_1.test)("throws last error when all retries exhausted", async () => {
+        const fn = (0, bun_test_1.mock)(async () => {
+            throw new Error("always fails");
+        });
+        await (0, bun_test_1.expect)((0, retry_1.retryWithBackoff)(fn, { maxRetries: 2, baseDelay: 0 })).rejects.toThrow("always fails");
+        // 1 initial + 2 retries = 3 calls
+        (0, bun_test_1.expect)(fn).toHaveBeenCalledTimes(3);
+    });
+    (0, bun_test_1.test)("maxRetries=0 means single attempt, no retries", async () => {
+        const fn = (0, bun_test_1.mock)(async () => {
+            throw new Error("fail");
+        });
+        await (0, bun_test_1.expect)((0, retry_1.retryWithBackoff)(fn, { maxRetries: 0, baseDelay: 0 })).rejects.toThrow("fail");
+        (0, bun_test_1.expect)(fn).toHaveBeenCalledTimes(1);
+    });
+    (0, bun_test_1.test)("calls onRetry callback with attempt number and error", async () => {
+        let attempt = 0;
+        const fn = async () => {
+            attempt++;
+            if (attempt < 3)
+                throw new Error(`err-${attempt}`);
+            return "done";
+        };
+        const retries = [];
+        await (0, retry_1.retryWithBackoff)(fn, {
+            maxRetries: 3,
+            baseDelay: 0,
+            onRetry: (attempt, error) => {
+                retries.push({ attempt, message: error.message });
+            },
+        });
+        (0, bun_test_1.expect)(retries).toEqual([
+            { attempt: 1, message: "err-1" },
+            { attempt: 2, message: "err-2" },
+        ]);
+    });
+    (0, bun_test_1.test)("uses defaults when no options provided", async () => {
+        const fn = (0, bun_test_1.mock)(() => Promise.resolve(42));
+        const result = await (0, retry_1.retryWithBackoff)(fn);
+        (0, bun_test_1.expect)(result).toBe(42);
+    });
+    (0, bun_test_1.test)("linear strategy increases delay linearly", async () => {
+        const delays = [];
+        const originalSetTimeout = globalThis.setTimeout;
+        // Patch setTimeout to capture delays (but resolve immediately)
+        globalThis.setTimeout = ((fn, ms) => {
+            delays.push(ms);
+            return originalSetTimeout(fn, 0);
+        });
+        let attempt = 0;
+        try {
+            await (0, retry_1.retryWithBackoff)(async () => {
+                attempt++;
+                if (attempt <= 3)
+                    throw new Error("fail");
+                return "ok";
+            }, { maxRetries: 3, baseDelay: 100, strategy: "linear" });
+        }
+        finally {
+            globalThis.setTimeout = originalSetTimeout;
+        }
+        // Linear: 100*(0+1)=100, 100*(1+1)=200, 100*(2+1)=300
+        (0, bun_test_1.expect)(delays).toEqual([100, 200, 300]);
+    });
+    (0, bun_test_1.test)("exponential strategy doubles delay", async () => {
+        const delays = [];
+        const originalSetTimeout = globalThis.setTimeout;
+        globalThis.setTimeout = ((fn, ms) => {
+            delays.push(ms);
+            return originalSetTimeout(fn, 0);
+        });
+        let attempt = 0;
+        try {
+            await (0, retry_1.retryWithBackoff)(async () => {
+                attempt++;
+                if (attempt <= 3)
+                    throw new Error("fail");
+                return "ok";
+            }, { maxRetries: 3, baseDelay: 100, strategy: "exponential" });
+        }
+        finally {
+            globalThis.setTimeout = originalSetTimeout;
+        }
+        // Exponential: 100*2^0=100, 100*2^1=200, 100*2^2=400
+        (0, bun_test_1.expect)(delays).toEqual([100, 200, 400]);
+    });
+});
+//# sourceMappingURL=retry.test.js.map

package/dist/__tests__/retry.test.js.map

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

package/dist/__tests__/sanitize.test.d.ts

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

package/dist/__tests__/sanitize.test.d.ts.map

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

package/dist/__tests__/sanitize.test.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const sanitize_1 = require("../utils/sanitize");
+(0, bun_test_1.describe)("sanitizeFilename", () => {
+    (0, bun_test_1.test)("removes path traversal (strips to basename)", () => {
+        // The regex strips everything up to and including the last / or \
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("../../etc/passwd")).toBe("passwd");
+    });
+    (0, bun_test_1.test)("removes windows path traversal (strips to basename)", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("..\\..\\windows\\system32")).toBe("system32");
+    });
+    (0, bun_test_1.test)("removes special characters", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)('file<>|*?:"name.txt')).toBe("file_______name.txt");
+    });
+    (0, bun_test_1.test)("removes leading dots (hidden files)", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)(".hidden")).toBe("hidden");
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("...secret")).toBe("secret");
+    });
+    (0, bun_test_1.test)("collapses consecutive dots", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("file..name..txt")).toBe("file.name.txt");
+    });
+    (0, bun_test_1.test)("returns unnamed_file for empty result", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("")).toBe("unnamed_file");
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("...")).toBe("unnamed_file");
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("///")).toBe("unnamed_file");
+    });
+    (0, bun_test_1.test)("preserves safe filenames", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("document.pdf")).toBe("document.pdf");
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("my-file_v2.tar.gz")).toBe("my-file_v2.tar.gz");
+    });
+    (0, bun_test_1.test)("truncates to maxLength", () => {
+        const long = "a".repeat(300);
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)(long).length).toBe(255);
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)(long, 10).length).toBe(10);
+    });
+    (0, bun_test_1.test)("preserves spaces", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("my file name.txt")).toBe("my file name.txt");
+    });
+    (0, bun_test_1.test)("strips directory path components", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("/path/to/file.txt")).toBe("file.txt");
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeFilename)("C:\\Users\\doc.pdf")).toBe("doc.pdf");
+    });
+});
+(0, bun_test_1.describe)("sanitizeConversationId", () => {
+    (0, bun_test_1.test)("preserves valid conversation IDs", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeConversationId)("1756766056.836119")).toBe("1756766056.836119");
+    });
+    (0, bun_test_1.test)("replaces slashes and special chars", () => {
+        // Only non-alphanumeric (except . and -) are replaced
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeConversationId)("thread/123/../456")).toBe("thread_123_.._456");
+    });
+    (0, bun_test_1.test)("preserves hyphens and dots", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeConversationId)("abc-def.123")).toBe("abc-def.123");
+    });
+    (0, bun_test_1.test)("replaces colons and spaces", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeConversationId)("a:b c")).toBe("a_b_c");
+    });
+});
+(0, bun_test_1.describe)("sanitizeForLogging", () => {
+    (0, bun_test_1.test)("redacts default sensitive keys (lowercase match)", () => {
+        const obj = {
+            // "token" is in the sensitive list and matches case-insensitively
+            token: "bearer-xyz",
+            // "password" matches
+            password: "secret123",
+            timeout: 5000,
+        };
+        const result = (0, sanitize_1.sanitizeForLogging)(obj);
+        (0, bun_test_1.expect)(result.token).toBe("[REDACTED:10]");
+        (0, bun_test_1.expect)(result.password).toBe("[REDACTED:9]");
+        (0, bun_test_1.expect)(result.timeout).toBe(5000);
+    });
+    (0, bun_test_1.test)("matches via includes (key containing sensitive substring)", () => {
+        // Object key "my_api_key_field" lowercased includes "api_key"
+        const obj = { my_api_key_field: "secret-value" };
+        const result = (0, sanitize_1.sanitizeForLogging)(obj);
+        (0, bun_test_1.expect)(result.my_api_key_field).toBe("[REDACTED:12]");
+    });
+    (0, bun_test_1.test)("redacts authorization header (case-insensitive key)", () => {
+        // "Authorization" lowered → "authorization" which includes "authorization"
+        const obj = { Authorization: "Bearer tok12" };
+        const result = (0, sanitize_1.sanitizeForLogging)(obj);
+        (0, bun_test_1.expect)(result.Authorization).toBe("[REDACTED:12]");
+    });
+    (0, bun_test_1.test)("recursively sanitizes nested objects", () => {
+        const obj = {
+            config: { password: "secret", port: 3000 },
+        };
+        const result = (0, sanitize_1.sanitizeForLogging)(obj);
+        (0, bun_test_1.expect)(result.config.password).toBe("[REDACTED:6]");
+        (0, bun_test_1.expect)(result.config.port).toBe(3000);
+    });
+    (0, bun_test_1.test)("recursively sanitizes env key", () => {
+        const obj = { env: { TOKEN: "abc123" } };
+        const result = (0, sanitize_1.sanitizeForLogging)(obj);
+        (0, bun_test_1.expect)(result.env.TOKEN).toBe("[REDACTED:6]");
+    });
+    (0, bun_test_1.test)("handles arrays (recurses into elements)", () => {
+        const arr = [{ token: "secret" }, { name: "safe" }];
+        const result = (0, sanitize_1.sanitizeForLogging)(arr);
+        (0, bun_test_1.expect)(result[0].token).toBe("[REDACTED:6]");
+        (0, bun_test_1.expect)(result[1].name).toBe("safe");
+    });
+    (0, bun_test_1.test)("handles additional sensitive keys", () => {
+        const obj = { customSecret: "hidden", name: "visible" };
+        const result = (0, sanitize_1.sanitizeForLogging)(obj, ["customsecret"]);
+        (0, bun_test_1.expect)(result.customSecret).toBe("[REDACTED:6]");
+        (0, bun_test_1.expect)(result.name).toBe("visible");
+    });
+    (0, bun_test_1.test)("returns primitives unchanged", () => {
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeForLogging)("string")).toBe("string");
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeForLogging)(42)).toBe(42);
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeForLogging)(null)).toBe(null);
+        (0, bun_test_1.expect)((0, sanitize_1.sanitizeForLogging)(undefined)).toBe(undefined);
+    });
+    (0, bun_test_1.test)("does not mutate original object", () => {
+        const obj = { apiKey: "secret" };
+        (0, sanitize_1.sanitizeForLogging)(obj);
+        (0, bun_test_1.expect)(obj.apiKey).toBe("secret");
+    });
+    (0, bun_test_1.test)("only redacts string values of sensitive keys", () => {
+        const obj = { token: 12345 };
+        const result = (0, sanitize_1.sanitizeForLogging)(obj);
+        // Non-string sensitive values are not redacted
+        (0, bun_test_1.expect)(result.token).toBe(12345);
+    });
+});
+//# sourceMappingURL=sanitize.test.js.map

package/dist/__tests__/sanitize.test.js.map

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

package/dist/agent-policy.d.ts

@@ -0,0 +1,21 @@
+export interface CustomToolMetadata {
+    description: string;
+}
+export interface ToolIntentRule {
+    id: string;
+    title: string;
+    tools: string[];
+    instructionLines: string[];
+    patterns: RegExp[];
+    priority: number;
+    alwaysInclude?: boolean;
+}
+export declare const CUSTOM_TOOL_METADATA: Record<string, CustomToolMetadata>;
+export declare const TOOL_INTENT_RULES: ToolIntentRule[];
+export declare function getCustomToolDescription(name: string): string;
+export declare function renderBaselineAgentPolicy(): string;
+export declare function renderAlwaysOnToolPolicyRules(): string;
+export declare function detectToolIntentRules(prompt: string): ToolIntentRule[];
+export declare function renderDetectedToolIntentRules(prompt: string): string;
+export declare function buildUnconfiguredAgentNotice(settingsUrl?: string): string;
+//# sourceMappingURL=agent-policy.d.ts.map

package/dist/agent-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-policy.d.ts","sourceRoot":"","sources":["../src/agent-policy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAiCnE,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAuF7C,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAQlD;AAWD,wBAAgB,6BAA6B,IAAI,MAAM,CAQtD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAWtE;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASpE;AAED,wBAAgB,4BAA4B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAWzE"}