import { sanitizeAssetId } from "../lib/safe-paths.js";
import type { BundleLock, MirrorIndexEntry } from "../types.js";
/**
 * Defines install hosts shared by the lifecycle pipeline.
 */
export declare const INSTALL_HOSTS: readonly ["opencode", "copilot-vscode", "shared"];
/**
 * Re-exports package-safe asset identifier sanitization for install callers.
 */
export { sanitizeAssetId };
/**
 * Validates a user-supplied install-domain `--host` value against the known
 * install hosts (#446 contract, review): empty values and unknown hosts throw
 * a clean one-line `CliUsageError` instead of a raw stack, and the error
 * message shape is shared by every install subcommand that accepts `--host`.
 *
 * @param value - The option value, or `undefined` when `--host` was absent.
 * @param usageHint - `agent-harness install <subcommand> --help` hint.
 * @returns The validated host value, or `undefined` when not provided.
 */
export declare function validateInstallHostValue(value: string | undefined, usageHint: string): (typeof INSTALL_HOSTS)[number] | undefined;
/**
 * Returns get installable assets for the provided inputs.
 */
export declare function getInstallableAssets(bundleAssets: BundleLock["assets"], mirrorIndexById: Map<string, MirrorIndexEntry>): BundleLock["assets"];