/**
 * The folder's link to its agent, the way `vercel link` leaves `.vercel/project.json`
 * and `supabase init` leaves `supabase/config.toml`: a pointer in the folder, the
 * credential in the global store (_artifacts/cli-connect-design-20260912.md, item 2).
 * `handle` names the saved profile; `apiUrl` says which Relay it lives on. No token.
 */
export interface FolderLink {
    handle: string;
    apiUrl: string;
}
export declare const FOLDER_LINK_DIR = ".relay";
export declare const folderLinkPath: (cwd: string) => string;
/** The nearest link at or above the folder, the way git finds its `.git`. */
export declare function readFolderLink(cwd: string): Promise<(FolderLink & {
    path: string;
}) | undefined>;
/**
 * Writes the link, owner-only, and adds `.relay` to the folder's `.gitignore`
 * when there is one, the way vercel adds `.vercel` (packages/cli/src/util/link/link.ts).
 * A folder without a `.gitignore` gets none: it is not a repository's business yet.
 */
export declare function writeFolderLink(cwd: string, link: FolderLink): Promise<string>;
/**
 * Which saved agent a folder means: the folder link first, then `RELAY_AGENT`,
 * then the last connected one. Profiles are keyed by handle, so the answer is a
 * profile name, or nothing when none of the three names a saved profile.
 */
export declare function resolveFolderAgent(cwd: string, env: NodeJS.ProcessEnv, config: {
    profiles: Record<string, {
        agent_token?: string;
    }>;
    defaultAgent?: string;
}): Promise<{
    profile: string;
    source: "folder" | "env" | "default";
} | undefined>;
//# sourceMappingURL=folder-link.d.ts.map