@farazirfan/costar-server-executor 1.0.0

package/dist/browser/chrome.js

@@ -0,0 +1,254 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import WebSocket from "ws";
+import { ensurePortAvailable } from "../infra/ports.js";
+import { createSubsystemLogger } from "../logging/subsystem.js";
+import { CONFIG_DIR } from "../utils.js";
+import { getHeadersWithAuth, normalizeCdpWsUrl } from "./cdp.js";
+import { appendCdpPath } from "./cdp.helpers.js";
+import { resolveBrowserExecutableForPlatform, } from "./chrome.executables.js";
+import { decorateOpenClawProfile, ensureProfileCleanExit, isProfileDecorated, } from "./chrome.profile-decoration.js";
+import { DEFAULT_OPENCLAW_BROWSER_COLOR, DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME, } from "./constants.js";
+const log = createSubsystemLogger("browser").child("chrome");
+export { findChromeExecutableLinux, findChromeExecutableMac, findChromeExecutableWindows, resolveBrowserExecutableForPlatform, } from "./chrome.executables.js";
+export { decorateOpenClawProfile, ensureProfileCleanExit, isProfileDecorated, } from "./chrome.profile-decoration.js";
+function exists(filePath) {
+    try {
+        return fs.existsSync(filePath);
+    }
+    catch {
+        return false;
+    }
+}
+function resolveBrowserExecutable(resolved) {
+    return resolveBrowserExecutableForPlatform(resolved, process.platform);
+}
+export function resolveOpenClawUserDataDir(profileName = DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME) {
+    return path.join(CONFIG_DIR, "browser", profileName, "user-data");
+}
+function cdpUrlForPort(cdpPort) {
+    return `http://127.0.0.1:${cdpPort}`;
+}
+export async function isChromeReachable(cdpUrl, timeoutMs = 500) {
+    const version = await fetchChromeVersion(cdpUrl, timeoutMs);
+    return Boolean(version);
+}
+async function fetchChromeVersion(cdpUrl, timeoutMs = 500) {
+    const ctrl = new AbortController();
+    const t = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const versionUrl = appendCdpPath(cdpUrl, "/json/version");
+        const res = await fetch(versionUrl, {
+            signal: ctrl.signal,
+            headers: getHeadersWithAuth(versionUrl),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        if (!data || typeof data !== "object")
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+export async function getChromeWebSocketUrl(cdpUrl, timeoutMs = 500) {
+    const version = await fetchChromeVersion(cdpUrl, timeoutMs);
+    const wsUrl = String(version?.webSocketDebuggerUrl ?? "").trim();
+    if (!wsUrl)
+        return null;
+    return normalizeCdpWsUrl(wsUrl, cdpUrl);
+}
+async function canOpenWebSocket(wsUrl, timeoutMs = 800) {
+    return await new Promise((resolve) => {
+        const headers = getHeadersWithAuth(wsUrl);
+        const ws = new WebSocket(wsUrl, {
+            handshakeTimeout: timeoutMs,
+            ...(Object.keys(headers).length ? { headers } : {}),
+        });
+        const timer = setTimeout(() => {
+            try {
+                ws.terminate();
+            }
+            catch {
+                // ignore
+            }
+            resolve(false);
+        }, Math.max(50, timeoutMs + 25));
+        ws.once("open", () => {
+            clearTimeout(timer);
+            try {
+                ws.close();
+            }
+            catch {
+                // ignore
+            }
+            resolve(true);
+        });
+        ws.once("error", () => {
+            clearTimeout(timer);
+            resolve(false);
+        });
+    });
+}
+export async function isChromeCdpReady(cdpUrl, timeoutMs = 500, handshakeTimeoutMs = 800) {
+    const wsUrl = await getChromeWebSocketUrl(cdpUrl, timeoutMs);
+    if (!wsUrl)
+        return false;
+    return await canOpenWebSocket(wsUrl, handshakeTimeoutMs);
+}
+export async function launchOpenClawChrome(resolved, profile) {
+    if (!profile.cdpIsLoopback) {
+        throw new Error(`Profile "${profile.name}" is remote; cannot launch local Chrome.`);
+    }
+    await ensurePortAvailable(profile.cdpPort);
+    const exe = resolveBrowserExecutable(resolved);
+    if (!exe) {
+        throw new Error("No supported browser found (Chrome/Brave/Edge/Chromium on macOS, Linux, or Windows).");
+    }
+    const userDataDir = resolveOpenClawUserDataDir(profile.name);
+    fs.mkdirSync(userDataDir, { recursive: true });
+    const needsDecorate = !isProfileDecorated(userDataDir, profile.name, (profile.color ?? DEFAULT_OPENCLAW_BROWSER_COLOR).toUpperCase());
+    // First launch to create preference files if missing, then decorate and relaunch.
+    const spawnOnce = () => {
+        const args = [
+            `--remote-debugging-port=${profile.cdpPort}`,
+            `--user-data-dir=${userDataDir}`,
+            "--no-first-run",
+            "--no-default-browser-check",
+            "--disable-sync",
+            "--disable-background-networking",
+            "--disable-component-update",
+            "--disable-features=Translate,MediaRouter",
+            "--disable-session-crashed-bubble",
+            "--hide-crash-restore-bubble",
+            "--password-store=basic",
+        ];
+        if (resolved.headless) {
+            // Best-effort; older Chromes may ignore.
+            args.push("--headless=new");
+            args.push("--disable-gpu");
+        }
+        if (resolved.noSandbox) {
+            args.push("--no-sandbox");
+            args.push("--disable-setuid-sandbox");
+        }
+        if (process.platform === "linux") {
+            args.push("--disable-dev-shm-usage");
+        }
+        // Always open a blank tab to ensure a target exists.
+        args.push("about:blank");
+        return spawn(exe.path, args, {
+            stdio: "pipe",
+            env: {
+                ...process.env,
+                // Reduce accidental sharing with the user's env.
+                HOME: os.homedir(),
+            },
+        });
+    };
+    const startedAt = Date.now();
+    const localStatePath = path.join(userDataDir, "Local State");
+    const preferencesPath = path.join(userDataDir, "Default", "Preferences");
+    const needsBootstrap = !exists(localStatePath) || !exists(preferencesPath);
+    // If the profile doesn't exist yet, bootstrap it once so Chrome creates defaults.
+    // Then decorate (if needed) before the "real" run.
+    if (needsBootstrap) {
+        const bootstrap = spawnOnce();
+        const deadline = Date.now() + 10_000;
+        while (Date.now() < deadline) {
+            if (exists(localStatePath) && exists(preferencesPath))
+                break;
+            await new Promise((r) => setTimeout(r, 100));
+        }
+        try {
+            bootstrap.kill("SIGTERM");
+        }
+        catch {
+            // ignore
+        }
+        const exitDeadline = Date.now() + 5000;
+        while (Date.now() < exitDeadline) {
+            if (bootstrap.exitCode != null)
+                break;
+            await new Promise((r) => setTimeout(r, 50));
+        }
+    }
+    if (needsDecorate) {
+        try {
+            decorateOpenClawProfile(userDataDir, {
+                name: profile.name,
+                color: profile.color,
+            });
+            log.info(`🦞 openclaw browser profile decorated (${profile.color})`);
+        }
+        catch (err) {
+            log.warn(`openclaw browser profile decoration failed: ${String(err)}`);
+        }
+    }
+    try {
+        ensureProfileCleanExit(userDataDir);
+    }
+    catch (err) {
+        log.warn(`openclaw browser clean-exit prefs failed: ${String(err)}`);
+    }
+    const proc = spawnOnce();
+    // Wait for CDP to come up.
+    const readyDeadline = Date.now() + 15_000;
+    while (Date.now() < readyDeadline) {
+        if (await isChromeReachable(profile.cdpUrl, 500))
+            break;
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    if (!(await isChromeReachable(profile.cdpUrl, 500))) {
+        try {
+            proc.kill("SIGKILL");
+        }
+        catch {
+            // ignore
+        }
+        throw new Error(`Failed to start Chrome CDP on port ${profile.cdpPort} for profile "${profile.name}".`);
+    }
+    const pid = proc.pid ?? -1;
+    log.info(`🦞 openclaw browser started (${exe.kind}) profile "${profile.name}" on 127.0.0.1:${profile.cdpPort} (pid ${pid})`);
+    return {
+        pid,
+        exe,
+        userDataDir,
+        cdpPort: profile.cdpPort,
+        startedAt,
+        proc,
+    };
+}
+export async function stopOpenClawChrome(running, timeoutMs = 2500) {
+    const proc = running.proc;
+    if (proc.killed)
+        return;
+    try {
+        proc.kill("SIGTERM");
+    }
+    catch {
+        // ignore
+    }
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        if (!proc.exitCode && proc.killed)
+            break;
+        if (!(await isChromeReachable(cdpUrlForPort(running.cdpPort), 200)))
+            return;
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    try {
+        proc.kill("SIGKILL");
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=chrome.js.map

package/dist/browser/chrome.js.map

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

package/dist/browser/chrome.profile-decoration.d.ts

@@ -0,0 +1,11 @@
+export declare function isProfileDecorated(userDataDir: string, desiredName: string, desiredColorHex: string): boolean;
+/**
+ * Best-effort profile decoration (name + lobster-orange). Chrome preference keys
+ * vary by version; we keep this conservative and idempotent.
+ */
+export declare function decorateOpenClawProfile(userDataDir: string, opts?: {
+    name?: string;
+    color?: string;
+}): void;
+export declare function ensureProfileCleanExit(userDataDir: string): void;
+//# sourceMappingURL=chrome.profile-decoration.d.ts.map

package/dist/browser/chrome.profile-decoration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.profile-decoration.d.ts","sourceRoot":"","sources":["../../src/browser/chrome.profile-decoration.ts"],"names":[],"mappings":"AAkDA,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CA+DT;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,QA2DzC;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,QAMzD"}

package/dist/browser/chrome.profile-decoration.js

@@ -0,0 +1,145 @@
+import fs from "node:fs";
+import path from "node:path";
+import { DEFAULT_OPENCLAW_BROWSER_COLOR, DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME, } from "./constants.js";
+function decoratedMarkerPath(userDataDir) {
+    return path.join(userDataDir, ".openclaw-profile-decorated");
+}
+function safeReadJson(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function safeWriteJson(filePath, data) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}
+function setDeep(obj, keys, value) {
+    let node = obj;
+    for (const key of keys.slice(0, -1)) {
+        const next = node[key];
+        if (typeof next !== "object" || next === null || Array.isArray(next)) {
+            node[key] = {};
+        }
+        node = node[key];
+    }
+    node[keys[keys.length - 1] ?? ""] = value;
+}
+function parseHexRgbToSignedArgbInt(hex) {
+    const cleaned = hex.trim().replace(/^#/, "");
+    if (!/^[0-9a-fA-F]{6}$/.test(cleaned))
+        return null;
+    const rgb = Number.parseInt(cleaned, 16);
+    const argbUnsigned = (0xff << 24) | rgb;
+    // Chrome stores colors as signed 32-bit ints (SkColor).
+    return argbUnsigned > 0x7fffffff ? argbUnsigned - 0x1_0000_0000 : argbUnsigned;
+}
+export function isProfileDecorated(userDataDir, desiredName, desiredColorHex) {
+    const desiredColorInt = parseHexRgbToSignedArgbInt(desiredColorHex);
+    const localStatePath = path.join(userDataDir, "Local State");
+    const preferencesPath = path.join(userDataDir, "Default", "Preferences");
+    const localState = safeReadJson(localStatePath);
+    const profile = localState?.profile;
+    const infoCache = typeof profile === "object" && profile !== null && !Array.isArray(profile)
+        ? profile.info_cache
+        : null;
+    const info = typeof infoCache === "object" &&
+        infoCache !== null &&
+        !Array.isArray(infoCache) &&
+        typeof infoCache.Default === "object" &&
+        infoCache.Default !== null &&
+        !Array.isArray(infoCache.Default)
+        ? infoCache.Default
+        : null;
+    const prefs = safeReadJson(preferencesPath);
+    const browserTheme = (() => {
+        const browser = prefs?.browser;
+        const theme = typeof browser === "object" && browser !== null && !Array.isArray(browser)
+            ? browser.theme
+            : null;
+        return typeof theme === "object" && theme !== null && !Array.isArray(theme)
+            ? theme
+            : null;
+    })();
+    const autogeneratedTheme = (() => {
+        const autogenerated = prefs?.autogenerated;
+        const theme = typeof autogenerated === "object" && autogenerated !== null && !Array.isArray(autogenerated)
+            ? autogenerated.theme
+            : null;
+        return typeof theme === "object" && theme !== null && !Array.isArray(theme)
+            ? theme
+            : null;
+    })();
+    const nameOk = typeof info?.name === "string" ? info.name === desiredName : true;
+    if (desiredColorInt == null) {
+        // If the user provided a non-#RRGGBB value, we can only do best-effort.
+        return nameOk;
+    }
+    const localSeedOk = typeof info?.profile_color_seed === "number"
+        ? info.profile_color_seed === desiredColorInt
+        : false;
+    const prefOk = (typeof browserTheme?.user_color2 === "number" &&
+        browserTheme.user_color2 === desiredColorInt) ||
+        (typeof autogeneratedTheme?.color === "number" && autogeneratedTheme.color === desiredColorInt);
+    return nameOk && localSeedOk && prefOk;
+}
+/**
+ * Best-effort profile decoration (name + lobster-orange). Chrome preference keys
+ * vary by version; we keep this conservative and idempotent.
+ */
+export function decorateOpenClawProfile(userDataDir, opts) {
+    const desiredName = opts?.name ?? DEFAULT_OPENCLAW_BROWSER_PROFILE_NAME;
+    const desiredColor = (opts?.color ?? DEFAULT_OPENCLAW_BROWSER_COLOR).toUpperCase();
+    const desiredColorInt = parseHexRgbToSignedArgbInt(desiredColor);
+    const localStatePath = path.join(userDataDir, "Local State");
+    const preferencesPath = path.join(userDataDir, "Default", "Preferences");
+    const localState = safeReadJson(localStatePath) ?? {};
+    // Common-ish shape: profile.info_cache.Default
+    setDeep(localState, ["profile", "info_cache", "Default", "name"], desiredName);
+    setDeep(localState, ["profile", "info_cache", "Default", "shortcut_name"], desiredName);
+    setDeep(localState, ["profile", "info_cache", "Default", "user_name"], desiredName);
+    // Color keys are best-effort (Chrome changes these frequently).
+    setDeep(localState, ["profile", "info_cache", "Default", "profile_color"], desiredColor);
+    setDeep(localState, ["profile", "info_cache", "Default", "user_color"], desiredColor);
+    if (desiredColorInt != null) {
+        // These are the fields Chrome actually uses for profile/avatar tinting.
+        setDeep(localState, ["profile", "info_cache", "Default", "profile_color_seed"], desiredColorInt);
+        setDeep(localState, ["profile", "info_cache", "Default", "profile_highlight_color"], desiredColorInt);
+        setDeep(localState, ["profile", "info_cache", "Default", "default_avatar_fill_color"], desiredColorInt);
+        setDeep(localState, ["profile", "info_cache", "Default", "default_avatar_stroke_color"], desiredColorInt);
+    }
+    safeWriteJson(localStatePath, localState);
+    const prefs = safeReadJson(preferencesPath) ?? {};
+    setDeep(prefs, ["profile", "name"], desiredName);
+    setDeep(prefs, ["profile", "profile_color"], desiredColor);
+    setDeep(prefs, ["profile", "user_color"], desiredColor);
+    if (desiredColorInt != null) {
+        // Chrome refresh stores the autogenerated theme in these prefs (SkColor ints).
+        setDeep(prefs, ["autogenerated", "theme", "color"], desiredColorInt);
+        // User-selected browser theme color (pref name: browser.theme.user_color2).
+        setDeep(prefs, ["browser", "theme", "user_color2"], desiredColorInt);
+    }
+    safeWriteJson(preferencesPath, prefs);
+    try {
+        fs.writeFileSync(decoratedMarkerPath(userDataDir), `${Date.now()}\n`, "utf-8");
+    }
+    catch {
+        // ignore
+    }
+}
+export function ensureProfileCleanExit(userDataDir) {
+    const preferencesPath = path.join(userDataDir, "Default", "Preferences");
+    const prefs = safeReadJson(preferencesPath) ?? {};
+    setDeep(prefs, ["exit_type"], "Normal");
+    setDeep(prefs, ["exited_cleanly"], true);
+    safeWriteJson(preferencesPath, prefs);
+}
+//# sourceMappingURL=chrome.profile-decoration.js.map

package/dist/browser/chrome.profile-decoration.js.map

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

package/dist/browser/client-actions-core.d.ts

@@ -0,0 +1,144 @@
+import type { BrowserActionOk, BrowserActionPathResult, BrowserActionTabResult } from "./client-actions-types.js";
+export type BrowserFormField = {
+    ref: string;
+    type: string;
+    value?: string | number | boolean;
+};
+export type BrowserActRequest = {
+    kind: "click";
+    ref: string;
+    targetId?: string;
+    doubleClick?: boolean;
+    button?: string;
+    modifiers?: string[];
+    timeoutMs?: number;
+} | {
+    kind: "type";
+    ref: string;
+    text: string;
+    targetId?: string;
+    submit?: boolean;
+    slowly?: boolean;
+    timeoutMs?: number;
+} | {
+    kind: "press";
+    key: string;
+    targetId?: string;
+    delayMs?: number;
+} | {
+    kind: "hover";
+    ref: string;
+    targetId?: string;
+    timeoutMs?: number;
+} | {
+    kind: "scrollIntoView";
+    ref: string;
+    targetId?: string;
+    timeoutMs?: number;
+} | {
+    kind: "drag";
+    startRef: string;
+    endRef: string;
+    targetId?: string;
+    timeoutMs?: number;
+} | {
+    kind: "select";
+    ref: string;
+    values: string[];
+    targetId?: string;
+    timeoutMs?: number;
+} | {
+    kind: "fill";
+    fields: BrowserFormField[];
+    targetId?: string;
+    timeoutMs?: number;
+} | {
+    kind: "resize";
+    width: number;
+    height: number;
+    targetId?: string;
+} | {
+    kind: "wait";
+    timeMs?: number;
+    text?: string;
+    textGone?: string;
+    selector?: string;
+    url?: string;
+    loadState?: "load" | "domcontentloaded" | "networkidle";
+    fn?: string;
+    targetId?: string;
+    timeoutMs?: number;
+} | {
+    kind: "evaluate";
+    fn: string;
+    ref?: string;
+    targetId?: string;
+} | {
+    kind: "close";
+    targetId?: string;
+};
+export type BrowserActResponse = {
+    ok: true;
+    targetId: string;
+    url?: string;
+    result?: unknown;
+};
+export type BrowserDownloadPayload = {
+    url: string;
+    suggestedFilename: string;
+    path: string;
+};
+export declare function browserNavigate(baseUrl: string | undefined, opts: {
+    url: string;
+    targetId?: string;
+    profile?: string;
+}): Promise<BrowserActionTabResult>;
+export declare function browserArmDialog(baseUrl: string | undefined, opts: {
+    accept: boolean;
+    promptText?: string;
+    targetId?: string;
+    timeoutMs?: number;
+    profile?: string;
+}): Promise<BrowserActionOk>;
+export declare function browserArmFileChooser(baseUrl: string | undefined, opts: {
+    paths: string[];
+    ref?: string;
+    inputRef?: string;
+    element?: string;
+    targetId?: string;
+    timeoutMs?: number;
+    profile?: string;
+}): Promise<BrowserActionOk>;
+export declare function browserWaitForDownload(baseUrl: string | undefined, opts: {
+    path?: string;
+    targetId?: string;
+    timeoutMs?: number;
+    profile?: string;
+}): Promise<{
+    ok: true;
+    targetId: string;
+    download: BrowserDownloadPayload;
+}>;
+export declare function browserDownload(baseUrl: string | undefined, opts: {
+    ref: string;
+    path: string;
+    targetId?: string;
+    timeoutMs?: number;
+    profile?: string;
+}): Promise<{
+    ok: true;
+    targetId: string;
+    download: BrowserDownloadPayload;
+}>;
+export declare function browserAct(baseUrl: string | undefined, req: BrowserActRequest, opts?: {
+    profile?: string;
+}): Promise<BrowserActResponse>;
+export declare function browserScreenshotAction(baseUrl: string | undefined, opts: {
+    targetId?: string;
+    fullPage?: boolean;
+    ref?: string;
+    element?: string;
+    type?: "png" | "jpeg";
+    profile?: string;
+}): Promise<BrowserActionPathResult>;
+//# sourceMappingURL=client-actions-core.d.ts.map

package/dist/browser/client-actions-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-actions-core.d.ts","sourceRoot":"","sources":["../../src/browser/client-actions-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAanC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,sBAAsB,CAAC,CAQjC;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IACJ,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,eAAe,CAAC,CAe1B;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAA;CAAE,CAAC,CAgB3E;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAA;CAAE,CAAC,CAiB3E;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,GAAG,EAAE,iBAAiB,EACtB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAQ7B;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,uBAAuB,CAAC,CAclC"}