@oka-core/reason 0.2.14 → 0.2.16

package/dist/buffered-writer.js

@@ -0,0 +1,87 @@
+/**
+ * Batched I/O writer with backpressure — zero external dependencies.
+ *
+ * Batches writes by count, byte size, or time interval. Overflow batches
+ * are deferred via `setImmediate` to keep the current tick fast.
+ *
+ * Inspired by Claude Code's `src/utils/bufferedWriter.ts`.
+ */
+// ─── Factory ────────────────────────────────────────────────────────
+const scheduleImmediate = typeof globalThis.setImmediate === "function"
+    ? globalThis.setImmediate
+    : (fn) => setTimeout(fn, 0);
+export function createBufferedWriter(opts) {
+    const { writeFn, flushIntervalMs = 1000, maxBufferSize = 100, maxBufferBytes = Infinity, immediateMode = false, } = opts;
+    let buffer = [];
+    let bufferBytes = 0;
+    let flushTimer = null;
+    let pendingOverflow = null;
+    function drainOverflow() {
+        if (pendingOverflow) {
+            const batch = pendingOverflow;
+            pendingOverflow = null;
+            writeFn(batch);
+        }
+    }
+    function flushBuffer() {
+        if (buffer.length === 0)
+            return;
+        const batch = buffer;
+        buffer = [];
+        bufferBytes = 0;
+        writeFn(batch);
+    }
+    function scheduleFlush() {
+        if (flushTimer !== null)
+            return;
+        flushTimer = setTimeout(() => {
+            flushTimer = null;
+            flushBuffer();
+        }, flushIntervalMs);
+        if (typeof flushTimer === "object" && "unref" in flushTimer) {
+            flushTimer.unref();
+        }
+    }
+    return {
+        write(content) {
+            if (immediateMode) {
+                writeFn([content]);
+                return;
+            }
+            buffer.push(content);
+            bufferBytes += content.length;
+            if (buffer.length >= maxBufferSize || bufferBytes >= maxBufferBytes) {
+                // Overflow: detach buffer and defer the write
+                const batch = buffer;
+                buffer = [];
+                bufferBytes = 0;
+                if (pendingOverflow) {
+                    pendingOverflow.push(...batch);
+                }
+                else {
+                    pendingOverflow = batch;
+                    scheduleImmediate(drainOverflow);
+                }
+            }
+            else {
+                scheduleFlush();
+            }
+        },
+        flush() {
+            drainOverflow();
+            flushBuffer();
+            if (flushTimer !== null) {
+                clearTimeout(flushTimer);
+                flushTimer = null;
+            }
+        },
+        dispose() {
+            drainOverflow();
+            flushBuffer();
+            if (flushTimer !== null) {
+                clearTimeout(flushTimer);
+                flushTimer = null;
+            }
+        },
+    };
+}

package/dist/circular-buffer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Fixed-size circular buffer — zero external dependencies.
+ *
+ * O(1) add, automatic eviction of oldest entries when capacity is exceeded.
+ * Useful for metrics windows, log tailing, and recent-activity buffers.
+ *
+ * Inspired by Claude Code's `src/utils/CircularBuffer.ts`.
+ */
+export declare class CircularBuffer<T> {
+    private readonly capacity;
+    private buffer;
+    private head;
+    private _size;
+    constructor(capacity: number);
+    /** Add an item, evicting the oldest if at capacity. */
+    add(item: T): void;
+    /** Add multiple items. */
+    addAll(items: T[]): void;
+    /** Get the most recent `count` items in insertion order (oldest first). */
+    getRecent(count?: number): T[];
+    /** Get all items in insertion order (oldest first). */
+    toArray(): T[];
+    /** Remove all items. */
+    clear(): void;
+    /** Current number of items (0 to capacity). */
+    get length(): number;
+}
+//# sourceMappingURL=circular-buffer.d.ts.map

package/dist/circular-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circular-buffer.d.ts","sourceRoot":"","sources":["../src/circular-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,cAAc,CAAC,CAAC;IAKf,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;gBAEW,QAAQ,EAAE,MAAM;IAO7C,uDAAuD;IACvD,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAQlB,0BAA0B;IAC1B,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAMxB,2EAA2E;IAC3E,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;IAa9B,uDAAuD;IACvD,OAAO,IAAI,CAAC,EAAE;IAId,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAKb,+CAA+C;IAC/C,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/circular-buffer.js

