@polderlabs/bizar-omp 0.7.9 → 0.7.10

package/dist/cli/omb-commands.js.map

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

package/dist/cli/omb-mobile.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `omb mobile` — the command surface for the in-repo mobile host.
+ *
+ * The design rule from docs/07-bizarharness-integration.md is that this command
+ * must not grow a second tunnel, pairing or session engine. BizarHarness owns
+ * the terminal runtime; the mobile host owns the phone transport. This file
+ * exists so every operator-facing mobile action belongs to `omb mobile`.
+ * OMB's dispatch for this command is internal, and the host CLI is not a
+ * separately installed command.
+ *
+ * Registering `mobile` here also fixes a real footgun: unmatched tokens fall
+ * through to OMP, so before this command existed `omb mobile` silently started
+ * an OMP session with the literal argument `mobile`.
+ */
+export declare const PAIR_USAGE = "omb pair\n\n  Pair the Android app with this OMB host. The OMB daemon keeps the gateway\n  and tunnel running after the QR is printed, so this terminal can be closed.\n";
+export declare function runPairCommand(args: string[], env: NodeJS.ProcessEnv): Promise<number>;
+export declare const MOBILE_USAGE = "omb mobile <command> [options]\n\n  Runs the BizarOMP Mobile host on this machine, which lets the Android app\n  control native OMP sessions started here.\n\n  Host operations run through this command family. Mobile ownership controls\n  are handled by OMB under \"omb mobile sessions\".\n\n  OMP remains the runtime. omb mobile supervises the omp you already have\n  installed; it does not run a second one.\n\n  Source checkout commands:\n    omb mobile workspace install|check\n    omb mobile build\n    omb mobile app start|android|android:release\n";
+/** Map source-workspace tasks to their implementation without exposing another CLI. */
+export declare function mobileDevelopmentInvocation(args: readonly string[]): {
+    command: string;
+    args: string[];
+} | undefined;
+/** The host contract Bizar negotiates against. */
+export interface MobileHostCapabilities {
+    readonly schemaVersion: number;
+    readonly hostVersion: string;
+    readonly protocol: number;
+    readonly commands: readonly string[];
+    readonly capabilities: readonly string[];
+}
+/**
+ * Reads the in-repo host capability contract.
+ *
+ * Returns undefined for a host too old to answer. That is a supported state, not
+ * an error: the host is executable and may work perfectly well, so presence is
+ * not evidence of a contract and the caller decides what to do about it.
+ */
+export declare function readHostCapabilities(binary: string, env?: NodeJS.ProcessEnv): MobileHostCapabilities | undefined;
+/**
+ * Help that only claims what the integrated host can do.
+ *
+ * Keep this capability-aware so a mismatched local build never advertises
+ * commands its internal host cannot serve.
+ */
+export declare function renderUsage(capabilities: MobileHostCapabilities | undefined): string;
+export declare function runMobileCommand(args: string[], env: NodeJS.ProcessEnv): Promise<number>;
+//# sourceMappingURL=omb-mobile.d.ts.map

package/dist/cli/omb-mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omb-mobile.d.ts","sourceRoot":"","sources":["../../src/cli/omb-mobile.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,UAAU,6KAItB,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5F;AAED,eAAO,MAAM,YAAY,8iBAexB,CAAC;AAKF,uFAAuF;AACvF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAepH;AAqCD,kDAAkD;AAClD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAcD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,GAAG,SAAS,CAmBpC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAyBpF;AAoBD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA8E9F"}

package/dist/cli/omb-mobile.js

