@runcore-sh/runcore 0.3.1 → 0.4.0

package/dist/tier/types.js

@@ -17,8 +17,8 @@ export const TIER_CAPS = {
         brain: true,
         memory: true,
         ollama: true,
-        server: false,
-        ui: false,
+        server: true,
+        ui: true,
         mesh: false,
         alerting: false,
         spawning: false,
@@ -35,7 +35,7 @@ export const TIER_CAPS = {
         ui: true,
         mesh: true,
         alerting: true,
-        spawning: false,
+        spawning: true,
         governance: false,
         vault: true,
         voice: true,

package/dist/tier/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tier/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,UAAU,GAA6B;IAClD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAiBF,MAAM,CAAC,MAAM,SAAS,GAAuC;IAC3D,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,YAAY,EAAE,KAAK;KACpB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;KACnB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tier/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,UAAU,GAA6B;IAClD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAiBF,MAAM,CAAC,MAAM,SAAS,GAAuC;IAC3D,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,YAAY,EAAE,KAAK;KACpB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;KACnB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC"}

package/dist/ui-sync.d.ts

@@ -0,0 +1,34 @@
+/**
+ * UI sync — pulls the latest UI bundle from runcore.sh on first boot.
+ * npm package ships only the engine. UI arrives from the CDN, cached locally.
+ *
+ * Flow:
+ *   1. Check brain/.ui/revision.json — if present and fresh, skip
+ *   2. Fetch https://runcore.sh/ui/manifest.json — current revision + tarball URL
+ *   3. If revision matches cached, skip
+ *   4. Download + extract tarball to brain/.ui/public/
+ *   5. Stamp revision.json with revision, timestamp, npm version
+ *
+ * Falls back to bundled public/ (in npm package) if CDN unreachable.
+ */
+export interface UiRevision {
+    revision: string;
+    downloadedAt: string;
+    npmVersion?: string;
+    url?: string;
+}
+/**
+ * Returns the path to the UI public directory.
+ * Prefers the synced CDN version; falls back to bundled package version.
+ */
+export declare function getUiPublicDir(pkgRoot: string): string;
+/**
+ * Sync UI from runcore.sh. Non-blocking, non-fatal.
+ * Call at startup — if CDN is unreachable, falls back to bundled.
+ */
+export declare function syncUi(npmVersion?: string): Promise<{
+    synced: boolean;
+    revision?: string;
+    source: "cdn" | "cached" | "bundled";
+}>;
+//# sourceMappingURL=ui-sync.d.ts.map

package/dist/ui-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-sync.d.ts","sourceRoot":"","sources":["../src/ui-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtD;AAcD;;;GAGG;AACH,wBAAsB,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAA;CAAE,CAAC,CAkEvI"}

package/dist/ui-sync.js

@@ -0,0 +1,108 @@
+/**
+ * UI sync — pulls the latest UI bundle from runcore.sh on first boot.
+ * npm package ships only the engine. UI arrives from the CDN, cached locally.
+ *
+ * Flow:
+ *   1. Check brain/.ui/revision.json — if present and fresh, skip
+ *   2. Fetch https://runcore.sh/ui/manifest.json — current revision + tarball URL
+ *   3. If revision matches cached, skip
+ *   4. Download + extract tarball to brain/.ui/public/
+ *   5. Stamp revision.json with revision, timestamp, npm version
+ *
+ * Falls back to bundled public/ (in npm package) if CDN unreachable.
+ */
+import { mkdir, readFile, writeFile, rm } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { BRAIN_DIR } from "./lib/paths.js";
+import { createLogger } from "./utils/logger.js";
+const log = createLogger("ui-sync");
+const UI_BASE_URL = process.env.CORE_UI_URL ?? "https://runcore.sh/ui";
+const UI_CACHE_DIR = join(BRAIN_DIR, ".ui");
+const UI_PUBLIC_DIR = join(UI_CACHE_DIR, "public");
+const REVISION_PATH = join(UI_CACHE_DIR, "revision.json");
+/**
+ * Returns the path to the UI public directory.
+ * Prefers the synced CDN version; falls back to bundled package version.
+ */
+export function getUiPublicDir(pkgRoot) {
+    if (existsSync(join(UI_PUBLIC_DIR, "index.html"))) {
+        return UI_PUBLIC_DIR;
+    }
+    // Fallback: bundled in npm package
+    return join(pkgRoot, "public");
+}
+/**
+ * Read the current cached revision, or null if not synced yet.
+ */
+async function readRevision() {
+    try {
+        const raw = await readFile(REVISION_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Sync UI from runcore.sh. Non-blocking, non-fatal.
+ * Call at startup — if CDN is unreachable, falls back to bundled.
+ */
+export async function syncUi(npmVersion) {
+    try {
+        // Check manifest
+        const manifestRes = await fetch(`${UI_BASE_URL}/manifest.json`, {
+            signal: AbortSignal.timeout(5_000),
+        });
+        if (!manifestRes.ok) {
+            log.warn("UI manifest fetch failed", { status: manifestRes.status });
+            return { synced: false, source: existsSync(UI_PUBLIC_DIR) ? "cached" : "bundled" };
+        }
+        const manifest = await manifestRes.json();
+        // Check if already up to date
+        const cached = await readRevision();
+        if (cached?.revision === manifest.revision) {
+            log.info("UI up to date", { revision: manifest.revision });
+            return { synced: false, revision: manifest.revision, source: "cached" };
+        }
+        // Download tarball
+        log.info("Downloading UI update", { revision: manifest.revision });
+        const tarballUrl = manifest.tarball.startsWith("http") ? manifest.tarball : `${UI_BASE_URL}/${manifest.tarball}`;
+        const tarRes = await fetch(tarballUrl, { signal: AbortSignal.timeout(30_000) });
+        if (!tarRes.ok || !tarRes.body) {
+            log.warn("UI tarball download failed", { status: tarRes.status });
+            return { synced: false, source: existsSync(UI_PUBLIC_DIR) ? "cached" : "bundled" };
+        }
+        // Extract — use tar if available, otherwise simple approach
+        await mkdir(UI_PUBLIC_DIR, { recursive: true });
+        // Write tarball to temp file, then extract
+        const tarballPath = join(UI_CACHE_DIR, "ui.tar.gz");
+        const arrayBuf = await tarRes.arrayBuffer();
+        await writeFile(tarballPath, Buffer.from(arrayBuf));
+        // Extract using tar command (available on all platforms with Node)
+        const { exec } = await import("node:child_process");
+        const { promisify } = await import("node:util");
+        const execAsync = promisify(exec);
+        // Clean old UI files before extracting
+        await rm(UI_PUBLIC_DIR, { recursive: true, force: true });
+        await mkdir(UI_PUBLIC_DIR, { recursive: true });
+        await execAsync(`tar -xzf "${tarballPath}" -C "${UI_PUBLIC_DIR}"`, { timeout: 15_000 });
+        // Clean up tarball
+        await rm(tarballPath, { force: true });
+        // Stamp revision
+        const revision = {
+            revision: manifest.revision,
+            downloadedAt: new Date().toISOString(),
+            npmVersion,
+            url: tarballUrl,
+        };
+        await writeFile(REVISION_PATH, JSON.stringify(revision, null, 2), "utf-8");
+        log.info("UI synced", { revision: manifest.revision });
+        return { synced: true, revision: manifest.revision, source: "cdn" };
+    }
+    catch (err) {
+        log.warn("UI sync failed, using fallback", { error: err.message });
+        return { synced: false, source: existsSync(UI_PUBLIC_DIR) ? "cached" : "bundled" };
+    }
+}
+//# sourceMappingURL=ui-sync.js.map

package/dist/ui-sync.js.map

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

package/dist/utils/git.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Git signal source — optional tuning layer.
+ *
+ * Git is a signal source for development tuning and AI engine tuning.
+ * It is NOT a runtime dependency. Once an instance is deployed (umbilical
+ * detached), git may not exist. All call sites degrade gracefully.
+ */
+/** Check once whether git is on PATH and cwd is a repo. Cached after first call. */
+export declare function gitAvailable(): boolean;
+/** Run a git command, return stdout or null on failure. Returns null if git unavailable. */
+export declare function git(cmd: string, cwd?: string): string | null;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,oFAAoF;AACpF,wBAAgB,YAAY,IAAI,OAAO,CActC;AAED,4FAA4F;AAC5F,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW5D"}

package/dist/utils/git.js

@@ -0,0 +1,44 @@
+/**
+ * Git signal source — optional tuning layer.
+ *
+ * Git is a signal source for development tuning and AI engine tuning.
+ * It is NOT a runtime dependency. Once an instance is deployed (umbilical
+ * detached), git may not exist. All call sites degrade gracefully.
+ */
+import { execSync } from "node:child_process";
+let _gitChecked = false;
+let _gitAvailable = false;
+/** Check once whether git is on PATH and cwd is a repo. Cached after first call. */
+export function gitAvailable() {
+    if (_gitChecked)
+        return _gitAvailable;
+    _gitChecked = true;
+    try {
+        execSync("git rev-parse --is-inside-work-tree", {
+            encoding: "utf-8",
+            timeout: 3_000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        _gitAvailable = true;
+    }
+    catch {
+        _gitAvailable = false;
+    }
+    return _gitAvailable;
+}
+/** Run a git command, return stdout or null on failure. Returns null if git unavailable. */
+export function git(cmd, cwd) {
+    if (!gitAvailable())
+        return null;
+    try {
+        return execSync(`git ${cmd}`, {
+            cwd: cwd ?? process.cwd(),
+            encoding: "utf-8",
+            timeout: 15_000,
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,oFAAoF;AACpF,MAAM,UAAU,YAAY;IAC1B,IAAI,WAAW;QAAE,OAAO,aAAa,CAAC;IACtC,WAAW,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC;QACH,QAAQ,CAAC,qCAAqC,EAAE;YAC9C,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,GAAY;IAC3C,IAAI,CAAC,YAAY,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;YAC5B,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YACzB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/volumes/index.d.ts

@@ -0,0 +1,3 @@
+export { VolumeManager } from "./manager.js";
+export type { VolumeConfig, VolumeState, VolumeTier, VolumeEvent, ReplicationEntry, MigrationEntry, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/volumes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/volumes/index.js

@@ -0,0 +1,2 @@
+export { VolumeManager } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/volumes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/volumes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/volumes/manager.d.ts

@@ -0,0 +1,83 @@
+/**
+ * VolumeManager — event-driven multi-volume brain storage.
+ *
+ * No timers. No polling. Five triggers:
+ *   on-write    → queue replication to other volumes
+ *   on-connect  → drain pending replications
+ *   on-pressure → migrate cold files to lower tier
+ *   on-access   → promote file to sphere
+ *   on-disconnect → ensure sphere has essentials
+ *
+ * The append-only JSONL log is the replication queue.
+ * Any volume that's behind just reads the appends it missed.
+ */
+import type { VolumeConfig, VolumeState, VolumeTier, VolumeEvent } from "./types.js";
+export declare class VolumeManager {
+    private primaryBrainDir;
+    private volumes;
+    private states;
+    private replicationQueue;
+    private configPath;
+    private queuePath;
+    private draining;
+    constructor(primaryBrainDir: string);
+    init(): Promise<void>;
+    private loadConfig;
+    private parseVolumesYaml;
+    /** Check which volumes are online and get disk stats. */
+    probeAll(): Promise<VolumeState[]>;
+    private probeVolume;
+    /** Process a volume event. This is the only entry point for volume operations. */
+    handleEvent(event: VolumeEvent): Promise<void>;
+    /**
+     * ON WRITE — a file was stored on a volume. Queue replication to other volumes.
+     * Every append is a replication event.
+     */
+    private onWrite;
+    /**
+     * ON CONNECT — a volume came online. Drain pending replications to it.
+     * The road opened. Send what's waiting.
+     */
+    private onConnect;
+    /**
+     * ON DISCONNECT — volume going away. Ensure sphere has essentials.
+     * The goodbye is the checkpoint.
+     */
+    private onDisconnect;
+    /**
+     * ON PRESSURE — volume is getting full. Migrate cold files to lower tier.
+     * Storage pressure is the natural signal. Not a timer.
+     */
+    private onPressure;
+    /**
+     * ON ACCESS — file requested from a non-sphere volume. Promote to sphere.
+     * Accessing something makes it hot. The ask is the promotion.
+     */
+    private onAccess;
+    private loadQueue;
+    private persistQueue;
+    /** Drain pending replications, optionally filtered to a specific target. */
+    private drainQueue;
+    private replicateFile;
+    /** Copy the registry JSONL to another volume so it can self-recover. */
+    private replicateRegistry;
+    /** Get all volume states. */
+    getStates(): VolumeState[];
+    /** Get config for all volumes. */
+    getConfigs(): VolumeConfig[];
+    /** Get the sphere volume (primary hot storage). */
+    getSphere(): VolumeConfig | undefined;
+    /** Get online volumes of a specific tier. */
+    getOnlineByTier(tier: VolumeTier): VolumeConfig[];
+    /** Get volume by name. */
+    getVolume(name: string): VolumeConfig | undefined;
+    /** Check if a specific volume is under pressure. */
+    isUnderPressure(volumeName: string): boolean;
+    /** Get count of pending replications. */
+    getPendingCount(): number;
+    /** Resolve the physical path for a file on a given volume. */
+    resolveFilePath(volume: string, relativePath: string): string | null;
+    /** Find which online volume has a file (by checking existence). */
+    locateFile(relativePath: string): Promise<string | null>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/volumes/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/volumes/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EAGZ,MAAM,YAAY,CAAC;AAapB,qBAAa,aAAa;IAQZ,OAAO,CAAC,eAAe;IAPnC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEL,eAAe,EAAE,MAAM;IAOrC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAcb,UAAU;IAyBxB,OAAO,CAAC,gBAAgB;IAmCxB,yDAAyD;IACnD,QAAQ,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAgC1B,WAAW;IAiCzB,kFAAkF;IAC5E,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD;;;OAGG;YACW,OAAO;IA6BrB;;;OAGG;YACW,SAAS;IA4BvB;;;OAGG;YACW,YAAY;IAe1B;;;OAGG;YACW,UAAU;IAoCxB;;;OAGG;YACW,QAAQ;YAyBR,SAAS;YAkBT,YAAY;IAS1B,4EAA4E;YAC9D,UAAU;YAyBV,aAAa;IA6B3B,wEAAwE;YAC1D,iBAAiB;IAc/B,6BAA6B;IAC7B,SAAS,IAAI,WAAW,EAAE;IAI1B,kCAAkC;IAClC,UAAU,IAAI,YAAY,EAAE;IAI5B,mDAAmD;IACnD,SAAS,IAAI,YAAY,GAAG,SAAS;IAIrC,6CAA6C;IAC7C,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE;IAMjD,0BAA0B;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD,oDAAoD;IACpD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI5C,yCAAyC;IACzC,eAAe,IAAI,MAAM;IAIzB,8DAA8D;IAC9D,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMpE,mEAAmE;IAC7D,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAiB/D"}