@runcore-sh/runcore 0.1.2

package/dist/activity/log.js

@@ -0,0 +1,259 @@
+/**
+ * Activity log — in-memory with JSONL persistence.
+ * Appends to brain/ops/activity.jsonl so history survives restarts.
+ * Hydrates from disk on first access (lazy).
+ * All entries encrypted at rest via brain-io.
+ */
+import { join } from "node:path";
+import { createReadStream, openSync, fstatSync, readSync, closeSync } from "node:fs";
+import { createInterface } from "node:readline";
+import { randomBytes } from "node:crypto";
+import { createLogger } from "../utils/logger.js";
+import { appendBrainLineSync, appendBrainLine, ensureBrainFileSync, } from "../lib/brain-io.js";
+import { getPressureIntegrator } from "../pulse/pressure.js";
+const log = createLogger("activity");
+/** Generate a short, unique trace ID: ts_ + 12 hex chars. */
+export function generateTraceId() {
+    return "ts_" + randomBytes(6).toString("hex");
+}
+// ─── File path ───────────────────────────────────────────────────────────────
+const OPS_DIR = join(process.cwd(), "brain", "ops");
+const ACTIVITY_FILE = join(OPS_DIR, "activity.jsonl");
+const SCHEMA_LINE = JSON.stringify({ _schema: "activity", _version: "1.0" });
+// ─── State ───────────────────────────────────────────────────────────────────
+const RETENTION_MS = 24 * 60 * 60 * 1000; // 24-hour retention window
+const MAX_IN_MEMORY = 15_000; // safety cap (~40h at peak rates)
+const EVICT_CHECK_INTERVAL = 50; // run time-based eviction every N inserts
+let entries = [];
+let nextId = 1;
+let hydrated = false;
+let writeReady = false;
+let fileEnsured = false;
+let insertsSinceEvict = 0;
+// ─── Logger cache ────────────────────────────────────────────────────────────
+const loggerCache = new Map();
+function getCachedLogger(source) {
+    let cached = loggerCache.get(source);
+    if (!cached) {
+        cached = createLogger(source);
+        loggerCache.set(source, cached);
+    }
+    return cached;
+}
+// ─── Persistence ─────────────────────────────────────────────────────────────
+function ensureFile() {
+    if (fileEnsured)
+        return;
+    ensureBrainFileSync(ACTIVITY_FILE, SCHEMA_LINE);
+    fileEnsured = true;
+}
+/**
+ * Cheap write-readiness check. Reads only the last ~8KB of the file
+ * (enough for ~30 JSON lines) to determine `nextId`.
+ * Called by logActivity() during startup instead of full hydrate(),
+ * so provider registrations don't pay the full-file-read cost.
+ */
+function ensureWriteReady() {
+    if (writeReady || hydrated)
+        return;
+    writeReady = true;
+    try {
+        ensureFile();
+        let fd;
+        try {
+            fd = openSync(ACTIVITY_FILE, "r");
+        }
+        catch {
+            return; // file doesn't exist yet — nextId stays at 1
+        }
+        try {
+            const stat = fstatSync(fd);
+            const fileSize = stat.size;
+            if (fileSize === 0)
+                return;
+            // Read only the tail — 8KB is plenty for ~30 JSON lines
+            const TAIL_BYTES = 8192;
+            const readStart = Math.max(0, fileSize - TAIL_BYTES);
+            const readLen = fileSize - readStart;
+            const buf = Buffer.alloc(readLen);
+            readSync(fd, buf, 0, readLen, readStart);
+            const tail = buf.toString("utf-8");
+            // Scan tail lines (last 30 non-empty) for the highest id
+            const lines = tail.split("\n");
+            const TAIL_SIZE = 30;
+            let scanned = 0;
+            for (let i = lines.length - 1; i >= 0 && scanned < TAIL_SIZE; i--) {
+                const line = lines[i].trim();
+                if (!line)
+                    continue;
+                scanned++;
+                try {
+                    const obj = JSON.parse(line);
+                    if (obj._schema)
+                        continue;
+                    if (typeof obj.id === "number" && obj.id >= nextId) {
+                        nextId = obj.id + 1;
+                    }
+                }
+                catch {
+                    // skip malformed / partial lines (first line may be truncated)
+                }
+            }
+            log.debug(`Write-ready: nextId=${nextId} (scanned ${scanned} tail lines, read ${readLen}B of ${fileSize}B)`);
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch (err) {
+        log.warn(`Failed to init write-ready: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Load existing entries from disk using a streaming line reader.
+ * Processes the JSONL file incrementally via readline — never loads the
+ * entire file into a single string, keeping memory pressure low even for
+ * 10k+ line files. Called once, lazily — only by read paths.
+ */
+let hydratePromise = null;
+async function hydrate() {
+    if (hydrated)
+        return;
+    if (hydratePromise)
+        return hydratePromise;
+    hydratePromise = doHydrate();
+    return hydratePromise;
+}
+async function doHydrate() {
+    hydrated = true;
+    writeReady = true; // full hydrate subsumes write-ready
+    try {
+        ensureFile();
+        const cutoff = new Date(Date.now() - RETENTION_MS).toISOString();
+        const recent = [];
+        const rl = createInterface({
+            input: createReadStream(ACTIVITY_FILE, { encoding: "utf-8" }),
+            crlfDelay: Infinity,
+        });
+        for await (const raw of rl) {
+            const line = raw.trim();
+            if (!line)
+                continue;
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue; // skip schema header
+                if (obj.id && obj.timestamp && obj.source) {
+                    if (obj.id >= nextId)
+                        nextId = obj.id + 1;
+                    // Only collect entries within the 24h window
+                    if (obj.timestamp >= cutoff) {
+                        recent.push(obj);
+                    }
+                }
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        // Cap at MAX_IN_MEMORY (keep most recent)
+        entries = recent.length > MAX_IN_MEMORY
+            ? recent.slice(recent.length - MAX_IN_MEMORY)
+            : recent;
+        if (entries.length > 0) {
+            nextId = Math.max(nextId, entries[entries.length - 1].id + 1);
+        }
+        log.info(`Hydrated ${entries.length} activity entries from disk (streaming)`);
+    }
+    catch (err) {
+        log.warn(`Failed to hydrate activity log: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Append a single entry to the JSONL file. Fire-and-forget.
+ * Uses async I/O to avoid blocking the event loop during startup
+ * (webhook provider registration triggers multiple logActivity calls).
+ * Falls back to sync I/O if the async write fails.
+ */
+function persistEntry(entry) {
+    try {
+        ensureFile();
+        const json = JSON.stringify(entry);
+        // Use async append — fire-and-forget to unblock the event loop.
+        // This is safe because in-memory entries[] is the source of truth;
+        // disk is only for persistence across restarts.
+        appendBrainLine(ACTIVITY_FILE, json).catch((err) => {
+            // Async write failed — fall back to sync as last resort
+            try {
+                appendBrainLineSync(ACTIVITY_FILE, json);
+            }
+            catch {
+                log.warn(`Failed to persist activity entry: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        });
+    }
+    catch (err) {
+        log.warn(`Failed to persist activity entry: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/** Append an activity entry, persist to disk, and echo to console. */
+export function logActivity(opts) {
+    ensureWriteReady();
+    const entry = {
+        id: nextId++,
+        timestamp: new Date().toISOString(),
+        source: opts.source,
+        summary: opts.summary,
+        detail: opts.detail,
+        traceId: opts.traceId ?? generateTraceId(),
+        backref: opts.backref,
+        actionLabel: opts.actionLabel,
+        reason: opts.reason,
+    };
+    entries.push(entry);
+    // Time-based eviction: periodically trim entries older than 24h.
+    // Amortised across inserts so we don't scan on every call.
+    insertsSinceEvict++;
+    if (insertsSinceEvict >= EVICT_CHECK_INTERVAL) {
+        insertsSinceEvict = 0;
+        const cutoff = new Date(Date.now() - RETENTION_MS).toISOString();
+        // entries are chronologically sorted — find first entry within window
+        let trimIndex = 0;
+        while (trimIndex < entries.length && entries[trimIndex].timestamp < cutoff) {
+            trimIndex++;
+        }
+        if (trimIndex > 0) {
+            entries = entries.slice(trimIndex);
+        }
+    }
+    // Hard safety cap (shouldn't normally trigger with time-based eviction)
+    if (entries.length > MAX_IN_MEMORY) {
+        entries = entries.slice(entries.length - MAX_IN_MEMORY);
+    }
+    persistEntry(entry);
+    getCachedLogger(entry.source).info(entry.summary);
+    // Feed event into pressure integrator (if initialized)
+    getPressureIntegrator()?.addTension(entry.source, entry.summary);
+    return entry;
+}
+/** Return entries with id > since (for efficient polling). */
+export async function getActivities(since) {
+    await hydrate();
+    if (since == null)
+        return [...entries];
+    return entries.filter((e) => e.id > since);
+}
+/** Return entries matching the given IDs (for branch context). */
+export async function getActivitiesByIds(ids) {
+    await hydrate();
+    const idSet = new Set(ids);
+    return entries.filter((e) => idSet.has(e.id));
+}
+/** Return entries matching the given trace IDs. */
+export async function getActivitiesByTraceIds(traceIds) {
+    await hydrate();
+    const idSet = new Set(traceIds);
+    return entries.filter((e) => idSet.has(e.traceId));
+}
+//# sourceMappingURL=log.js.map

package/dist/activity/log.js.map

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

package/dist/adapters/storage/gdrive-backup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Google Drive storage adapter for brain backups.
+ * Leverages existing Google OAuth from src/google/auth.ts.
+ * Stores backup archives in a dedicated "Core Backups" folder.
+ */
+import type { StorageAdapter, BackupManifest, BackupResult, RestoreResult } from "./types.js";
+export declare class GDriveBackupAdapter implements StorageAdapter {
+    readonly name = "gdrive";
+    private folderId;
+    isAvailable(): Promise<boolean>;
+    private ensureFolder;
+    upload(archivePath: string, remoteName: string): Promise<BackupResult>;
+    download(remoteName: string, localPath: string): Promise<RestoreResult>;
+    listBackups(): Promise<BackupManifest[]>;
+    deleteBackup(backupId: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=gdrive-backup.d.ts.map

package/dist/adapters/storage/gdrive-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdrive-backup.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/gdrive-backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiE9F,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAuB;IAEjC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;YAIvB,YAAY;IA8BpB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4EtE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA4CvE,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAqCxC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA8BhF"}

package/dist/adapters/storage/gdrive-backup.js

@@ -0,0 +1,244 @@
+/**
+ * Google Drive storage adapter for brain backups.
+ * Leverages existing Google OAuth from src/google/auth.ts.
+ * Stores backup archives in a dedicated "Core Backups" folder.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { getInstanceName } from "../../instance.js";
+import { createLogger } from "../../utils/logger.js";
+import { getAccessToken, isGoogleAuthenticated } from "../../google/auth.js";
+const log = createLogger("backup.gdrive");
+const DRIVE_API = "https://www.googleapis.com/drive/v3";
+const DRIVE_UPLOAD_API = "https://www.googleapis.com/upload/drive/v3";
+function getBackupFolderName() {
+    return `${getInstanceName()} Backups`;
+}
+async function driveRequest(method, url, body, contentType) {
+    const auth = await getAccessToken();
+    if (!auth.ok)
+        return { ok: false, message: auth.message };
+    try {
+        const headers = {
+            Authorization: `Bearer ${auth.token}`,
+        };
+        if (contentType)
+            headers["Content-Type"] = contentType;
+        const fetchOpts = { method, headers };
+        if (body) {
+            fetchOpts.body = body instanceof Buffer
+                ? body
+                : typeof body === "string"
+                    ? body
+                    : JSON.stringify(body);
+            if (!contentType && typeof body === "object" && !(body instanceof Buffer)) {
+                headers["Content-Type"] = "application/json";
+            }
+        }
+        const res = await fetch(url, { ...fetchOpts, signal: AbortSignal.timeout(120_000) });
+        if (!res.ok) {
+            const text = await res.text();
+            return { ok: false, message: `Drive API error (${res.status}): ${text}` };
+        }
+        const resText = await res.text();
+        const data = resText ? JSON.parse(resText) : undefined;
+        return { ok: true, data, message: "OK" };
+    }
+    catch (err) {
+        return { ok: false, message: `Drive request failed: ${err.message}` };
+    }
+}
+export class GDriveBackupAdapter {
+    name = "gdrive";
+    folderId = null;
+    async isAvailable() {
+        return isGoogleAuthenticated();
+    }
+    async ensureFolder() {
+        if (this.folderId)
+            return this.folderId;
+        // Search for existing folder
+        const searchUrl = `${DRIVE_API}/files?q=${encodeURIComponent(`name='${getBackupFolderName()}' and mimeType='application/vnd.google-apps.folder' and trashed=false`)}&fields=files(id,name)`;
+        const search = await driveRequest("GET", searchUrl);
+        if (search.ok && search.data?.files?.length) {
+            this.folderId = search.data.files[0].id;
+            return this.folderId;
+        }
+        // Create folder
+        const create = await driveRequest("POST", `${DRIVE_API}/files`, {
+            name: getBackupFolderName(),
+            mimeType: "application/vnd.google-apps.folder",
+        });
+        if (create.ok && create.data) {
+            this.folderId = create.data.id;
+            log.info("created Drive backup folder", { folderId: this.folderId });
+            return this.folderId;
+        }
+        log.error("failed to create Drive backup folder", { error: create.message });
+        return null;
+    }
+    async upload(archivePath, remoteName) {
+        if (!isGoogleAuthenticated()) {
+            return { ok: false, message: "Google not authenticated" };
+        }
+        const folderId = await this.ensureFolder();
+        if (!folderId)
+            return { ok: false, message: "Could not create backup folder on Drive" };
+        try {
+            const buffer = await readFile(archivePath);
+            const boundary = "dash_backup_upload_boundary";
+            const metadata = {
+                name: remoteName,
+                mimeType: "application/gzip",
+                parents: [folderId],
+            };
+            // Read manifest if it exists alongside archive
+            let manifest;
+            const manifestPath = archivePath.replace(/\.tar\.gz$/, ".manifest.json");
+            try {
+                const raw = await readFile(manifestPath, "utf-8");
+                manifest = JSON.parse(raw);
+                metadata.appProperties = { backupId: manifest.id, timestamp: manifest.timestamp };
+            }
+            catch {
+                // No manifest
+            }
+            const metaPart = JSON.stringify(metadata);
+            const body = Buffer.concat([
+                Buffer.from(`--${boundary}\r\nContent-Type: application/json; charset=UTF-8\r\n\r\n`),
+                Buffer.from(metaPart),
+                Buffer.from(`\r\n--${boundary}\r\nContent-Type: application/gzip\r\n\r\n`),
+                buffer,
+                Buffer.from(`\r\n--${boundary}--`),
+            ]);
+            const result = await driveRequest("POST", `${DRIVE_UPLOAD_API}/files?uploadType=multipart`, body, `multipart/related; boundary=${boundary}`);
+            if (!result.ok)
+                return { ok: false, message: result.message };
+            // Upload manifest file too
+            if (manifest) {
+                const manifestBuffer = Buffer.from(JSON.stringify(manifest, null, 2));
+                const manifestName = remoteName.replace(/\.tar\.gz$/, ".manifest.json");
+                const mBoundary = "dash_manifest_upload_boundary";
+                const mMeta = JSON.stringify({
+                    name: manifestName,
+                    mimeType: "application/json",
+                    parents: [folderId],
+                    appProperties: { backupId: manifest.id, type: "manifest" },
+                });
+                const mBody = Buffer.concat([
+                    Buffer.from(`--${mBoundary}\r\nContent-Type: application/json; charset=UTF-8\r\n\r\n`),
+                    Buffer.from(mMeta),
+                    Buffer.from(`\r\n--${mBoundary}\r\nContent-Type: application/json\r\n\r\n`),
+                    manifestBuffer,
+                    Buffer.from(`\r\n--${mBoundary}--`),
+                ]);
+                await driveRequest("POST", `${DRIVE_UPLOAD_API}/files?uploadType=multipart`, mBody, `multipart/related; boundary=${mBoundary}`);
+            }
+            log.info("backup uploaded to Drive", { remoteName, driveFileId: result.data?.id });
+            return { ok: true, message: `Uploaded to Drive: ${remoteName}`, manifest };
+        }
+        catch (err) {
+            log.error("Drive upload failed", { error: err.message });
+            return { ok: false, message: `Drive upload failed: ${err.message}` };
+        }
+    }
+    async download(remoteName, localPath) {
+        if (!isGoogleAuthenticated()) {
+            return { ok: false, message: "Google not authenticated", filesRestored: 0 };
+        }
+        try {
+            const folderId = await this.ensureFolder();
+            if (!folderId)
+                return { ok: false, message: "Backup folder not found", filesRestored: 0 };
+            // Find file by name in backup folder
+            const searchUrl = `${DRIVE_API}/files?q=${encodeURIComponent(`name='${remoteName}' and '${folderId}' in parents and trashed=false`)}&fields=files(id,name)`;
+            const search = await driveRequest("GET", searchUrl);
+            if (!search.ok || !search.data?.files?.length) {
+                return { ok: false, message: `Backup ${remoteName} not found on Drive`, filesRestored: 0 };
+            }
+            const fileId = search.data.files[0].id;
+            const auth = await getAccessToken();
+            if (!auth.ok)
+                return { ok: false, message: auth.message, filesRestored: 0 };
+            const res = await fetch(`${DRIVE_API}/files/${fileId}?alt=media`, {
+                headers: { Authorization: `Bearer ${auth.token}` },
+                signal: AbortSignal.timeout(120_000),
+            });
+            if (!res.ok) {
+                return { ok: false, message: `Drive download error (${res.status})`, filesRestored: 0 };
+            }
+            const buffer = Buffer.from(await res.arrayBuffer());
+            await mkdir(dirname(localPath), { recursive: true });
+            await writeFile(localPath, buffer);
+            log.info("backup downloaded from Drive", { remoteName, localPath });
+            return { ok: true, message: `Downloaded from Drive: ${remoteName}`, filesRestored: 1 };
+        }
+        catch (err) {
+            log.error("Drive download failed", { error: err.message });
+            return { ok: false, message: `Drive download failed: ${err.message}`, filesRestored: 0 };
+        }
+    }
+    async listBackups() {
+        if (!isGoogleAuthenticated())
+            return [];
+        try {
+            const folderId = await this.ensureFolder();
+            if (!folderId)
+                return [];
+            const searchUrl = `${DRIVE_API}/files?q=${encodeURIComponent(`'${folderId}' in parents and name contains '.manifest.json' and trashed=false`)}&fields=files(id,name,appProperties)&orderBy=modifiedTime desc&pageSize=50`;
+            const result = await driveRequest("GET", searchUrl);
+            if (!result.ok || !result.data?.files?.length)
+                return [];
+            const manifests = [];
+            for (const file of result.data.files) {
+                try {
+                    const auth = await getAccessToken();
+                    if (!auth.ok)
+                        continue;
+                    const res = await fetch(`${DRIVE_API}/files/${file.id}?alt=media`, {
+                        headers: { Authorization: `Bearer ${auth.token}` },
+                        signal: AbortSignal.timeout(30_000),
+                    });
+                    if (!res.ok)
+                        continue;
+                    const manifest = (await res.json());
+                    manifests.push(manifest);
+                }
+                catch {
+                    continue;
+                }
+            }
+            return manifests.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        }
+        catch {
+            return [];
+        }
+    }
+    async deleteBackup(backupId) {
+        if (!isGoogleAuthenticated()) {
+            return { ok: false, message: "Google not authenticated" };
+        }
+        try {
+            const folderId = await this.ensureFolder();
+            if (!folderId)
+                return { ok: false, message: "Backup folder not found" };
+            // Find files with matching backupId
+            const searchUrl = `${DRIVE_API}/files?q=${encodeURIComponent(`'${folderId}' in parents and appProperties has { key='backupId' and value='${backupId}' } and trashed=false`)}&fields=files(id,name)`;
+            const search = await driveRequest("GET", searchUrl);
+            if (!search.ok || !search.data?.files?.length) {
+                return { ok: false, message: `No backup found with id ${backupId}` };
+            }
+            let deleted = 0;
+            for (const file of search.data.files) {
+                const result = await driveRequest("DELETE", `${DRIVE_API}/files/${file.id}`);
+                if (result.ok)
+                    deleted++;
+            }
+            return { ok: true, message: `Deleted ${deleted} files for backup ${backupId}` };
+        }
+        catch (err) {
+            return { ok: false, message: `Delete failed: ${err.message}` };
+        }
+    }
+}
+//# sourceMappingURL=gdrive-backup.js.map

package/dist/adapters/storage/gdrive-backup.js.map

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

package/dist/adapters/storage/local.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Local filesystem storage adapter — stores backups in a configurable directory.
+ * Always available. Good for local redundancy or external-drive backups.
+ */
+import type { StorageAdapter, BackupManifest, BackupResult, RestoreResult } from "./types.js";
+export declare class LocalStorageAdapter implements StorageAdapter {
+    readonly name = "local";
+    private readonly backupDir;
+    constructor(backupDir: string);
+    isAvailable(): Promise<boolean>;
+    upload(archivePath: string, remoteName: string): Promise<BackupResult>;
+    download(remoteName: string, localPath: string): Promise<RestoreResult>;
+    listBackups(): Promise<BackupManifest[]>;
+    deleteBackup(backupId: string): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/adapters/storage/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI9F,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,EAAE,MAAM;IAIvB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBtE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAYvE,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAsBxC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAkBhF"}