@oh-my-pi/pi-utils 18.1.21 → 18.2.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 ## [Unreleased]
 
+## [18.2.0] - 2026-09-15
+
+### Breaking Changes
+
+- Removed the unused `globPaths`, `loadGitignorePatterns`, and `GlobPathsOptions` exports.
+- Browser helpers now manage Chrome only: removed `Browser`, `BrowserTag`, `resolveBuildId()`, `getInstalledBrowsers()`, and `browser` options/metadata; `getDownloadUrl()` now takes `(platform, buildId, baseUrl?)`.
+
+### Added
+
+- Added `relativePathWithinNormalizedRoot()` for reusing canonical paths across containment checks.
+- Added `sleepLong()` and `MAX_TIMER_DELAY_MS`: an abortable sleep that chunks delays past the signed 32-bit timer ceiling so day-scale provider waits elapse instead of overflowing the timer.
+
+### Changed
+
+- Log-retention cleanup now runs after logger construction without keeping short-lived commands alive.
+- Debugger support now loads only when SIGUSR1 requests it.
+
+### Fixed
+
+- Fixed `extractRetryHint` dropping OpenCode Go's `Resets in …` quota window (`45min`, `2hr 15min`, `3 days`): the `reset in` pattern now accepts `Resets` phrasing, `hr`/`day` units, and compound `2hr 15min` remainders, so exhausted Go credentials block for the server-stated window instead of the 60s heuristic guess. ([#12091](https://github.com/can1357/oh-my-pi/pull/12091) by [@H4vC](https://github.com/H4vC))
+- Async file-peek callbacks now receive stable `Uint8Array` windows with copying `slice()` semantics.
+- Dotenv loading now handles multiline values and escapes consistently with Bun, preventing project values from leaking into child-shell environments.
+- SSE readers now support lone-CR line endings and CRLF split across chunks without merging or delaying events.
+
+## [18.1.22] - 2026-09-14
+
+### Fixed
+
+- Fixed `extractRetryHint` sleeping hours past the provider's stated wait when a timezone-naive `reset at` timestamp overshoots the relative retry hint: the skewed stamp is now ignored instead of winning longest-wins ([#12070](https://github.com/can1357/oh-my-pi/pull/12070) by [@H4vC](https://github.com/H4vC)).
+
 ## [18.1.21] - 2026-09-14
 
 ### Added

package/THIRD-PARTY-NOTICES.txt

@@ -10843,7 +10843,7 @@ RUST RUNTIME DEPENDENCY LICENSES
 
 Generated from Cargo.lock by cargo-about 0.8.2 in locked, offline, workspace, all-feature, all-target mode, then restricted using cargo metadata to normal and build edges reachable from the workspace (development-only edges are excluded). cargo-deny independently evaluates the complete all-target graph.
 
-Native Opus (audiopus/audiopus_sys) and PCRE2 (pcre2/pcre2-sys) are covered by the exact crate license payloads below. inferno 0.12.8 is package-scoped as CDDL-1.0: its CDDL-covered source remains available in the locked crates.io source archive at https://crates.io/crates/inferno/0.12.8 and https://github.com/jonhoo/inferno. The full locked license text follows below.
+Native Opus (opus/opusic-sys) and PCRE2 (pcre2/pcre2-sys) are covered by the exact crate license payloads below. inferno 0.12.8 is package-scoped as CDDL-1.0: its CDDL-covered source remains available in the locked crates.io source archive at https://crates.io/crates/inferno/0.12.8 and https://github.com/jonhoo/inferno. The full locked license text follows below.
 
 -------------------------------------------------------------------------------
 License: Apache License 2.0 (Apache-2.0)
