/**
 * synap pods — manage multiple pod profiles and switch between them
 *
 *   synap pods list              list all configured pods
 *   synap pods add [name]        connect a new pod and save as a named profile
 *   synap pods use <name>        switch active pod and propagate to all surfaces
 *   synap pods remove <name>     remove a pod profile
 */
import { type SurfaceName } from "../lib/pod.js";
export declare function podsList(): Promise<void>;
export declare function podsAdd(name?: string, podUrlArg?: string): Promise<void>;
export type { SurfaceName };
export declare function podsUse(name: string, opts?: {
    surface?: SurfaceName;
    json?: boolean;
}): Promise<void>;
export declare function podsSwitch(name?: string): Promise<void>;
export declare function podsRemove(name: string): Promise<void>;
/**
 * Re-run the browser auth flow against an already-saved pod URL.
 * Lets users refresh a broken/expired API key without re-entering the pod URL.
 */
export declare function podsReconnect(name?: string): Promise<void>;
/**
 * synap pods update <name> [newUrl] — change a saved pod's URL in place.
 *
 * The safe path for a domain move (e.g. pod.team.thearchitech.xyz →
 * pod.thearch.synap.live): checks the pod is reachable at the new URL, verifies
 * whether the existing key still authenticates there, and ONLY offers to recreate
 * the key if the pod genuinely rejects it (keys survive a domain change, so a
 * re-auth is usually unnecessary). Nothing is written until both checks pass, so
 * a typo or a not-yet-live domain leaves the working profile untouched.
 */
export declare function podsUpdate(name: string, newUrlArg?: string, opts?: {
    url?: string;
    yes?: boolean;
}): Promise<void>;