@@ -0,0 +1,61 @@
+/**
+ * Fixed-size circular buffer — zero external dependencies.
+ *
+ * O(1) add, automatic eviction of oldest entries when capacity is exceeded.
+ * Useful for metrics windows, log tailing, and recent-activity buffers.
+ *
+ * Inspired by Claude Code's `src/utils/CircularBuffer.ts`.
+ */
+export class CircularBuffer {
+    capacity;
+    buffer;
+    head = 0;
+    _size = 0;
+    constructor(capacity) {
+        this.capacity = capacity;
+        if (capacity < 1) {
+            throw new RangeError("CircularBuffer capacity must be >= 1");
+        }
+        this.buffer = new Array(capacity);
+    }
+    /** Add an item, evicting the oldest if at capacity. */
+    add(item) {
+        this.buffer[this.head] = item;
+        this.head = (this.head + 1) % this.capacity;
+        if (this._size < this.capacity) {
+            this._size++;
+        }
+    }
+    /** Add multiple items. */
+    addAll(items) {
+        for (const item of items) {
+            this.add(item);
+        }
+    }
+    /** Get the most recent `count` items in insertion order (oldest first). */
+    getRecent(count) {
+        const n = Math.min(count ?? this._size, this._size);
+        if (n === 0)
+            return [];
+        const result = [];
+        // Start from (head - n) wrapped around
+        let start = (this.head - n + this.capacity) % this.capacity;
+        for (let i = 0; i < n; i++) {
+            result.push(this.buffer[(start + i) % this.capacity]);
+        }
+        return result;
+    }
+    /** Get all items in insertion order (oldest first). */
+    toArray() {
+        return this.getRecent(this._size);
+    }
+    /** Remove all items. */
+    clear() {
+        this.head = 0;
+        this._size = 0;
+    }
+    /** Current number of items (0 to capacity). */
+    get length() {
+        return this._size;
+    }
+}

package/dist/cleanup-registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Global cleanup function registry — zero external dependencies.
+ *
+ * Any module can register its cleanup handler without importing the shutdown
+ * controller. Call `runCleanupFunctions()` during graceful shutdown.
+ *
+ * Inspired by Claude Code's `src/utils/cleanupRegistry.ts`.
+ */
+/**
+ * Register a cleanup function. Returns an unregister function.
+ */
+export declare function registerCleanup(fn: () => Promise<void>): () => void;
+/**
+ * Run all registered cleanup functions in parallel.
+ * Errors in individual functions don't block others.
+ * Clears the registry after execution.
+ */
+export declare function runCleanupFunctions(): Promise<void>;
+/**
+ * Reset the registry (for testing only).
+ */
+export declare function _resetRegistryForTesting(): void;
+//# sourceMappingURL=cleanup-registry.d.ts.map

package/dist/cleanup-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-registry.d.ts","sourceRoot":"","sources":["../src/cleanup-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAKnE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/cleanup-registry.js

@@ -0,0 +1,34 @@
+/**
+ * Global cleanup function registry — zero external dependencies.
+ *
+ * Any module can register its cleanup handler without importing the shutdown
+ * controller. Call `runCleanupFunctions()` during graceful shutdown.
+ *
+ * Inspired by Claude Code's `src/utils/cleanupRegistry.ts`.
+ */
+const registry = new Set();
+/**
+ * Register a cleanup function. Returns an unregister function.
+ */
+export function registerCleanup(fn) {
+    registry.add(fn);
+    return () => {
+        registry.delete(fn);
+    };
+}
+/**
+ * Run all registered cleanup functions in parallel.
+ * Errors in individual functions don't block others.
+ * Clears the registry after execution.
+ */
+export async function runCleanupFunctions() {
+    const fns = [...registry];
+    registry.clear();
+    await Promise.allSettled(fns.map((fn) => fn()));
+}
+/**
+ * Reset the registry (for testing only).
+ */
+export function _resetRegistryForTesting() {
+    registry.clear();
+}

package/dist/client.d.ts