@@ -12509,6 +12509,58 @@ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
+-------------------------------------------------------------------------------
+License: BSD 3-Clause "New" or "Revised" License (BSD-3-Clause)
+Used by:
+- opusic-sys 0.7.5 (https://github.com/DoumanAsh/opusic-sys)
+
+Full license text:
+
+Copyright 2001-2023 Xiph.Org, Skype Limited, Octasic,
+                    Jean-Marc Valin, Timothy B. Terriberry,
+                    CSIRO, Gregory Maxwell, Mark Borgerding,
+                    Erik de Castro Lopo, Mozilla, Amazon
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+- Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+- Neither the name of Internet Society, IETF or IETF Trust, nor the
+names of specific contributors, may be used to endorse or promote
+products derived from this software without specific prior written
+permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Opus is subject to the royalty-free patent licenses which are
+specified at:
+
+Xiph.Org Foundation:
+https://datatracker.ietf.org/ipr/1524/
+
+Microsoft Corporation:
+https://datatracker.ietf.org/ipr/1914/
+
+Broadcom Corporation:
+https://datatracker.ietf.org/ipr/1526/
+
 -------------------------------------------------------------------------------
 License: BSD 3-Clause "New" or "Revised" License (BSD-3-Clause)
 Used by:
@@ -13290,29 +13342,6 @@ jurisdiction of the Federal Courts of the Northern District of
 California and the state courts of the State of California, with
 venue lying in Santa Clara County, California.
 
--------------------------------------------------------------------------------
-License: ISC License (ISC)
-Used by:
-- audiopus_sys 0.2.2 (https://github.com/lakelezz/audiopus_sys.git)
-
-Full license text:
-
-ISC License
-
-Copyright (c) 2019, Lakelezz
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-
 -------------------------------------------------------------------------------
 License: ISC License (ISC)
 Used by:
@@ -18734,7 +18763,7 @@ DEALINGS IN THE SOFTWARE.
 -------------------------------------------------------------------------------
 License: MIT License (MIT)
 Used by:
-- opus 0.3.1 (https://github.com/SpaceManiac/opus-rs)
+- opus 0.4.0 (https://github.com/SpaceManiac/opus-rs)
 
 Full license text:
 

package/dist/types/async.d.ts

@@ -1,3 +1,28 @@
+/**
+ * Largest delay `setTimeout` (and `timers/promises` `scheduler.wait`)
+ * accepts without 32-bit signed overflow: larger values wrap and fire
+ * almost immediately instead of sleeping. Chunk day-scale provider waits
+ * (e.g. a monthly quota reset parsed from an error hint) so the full
+ * duration elapses instead of overflowing the timer.
+ */
+export declare const MAX_TIMER_DELAY_MS = 2147483647;
+/**
+ * Abortable sleep for arbitrarily long delays. Waits longer than
+ * {@link MAX_TIMER_DELAY_MS} chunk the sleep into back-to-back timer waits
+ * so no single timer overflows; an abort during any chunk rejects like
+ * `scheduler.wait`.
+ *
+ * The remainder is deliberately consumed by chunk, not recomputed from a
+ * monotonic deadline: deadline tracking never terminates under the repo's
+ * instant `scheduler.wait` mocks (retry-cap suites spy it to resolve
+ * immediately, so `deadline - performance.now()` never reaches zero and the
+ * loop spins forever). A premature native wake (Bun `uv_async_send`, see
+ * `sleepAtLeast` in `packages/agent/src/utils/yield.ts`) can therefore
+ * under-wait by the unelapsed chunk time — but that self-corrects downstream:
+ * credential blocks carry the true deadline independently of this sleep, so
+ * an early retry re-hits 429 and re-sleeps on a fresh server hint.
+ */
+export declare function sleepLong(delayMs: number, signal?: AbortSignal): Promise<void>;
 /**
  * Wrap a promise with a timeout and optional abort signal.
  * Rejects with the given error or a new error containing the given message if

package/dist/types/browsers.d.ts

@@ -1,12 +1,3 @@
-/** Behavior-compatible reimplementation of @puppeteer/browsers' used surface. */
-/** Supported browser products. */
-export declare enum Browser {
-    CHROME = "chrome",
-    CHROMEHEADLESSSHELL = "chrome-headless-shell",
-    CHROMIUM = "chromium",
-    FIREFOX = "firefox",
-    CHROMEDRIVER = "chromedriver"
-}
 /** Browser download platform identifiers. */
 export declare enum BrowserPlatform {
     LINUX = "linux",
@@ -16,17 +7,6 @@ export declare enum BrowserPlatform {
     WIN32 = "win32",
     WIN64 = "win64"
 }
-/** Chrome-for-Testing release channel tags accepted by {@link resolveBuildId}. */
-export declare enum BrowserTag {
-    CANARY = "canary",
-    NIGHTLY = "nightly",
-    BETA = "beta",
-    DEV = "dev",
-    DEVEDITION = "devedition",
-    STABLE = "stable",
-    ESR = "esr",
-    LATEST = "latest"
-}
 /** Download progress reported while a browser archive is streamed to disk. */
 export interface BrowserDownloadProgress {
     downloadedBytes: number;
@@ -34,7 +14,6 @@ export interface BrowserDownloadProgress {
 }
 /** Inputs used to locate an installed browser executable. */
 export interface ComputeExecutablePathOptions {
-    browser: Browser;
     buildId: string;
     cacheDir: string;
     platform?: BrowserPlatform;
@@ -44,9 +23,8 @@ export interface InstallOptions extends ComputeExecutablePathOptions {
     baseUrl?: string;
     downloadProgressCallback?: (progress: BrowserDownloadProgress) => void;
 }
-/** Metadata for one browser installation found in a Puppeteer cache. */
+/** Metadata for a managed Chrome installation in Puppeteer's cache layout. */
 export interface InstalledBrowser {
-    browser: Browser;
     buildId: string;
     platform: BrowserPlatform;
     path: string;
@@ -54,15 +32,9 @@ export interface InstalledBrowser {
 }
 /** Detect the current host's Puppeteer browser platform. */
 export declare function detectBrowserPlatform(): BrowserPlatform | undefined;
-/** Resolve a Chrome-for-Testing channel, milestone, or build prefix to a full build ID. */
-export declare function resolveBuildId(browser: Browser, _platform: BrowserPlatform, tag: string | BrowserTag): Promise<string>;
 /** Return the Chrome-for-Testing archive URL for a browser build. */
-export declare function getDownloadUrl(browser: Browser, platform: BrowserPlatform, buildId: string, baseUrl?: string): URL;
+export declare function getDownloadUrl(platform: BrowserPlatform, buildId: string, baseUrl?: string): URL;
 /** Compute the executable path in Puppeteer's cache layout. */
 export declare function computeExecutablePath(options: ComputeExecutablePathOptions): string;
-/** Scan a Puppeteer cache for browser installation directories. */
-export declare function getInstalledBrowsers(options: {
-    cacheDir: string;
-}): Promise<InstalledBrowser[]>;
 /** Download and unpack Chrome into Puppeteer's existing cache layout. */
 export declare function install(options: InstallOptions): Promise<InstalledBrowser>;

package/dist/types/dirs.d.ts

@@ -44,6 +44,16 @@ export declare function resolveProfileEnv(omp: string | undefined, pi: string |
 export declare function getBaseConfigRoot(): string;
 export declare function resolveEquivalentPath(inputPath: string): string;
 export declare function normalizePathForComparison(inputPath: string): string;
+/**
+ * Compare paths already normalized by {@link normalizePathForComparison}.
+ *
+ * Returns the relative path (an empty string when the paths are equal), or
+ * `null` when the candidate is outside the root. Callers classifying one
+ * candidate against several static roots can normalize each side once and
+ * reuse the public helpers' containment semantics without repeating realpath
+ * work.
+ */
+export declare function relativePathWithinNormalizedRoot(normalizedRoot: string, normalizedCandidate: string): string | null;
 export declare function pathIsWithin(root: string, candidate: string): boolean;
 export declare function relativePathWithinRoot(root: string, candidate: string): string | null;
 /** Get the project directory. */

package/dist/types/env.d.ts

@@ -29,8 +29,8 @@ export declare function filterProcessEnv(env: Record<string, string | undefined>
 /** Filters process env for child shells without launch-cwd dotenv values. */
 export declare function filterChildShellEnv(env: Record<string, string | undefined>, cwd?: string): Record<string, string>;
 /**
- * Parses a .env file synchronously into key-value string pairs using
- * {@link parseEnvLine} for Bun-compatible line semantics, then mirrors valid
+ * Parses a complete .env file with the runtime's dotenv grammar, then retains
+ * only shell-identifier names and spawn-safe values before mirroring valid
  * `OMP_` variables to their `PI_` aliases.
  */
 export declare function parseEnvFile(filePath: string): Record<string, string>;

package/dist/types/fetch-retry.d.ts

@@ -1,6 +1,5 @@
 /**
  * Server-suggested retry delay extraction. Merges the patterns historically used
- * by the OpenAI Codex and Google Gemini retry helpers.
  *
  * Header sources (checked in order):
  *  - `retry-after-ms` (milliseconds)
@@ -16,6 +15,8 @@
  *  - `try again in 250ms` / `try again in 12s` / `try again in 5 min` / `try again in ~158 min`
  *  - `retry-after-ms=98497000` / `retry-after-ms: 7200000` / `retry-after-ms = 7200000`
  *  - `Your limit will reset at 2026-09-01 09:44:51` / `将在 2026-09-01 09:44:51 重置`
+ *    (offset-bearing only; a timezone-naive stamp is provider wall clock in
+ *    an unknown zone and only resolves when no relative signal is present)
  *
  * Returns `undefined` if no signal is found, or `0` when the provider
  * explicitly asks for an immediate retry (`retry-after…=0`, or an absolute

package/dist/types/index.d.ts

@@ -9,7 +9,6 @@ export * from "./file-lock.js";
 export * from "./format.js";
 export * from "./frontmatter.js";
 export * from "./fs-error.js";
-export * from "./glob.js";
 export * from "./incoming-json.js";
 export * from "./json.js";
 export * from "./json-parse.js";

package/dist/types/peek-file.d.ts

@@ -10,9 +10,8 @@ export declare function peekFile<T>(filePath: string, maxBytes: number, op: (hea
 /**
  * Read up to the last `maxBytes` of `filePath` and pass that slice to `op`.
  *
- * The tail mirror of {@link peekFile}: same pooled-buffer strategy (no per-call
- * allocation for small reads), but the read is positioned at `size - len` so the
- * window ends at EOF. When the file is shorter than `maxBytes`, the whole file is
+ * The tail mirror of {@link peekFile}: the read is positioned at `size - len` so
+ * the window ends at EOF. When the file is shorter than `maxBytes`, the whole file is
  * returned. A multi-byte codepoint straddling the leading cut decodes to a
  * replacement char — callers that parse line-oriented tails drop the partial
  * leading line anyway.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-utils",
-	"version": "18.1.21",
+	"version": "18.2.0",
 	"description": "Shared utilities for pi packages",
 	"keywords": [
 		"cli",
@@ -54,7 +54,7 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "18.1.21"
+		"@oh-my-pi/pi-natives": "18.2.0"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"

package/src/async.ts

@@ -1,3 +1,40 @@
+import { scheduler } from "node:timers/promises";
+
+/**
+ * Largest delay `setTimeout` (and `timers/promises` `scheduler.wait`)
+ * accepts without 32-bit signed overflow: larger values wrap and fire
+ * almost immediately instead of sleeping. Chunk day-scale provider waits
+ * (e.g. a monthly quota reset parsed from an error hint) so the full
+ * duration elapses instead of overflowing the timer.
+ */
+export const MAX_TIMER_DELAY_MS = 2_147_483_647;
+
+/**
+ * Abortable sleep for arbitrarily long delays. Waits longer than
+ * {@link MAX_TIMER_DELAY_MS} chunk the sleep into back-to-back timer waits
+ * so no single timer overflows; an abort during any chunk rejects like
+ * `scheduler.wait`.
+ *
+ * The remainder is deliberately consumed by chunk, not recomputed from a
+ * monotonic deadline: deadline tracking never terminates under the repo's
+ * instant `scheduler.wait` mocks (retry-cap suites spy it to resolve
+ * immediately, so `deadline - performance.now()` never reaches zero and the
+ * loop spins forever). A premature native wake (Bun `uv_async_send`, see
+ * `sleepAtLeast` in `packages/agent/src/utils/yield.ts`) can therefore
+ * under-wait by the unelapsed chunk time — but that self-corrects downstream:
+ * credential blocks carry the true deadline independently of this sleep, so
+ * an early retry re-hits 429 and re-sleeps on a fresh server hint.
+ */
+export async function sleepLong(delayMs: number, signal?: AbortSignal): Promise<void> {
+	signal?.throwIfAborted();
+	let remaining = delayMs;
+	while (remaining > 0) {
+		await scheduler.wait(Math.min(remaining, MAX_TIMER_DELAY_MS), { signal });
+		remaining -= MAX_TIMER_DELAY_MS;
+		signal?.throwIfAborted();
+	}
+}
+
 /**
  * Wrap a promise with a timeout and optional abort signal.
  * Rejects with the given error or a new error containing the given message if

package/src/browsers.ts

@@ -1,6 +1,4 @@
-/** Behavior-compatible reimplementation of @puppeteer/browsers' used surface. */
-
-import type * as fs from "node:fs";
+/** Managed Chrome-for-Testing installation with bounded downloads and atomic publication. */
 import * as fsp from "node:fs/promises";
 import * as os from "node:os";
 import * as path from "node:path";
@@ -8,7 +6,6 @@ import { type ArchiveLimits, extractArchive } from "./ar";
 import { withFileLock } from "./file-lock";
 
 const CHROME_FOR_TESTING_BASE_URL = "https://storage.googleapis.com/chrome-for-testing-public";
-const CHROME_METADATA_BASE_URL = "https://googlechromelabs.github.io/chrome-for-testing";
 // Installation is outside browser/Eval operation deadlines, but a stalled CDN
 // must still release the cached install promise and permit a later attempt.
 const DOWNLOAD_TIMEOUT_MS = 5 * 60_000;
@@ -25,15 +22,6 @@ const BROWSER_ARCHIVE_LIMITS: Partial<ArchiveLimits> = {
 	maxInMemorySize: 1024 * 1024 * 1024,
 };
 
-/** Supported browser products. */
-export enum Browser {
-	CHROME = "chrome",
-	CHROMEHEADLESSSHELL = "chrome-headless-shell",
-	CHROMIUM = "chromium",
-	FIREFOX = "firefox",
-	CHROMEDRIVER = "chromedriver",
-}
-
 /** Browser download platform identifiers. */
 export enum BrowserPlatform {
 	LINUX = "linux",
@@ -51,34 +39,6 @@ function requireChromeForTestingPlatform(platform: BrowserPlatform): ChromeForTe
 	return platform;
 }
 
-const BROWSERS = [
-	Browser.CHROME,
-	Browser.CHROMEHEADLESSSHELL,
-	Browser.CHROMIUM,
-	Browser.FIREFOX,
-	Browser.CHROMEDRIVER,
-] as const;
-const BROWSER_PLATFORMS = [
-	BrowserPlatform.LINUX,
-	BrowserPlatform.LINUX_ARM,
-	BrowserPlatform.MAC,
-	BrowserPlatform.MAC_ARM,
-	BrowserPlatform.WIN32,
-	BrowserPlatform.WIN64,
-] as const;
-
-/** Chrome-for-Testing release channel tags accepted by {@link resolveBuildId}. */
-export enum BrowserTag {
-	CANARY = "canary",
-	NIGHTLY = "nightly",
-	BETA = "beta",
-	DEV = "dev",
-	DEVEDITION = "devedition",
-	STABLE = "stable",
-	ESR = "esr",
-	LATEST = "latest",
-}
-
 /** Download progress reported while a browser archive is streamed to disk. */
 export interface BrowserDownloadProgress {
 	downloadedBytes: number;
@@ -87,7 +47,6 @@ export interface BrowserDownloadProgress {
 
 /** Inputs used to locate an installed browser executable. */
 export interface ComputeExecutablePathOptions {
-	browser: Browser;
 	buildId: string;
 	cacheDir: string;
 	platform?: BrowserPlatform;
@@ -99,27 +58,14 @@ export interface InstallOptions extends ComputeExecutablePathOptions {
 	downloadProgressCallback?: (progress: BrowserDownloadProgress) => void;
 }
 
-/** Metadata for one browser installation found in a Puppeteer cache. */
+/** Metadata for a managed Chrome installation in Puppeteer's cache layout. */
 export interface InstalledBrowser {
-	browser: Browser;
 	buildId: string;
 	platform: BrowserPlatform;
 	path: string;
 	executablePath: string;
 }
 
-interface LastKnownGoodVersions {
-	channels: Record<string, { version: string }>;
-}
-
-interface MilestoneVersions {
-	milestones: Record<string, { version: string }>;
-}
-
-interface PatchVersions {
-	builds: Record<string, { version: string }>;
-}
-
 /** Detect the current host's Puppeteer browser platform. */
 export function detectBrowserPlatform(): BrowserPlatform | undefined {
 	const platform = os.platform();
@@ -130,43 +76,8 @@ export function detectBrowserPlatform(): BrowserPlatform | undefined {
 	return undefined;
 }
 
-/** Resolve a Chrome-for-Testing channel, milestone, or build prefix to a full build ID. */
-export async function resolveBuildId(
-	browser: Browser,
-	_platform: BrowserPlatform,
-	tag: string | BrowserTag,
-): Promise<string> {
-	if (browser !== Browser.CHROME && browser !== Browser.CHROMEHEADLESSSHELL && browser !== Browser.CHROMEDRIVER) {
-		return tag;
-	}
-	if (/^\d+\.\d+\.\d+\.\d+$/.test(tag)) return tag;
-
-	const channel = tag === BrowserTag.LATEST ? "Canary" : chromeChannelName(tag);
-	if (channel) {
-		const metadata = await fetchMetadata<LastKnownGoodVersions>("last-known-good-versions.json");
-		const version = metadata.channels[channel]?.version;
-		if (!version) throw new Error(`Chrome channel ${tag} was not found in Chrome-for-Testing metadata`);
-		return version;
-	}
-	if (/^\d+$/.test(tag)) {
-		const metadata = await fetchMetadata<MilestoneVersions>("latest-versions-per-milestone.json");
-		return metadata.milestones[tag]?.version ?? tag;
-	}
-	if (/^\d+\.\d+\.\d+$/.test(tag)) {
-		const metadata = await fetchMetadata<PatchVersions>("latest-patch-versions-per-build.json");
-		return metadata.builds[tag]?.version ?? tag;
-	}
-	return tag;
-}
-
 /** Return the Chrome-for-Testing archive URL for a browser build. */
-export function getDownloadUrl(
-	browser: Browser,
-	platform: BrowserPlatform,
-	buildId: string,
-	baseUrl = CHROME_FOR_TESTING_BASE_URL,
-): URL {
-	if (browser !== Browser.CHROME) throw new Error(`Unsupported browser download: ${browser}`);
+export function getDownloadUrl(platform: BrowserPlatform, buildId: string, baseUrl = CHROME_FOR_TESTING_BASE_URL): URL {
 	const archivePlatform = chromeArchivePlatform(platform);
 	const root = baseUrl.replace(/\/$/, "");
 	return new URL(`${root}/${buildId}/${archivePlatform}/chrome-${archivePlatform}.zip`);
@@ -176,9 +87,8 @@ export function getDownloadUrl(
 export function computeExecutablePath(options: ComputeExecutablePathOptions): string {
 	const detectedPlatform = options.platform ?? detectBrowserPlatform();
 	if (!detectedPlatform) throw new Error("Cannot determine a browser platform for this host");
-	if (options.browser !== Browser.CHROME) throw new Error(`Unsupported browser executable: ${options.browser}`);
 	const platform = requireChromeForTestingPlatform(detectedPlatform);
-	const installDir = installationDir(options.cacheDir, options.browser, platform, options.buildId);
+	const installDir = installationDir(options.cacheDir, platform, options.buildId);
 	switch (platform) {
 		case BrowserPlatform.LINUX:
 			return path.join(installDir, "chrome-linux64", "chrome");
@@ -207,52 +117,14 @@ export function computeExecutablePath(options: ComputeExecutablePathOptions): st
 	}
 }
 
-/** Scan a Puppeteer cache for browser installation directories. */
-export async function getInstalledBrowsers(options: { cacheDir: string }): Promise<InstalledBrowser[]> {
-	const installed: InstalledBrowser[] = [];
-	for (const browser of BROWSERS) {
-		const browserDir = path.join(options.cacheDir, browser);
-		let entries: fs.Dirent[];
-		try {
-			entries = await fsp.readdir(browserDir, { withFileTypes: true });
-		} catch (error) {
-			if (isMissingPath(error)) continue;
-			throw error;
-		}
-		for (const entry of entries) {
-			if (!entry.isDirectory()) continue;
-			const parsed = parseInstallationName(entry.name);
-			if (!parsed) continue;
-			const installPath = path.join(browserDir, entry.name);
-			try {
-				installed.push({
-					browser,
-					buildId: parsed.buildId,
-					platform: parsed.platform,
-					path: installPath,
-					executablePath: computeExecutablePath({
-						browser,
-						buildId: parsed.buildId,
-						cacheDir: options.cacheDir,
-						platform: parsed.platform,
-					}),
-				});
-			} catch {
-				// Other browser products are not part of the surface used by OMP.
-			}
-		}
-	}
-	return installed;
-}
-
 /** Download and unpack Chrome into Puppeteer's existing cache layout. */
 export async function install(options: InstallOptions): Promise<InstalledBrowser> {
 	const platform = options.platform ?? detectBrowserPlatform();
 	if (!platform) throw new Error("Cannot determine a browser platform for this host");
 	const executablePath = computeExecutablePath({ ...options, platform });
-	const installPath = installationDir(options.cacheDir, options.browser, platform, options.buildId);
+	const installPath = installationDir(options.cacheDir, platform, options.buildId);
 	if (await pathExists(executablePath)) {
-		return { browser: options.browser, buildId: options.buildId, platform, path: installPath, executablePath };
+		return { buildId: options.buildId, platform, path: installPath, executablePath };
 	}
 
 	await fsp.mkdir(path.dirname(installPath), { recursive: true });
@@ -267,7 +139,7 @@ export async function install(options: InstallOptions): Promise<InstalledBrowser
 				const stagingPath = path.join(options.cacheDir, `.browser-${nonce}`);
 				try {
 					await downloadArchive(
-						getDownloadUrl(options.browser, platform, options.buildId, options.baseUrl),
+						getDownloadUrl(platform, options.buildId, options.baseUrl),
 						archivePath,
 						options.downloadProgressCallback,
 					);
@@ -284,34 +156,12 @@ export async function install(options: InstallOptions): Promise<InstalledBrowser
 					]);
 				}
 			}
-			return { browser: options.browser, buildId: options.buildId, platform, path: installPath, executablePath };
+			return { buildId: options.buildId, platform, path: installPath, executablePath };
 		},
 		{ retries: Math.ceil(DOWNLOAD_TIMEOUT_MS / 100) + 1, retryDelayMs: 100 },
 	);
 }
 
-function chromeChannelName(tag: string): string | undefined {
-	switch (tag) {
-		case BrowserTag.STABLE:
-			return "Stable";
-		case BrowserTag.BETA:
-			return "Beta";
-		case BrowserTag.DEV:
-			return "Dev";
-		case BrowserTag.CANARY:
-			return "Canary";
-		default:
-			return undefined;
-	}
-}
-
-async function fetchMetadata<T>(filename: string): Promise<T> {
-	const response = await fetch(`${CHROME_METADATA_BASE_URL}/${filename}`, { signal: AbortSignal.timeout(30_000) });
-	if (!response.ok)
-		throw new Error(`Failed to fetch Chrome-for-Testing metadata (${response.status} ${response.statusText})`);
-	return (await response.json()) as T;
-}
-
 function chromeArchivePlatform(platform: BrowserPlatform): string {
 	switch (requireChromeForTestingPlatform(platform)) {
 		case BrowserPlatform.LINUX:
@@ -327,17 +177,8 @@ function chromeArchivePlatform(platform: BrowserPlatform): string {
 	}
 }
 
-function installationDir(cacheDir: string, browser: Browser, platform: BrowserPlatform, buildId: string): string {
-	return path.join(cacheDir, browser, `${platform}-${buildId}`);
-}
-
-function parseInstallationName(name: string): { platform: BrowserPlatform; buildId: string } | undefined {
-	for (const platform of BROWSER_PLATFORMS) {
-		const prefix = `${platform}-`;
-		if (name.startsWith(prefix) && name.length > prefix.length)
-			return { platform, buildId: name.slice(prefix.length) };
-	}
-	return undefined;
+function installationDir(cacheDir: string, platform: BrowserPlatform, buildId: string): string {
+	return path.join(cacheDir, "chrome", `${platform}-${buildId}`);
 }
 
 function isMissingPath(error: unknown): boolean {