@amd-gaia/gaia 0.1.0 → 0.2.0

package/dist/cli.js

@@ -0,0 +1,493 @@
+#!/usr/bin/env node
+// Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
+// SPDX-License-Identifier: MIT
+/**
+ * `gaia` — the one command that gets you running.
+ *
+ *   npx @amd-gaia/gaia                 fetch + verify both binaries, then launch the TUI
+ *   npx @amd-gaia/gaia fetch           fetch + verify only
+ *   npx @amd-gaia/gaia serve           run the agent sidecar alone (REST, no TUI)
+ *   npx @amd-gaia/gaia version         print the lock manifest
+ *
+ * Every download is SHA-256 verified against `binaries.lock.json` before it is
+ * written, and a mismatch or a placeholder hash aborts the run. There is no
+ * "continue anyway" path.
+ */
+import { readFileSync, readdirSync, realpathSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { GaiaError } from "./errors.js";
+import { daemonSidecarCacheDir, defaultCacheDir, fetchAll, fetchBinary, } from "./fetch.js";
+import { DEFAULT_PORT, RESERVED_PORT, runTui, shutdown, startSidecar, } from "./lifecycle.js";
+import { COMPONENTS, componentBaseUrl, componentLock, currentPlatformKey, loadLock, platformsFor, } from "./platform.js";
+// Flags that consume a value. Being explicit avoids the footgun where
+// `--base-url --force` silently swallows the next flag as a value.
+const VALUE_FLAGS = new Set([
+    "base-url",
+    "platform",
+    "port",
+    "cache-dir",
+    "sidecar-dir",
+    "component",
+]);
+/** Raised for a malformed command line; the caller turns it into exit 2. */
+export class UsageError extends Error {
+}
+export function parseArgs(argv) {
+    const out = { _: [], flags: {}, passthrough: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--") {
+            out.passthrough = argv.slice(i + 1);
+            break;
+        }
+        if (a.startsWith("--")) {
+            // Both `--flag value` and `--flag=value` — dropping the second silently
+            // would download from the default hub after the user pointed us elsewhere.
+            const eq = a.indexOf("=");
+            const key = eq === -1 ? a.slice(2) : a.slice(2, eq);
+            const inline = eq === -1 ? undefined : a.slice(eq + 1);
+            if (VALUE_FLAGS.has(key)) {
+                if (inline !== undefined) {
+                    if (inline === "")
+                        throw new UsageError(`--${key} was given an empty value`);
+                    out.flags[key] = inline;
+                    continue;
+                }
+                const next = argv[i + 1];
+                if (next === undefined || next.startsWith("--")) {
+                    throw new UsageError(`--${key} expects a value`);
+                }
+                out.flags[key] = next;
+                i++;
+            }
+            else {
+                if (inline !== undefined) {
+                    throw new UsageError(`--${key} does not take a value (got '${a}')`);
+                }
+                out.flags[key] = true;
+            }
+        }
+        else if (a === "-h") {
+            out.flags["help"] = true;
+        }
+        else {
+            out._.push(a);
+        }
+    }
+    return out;
+}
+const HELP = `@amd-gaia/gaia — run GAIA locally on AMD Ryzen AI
+
+Usage:
+  gaia [run] [options] [-- <tui args>]   Fetch + verify both binaries, then launch the TUI
+  gaia fetch [options]                   Download + SHA-256 verify the binaries only
+  gaia serve [options]                   Run the agent sidecar alone (REST API, no TUI)
+  gaia version                           Print the lock manifest and this host's platform
+  gaia help                              Show this help
+
+run options:
+  --base-url <url>     Override the per-component download base URL from
+                       binaries.lock.json (applies to every component fetched).
+                       Must be https unless --allow-insecure-base-url is given.
+  --allow-insecure-base-url
+                       Permit a non-https --base-url (a trusted local mirror)
+  --cache-dir <dir>    Where to cache the TUI binary
+  --sidecar-dir <dir>  Where to install the agent sidecar
+                       (default ~/.gaia/agents/gaia — the daemon's own cache)
+  --force              Re-download even when a verified binary is already cached
+  -- <tui args>        Forward everything after \`--\` to gaia-tui verbatim
+
+fetch options:
+  --component <name>   Fetch only one of: ${COMPONENTS.join(", ")} (default: both)
+  --platform <key>     Override the platform key (e.g. linux-x64). Default: this host
+  plus every run option above.
+
+serve options:
+  --port <n>           Bind port (default ${DEFAULT_PORT}; ${RESERVED_PORT} is reserved and refused)
+  --base-url, --sidecar-dir, --force as above. \`serve\` never downloads the TUI,
+  so --cache-dir is refused rather than ignored.
+
+Notes:
+  * No binaries are committed to the repo. Every download is SHA-256 verified
+    against binaries.lock.json and FAILS LOUDLY on any mismatch.
+  * A placeholder hash in the lock blocks the fetch outright, so an unverifiable
+    binary can never be trusted.
+  * The agent sidecar has no arm64 Linux or arm64 Windows build; the TUI does.
+    \`gaia version\` prints the exact per-component platform matrix.
+  * The TUI is the published \`terminal-hub\` component — byte-identical to the
+    \`gaia tui\` a core install runs, so its behaviour cannot drift from it.
+  * Set DEBUG=gaia for download, spawn, and sidecar output on stderr.
+`;
+const flagStr = (args, k) => typeof args.flags[k] === "string" ? args.flags[k] : undefined;
+/**
+ * Which commands actually READ each value flag, and why the others refuse it.
+ * A flag a command ignores is worse than one it rejects: `run --port 9000`
+ * used to parse fine and silently come up on the default port.
+ */
+const VALUE_FLAG_SCOPE = {
+    "base-url": { commands: ["run", "fetch", "serve"], why: "it only affects downloads" },
+    "sidecar-dir": { commands: ["run", "fetch", "serve"], why: "it only affects downloads" },
+    platform: {
+        commands: ["fetch"],
+        why: "`run` and `serve` execute the binary, so it must be built for this host " +
+            `(${currentPlatformKey()})`,
+    },
+    port: {
+        commands: ["serve"],
+        why: "only `serve` binds a port; `run` reaches the agent through the daemon, which picks its own",
+    },
+    component: {
+        commands: ["fetch"],
+        why: "`run` needs both binaries and `serve` needs the sidecar, so neither can fetch a subset",
+    },
+    "cache-dir": {
+        commands: ["run", "fetch"],
+        why: "it caches the TUI, which `serve` never downloads (use --sidecar-dir)",
+    },
+};
+/** Refuse a value flag the chosen command would otherwise silently ignore. */
+function assertFlagsInScope(args, cmd) {
+    for (const [flag, scope] of Object.entries(VALUE_FLAG_SCOPE)) {
+        if (args.flags[flag] === undefined || scope.commands.includes(cmd))
+            continue;
+        throw new UsageError(`--${flag} is not valid for \`gaia ${cmd}\` — ${scope.why}. ` +
+            `It is accepted by: ${scope.commands.map((c) => `\`gaia ${c}\``).join(", ")}.`);
+    }
+}
+/**
+ * Require https for a download source. Integrity still holds over plaintext
+ * (the SHA is pinned), but a MITM then surfaces as a baffling IntegrityError
+ * instead of the transport failure it is.
+ */
+function checkedBaseUrl(args) {
+    const raw = flagStr(args, "base-url");
+    if (raw === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new UsageError(`--base-url '${raw}' is not a valid absolute URL (expected e.g. https://host/path).`);
+    }
+    if (parsed.protocol !== "https:" && !args.flags["allow-insecure-base-url"]) {
+        throw new UsageError(`--base-url '${raw}' uses ${parsed.protocol}, not https. Downloads are ` +
+            "SHA-256 verified either way, but plaintext turns tampering into a " +
+            "confusing integrity failure instead of a transport error. Use an https " +
+            "URL, or pass --allow-insecure-base-url for a trusted local mirror.");
+    }
+    return raw;
+}
+/** Shared download options. Scope and scheme are validated before we get here. */
+function downloadOptions(args, allowPlatform = false) {
+    const platformKey = flagStr(args, "platform");
+    return {
+        baseUrl: checkedBaseUrl(args),
+        ...(allowPlatform && platformKey !== undefined ? { platformKey } : {}),
+        force: Boolean(args.flags["force"]),
+        tuiDir: flagStr(args, "cache-dir"),
+        sidecarDir: flagStr(args, "sidecar-dir"),
+    };
+}
+/**
+ * The child's PATH with this package's own bin directory removed.
+ *
+ * npm installs our shim as `gaia`, and the TUI starts the daemon by resolving
+ * `gaia` on PATH (tui/internal/daemon/client.go) expecting the *Python* CLI.
+ * Left alone, the TUI would re-invoke us with `daemon start` and the daemon would
+ * never come up. Returns undefined when PATH is unset.
+ */
+export function pathWithoutOwnShim(rawPath = process.env["PATH"], argv1 = process.argv[1]) {
+    if (rawPath === undefined || !argv1)
+        return rawPath;
+    const sep = process.platform === "win32" ? ";" : ":";
+    let ownBinDir;
+    let ownName;
+    try {
+        ownBinDir = path.resolve(path.dirname(argv1));
+        ownName = path.basename(argv1);
+    }
+    catch {
+        return rawPath;
+    }
+    const same = (dir) => {
+        const resolved = path.resolve(dir);
+        return process.platform === "win32"
+            ? resolved.toLowerCase() === ownBinDir.toLowerCase()
+            : resolved === ownBinDir;
+    };
+    const entries = rawPath.split(sep).filter((d) => d !== "");
+    const ours = entries.filter((d) => same(d) || shimTargetsScript(d, argv1));
+    const kept = entries.filter((d) => !ours.includes(d));
+    const shared = ours.filter((d) => !isExclusivelyOurs(d, same(d) ? ownName : "gaia"));
+    return [...kept, ...shared].join(sep);
+}
+/** Match npm's symlink or generated cmd/PowerShell wrapper to this script. */
+function shimTargetsScript(dir, script) {
+    const canonical = (file) => {
+        try {
+            const resolved = realpathSync(file);
+            return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+        }
+        catch {
+            return undefined; // no resolvable executable at this candidate
+        }
+    };
+    const expected = canonical(script);
+    if (!expected)
+        return false;
+    for (const name of ["gaia", "gaia.cmd", "gaia.ps1"]) {
+        const shim = path.join(dir, name);
+        if (canonical(shim) === expected)
+            return true;
+        if (!name.includes("."))
+            continue;
+        let contents;
+        try {
+            contents = readFileSync(shim, "utf8");
+        }
+        catch {
+            continue; // this PATH directory does not contain a readable wrapper
+        }
+        for (const match of contents.matchAll(/["'](?:%dp0%|\$basedir)[\\/]([^"']+)["']/gi)) {
+            const target = path.resolve(dir, match[1].replace(/[\\/]/g, path.sep));
+            if (canonical(target) === expected)
+                return true;
+        }
+    }
+    return false;
+}
+/** True when every file in `dir` is a shim for `name` (`gaia`, `gaia.cmd`, …). */
+function isExclusivelyOurs(dir, name) {
+    const stem = name.replace(/\.(cmd|bat|ps1|exe)$/i, "");
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return false; // unreadable → treat as shared, the non-destructive branch
+    }
+    return (entries.length > 0 &&
+        entries.every((e) => e.replace(/\.(cmd|bat|ps1|exe)$/i, "") === stem));
+}
+/** Validate `--port`. Rejects out-of-range values and the reserved port. */
+export function resolvePort(raw) {
+    // Strict digits, not Number(): that accepts "0x2710", " 80 ", and "1e3",
+    // so a typo would quietly bind a port the user never named.
+    const port = typeof raw === "string" ? (/^\d+$/.test(raw) ? Number(raw) : NaN) : DEFAULT_PORT;
+    if (!Number.isInteger(port) || port <= 0 || port > 65535 || port === RESERVED_PORT) {
+        return {
+            error: `--port must be a port in 1..65535 and not ${RESERVED_PORT} (got ${String(raw)})`,
+        };
+    }
+    return { port };
+}
+async function cmdRun(args) {
+    const opts = downloadOptions(args);
+    process.stderr.write("[gaia] fetching and verifying the agent sidecar and the terminal UI ...\n");
+    const { sidecar, tui } = await fetchAll(opts);
+    process.stderr.write(`[gaia] sidecar ${sidecar.cached ? "cached" : "installed"} -> ${sidecar.binaryPath}\n` +
+        `[gaia] tui     ${tui.cached ? "cached" : "installed"} -> ${tui.binaryPath}\n` +
+        "[gaia] starting the terminal UI ...\n");
+    // The TUI owns the daemon handshake and the daemon owns the sidecar process —
+    // the TUI never holds a sidecar bearer token, so starting one here would only
+    // fight it for the port. Our job is to put a *verified* binary where the daemon
+    // looks, which fetchAll just did.
+    const childPath = pathWithoutOwnShim();
+    return runTui({
+        binaryPath: tui.binaryPath,
+        args: args.passthrough,
+        env: childPath === undefined ? {} : { PATH: childPath, Path: childPath },
+    });
+}
+async function cmdFetch(args) {
+    const opts = downloadOptions(args, true);
+    const only = args.flags["component"];
+    const results = [];
+    if (typeof only === "string") {
+        if (!COMPONENTS.includes(only)) {
+            throw new UsageError(`unknown --component '${only}'; expected one of ${COMPONENTS.join(", ")}`);
+        }
+        const component = only;
+        const lock = loadLock();
+        results.push(await fetchBinary({
+            component,
+            lock,
+            outDir: component === "sidecar"
+                ? (opts.sidecarDir ?? daemonSidecarCacheDir())
+                : (opts.tuiDir ?? defaultCacheDir(lock.agentVersion)),
+            baseUrl: opts.baseUrl,
+            platformKey: opts.platformKey,
+            force: opts.force,
+        }));
+    }
+    else {
+        const all = await fetchAll(opts);
+        results.push(all.sidecar, all.tui);
+    }
+    process.stdout.write(JSON.stringify({
+        ok: true,
+        binaries: results.map((r) => ({
+            component: r.component,
+            binaryPath: r.binaryPath,
+            platform: r.platformKey,
+            sha256: r.sha256,
+            cached: r.cached,
+            url: r.url,
+        })),
+    }, null, 2) + "\n");
+    return 0;
+}
+const SERVE_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
+async function cmdServe(args) {
+    const parsed = resolvePort(args.flags["port"]);
+    if ("error" in parsed) {
+        process.stderr.write(`error: ${parsed.error}\n`);
+        return 2;
+    }
+    const { port } = parsed;
+    const opts = downloadOptions(args);
+    process.stderr.write("[gaia] fetching and verifying the agent sidecar ...\n");
+    const result = await fetchBinary({
+        component: "sidecar",
+        outDir: opts.sidecarDir ?? daemonSidecarCacheDir(),
+        baseUrl: opts.baseUrl,
+        force: opts.force,
+    });
+    // We own the lifecycle here (autoCleanup off) so the graceful shutdown below
+    // actually runs; the default auto-reaper would SIGKILL the tree first.
+    const sidecar = await startSidecar({
+        binaryPath: result.binaryPath,
+        port,
+        autoCleanup: false,
+    });
+    try {
+        process.stdout.write(`\n  ▸ GAIA agent: ${sidecar.baseUrl}/v1/gaia/query\n`);
+        process.stdout.write(`    Health:     ${sidecar.baseUrl}/health\n`);
+        process.stdout.write("    Lemonade must be running for live queries. Ctrl+C to stop.\n\n");
+        let stop;
+        const stopped = new Promise((resolve) => {
+            let stopping = false;
+            stop = () => {
+                if (stopping) {
+                    // Absorbed, so say what is happening — otherwise a repeat Ctrl+C
+                    // during a slow teardown just looks like a frozen terminal.
+                    process.stderr.write(`[gaia] already stopping the sidecar (pid ${String(sidecar.child.pid)}); ` +
+                        "waiting for its process tree to exit ...\n");
+                    return;
+                }
+                stopping = true;
+                process.stderr.write("\n[gaia] stopping the sidecar ...\n");
+                void shutdown(sidecar).catch(() => undefined).finally(resolve);
+            };
+            // process.on, not once: a second Ctrl+C during the shutdown would
+            // otherwise hit Node's default disposition and kill us mid-teardown,
+            // orphaning the detached sidecar tree on port 8141. The `stopping` guard
+            // absorbs the repeats.
+            for (const sig of SERVE_SIGNALS)
+                process.on(sig, stop);
+        });
+        try {
+            await stopped;
+        }
+        finally {
+            // Left installed, they would swallow every later signal AND suppress
+            // Node's default disposition, so Ctrl+C would stop working entirely.
+            for (const sig of SERVE_SIGNALS)
+                process.removeListener(sig, stop);
+        }
+        return 0;
+    }
+    catch (e) {
+        await shutdown(sidecar).catch(() => undefined);
+        throw e;
+    }
+}
+function cmdVersion() {
+    const lock = loadLock();
+    process.stdout.write(JSON.stringify({
+        agentVersion: lock.agentVersion,
+        schemaVersion: lock.schemaVersion,
+        currentPlatform: currentPlatformKey(),
+        // Per component: each ships from its own hub lane at its own version.
+        components: Object.fromEntries(COMPONENTS.map((c) => [
+            c,
+            {
+                componentVersion: componentLock(lock, c).componentVersion,
+                baseUrl: componentBaseUrl(lock, c),
+                platforms: platformsFor(lock, c),
+            },
+        ])),
+    }, null, 2) + "\n");
+    return 0;
+}
+const KNOWN_COMMANDS = ["run", "fetch", "serve", "version", "help"];
+export async function main(argv) {
+    const args = parseArgs(argv);
+    const explicit = args._[0];
+    const cmd = explicit ?? (args.flags["help"] ? "help" : "run");
+    if (args.flags["help"] && cmd !== "help") {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if (!KNOWN_COMMANDS.includes(cmd)) {
+        throw new UsageError(`unknown command '${cmd}'`);
+    }
+    // A dropped positional means a mistyped invocation whose flags may also be
+    // wrong; refuse rather than run something the user did not ask for.
+    const extra = explicit === undefined ? args._ : args._.slice(1);
+    if (extra.length > 0) {
+        throw new UsageError(`unexpected argument${extra.length > 1 ? "s" : ""} ${extra.map((a) => `'${a}'`).join(", ")}. ` +
+            "Arguments for the terminal UI go after a bare `--`.");
+    }
+    assertFlagsInScope(args, cmd);
+    switch (cmd) {
+        case "run":
+            return cmdRun(args);
+        case "fetch":
+            return cmdFetch(args);
+        case "serve":
+            return cmdServe(args);
+        case "version":
+            return cmdVersion();
+        default:
+            process.stdout.write(HELP);
+            return 0;
+    }
+}
+/** True when this file is the entry point (so importing it for tests is a no-op). */
+function invokedDirectly() {
+    if (!process.argv[1])
+        return false;
+    try {
+        return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1]);
+    }
+    catch {
+        return false;
+    }
+}
+if (invokedDirectly()) {
+    main(process.argv.slice(2))
+        // exitCode rather than process.exit(): the latter can truncate the JSON
+        // `fetch`/`version` just wrote into an async stdout pipe.
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((e) => {
+        // Fail loudly with an actionable message; never swallow.
+        if (e instanceof UsageError) {
+            process.stderr.write(`error: ${e.message}\n\n${HELP}`);
+            process.exitCode = 2;
+        }
+        else if (e instanceof GaiaError) {
+            process.stderr.write(`[gaia] ${e.name}: ${e.message}\n`);
+            process.exitCode = 1;
+        }
+        else {
+            process.stderr.write(`[gaia] unexpected error: ${e.stack ?? e}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,2EAA2E;AAC3E,+BAA+B;AAC/B;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,MAAM,EACN,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EAEV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,YAAY,GACb,MAAM,eAAe,CAAC;AASvB,sEAAsE;AACtE,mEAAmE;AACnE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,UAAU;IACV,UAAU;IACV,MAAM;IACN,WAAW;IACX,aAAa;IACb,WAAW;CACZ,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG;AAExC,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,GAAG,GAAe,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACf,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,wEAAwE;YACxE,2EAA2E;YAC3E,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACvD,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,IAAI,MAAM,KAAK,EAAE;wBAAE,MAAM,IAAI,UAAU,CAAC,KAAK,GAAG,2BAA2B,CAAC,CAAC;oBAC7E,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;oBACxB,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChD,MAAM,IAAI,UAAU,CAAC,KAAK,GAAG,kBAAkB,CAAC,CAAC;gBACnD,CAAC;gBACD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACtB,CAAC,EAAE,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,MAAM,IAAI,UAAU,CAAC,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC;gBACtE,CAAC;gBACD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;4CAsB+B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;4CAKrB,YAAY,KAAK,aAAa;;;;;;;;;;;;;;CAczE,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,IAAgB,EAAE,CAAS,EAAsB,EAAE,CAClE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;AAU5E;;;;GAIG;AACH,MAAM,gBAAgB,GAAiE;IACrF,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,2BAA2B,EAAE;IACrF,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,2BAA2B,EAAE;IACxF,QAAQ,EAAE;QACR,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,GAAG,EACD,0EAA0E;YAC1E,IAAI,kBAAkB,EAAE,GAAG;KAC9B;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,4FAA4F;KAClG;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,GAAG,EAAE,wFAAwF;KAC9F;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;QAC1B,GAAG,EAAE,sEAAsE;KAC5E;CACF,CAAC;AAEF,8EAA8E;AAC9E,SAAS,kBAAkB,CAAC,IAAgB,EAAE,GAAW;IACvD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC7D,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC7E,MAAM,IAAI,UAAU,CAClB,KAAK,IAAI,4BAA4B,GAAG,QAAQ,KAAK,CAAC,GAAG,IAAI;YAC3D,sBAAsB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAgB;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAClB,eAAe,GAAG,kEAAkE,CACrF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,UAAU,CAClB,eAAe,GAAG,UAAU,MAAM,CAAC,QAAQ,6BAA6B;YACtE,oEAAoE;YACpE,yEAAyE;YACzE,oEAAoE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kFAAkF;AAClF,SAAS,eAAe,CAAC,IAAgB,EAAE,aAAa,GAAG,KAAK;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9C,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;QAC7B,GAAG,CAAC,aAAa,IAAI,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;QAClC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA8B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EACjD,QAA4B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3C,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,IAAI,SAAiB,CAAC;IACtB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAW,EAAE;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;YACjC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE;YACpD,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC;IAC7B,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,SAAS,iBAAiB,CAAC,GAAW,EAAE,MAAc;IACpD,MAAM,SAAS,GAAG,CAAC,IAAY,EAAsB,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC,CAAC,6CAA6C;QACjE,CAAC;IACH,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,0DAA0D;QACtE,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,4CAA4C,CAAC,EAAE,CAAC;YACpF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACxE,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kFAAkF;AAClF,SAAS,iBAAiB,CAAC,GAAW,EAAE,IAAY;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,2DAA2D;IAC3E,CAAC;IACD,OAAO,CACL,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,CACtE,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,GAAiC;IAC3D,yEAAyE;IACzE,4DAA4D;IAC5D,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAC9F,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QACnF,OAAO;YACL,KAAK,EAAE,6CAA6C,aAAa,SAAS,MAAM,CAAC,GAAG,CAAC,GAAG;SACzF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAgB;IACpC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAClG,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kBAAkB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,OAAO,OAAO,CAAC,UAAU,IAAI;QACpF,kBAAkB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,OAAO,GAAG,CAAC,UAAU,IAAI;QAC9E,uCAAuC,CAC1C,CAAC;IACF,8EAA8E;IAC9E,8EAA8E;IAC9E,gFAAgF;IAChF,kCAAkC;IAClC,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,OAAO,MAAM,CAAC;QACZ,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,IAAI,EAAE,IAAI,CAAC,WAAW;QACtB,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;KACzE,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAgB;IACtC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAE,UAAgC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,UAAU,CAClB,wBAAwB,IAAI,sBAAsB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,IAAqB,CAAC;QACxC,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CACV,MAAM,WAAW,CAAC;YAChB,SAAS;YACT,IAAI;YACJ,MAAM,EACJ,SAAS,KAAK,SAAS;gBACrB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,qBAAqB,EAAE,CAAC;gBAC9C,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CACZ;QACE,EAAE,EAAE,IAAI;QACR,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ,EAAE,CAAC,CAAC,WAAW;YACvB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAC;KACJ,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAE/D,KAAK,UAAU,QAAQ,CAAC,IAAgB;IACtC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,IAAI,CAAC,UAAU,IAAI,qBAAqB,EAAE;QAClD,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,6EAA6E;IAC7E,uEAAuE;IACvE,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,IAAI;QACJ,WAAW,EAAE,KAAK;KACnB,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,CAAC,OAAO,kBAAkB,CAAC,CAAC;QAC7E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;QACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;QAC3F,IAAI,IAAiB,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,GAAG,GAAS,EAAE;gBAChB,IAAI,QAAQ,EAAE,CAAC;oBACb,iEAAiE;oBACjE,4DAA4D;oBAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4CAA4C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK;wBACxE,4CAA4C,CAC/C,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;gBAC5D,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACjE,CAAC,CAAC;YACF,kEAAkE;YAClE,qEAAqE;YACrE,yEAAyE;YACzE,uBAAuB;YACvB,KAAK,MAAM,GAAG,IAAI,aAAa;gBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,OAAO,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,qEAAqE;YACrE,qEAAqE;YACrE,KAAK,MAAM,GAAG,IAAI,aAAa;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CACZ;QACE,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,eAAe,EAAE,kBAAkB,EAAE;QACrC,sEAAsE;QACtE,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACpB,CAAC;YACD;gBACE,gBAAgB,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,gBAAgB;gBACzD,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;gBAClC,SAAS,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;aACjC;SACF,CAAC,CACH;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAE,cAAoC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,UAAU,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,UAAU,CAClB,sBAAsB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC5F,qDAAqD,CACxD,CAAC;IACJ,CAAC;IACD,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,SAAS;YACZ,OAAO,UAAU,EAAE,CAAC;QACtB;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,SAAS,eAAe;IACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,eAAe,EAAE,EAAE,CAAC;IACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,wEAAwE;QACxE,0DAA0D;SACzD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACX,yDAAyD;QACzD,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,OAAO,IAAI,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,CAAC,YAAY,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YACzD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA6B,CAAW,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Typed error classes. Per the GAIA no-silent-fallback rule, every failure path
+ * raises one of these with an actionable message — never a swallowed error or a
+ * silently-degraded result.
+ */
+/** Base class so callers can `instanceof GaiaError` to catch any of ours. */
+export declare class GaiaError extends Error {
+    constructor(message: string);
+}
+/** A downloaded binary's SHA-256 did not match `binaries.lock.json`. */
+export declare class IntegrityError extends GaiaError {
+}
+/** Unsupported platform-arch, or no lock entry for a component on this host. */
+export declare class PlatformError extends GaiaError {
+}
+/** The sidecar did not become healthy within the timeout. */
+export declare class HealthTimeoutError extends GaiaError {
+}
+/** The sidecar's apiVersion is incompatible with what this package expects. */
+export declare class VersionMismatchError extends GaiaError {
+}
+/** A binary could not be located on disk for spawning. */
+export declare class BinaryNotFoundError extends GaiaError {
+}
+/** The sidecar we spawned died; anything answering its port is not ours. */
+export declare class SidecarExitedError extends GaiaError {
+}
+/** The bind port was already taken before we spawned anything. */
+export declare class PortInUseError extends GaiaError {
+}
+/** A 2xx response whose body is not the JSON the contract promises. */
+export declare class MalformedResponseError extends GaiaError {
+}
+/** An HTTP request to the sidecar returned a non-2xx status. */
+export declare class HttpError extends GaiaError {
+    readonly status: number;
+    readonly url: string;
+    readonly bodyText: string;
+    constructor(status: number, url: string, bodyText: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,6EAA6E;AAC7E,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,wEAAwE;AACxE,qBAAa,cAAe,SAAQ,SAAS;CAAG;AAEhD,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,SAAS;CAAG;AAE/C,6DAA6D;AAC7D,qBAAa,kBAAmB,SAAQ,SAAS;CAAG;AAEpD,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,SAAS;CAAG;AAEtD,0DAA0D;AAC1D,qBAAa,mBAAoB,SAAQ,SAAS;CAAG;AAErD,4EAA4E;AAC5E,qBAAa,kBAAmB,SAAQ,SAAS;CAAG;AAEpD,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,SAAS;CAAG;AAEhD,uEAAuE;AACvE,qBAAa,sBAAuB,SAAQ,SAAS;CAAG;AAExD,gEAAgE;AAChE,qBAAa,SAAU,SAAQ,SAAS;aAEpB,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,MAAM;aACX,QAAQ,EAAE,MAAM;gBAFhB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM;CAInC"}

package/dist/errors.js

@@ -0,0 +1,51 @@
+// Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
+// SPDX-License-Identifier: MIT
+/**
+ * Typed error classes. Per the GAIA no-silent-fallback rule, every failure path
+ * raises one of these with an actionable message — never a swallowed error or a
+ * silently-degraded result.
+ */
+/** Base class so callers can `instanceof GaiaError` to catch any of ours. */
+export class GaiaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+/** A downloaded binary's SHA-256 did not match `binaries.lock.json`. */
+export class IntegrityError extends GaiaError {
+}
+/** Unsupported platform-arch, or no lock entry for a component on this host. */
+export class PlatformError extends GaiaError {
+}
+/** The sidecar did not become healthy within the timeout. */
+export class HealthTimeoutError extends GaiaError {
+}
+/** The sidecar's apiVersion is incompatible with what this package expects. */
+export class VersionMismatchError extends GaiaError {
+}
+/** A binary could not be located on disk for spawning. */
+export class BinaryNotFoundError extends GaiaError {
+}
+/** The sidecar we spawned died; anything answering its port is not ours. */
+export class SidecarExitedError extends GaiaError {
+}
+/** The bind port was already taken before we spawned anything. */
+export class PortInUseError extends GaiaError {
+}
+/** A 2xx response whose body is not the JSON the contract promises. */
+export class MalformedResponseError extends GaiaError {
+}
+/** An HTTP request to the sidecar returned a non-2xx status. */
+export class HttpError extends GaiaError {
+    status;
+    url;
+    bodyText;
+    constructor(status, url, bodyText) {
+        super(`HTTP ${status} from ${url}: ${bodyText || "(empty body)"}`);
+        this.status = status;
+        this.url = url;
+        this.bodyText = bodyText;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,+BAA+B;AAC/B;;;;GAIG;AAEH,6EAA6E;AAC7E,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,cAAe,SAAQ,SAAS;CAAG;AAEhD,gFAAgF;AAChF,MAAM,OAAO,aAAc,SAAQ,SAAS;CAAG;AAE/C,6DAA6D;AAC7D,MAAM,OAAO,kBAAmB,SAAQ,SAAS;CAAG;AAEpD,+EAA+E;AAC/E,MAAM,OAAO,oBAAqB,SAAQ,SAAS;CAAG;AAEtD,0DAA0D;AAC1D,MAAM,OAAO,mBAAoB,SAAQ,SAAS;CAAG;AAErD,4EAA4E;AAC5E,MAAM,OAAO,kBAAmB,SAAQ,SAAS;CAAG;AAEpD,kEAAkE;AAClE,MAAM,OAAO,cAAe,SAAQ,SAAS;CAAG;AAEhD,uEAAuE;AACvE,MAAM,OAAO,sBAAuB,SAAQ,SAAS;CAAG;AAExD,gEAAgE;AAChE,MAAM,OAAO,SAAU,SAAQ,SAAS;IAEpB;IACA;IACA;IAHlB,YACkB,MAAc,EACd,GAAW,EACX,QAAgB;QAEhC,KAAK,CAAC,QAAQ,MAAM,SAAS,GAAG,KAAK,QAAQ,IAAI,cAAc,EAAE,CAAC,CAAC;QAJnD,WAAM,GAAN,MAAM,CAAQ;QACd,QAAG,GAAH,GAAG,CAAQ;QACX,aAAQ,GAAR,QAAQ,CAAQ;IAGlC,CAAC;CACF"}