/** Outcome of resolving the debug UI bundle. `ok` resolved to a file on disk;
 *  `inline` was fetched into memory under `--no-cache-write` and is served
 *  without ever touching the (read-only) cache; `unavailable` carries a human
 *  `reason` — surfaced verbatim (e.g. the exact fetch URL that failed) rather than
 *  collapsed to a silent null, so the inspect endpoint's 503 says *why*. */
export type UiBundleResolution = {
    kind: "ok";
    path: string;
} | {
    kind: "inline";
    html: Buffer;
} | {
    kind: "unavailable";
    reason: string;
};
/** Resolve the on-demand single-file debug UI, first hit wins so local
 *  development never touches the network:
 *
 *    1. `TELO_DEBUG_UI_PATH`         — explicit override (any local build).
 *    2. devDep on disk               — present in the monorepo, absent in a
 *                                      production install.
 *    3. `<cacheRoot>/debug-ui/<ver>` — a previous fetch.
 *    4. CDN (jsDelivr / `TELO_DEBUG_UI_URL`) — fetch the pinned version. Cached
 *                                      to disk when `cacheWrite` is set; under
 *                                      `--no-cache-write` (e.g. the k8s runner's
 *                                      baked, read-only `/telo-cache`) the bytes
 *                                      are returned in-memory instead of written.
 *
 *  When nothing resolves the inspect endpoint still works headless; the returned
 *  `reason` explains the gap (missing version, no cache dir, or a failed fetch
 *  with its URL and status) so the failure is never silent.
 */
export declare function resolveUiBundle(cacheRoot: string | null, cacheWrite?: boolean): Promise<UiBundleResolution>;
//# sourceMappingURL=ui-fetch.d.ts.map