@amd-gaia/gaia 0.1.0 → 0.2.0

package/dist/fetch.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Binary fetcher for both components (`sidecar` and `tui`).
+ *
+ * Resolves the current platform → looks the component up in
+ * `binaries.lock.json` → downloads it from THAT COMPONENT's base URL
+ * (overridable) → **verifies its SHA-256 against the lock and fails loudly on
+ * any mismatch** → writes it into a cache dir → `chmod +x` on POSIX.
+ *
+ * The two components come from different hub lanes: the sidecar from
+ * `agents/gaia/<agentVersion>/`, the TUI from `agents/terminal-hub/<tuiVersion>/`
+ * (the same binary a core install runs as `gaia tui`). Each entry's base URL
+ * comes from its own component, never from a shared top-level one.
+ *
+ * The SHA verify is the security boundary: a tampered, truncated, or
+ * not-yet-published artifact is rejected before it can ever be spawned. There is
+ * NO "use it anyway" path, and a placeholder hash in the lock blocks the fetch
+ * outright rather than degrading to an unverified download.
+ */
+import { type BinaryLock, type ComponentName } from "./platform.js";
+/**
+ * Where verified binaries are cached, keyed by agent version so a version bump
+ * never reuses the previous release's executables.
+ */
+export declare function defaultCacheDir(agentVersion: string): string;
+/** The hub agent id this package installs the sidecar as. */
+export declare const SIDECAR_AGENT_ID = "gaia";
+/** Basename of the hub install record (`gaia.hub.installer.SENTINEL_NAME`). */
+export declare const INSTALLED_SENTINEL_NAME = ".installed";
+/**
+ * The daemon's own sidecar cache — `~/.gaia/agents/gaia/`, mirroring
+ * `gaia.daemon.sidecars.fetch.default_cache_dir("gaia")`. Staging the verified
+ * sidecar here means the daemon's own fetch is a SHA-256 cache hit instead of a
+ * second download. This path is a cross-repo contract with the daemon.
+ */
+export declare function daemonSidecarCacheDir(agentId?: string): string;
+export interface FetchOptions {
+    /** Which binary to fetch. */
+    component: ComponentName;
+    /** Directory the verified binary is written into. Required. */
+    outDir: string;
+    /**
+     * Override this component's `baseUrl` (e.g. a local mirror). Trailing slash
+     * optional. Applies to whichever component is being fetched — the two lanes'
+     * filenames never collide, so one flat mirror directory can serve both.
+     */
+    baseUrl?: string;
+    /** Override the platform key (defaults to the current host). */
+    platformKey?: string;
+    /** Path to the lock file (defaults to the packaged binaries.lock.json). */
+    lockPath?: string;
+    /** A pre-loaded lock, to avoid re-reading it per component. */
+    lock?: BinaryLock;
+    /** Fetch override (tests). Defaults to global `fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Re-download even when a verified binary is already cached. Default false. */
+    force?: boolean;
+    /** Abort the download after this many ms. Default 300000 (the sidecar is ~200MB). */
+    timeoutMs?: number;
+}
+export interface FetchResult {
+    component: ComponentName;
+    /** Absolute path to the written, verified executable. */
+    binaryPath: string;
+    /** The platform key resolved. */
+    platformKey: string;
+    /** The verified SHA-256 (lowercase hex). */
+    sha256: string;
+    /** Source URL the artifact was downloaded from. */
+    url: string;
+    /** True when the on-disk binary was reused (hash already matched). */
+    cached: boolean;
+}
+/**
+ * SHA-256 of a file on disk, or null when it is simply absent. Any other error
+ * (a permission problem, a directory in the way) is re-raised: reading it as
+ * "no cache" would trigger a re-download that then fails on write with a far
+ * less useful message.
+ */
+export declare function fileSha256(filePath: string): Promise<string | null>;
+/** Verify an in-memory buffer against an expected SHA-256. */
+export declare function verifySha256(buf: Buffer, expected: string, sourceLabel: string): string;
+/**
+ * Fetch + verify + install one component's binary for the current platform.
+ *
+ * @throws PlatformError   unsupported platform / incomplete entry / placeholder hash
+ * @throws IntegrityError  SHA-256 mismatch
+ * @throws Error           download/network failure (HTTP status surfaced)
+ */
+export declare function fetchBinary(opts: FetchOptions): Promise<FetchResult>;
+export interface FetchAllOptions extends Omit<FetchOptions, "component" | "outDir"> {
+    /** Cache dir for the TUI. Defaults to `defaultCacheDir(lock.agentVersion)`. */
+    tuiDir?: string;
+    /** Cache dir for the sidecar. Defaults to the daemon's `~/.gaia/agents/gaia`. */
+    sidecarDir?: string;
+}
+export interface FetchAllResult {
+    sidecar: FetchResult;
+    tui: FetchResult;
+    lock: BinaryLock;
+}
+/**
+ * Fetch + verify BOTH binaries. Sequential on purpose: the sidecar is the large
+ * download and a failure there should not race a half-finished TUI download.
+ *
+ * The sidecar lands in the daemon's own cache dir so the daemon — which owns
+ * spawning it — finds it already verified instead of downloading it again.
+ */
+export declare function fetchAll(opts?: FetchAllOptions): Promise<FetchAllResult>;
+/** Sync existence check, for the lifecycle layer. */
+export declare function binaryExists(binaryPath: string): boolean;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAWH,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,aAAa,EAQnB,MAAM,eAAe,CAAC;AAIvB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,SAAmB,GAAG,MAAM,CAExE;AA+DD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,aAAa,CAAC;IACzB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;CACjB;AASD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BzE;AA+DD,8DAA8D;AAC9D,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAoJ1E;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,CAAC;IACjF,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,WAAW,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAelF;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/fetch.js