@@ -183,10 +183,13 @@ export declare class OkaClient {
     private readonly agentId;
     private readonly sessionId;
     private readonly timeout;
+    private readonly tokenManager;
     /** Maps learning_id → feedback_id for LTR attribution across tool calls. */
     private readonly searchContext;
     /** Reverse map: short ID prefix → full UUID */
     private readonly idLookup;
+    /** Memoized search — deduplicates concurrent identical queries (30s TTL). */
+    private readonly cachedGet;
     constructor(config?: OkaClientConfig);
     updateApiKey(key: string): void;
     ingest(event: IngestEvent): Promise<void>;
@@ -243,12 +246,10 @@ export declare class OkaClient {
      */
     triggerConsolidation(req: ConsolidateRequest): Promise<ConsolidateResponse>;
     private authHeaders;
+    private buildHeaders;
     private get;
     private post;
-    /**
-     * On 401, attempt to refresh the token and retry the request once.
-     * Returns the parsed JSON response on success, or null if refresh failed.
-     */
-    private retryWithRefresh;
+    private rawGet;
+    private rawPost;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -1,5 +1,8 @@
 import { EventBuffer } from "./buffer.js";
-import { resolveApiKey, resolveApiKeyWithRefresh } from "./auth.js";
+import { McpTokenManager } from "./auth.js";
+import { AuthenticationError, NetworkError } from "./errors.js";
+import { withRetry } from "./retry.js";
+import { memoizeAsync } from "./memo.js";
 /**
  * Unified HTTP client for Oka Reason API.
  *
@@ -21,10 +24,13 @@ export class OkaClient {
     agentId;
     sessionId;
     timeout;
+    tokenManager;
     /** Maps learning_id → feedback_id for LTR attribution across tool calls. */
     searchContext = new Map();
     /** Reverse map: short ID prefix → full UUID */
     idLookup = new Map();
+    /** Memoized search — deduplicates concurrent identical queries (30s TTL). */
+    cachedGet;
     constructor(config) {
         this.apiUrl = (config?.apiUrl ||
             process.env["OKA_API_URL"] ||
@@ -35,6 +41,12 @@ export class OkaClient {
         this.sessionId = process.env["SESSION_ID"] || `session-${Date.now()}`;
         this.buffer = new EventBuffer(100);
         this.timeout = 15_000;
+        this.tokenManager = new McpTokenManager();
+        this.cachedGet = memoizeAsync((path) => this.get(path), {
+            ttlMs: 30_000,
+            keyFn: (path) => path,
+            maxEntries: 100,
+        });
     }
     updateApiKey(key) {
         this.apiKey = key;
@@ -56,12 +68,10 @@ export class OkaClient {
         if (events.length === 0)
             return;
         try {
+            const headers = await this.authHeaders();
             await fetch(`${this.apiUrl}/api/reasoning/ingest`, {
                 method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    ...this.authHeaders(),
-                },
+                headers,
                 body: JSON.stringify({ events }),
                 signal: AbortSignal.timeout(5_000),
             });
@@ -89,7 +99,7 @@ export class OkaClient {
             params.set("include_events", String(options.include_events));
         if (options?.visibility)
             params.set("visibility", options.visibility);
-        return this.get(`/api/learnings/context/${encodeURIComponent(topic)}?${params}`).catch(() => ({ topic, learnings: [], total_matched: 0 }));
+        return this.cachedGet(`/api/learnings/context/${encodeURIComponent(topic)}?${params}`).catch(() => ({ topic, learnings: [], total_matched: 0 }));
     }
     // ─── Event queries ──────────────────────────────────────────────
     async query(params) {
@@ -100,8 +110,9 @@ export class OkaClient {
                 if (v)
                     url.searchParams.set(k, v);
             }
+            const headers = await this.authHeaders();
             const res = await fetch(url.toString(), {
-                headers: this.authHeaders(),
+                headers,
                 signal: AbortSignal.timeout(10_000),
             });
             if (!res.ok)
@@ -188,7 +199,7 @@ export class OkaClient {
             params.set("min_confidence", String(options.min_confidence));
         if (options?.visibility)
             params.set("visibility", options.visibility);
-        return this.get(`/api/learnings/semantic/${encodeURIComponent(query)}?${params}`).catch(() => ({ query, results: [], total: 0 }));
+        return this.cachedGet(`/api/learnings/semantic/${encodeURIComponent(query)}?${params}`).catch(() => ({ query, results: [], total: 0 }));
     }
     // ─── Hybrid search (unified pipeline) ───────────────────────────
     /**
@@ -218,7 +229,7 @@ export class OkaClient {
             params.set("rerank", "true");
         if (options?.mode)
             params.set("mode", options.mode);
-        const data = await this.get(`/api/learnings/query/${encodeURIComponent(query)}?${params}`).catch(() => ({
+        const data = await this.cachedGet(`/api/learnings/query/${encodeURIComponent(query)}?${params}`).catch(() => ({
             query,
             results: [],
             total_candidates: 0,
@@ -296,17 +307,16 @@ export class OkaClient {
         return this.post("/api/reasoning/consolidate", body, 120_000);
     }
     // ─── HTTP helpers ───────────────────────────────────────────────
-    authHeaders() {
-        // Resolve credentials fresh each call so .env / credentials.json
-        // changes (e.g. after `login`) are picked up without MCP restart.
-        const key = this.apiKey || resolveApiKey();
+    async authHeaders() {
+        const key = this.apiKey || (await this.tokenManager.getValidToken());
+        return this.buildHeaders(key);
+    }
+    buildHeaders(key) {
         const headers = {
             "Content-Type": "application/json",
         };
         if (key) {
             // JWTs have dots (header.payload.signature); API keys don't.
-            // Sending both headers causes the server to try Bearer first and fail
-            // when the value is an API key, never falling back to X-Api-Key.
             const isJwt = key.includes(".");
             if (isJwt) {
                 headers["Authorization"] = `Bearer ${key}`;
@@ -318,47 +328,55 @@ export class OkaClient {
         return headers;
     }
     async get(path) {
+        return withRetry(() => this.rawGet(path), { source: "foreground" });
+    }
+    async post(path, body, timeout) {
+        return withRetry(() => this.rawPost(path, body, timeout), {
+            source: "foreground",
+        });
+    }
+    async rawGet(path) {
+        const headers = await this.authHeaders();
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeout);
         try {
             const response = await fetch(`${this.apiUrl}${path}`, {
                 method: "GET",
-                headers: this.authHeaders(),
+                headers,
                 signal: controller.signal,
             });
-            if (response.status === 401) {
-                const retried = await this.retryWithRefresh("GET", path);
-                if (retried !== null)
-                    return retried;
-                throw new Error("HTTP 401: authentication failed — run mcp__oka__login to re-authenticate");
+            if (!response.ok) {
+                if (response.status === 401) {
+                    throw new AuthenticationError("Authentication failed — run mcp__oka__login to re-authenticate");
+                }
+                throw new NetworkError(`HTTP ${response.status}`, {
+                    statusCode: response.status,
+                });
             }
-            if (!response.ok)
-                throw new Error(`HTTP ${response.status}`);
             return response.json();
         }
         finally {
             clearTimeout(timer);
         }
     }
-    async post(path, body, timeout) {
+    async rawPost(path, body, timeout) {
+        const headers = await this.authHeaders();
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), timeout ?? this.timeout);
         try {
             const response = await fetch(`${this.apiUrl}${path}`, {
                 method: "POST",
-                headers: this.authHeaders(),
+                headers,
                 body: JSON.stringify(body),
                 signal: controller.signal,
             });
-            if (response.status === 401) {
-                const retried = await this.retryWithRefresh("POST", path, body);
-                if (retried !== null)
-                    return retried;
-                throw new Error("HTTP 401: authentication failed — run mcp__oka__login to re-authenticate");
-            }
             if (!response.ok) {
-                const text = await response.text().catch(() => "");
-                throw new Error(`HTTP ${response.status}: ${text}`);
+                if (response.status === 401) {
+                    throw new AuthenticationError("Authentication failed — run mcp__oka__login to re-authenticate");
+                }
+                throw new NetworkError(`HTTP ${response.status}`, {
+                    statusCode: response.status,
+                });
             }
             return response.json();
         }
@@ -366,35 +384,4 @@ export class OkaClient {
             clearTimeout(timer);
         }
     }
-    /**
-     * On 401, attempt to refresh the token and retry the request once.
-     * Returns the parsed JSON response on success, or null if refresh failed.
-     */
-    async retryWithRefresh(method, path, body) {
-        const newKey = await resolveApiKeyWithRefresh();
-        if (!newKey)
-            return null;
-        const headers = {
-            "Content-Type": "application/json",
-        };
-        const isJwt = newKey.includes(".");
-        if (isJwt) {
-            headers["Authorization"] = `Bearer ${newKey}`;
-        }
-        else {
-            headers["X-Api-Key"] = newKey;
-        }
-        const opts = {
-            method,
-            headers,
-            signal: AbortSignal.timeout(this.timeout),
-        };
-        if (body !== undefined) {
-            opts.body = JSON.stringify(body);
-        }
-        const retryResponse = await fetch(`${this.apiUrl}${path}`, opts);
-        if (!retryResponse.ok)
-            return null;
-        return retryResponse.json();
-    }
 }

package/dist/combined-abort-signal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Compose multiple AbortSignals + optional timeout into a single signal.
+ *
+ * Uses setTimeout + clearTimeout instead of AbortSignal.timeout() to avoid
+ * the Bun memory issue where AbortSignal.timeout timers accumulate (~2.4KB
+ * per call) until they fire.
+ *
+ * Inspired by Claude Code's `src/utils/combinedAbortSignal.ts`.
+ */
+/**
+ * Create a combined AbortSignal that aborts when:
+ * - The primary `signal` aborts, OR
+ * - The optional `signalB` aborts, OR
+ * - The optional `timeoutMs` elapses.
+ *
+ * Returns both the signal and a cleanup function to remove listeners / clear timer.
+ */
+export declare function createCombinedAbortSignal(signal: AbortSignal | undefined, opts?: {
+    signalB?: AbortSignal;
+    timeoutMs?: number;
+}): {
+    signal: AbortSignal;
+    cleanup: () => void;
+};
+//# sourceMappingURL=combined-abort-signal.d.ts.map

package/dist/combined-abort-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combined-abort-signal.d.ts","sourceRoot":"","sources":["../src/combined-abort-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA+B9C"}

package/dist/combined-abort-signal.js

@@ -0,0 +1,47 @@
+/**
+ * Compose multiple AbortSignals + optional timeout into a single signal.
+ *
+ * Uses setTimeout + clearTimeout instead of AbortSignal.timeout() to avoid
+ * the Bun memory issue where AbortSignal.timeout timers accumulate (~2.4KB
+ * per call) until they fire.
+ *
+ * Inspired by Claude Code's `src/utils/combinedAbortSignal.ts`.
+ */
+import { createAbortController } from "./abort-controller.js";
+/**
+ * Create a combined AbortSignal that aborts when:
+ * - The primary `signal` aborts, OR
+ * - The optional `signalB` aborts, OR
+ * - The optional `timeoutMs` elapses.
+ *
+ * Returns both the signal and a cleanup function to remove listeners / clear timer.
+ */
+export function createCombinedAbortSignal(signal, opts) {
+    const { signalB, timeoutMs } = opts ?? {};
+    const combined = createAbortController();
+    if (signal?.aborted || signalB?.aborted) {
+        combined.abort();
+        return { signal: combined.signal, cleanup: () => { } };
+    }
+    let timer;
+    const abortCombined = () => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        combined.abort();
+    };
+    if (timeoutMs !== undefined) {
+        timer = setTimeout(abortCombined, timeoutMs);
+        if (typeof timer === "object" && "unref" in timer) {
+            timer.unref();
+        }
+    }
+    signal?.addEventListener("abort", abortCombined);
+    signalB?.addEventListener("abort", abortCombined);
+    const cleanup = () => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        signal?.removeEventListener("abort", abortCombined);
+        signalB?.removeEventListener("abort", abortCombined);
+    };
+    return { signal: combined.signal, cleanup };
+}

package/dist/cron-lock.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Scheduler lease lock for cron task files.
+ *
+ * When multiple processes share the same task directory, only one should
+ * drive the cron scheduler. Uses O_EXCL atomic create, PID liveness probe,
+ * and stale-lock recovery.
+ */
+export type SchedulerLockOptions = {
+    /** Directory containing the lock file. */
+    dir: string;
+    /** Stable owner identity (e.g. session ID or random UUID). */
+    ownerId: string;
+};
+/**
+ * Try to acquire the scheduler lock.
+ *
+ * Returns true on success, false if another live process holds it.
+ *
+ * Uses O_EXCL for atomic test-and-set. If the file exists:
+ *   - Already ours → true (idempotent)
+ *   - Another live PID → false
+ *   - Stale (PID dead / corrupt) → unlink and retry once
+ */
+export declare function tryAcquireSchedulerLock(opts: SchedulerLockOptions): Promise<boolean>;
+/**
+ * Release the scheduler lock if we own it.
+ */
+export declare function releaseSchedulerLock(opts: SchedulerLockOptions): Promise<void>;
+//# sourceMappingURL=cron-lock.d.ts.map

package/dist/cron-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-lock.d.ts","sourceRoot":"","sources":["../src/cron-lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,MAAM,oBAAoB,GAAG;IACjC,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAuEF;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CASf"}