/**
 * Host resolution for `setup wizard mcp` multi-host registration (Track MMH.1).
 *
 * The opensquid MCP writer (`mcp-writer.ts`) is host-generic — it merges the
 * opensquid entries into any `{ "mcpServers": { … } }` JSON file and preserves
 * every other key. The ONLY host-specific knowledge is each host's config-file
 * path, which differs per platform. This module owns that mapping + the
 * `--hosts` flag parsing. Everything here is pure (no I/O) so it's trivially
 * testable across platforms.
 *
 * Hosts in the "Claude ecosystem" on one machine each read a SEPARATE config —
 * registering one does not cover another (the 2026-05-27 "Desktop wasn't aware
 * of opensquid" gap). See the reference memory on per-host MCP config files.
 *
 * Imported by: src/setup/cli/mcp.ts.
 */
export type HostId = 'claude-code' | 'claude-desktop' | 'cursor';
export declare const ALL_HOSTS: readonly HostId[];
export interface HostTarget {
    id: HostId;
    /** Absolute config-file path for this host on this platform. */
    configPath: string;
    /** Human label for output + restart reminders. */
    label: string;
    /** Whether the app must be restarted to load the servers (binds MCP at start). */
    needsRestart: boolean;
}
export interface HostResolveEnv {
    platform: NodeJS.Platform;
    home: string;
    env: NodeJS.ProcessEnv;
}
/** Default resolution context from the live process. */
export declare function liveResolveEnv(): HostResolveEnv;
/** Resolve a host id to its per-platform config path. Pure. */
export declare function resolveHost(id: HostId, e: HostResolveEnv): HostTarget;
/**
 * Parse the `--hosts` flag value. Default (undefined/empty) = claude-code ONLY
 * (D1: no behavior change for existing callers). `all` = every host. A
 * comma-list selects by id; unknown ids are dropped with a warn (error only
 * surfaces later if NO valid host remains). De-duplicates, preserves order.
 */
export declare function parseHosts(raw: string | undefined, warn: (m: string) => void): HostId[];
//# sourceMappingURL=mcp-hosts.d.ts.map