import type { MeticulousClient } from "../types/client.types";
export interface WhoamiOrganization {
    id: string;
    name: string;
    /**
     * The caller's `OrganizationMembership.role` for this organization (one of
     * `owner` | `member` | `reader`). Optional for forward-compatibility with
     * older backends that do not yet populate it.
     */
    role?: string;
}
export interface WhoamiResponse {
    email: string;
    firstName: string;
    lastName: string;
    isAdmin?: boolean;
    organizations: WhoamiOrganization[];
}
export declare const getWhoami: (client: MeticulousClient) => Promise<WhoamiResponse>;
export interface OAuthProject {
    id: string;
    name: string;
    organization: {
        id: string;
        name: string;
    };
}
export interface OAuthProjectsResponse {
    projects: OAuthProject[];
}
export declare const getOAuthProjects: (client: MeticulousClient) => Promise<OAuthProject[]>;
export interface OAuthDefaultProjectResponse {
    projectId: string | null;
    name?: string;
    organization?: {
        id: string;
        name: string;
    };
}
/**
 * The OAuth caller's default project — set via `auth set-project` (or the
 * "CLI & MCP" section of the web app's user settings) and consulted by any
 * OAuth-authenticated call that omits `projectId`/`--project`. Server-side
 * (not a local file), so it's consistent across machines and visible to the
 * hosted MCP server, which has no access to a user's local files.
 *
 * By default the backend transiently auto-picks the caller's sole accessible
 * project when none is stored. Pass `includeAutoPick: false` to get only the
 * *stored* preference (no auto-pick) — needed to tell a real stored default
 * apart from an auto-pick.
 */
export declare const getOAuthDefaultProject: (client: MeticulousClient, opts?: {
    includeAutoPick?: boolean;
}) => Promise<OAuthDefaultProjectResponse>;
/**
 * Sets the default project. `project` is resolved flexibly server-side — a
 * bare id, an `"organization/name"` slug, or (if it uniquely identifies one
 * of the caller's accessible projects) a bare project name — see
 * `ProjectService.resolveForUserByIdentifier`. Use `clearOAuthDefaultProject`
 * to clear it.
 */
export declare const setOAuthDefaultProject: (client: MeticulousClient, project: string) => Promise<OAuthDefaultProjectResponse>;
export declare const clearOAuthDefaultProject: (client: MeticulousClient) => Promise<OAuthDefaultProjectResponse>;
//# sourceMappingURL=oauth.api.d.ts.map