@@ -0,0 +1,369 @@
+// Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
+// SPDX-License-Identifier: MIT
+/**
+ * Binary fetcher for both components (`sidecar` and `tui`).
+ *
+ * Resolves the current platform → looks the component up in
+ * `binaries.lock.json` → downloads it from THAT COMPONENT's base URL
+ * (overridable) → **verifies its SHA-256 against the lock and fails loudly on
+ * any mismatch** → writes it into a cache dir → `chmod +x` on POSIX.
+ *
+ * The two components come from different hub lanes: the sidecar from
+ * `agents/gaia/<agentVersion>/`, the TUI from `agents/terminal-hub/<tuiVersion>/`
+ * (the same binary a core install runs as `gaia tui`). Each entry's base URL
+ * comes from its own component, never from a shared top-level one.
+ *
+ * The SHA verify is the security boundary: a tampered, truncated, or
+ * not-yet-published artifact is rejected before it can ever be spawned. There is
+ * NO "use it anyway" path, and a placeholder hash in the lock blocks the fetch
+ * outright rather than degrading to an unverified download.
+ */
+import crypto from "node:crypto";
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { IntegrityError, PlatformError } from "./errors.js";
+import { createLogger } from "./logger.js";
+import { joinUrl } from "./url.js";
+import { componentBaseUrl, componentLock, currentPlatformKey, defaultLockPath, isPlaceholderSha, loadLock, resolveEntry, } from "./platform.js";
+const log = createLogger("fetch");
+/**
+ * Where verified binaries are cached, keyed by agent version so a version bump
+ * never reuses the previous release's executables.
+ */
+export function defaultCacheDir(agentVersion) {
+    return path.join(os.homedir(), ".gaia", "npm-cache", `gaia-${agentVersion}`);
+}
+/** The hub agent id this package installs the sidecar as. */
+export const SIDECAR_AGENT_ID = "gaia";
+/** Basename of the hub install record (`gaia.hub.installer.SENTINEL_NAME`). */
+export const INSTALLED_SENTINEL_NAME = ".installed";
+/**
+ * The daemon's own sidecar cache — `~/.gaia/agents/gaia/`, mirroring
+ * `gaia.daemon.sidecars.fetch.default_cache_dir("gaia")`. Staging the verified
+ * sidecar here means the daemon's own fetch is a SHA-256 cache hit instead of a
+ * second download. This path is a cross-repo contract with the daemon.
+ */
+export function daemonSidecarCacheDir(agentId = SIDECAR_AGENT_ID) {
+    return path.join(os.homedir(), ".gaia", "agents", agentId);
+}
+/**
+ * Whether this fetch produced a runnable local install worth recording.
+ *
+ * `--platform` fetches a binary for a DIFFERENT host — a cross-compile staging
+ * step, not an install. Recording one would hand the daemon a wrong-arch
+ * executable that re-hashes correctly and then fails to exec.
+ */
+function installsForThisHost(component, platformKey) {
+    return component === "sidecar" && platformKey === currentPlatformKey();
+}
+/**
+ * Record a completed install the way `gaia.hub.installer` does.
+ *
+ * Staging a verified binary is only half the job the CLI claims to do. Without
+ * this file the daemon's `_hub_installed_binary` sees no install, and the TUI
+ * treats `gaia-agent` as its own stdio child — spawning our REST sidecar over
+ * stdio and filling the chat with uvicorn's startup log. With it, the TUI uses
+ * daemon transport and the daemon supervises the process and mints its token.
+ *
+ * Field names and `artifact_kind`/`executable`/`artifact_sha256` are a
+ * cross-repo contract with `InstalledAgent.to_dict()`; the daemon re-hashes the
+ * binary and raises if it does not match `artifact_sha256`, so this must carry
+ * the hash we actually verified.
+ */
+async function writeInstalledSentinel(opts) {
+    const sentinel = path.join(opts.outDir, INSTALLED_SENTINEL_NAME);
+    const record = {
+        id: SIDECAR_AGENT_ID,
+        version: opts.version,
+        language: "python",
+        installed_at: new Date().toISOString(),
+        artifact_sha256: opts.sha256,
+        path: opts.outDir,
+        artifact_kind: "binary",
+        executable: opts.executable,
+    };
+    // Temp-then-rename: a truncated sentinel reads as a corrupt install, which
+    // looks identical to "never installed".
+    const tmp = `${sentinel}.tmp.${process.pid}`;
+    try {
+        await fsp.writeFile(tmp, `${JSON.stringify(record, null, 2)}\n`, "utf8");
+        await fsp.rename(tmp, sentinel);
+    }
+    catch (e) {
+        await fsp.rm(tmp, { force: true }).catch(() => undefined);
+        throw new Error(`verified the sidecar at ${opts.outDir} but could not write its ` +
+            `${INSTALLED_SENTINEL_NAME} record: ${e.message}. Without it the ` +
+            "daemon does not see a completed install and the TUI falls back to running " +
+            `the sidecar over stdio. Check write permissions on ${opts.outDir}.`, { cause: e });
+    }
+    log.debug(`wrote ${sentinel} (v${opts.version})`);
+}
+function sha256Hex(buf) {
+    return crypto.createHash("sha256").update(buf).digest("hex");
+}
+/** Read size for incremental hashing — bounded regardless of artifact size. */
+const HASH_CHUNK_BYTES = 1 << 20;
+/**
+ * SHA-256 of a file on disk, or null when it is simply absent. Any other error
+ * (a permission problem, a directory in the way) is re-raised: reading it as
+ * "no cache" would trigger a re-download that then fails on write with a far
+ * less useful message.
+ */
+export async function fileSha256(filePath) {
+    const unreadable = (e) => new Error(`cannot read the cached binary at ${filePath} to check its hash: ${e.message}. ` +
+        "Fix the permissions on that path, or pass a different --cache-dir / --sidecar-dir.", { cause: e });
+    let fh;
+    try {
+        fh = await fsp.open(filePath, "r");
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return null;
+        throw unreadable(e);
+    }
+    // Chunked, not readFile: this runs on every cache hit, and the sidecar is
+    // ~200MB — buffering it whole is the peak the streaming download removed.
+    try {
+        const hash = crypto.createHash("sha256");
+        const buf = Buffer.allocUnsafe(HASH_CHUNK_BYTES);
+        for (;;) {
+            const { bytesRead } = await fh.read(buf, 0, buf.length, null);
+            if (bytesRead === 0)
+                break;
+            hash.update(buf.subarray(0, bytesRead));
+        }
+        return hash.digest("hex");
+    }
+    catch (e) {
+        throw unreadable(e);
+    }
+    finally {
+        await fh.close();
+    }
+}
+/**
+ * Stream a response body to `tmp`, hashing as it goes.
+ *
+ * Incremental on purpose: the sidecar is ~200MB and `arrayBuffer()` would peak
+ * at roughly double that. Awaiting each write applies backpressure.
+ */
+async function streamToFile(res, tmp, url) {
+    if (!res.body) {
+        throw new Error(`download failed: ${url} returned HTTP ${res.status} with no response body. ` +
+            "Check the base URL and that the artifact is published for this platform.");
+    }
+    const hash = crypto.createHash("sha256");
+    let bytes = 0;
+    let fh;
+    try {
+        fh = await fsp.open(tmp, "w");
+    }
+    catch (e) {
+        throw new Error(`cannot open ${tmp} to stage the download: ${e.message}. ` +
+            "Check write permissions on that directory, or pass a different " +
+            "--sidecar-dir / --cache-dir.", { cause: e });
+    }
+    try {
+        for await (const chunk of res.body) {
+            hash.update(chunk);
+            bytes += chunk.byteLength;
+            await fh.write(chunk);
+        }
+    }
+    finally {
+        await fh.close();
+    }
+    return { sha256: hash.digest("hex"), bytes };
+}
+/**
+ * Compare an already-computed SHA-256 with the expected one. Throws
+ * `IntegrityError` loudly on mismatch — this is the no-silent-fallback gate.
+ */
+function assertSha256(actual, expected, sourceLabel) {
+    if (actual.toLowerCase() !== expected.toLowerCase()) {
+        throw new IntegrityError(`SHA-256 mismatch for ${sourceLabel}:\n` +
+            `  expected ${expected}\n` +
+            `  actual   ${actual}\n` +
+            "Refusing to use a binary that does not match binaries.lock.json. " +
+            "The download may be corrupt, truncated, or tampered with. Re-run the fetch; " +
+            "if it persists, the lock is stale relative to the published artifact — " +
+            "report it at https://github.com/amd/gaia/issues.");
+    }
+    return actual;
+}
+/** Verify an in-memory buffer against an expected SHA-256. */
+export function verifySha256(buf, expected, sourceLabel) {
+    return assertSha256(sha256Hex(buf), expected, sourceLabel);
+}
+/**
+ * Fetch + verify + install one component's binary for the current platform.
+ *
+ * @throws PlatformError   unsupported platform / incomplete entry / placeholder hash
+ * @throws IntegrityError  SHA-256 mismatch
+ * @throws Error           download/network failure (HTTP status surfaced)
+ */
+export async function fetchBinary(opts) {
+    if (!opts?.outDir) {
+        throw new TypeError("fetchBinary requires an outDir to write the binary into");
+    }
+    if (!opts?.component) {
+        throw new TypeError('fetchBinary requires a component ("sidecar" or "tui")');
+    }
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+        throw new TypeError("global fetch unavailable — use Node >= 18 or pass fetchImpl");
+    }
+    const lock = opts.lock ?? loadLock(opts.lockPath ?? defaultLockPath());
+    const platformKey = opts.platformKey ?? currentPlatformKey();
+    const entry = resolveEntry(lock, opts.component, platformKey);
+    // Per-component: the sidecar and the TUI live in different hub lanes at
+    // different versions, so there is no single base URL to fall back to.
+    const baseUrl = opts.baseUrl ?? componentBaseUrl(lock, opts.component);
+    if (isPlaceholderSha(entry.sha256)) {
+        throw new PlatformError(`binaries.lock.json has a placeholder sha256 for ${opts.component}/'${platformKey}' ` +
+            `(${entry.sha256}), so no verifiable binary is published for it in this build. ` +
+            "Fetch is blocked so an unverifiable binary can never be trusted. " +
+            "Install a released @amd-gaia/gaia, or build the binary locally " +
+            "(hub/agents/gaia/python/packaging for the sidecar, `make -C tui cross-compile` " +
+            "for the TUI) and point the lifecycle helpers at it directly.");
+    }
+    const outDir = path.resolve(opts.outDir);
+    await fsp.mkdir(outDir, { recursive: true });
+    const binaryPath = path.join(outDir, entry.executable);
+    const url = joinUrl(baseUrl, entry.filename);
+    if (!opts.force) {
+        const existing = await fileSha256(binaryPath);
+        if (existing && existing.toLowerCase() === entry.sha256.toLowerCase()) {
+            log.debug(`cache hit: ${binaryPath} already matches lock sha256`);
+            // Re-apply the exec bit: an interrupted earlier run or a restrictive umask
+            // can leave correct bytes that still cannot be spawned.
+            if (process.platform !== "win32")
+                await fsp.chmod(binaryPath, 0o755);
+            // Also on a cache hit: an earlier release staged a verified binary with no
+            // sentinel, and those installs would otherwise never repair themselves.
+            if (installsForThisHost(opts.component, platformKey)) {
+                await writeInstalledSentinel({
+                    outDir,
+                    version: componentLock(lock, "sidecar").componentVersion,
+                    sha256: existing,
+                    executable: entry.executable,
+                });
+            }
+            return {
+                component: opts.component,
+                binaryPath,
+                platformKey,
+                sha256: existing,
+                url,
+                cached: true,
+            };
+        }
+    }
+    log.info(`downloading ${opts.component} for ${platformKey} from ${url}`);
+    const timeoutMs = opts.timeoutMs ?? 300_000;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    // Streamed to a temp file while hashing incrementally: the sidecar is ~200MB
+    // and buffering it whole peaks at roughly double that in RSS.
+    const tmp = `${binaryPath}.download.${process.pid}`;
+    let actualSha;
+    let bytes;
+    try {
+        const res = await fetchImpl(url, {
+            headers: { accept: "application/octet-stream" },
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            throw new Error(`download failed: HTTP ${res.status} ${res.statusText} for ${url}. ` +
+                "Check the base URL and that the artifact is published for this platform.");
+        }
+        ({ sha256: actualSha, bytes } = await streamToFile(res, tmp, url));
+    }
+    catch (e) {
+        await fsp.rm(tmp, { force: true }).catch(() => undefined);
+        if (e.name === "AbortError") {
+            throw new Error(`download timed out after ${timeoutMs}ms for ${url}`);
+        }
+        throw e;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    log.debug(`downloaded ${bytes} bytes`);
+    // Verify BEFORE the rename: unverified bytes must never reach the final path.
+    let sha;
+    try {
+        sha = assertSha256(actualSha, entry.sha256, `${opts.component} ${platformKey} (${url})`);
+    }
+    catch (e) {
+        await fsp.rm(tmp, { force: true }).catch(() => undefined);
+        throw e;
+    }
+    try {
+        await fsp.rename(tmp, binaryPath);
+    }
+    catch (e) {
+        await fsp.rm(tmp, { force: true }).catch(() => undefined);
+        throw new Error(`downloaded and verified the ${opts.component}, but could not move it into place ` +
+            `at ${binaryPath}: ${e.message}. ` +
+            "The usual cause is that the file is in use — stop any running gaia sidecar " +
+            "or TUI (`gaia kill`) and re-run. Otherwise check write permissions on " +
+            `${outDir}, or pass a different --sidecar-dir / --cache-dir.`, { cause: e });
+    }
+    try {
+        if (process.platform !== "win32")
+            await fsp.chmod(binaryPath, 0o755);
+    }
+    catch (e) {
+        throw new Error(`installed the ${opts.component} at ${binaryPath} but could not make it ` +
+            `executable: ${e.message}. Run \`chmod +x ${binaryPath}\`, or ` +
+            "pass a --sidecar-dir / --cache-dir you own.", { cause: e });
+    }
+    if (installsForThisHost(opts.component, platformKey)) {
+        await writeInstalledSentinel({
+            outDir,
+            version: componentLock(lock, "sidecar").componentVersion,
+            sha256: sha,
+            executable: entry.executable,
+        });
+    }
+    log.info(`installed verified ${opts.component} -> ${binaryPath}`);
+    return {
+        component: opts.component,
+        binaryPath,
+        platformKey,
+        sha256: sha,
+        url,
+        cached: false,
+    };
+}
+/**
+ * Fetch + verify BOTH binaries. Sequential on purpose: the sidecar is the large
+ * download and a failure there should not race a half-finished TUI download.
+ *
+ * The sidecar lands in the daemon's own cache dir so the daemon — which owns
+ * spawning it — finds it already verified instead of downloading it again.
+ */
+export async function fetchAll(opts = {}) {
+    const lock = opts.lock ?? loadLock(opts.lockPath ?? defaultLockPath());
+    const platformKey = opts.platformKey ?? currentPlatformKey();
+    const common = { ...opts, lock, platformKey };
+    const sidecar = await fetchBinary({
+        ...common,
+        component: "sidecar",
+        outDir: opts.sidecarDir ?? daemonSidecarCacheDir(),
+    });
+    const tui = await fetchBinary({
+        ...common,
+        component: "tui",
+        outDir: opts.tuiDir ?? defaultCacheDir(lock.agentVersion),
+    });
+    return { sidecar, tui, lock };
+}
+/** Sync existence check, for the lifecycle layer. */
+export function binaryExists(binaryPath) {
+    return fs.existsSync(binaryPath);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @amd-gaia/gaia — binary fetcher + process lifecycle for the GAIA flagship
+ * agent sidecar and the GAIA terminal UI.
+ *
+ * The CLI (`npx @amd-gaia/gaia`) is the normal way in. These exports are for
+ * integrators who want the pieces:
+ *
+ *   import { fetchAll, startSidecar, shutdown } from "@amd-gaia/gaia";
+ *
+ *   const { sidecar, tui } = await fetchAll();          // both, SHA-256 verified
+ *   const proc = await startSidecar({ binaryPath: sidecar.binaryPath });
+ *   const res  = await fetch(`${proc.baseUrl}/v1/gaia/query`, { ... });
+ *   await shutdown(proc);
+ */
+export { INSTALLED_SENTINEL_NAME, SIDECAR_AGENT_ID, fetchAll, fetchBinary, verifySha256, fileSha256, binaryExists, defaultCacheDir, daemonSidecarCacheDir, } from "./fetch.js";
+export type { FetchOptions, FetchResult, FetchAllOptions, FetchAllResult, } from "./fetch.js";
+export { AGENT_ID, API_VERSION, DEFAULT_HOST, DEFAULT_PORT, RESERVED_PORT, checkVersion, health, resolveSidecarPath, resolveTuiPath, runTui, shutdown, sidecarExecutableName, spawnSidecar, startSidecar, tuiExecutableName, version, waitForHealth, } from "./lifecycle.js";
+export type { HealthResponse, ResolveOptions, RunTuiOptions, Sidecar, SpawnOptions, StartOptions, VersionCheckOptions, VersionResponse, WaitForHealthOptions, } from "./lifecycle.js";
+export { COMPONENTS, SCHEMA_MAJOR, SUPPORTED_PLATFORMS, SUPPORTED_SIDECAR_PLATFORMS, SUPPORTED_TUI_PLATFORMS, TUI_ARTIFACT_NAMES, componentBaseUrl, componentLock, currentPlatformKey, defaultLockPath, isPlaceholderSha, loadLock, platformsFor, resolveEntry, } from "./platform.js";
+export type { BinaryLock, BinaryLockEntry, ComponentLock, ComponentName, } from "./platform.js";
+export { BinaryNotFoundError, GaiaError, HealthTimeoutError, HttpError, IntegrityError, MalformedResponseError, PlatformError, PortInUseError, SidecarExitedError, VersionMismatchError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,MAAM,EACN,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACP,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved.
+// SPDX-License-Identifier: MIT
+/**
+ * @amd-gaia/gaia — binary fetcher + process lifecycle for the GAIA flagship
+ * agent sidecar and the GAIA terminal UI.
+ *
+ * The CLI (`npx @amd-gaia/gaia`) is the normal way in. These exports are for
+ * integrators who want the pieces:
+ *
+ *   import { fetchAll, startSidecar, shutdown } from "@amd-gaia/gaia";
+ *
+ *   const { sidecar, tui } = await fetchAll();          // both, SHA-256 verified
+ *   const proc = await startSidecar({ binaryPath: sidecar.binaryPath });
+ *   const res  = await fetch(`${proc.baseUrl}/v1/gaia/query`, { ... });
+ *   await shutdown(proc);
+ */
+export { INSTALLED_SENTINEL_NAME, SIDECAR_AGENT_ID, fetchAll, fetchBinary, verifySha256, fileSha256, binaryExists, defaultCacheDir, daemonSidecarCacheDir, } from "./fetch.js";
+export { AGENT_ID, API_VERSION, DEFAULT_HOST, DEFAULT_PORT, RESERVED_PORT, checkVersion, health, resolveSidecarPath, resolveTuiPath, runTui, shutdown, sidecarExecutableName, spawnSidecar, startSidecar, tuiExecutableName, version, waitForHealth, } from "./lifecycle.js";
+export { COMPONENTS, SCHEMA_MAJOR, SUPPORTED_PLATFORMS, SUPPORTED_SIDECAR_PLATFORMS, SUPPORTED_TUI_PLATFORMS, TUI_ARTIFACT_NAMES, componentBaseUrl, componentLock, currentPlatformKey, defaultLockPath, isPlaceholderSha, loadLock, platformsFor, resolveEntry, } from "./platform.js";
+export { BinaryNotFoundError, GaiaError, HealthTimeoutError, HttpError, IntegrityError, MalformedResponseError, PlatformError, PortInUseError, SidecarExitedError, VersionMismatchError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,+BAA+B;AAC/B;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAQpB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,MAAM,EACN,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACP,aAAa,GACd,MAAM,gBAAgB,CAAC;AAaxB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AAQvB,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}