@@ -0,0 +1,307 @@
+import { execFileSync, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { readDaemonStatus, startDaemon } from "../omp/daemon.js";
+import { MOBILE_SESSIONS_USAGE, runMobileSessionsCommand } from "./omb-sessions.js";
+/**
+ * `omb mobile` — the command surface for the in-repo mobile host.
+ *
+ * The design rule from docs/07-bizarharness-integration.md is that this command
+ * must not grow a second tunnel, pairing or session engine. BizarHarness owns
+ * the terminal runtime; the mobile host owns the phone transport. This file
+ * exists so every operator-facing mobile action belongs to `omb mobile`.
+ * OMB's dispatch for this command is internal, and the host CLI is not a
+ * separately installed command.
+ *
+ * Registering `mobile` here also fixes a real footgun: unmatched tokens fall
+ * through to OMP, so before this command existed `omb mobile` silently started
+ * an OMP session with the literal argument `mobile`.
+ */
+export const PAIR_USAGE = `omb pair
+
+  Pair the Android app with this OMB host. The OMB daemon keeps the gateway
+  and tunnel running after the QR is printed, so this terminal can be closed.
+`;
+export async function runPairCommand(args, env) {
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(`${PAIR_USAGE}\n`);
+        return 0;
+    }
+    if (args.length > 0) {
+        process.stderr.write(`omb pair: unexpected argument "${args[0]}"\n\n${PAIR_USAGE}\n`);
+        return 2;
+    }
+    return await runMobileCommand(["pair"], env);
+}
+export const MOBILE_USAGE = `omb mobile <command> [options]
+
+  Runs the BizarOMP Mobile host on this machine, which lets the Android app
+  control native OMP sessions started here.
+
+  Host operations run through this command family. Mobile ownership controls
+  are handled by OMB under "omb mobile sessions".
+
+  OMP remains the runtime. omb mobile supervises the omp you already have
+  installed; it does not run a second one.
+
+  Source checkout commands:
+    omb mobile workspace install|check
+    omb mobile build
+    omb mobile app start|android|android:release
+`;
+const HOST_ENTRY = fileURLToPath(new URL("../../mobile/packages/host/dist/cli/main.js", import.meta.url));
+const MOBILE_WORKSPACE = fileURLToPath(new URL("../../mobile/", import.meta.url));
+/** Map source-workspace tasks to their implementation without exposing another CLI. */
+export function mobileDevelopmentInvocation(args) {
+    const [group, action, ...extra] = args;
+    if (group === "workspace" && action === "install") {
+        return { command: "pnpm", args: ["install", "--frozen-lockfile", ...extra] };
+    }
+    if (group === "workspace" && action === "check") {
+        return { command: "pnpm", args: ["check", ...extra] };
+    }
+    if (group === "build" && action === undefined) {
+        return { command: "pnpm", args: ["--filter", "@polderlabs/bizaromp-mobile-host...", "build", ...extra] };
+    }
+    if (group === "app" && action !== undefined && ["start", "android", "android:release"].includes(action)) {
+        return { command: "pnpm", args: ["--filter", "@polderlabs/bizaromp-mobile", action, ...extra] };
+    }
+    return undefined;
+}
+async function runMobileDevelopmentCommand(args, env) {
+    const invocation = mobileDevelopmentInvocation(args);
+    if (invocation === undefined)
+        return undefined;
+    if (!existsSync(MOBILE_WORKSPACE)) {
+        process.stderr.write("omb mobile: source workspace is unavailable in this installation; run this command from a BizarOMP checkout.\n");
+        return 2;
+    }
+    return await new Promise((resolve) => {
+        const child = spawn(invocation.command, invocation.args, { cwd: MOBILE_WORKSPACE, env, stdio: "inherit" });
+        child.once("error", (error) => {
+            process.stderr.write(`omb mobile: could not start ${invocation.command}: ${error.message}\n`);
+            resolve(127);
+        });
+        child.once("close", (code) => resolve(code ?? 1));
+    });
+}
+/** How a missing host is reported, kept identical in shape across the CLI. */
+function hostMissing() {
+    process.stderr.write("omb mobile: the in-repo mobile host has not been built.\n" +
+        "  From the BizarOMP checkout, run `omb mobile build`, then retry.\n");
+    process.exit(127);
+}
+/**
+ * Locate the in-repo host entrypoint.
+ */
+function resolveHost(env) {
+    const entry = env.BIZAROMP_MOBILE_ENTRY || HOST_ENTRY;
+    if (!existsSync(entry))
+        hostMissing();
+    return entry;
+}
+/**
+ * The highest host contract schema this build understands.
+ *
+ * A newer host may add commands; it must not change the shape of this one
+ * without a new schema, because Bizar would then be reading fields it does not
+ * understand and could conclude the wrong thing.
+ */
+const MAX_HOST_SCHEMA_VERSION = 1;
+/** Subcommands this front end advertises and forwards. */
+const ADVERTISED_COMMANDS = ["setup", "pair", "start", "status", "stop", "doctor", "devices", "sessions", "tunnel"];
+/**
+ * Reads the in-repo host capability contract.
+ *
+ * Returns undefined for a host too old to answer. That is a supported state, not
+ * an error: the host is executable and may work perfectly well, so presence is
+ * not evidence of a contract and the caller decides what to do about it.
+ */
+export function readHostCapabilities(binary, env = process.env) {
+    try {
+        const stdout = execFileSync(process.execPath, [binary, "capabilities", "--json"], { encoding: "utf8", env, timeout: 20_000, stdio: ["ignore", "pipe", "pipe"] });
+        const parsed = JSON.parse(stdout);
+        if (typeof parsed !== "object" || parsed === null)
+            return undefined;
+        const record = parsed;
+        if (typeof record.schemaVersion !== "number" || record.schemaVersion > MAX_HOST_SCHEMA_VERSION)
+            return undefined;
+        if (typeof record.hostVersion !== "string" || typeof record.protocol !== "number")
+            return undefined;
+        if (!Array.isArray(record.commands) || !record.commands.every((entry) => typeof entry === "string"))
+            return undefined;
+        return {
+            schemaVersion: record.schemaVersion,
+            hostVersion: record.hostVersion,
+            protocol: record.protocol,
+            commands: record.commands,
+            capabilities: Array.isArray(record.capabilities) ? record.capabilities.filter((entry) => typeof entry === "string") : [],
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Help that only claims what the integrated host can do.
+ *
+ * Keep this capability-aware so a mismatched local build never advertises
+ * commands its internal host cannot serve.
+ */
+export function renderUsage(capabilities) {
+    const supported = capabilities === undefined ? undefined : new Set(capabilities.commands);
+    const line = (command, description) => supported === undefined || supported.has(command) ? `  ${command.padEnd(10)}${description}\n` : "";
+    return [
+        MOBILE_USAGE.split("Any argument not listed")[0] ?? MOBILE_USAGE,
+        "\n",
+        line("setup", "Install or repair the host's verified cloudflared binary."),
+        "  pair      Print a one-time QR; the OMB daemon keeps the host running.\n",
+        line("start", "Start the mobile host in this terminal."),
+        line("status", "Report host identity, paired devices and tunnel state."),
+        line("stop", "Stop the gateway and any tunnel it owns."),
+        line("doctor", "Report versions, permissions and RPC probe results as JSON."),
+        line("devices", "List, rename or revoke paired devices."),
+        line("sessions", "List sessions and manage mobile ownership claims."),
+        line("tunnel", "Configure or inspect the Cloudflare tunnel."),
+        "  workspace Manage mobile workspace dependencies and checks (source checkout).\n",
+        "  build     Build the integrated mobile host (source checkout).\n",
+        "  app       Start Expo or build/install the Android app (source checkout).\n",
+        `\n${MOBILE_SESSIONS_USAGE}\n`,
+        "",
+        capabilities === undefined
+            ? "  The integrated host did not report a capability contract.\n"
+            : `  Mobile host ${capabilities.hostVersion}, protocol ${capabilities.protocol}.\n`,
+    ].join("");
+}
+/**
+ * Probes a host without failing when there is none.
+ *
+ * `resolveHost` exits 127, which is right for running a subcommand and wrong
+ * for rendering help: `omb mobile --help` has to work on a machine where the
+ * host is not installed, because that is exactly when a user is reading it.
+ */
+function probeHost(env) {
+    try {
+        const binary = env.BIZAROMP_MOBILE_ENTRY || HOST_ENTRY;
+        if (!existsSync(binary))
+            return undefined;
+        execFileSync(process.execPath, [binary, "--help"], { stdio: "ignore", timeout: 10_000, env });
+        return binary;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function runMobileCommand(args, env) {
+    if (args.includes("--help") || args.includes("-h")) {
+        // Probe without failing: help that overstates the installed host's abilities
+        // is the problem this command exists to avoid, and help that cannot be read
+        // at all is the one way to guarantee someone relies on the overstated form.
+        const probe = probeHost(env);
+        process.stdout.write(`${renderUsage(probe === undefined ? undefined : readHostCapabilities(probe, env))}\n`);
+        return 0;
+    }
+    const developmentResult = await runMobileDevelopmentCommand(args, env);
+    if (developmentResult !== undefined)
+        return developmentResult;
+    const requested = args[0];
+    if (requested === "sessions" && args[1] !== undefined && args[1] !== "list" && !args.includes("--help") && !args.includes("-h")) {
+        return await runMobileSessionsCommand(process.cwd(), args.slice(1), env);
+    }
+    if (requested?.startsWith("--internal-") === true) {
+        process.stderr.write("omb mobile: internal host modes cannot be invoked as operator commands.\n");
+        return 2;
+    }
+    const host = resolveHost(env);
+    const capabilities = readHostCapabilities(host, env);
+    if (requested !== undefined && ADVERTISED_COMMANDS.includes(requested)) {
+        if (capabilities !== undefined && !capabilities.commands.includes(requested)) {
+            process.stderr.write(`omb mobile: this build's mobile host ${capabilities.hostVersion} does not support "${requested}".\n` +
+                "  Run `omb mobile --help` to see what this host actually provides.\n");
+            return 1;
+        }
+    }
+    if (requested === "pair") {
+        let daemon = readDaemonStatus(env).daemon;
+        if (!daemon) {
+            try {
+                daemon = await startDaemon(env);
+            }
+            catch (error) {
+                daemon = readDaemonStatus(env).daemon;
+                if (!daemon)
+                    throw error;
+            }
+        }
+        const response = await fetch(`http://127.0.0.1:${daemon.port}/mobile/pair`, {
+            method: "POST", headers: { authorization: `Bearer ${daemon.token}` }, signal: AbortSignal.timeout(70_000),
+        });
+        const pair = await response.json();
+        if (!response.ok || typeof pair.deepLink !== "string") {
+            process.stderr.write(`omb mobile: ${typeof pair.error === "string" ? pair.error : "daemon could not start pairing"}\n`);
+            return 1;
+        }
+        const deepLink = pair.deepLink;
+        const qr = execFileSync(process.execPath, [host, "--internal-render-pairing-qr", "--stdin"], { input: deepLink, encoding: "utf8", env, timeout: 10_000 });
+        const hostname = new URL(String(pair.endpoint)).hostname;
+        process.stdout.write(`\n  Host        ${hostname}\n  Fingerprint ${pair.hostKeyFingerprint}\n  Endpoint    ${pair.endpoint}\n  Pairing     expires at ${new Date(Number(pair.expiresAt)).toLocaleTimeString()}\n\n${qr}\n  The OMB daemon now owns the gateway and tunnel. You can close this terminal.\n`);
+        return 0;
+    }
+    if (requested === "status" || requested === "stop") {
+        const daemon = readDaemonStatus(env).daemon;
+        if (daemon) {
+            const path = requested === "status" ? "/mobile/status" : "/mobile/stop";
+            const response = await fetch(`http://127.0.0.1:${daemon.port}${path}`, {
+                method: requested === "stop" ? "POST" : "GET", headers: { authorization: `Bearer ${daemon.token}` }, signal: AbortSignal.timeout(5_000),
+            });
+            if (response.ok) {
+                const value = await response.json();
+                process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+                return 0;
+            }
+        }
+    }
+    // Inherit stdio: the host renders a terminal QR and progress, so a pipe would
+    // strip exactly the output the user is here to see.
+    //
+    // Spawned rather than run synchronously. `pair` is the one subcommand that
+    // stays alive for minutes — it prints a QR and then waits for a scan, writing
+    // progress the whole time. A synchronous child blocks this process's event
+    // loop, so SIGINT could not be observed or handed on: pressing Ctrl-C left
+    // the tunnel and the pairing window running with nobody to stop them. The
+    // child now shares our process group and receives the signal directly, and
+    // this process stays able to report how it ended.
+    return await runHost(host, args, env);
+}
+/** Runs the host as a long-lived passthrough and resolves with its exit code. */
+async function runHost(host, args, env) {
+    return await new Promise((resolve) => {
+        const child = spawn(process.execPath, [host, ...args], { stdio: "inherit", env });
+        // A signal the child did not handle is reported the way a shell would, so
+        // "Ctrl-C" and "exited 130" do not look like two different failures.
+        const settle = (code) => {
+            child.removeAllListeners();
+            resolve(code);
+        };
+        child.on("error", (error) => {
+            // A spawn failure is not the host "exiting abnormally": the host never ran.
+            // Saying so plainly is the difference between an install problem and a
+            // runtime problem for whoever is reading the terminal.
+            const cause = error.code === "EACCES"
+                ? `${host} is not executable. Reinstall the host, or run it with "node dist/cli/main.js".`
+                : error.code === "ENOENT"
+                    ? `${host} disappeared from PATH between the check and the run.`
+                    : `could not run ${host}: ${error.message}`;
+            process.stderr.write(`omb mobile: ${cause}\n`);
+            settle(1);
+        });
+        child.on("exit", (code, signal) => {
+            if (code !== null) {
+                settle(code);
+                return;
+            }
+            settle(signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : 1);
+        });
+    });
+}
+//# sourceMappingURL=omb-mobile.js.map

package/dist/cli/omb-mobile.js.map

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

package/dist/cli/omb-sessions.d.ts

@@ -0,0 +1,64 @@
+import type { OmbSessionActivity } from "../omp/session-activity.js";
+/**
+ * `omb sessions list --json` — a machine-readable session inventory.
+ *
+ * Until this existed there was no stable way for another tool to learn what
+ * sessions Bizar owns. The dashboard's `GET /sessions` is the only other
+ * machine-readable surface, and it is deliberately gated behind a loopback
+ * bearer token; a companion process on the same host has no way to reach it
+ * without minting one.
+ *
+ * Two properties are load-bearing and must not be relaxed:
+ *
+ * - **Scan authority travels with the data.** An empty list is ambiguous with
+ *   "the multiplexer did not answer", and a consumer that treats it as
+ *   authoritative blanks every row on a transient tmux restart. `authority.known`
+ *   is what lets a caller tell those apart.
+ * - **Liveness is never inferred.** `processObserved`, `authorityKnown` and
+ *   `uncertainLiveness` are three separate observations, reported as three
+ *   separate fields. Collapsing them would turn "we could not tell" into "no".
+ */
+export declare const SESSIONS_USAGE = "omb sessions list [--all] [--json]\n\n  Lists the Bizar-owned sessions for this project; --all selects every project.\n\n  --json            print machine-readable output for other tools.\n  --all             include sessions from every project known to this OMB host.\n\n  Fields are observations, not inferences. authority.known is false when the\n  multiplexer did not answer, and an empty sessions list in that state means\n  \"unknown\", not \"none\". uncertainLiveness and processObserved are reported\n  separately for the same reason: unknown liveness is never downgraded to\n  absent.";
+export interface SessionsInventorySession {
+    readonly name: string;
+    readonly displayName: string;
+    readonly state: string;
+    readonly generation: string;
+    readonly project: string;
+    readonly cwd: string;
+    readonly hosted: boolean;
+    readonly attached: boolean;
+    readonly authorityKnown: boolean;
+    readonly processObserved: boolean;
+    readonly uncertainLiveness: boolean;
+    /** Journal-derived, privacy-safe activity; never includes the process id. */
+    readonly activity?: Omit<OmbSessionActivity, "pid">;
+    readonly nativeId?: string;
+    /** OMP session pids are strings in `OmbSessionInfo`; keep that shape. */
+    readonly pid?: string;
+}
+export interface SessionsInventory {
+    readonly authority: {
+        readonly known: boolean;
+        readonly reason?: string;
+    };
+    readonly sessions: readonly SessionsInventorySession[];
+}
+/**
+ * One scan, one authority value.
+ *
+ * An earlier version probed authority and then listed sessions separately. That
+ * is wrong: if the multiplexer changes state between the two probes, the
+ * payload can claim `authority.known: true` alongside an empty list, which is
+ * exactly the "blank every row on a transient restart" failure the field
+ * exists to prevent. `requireMultiplexer` makes the listing itself fail
+ * closed, so authority and data are always the same observation.
+ */
+export declare function collectSessionsInventory(cwd?: string, env?: NodeJS.ProcessEnv, options?: {
+    readonly scope?: "project" | "all";
+}): Promise<SessionsInventory>;
+export declare function runSessionsCommand(cwd: string, args: string[], env: NodeJS.ProcessEnv): Promise<number>;
+/** Mobile ownership controls live under the mobile command family. */
+export declare function runMobileSessionsCommand(cwd: string, args: string[], env: NodeJS.ProcessEnv): Promise<number>;
+export declare const MOBILE_SESSIONS_USAGE = "omb mobile sessions <list|claims|claim|release> [options]\n\n  list                  List OMB sessions across projects (add --project for this directory only).\n  claims                List outstanding mobile ownership claims.\n  claim <name> <generation> [--owner <label>] [--holder-pid <pid>] [--json]\n                        Claim one stopped session generation for the mobile host.\n  release <claim-id> [--json]\n                        Release a mobile ownership claim.\n\n  Claims require an exact generation and confirmed stopped, unattached session.\n  A session with a live local owner is refused.\n";
+//# sourceMappingURL=omb-sessions.d.ts.map

package/dist/cli/omb-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omb-sessions.d.ts","sourceRoot":"","sources":["../../src/cli/omb-sessions.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,cAAc,slBAWjB,CAAC;AAEX,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACxD;AA4BD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,SAAgB,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,CAAA;CAAO,GACnD,OAAO,CAAC,iBAAiB,CAAC,CAY5B;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,sEAAsE;AACtE,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,eAAO,MAAM,qBAAqB,umBAWjC,CAAC"}