export type SetupAgentsAuthorizationInput = {
    endpoint: string;
    workspace?: string;
    fetchImpl?: typeof fetch;
    log?: (message: string) => void;
    prompt?: () => Promise<string>;
    readStdin?: () => Promise<string>;
};
export declare const DEFAULT_SETUP_AGENTS_AUTH_ENDPOINT = "https://setup-agents.jterrats.dev/api/setup-agents/code";
export declare const DEFAULT_SETUP_AGENTS_AUTH_EXCHANGE_ENDPOINT = "https://setup-agents.pages.dev/api/setup-agents/exchange";
export type SetupAgentsAuthorizationEndpoints = {
    exchange: string;
    issuance: string;
};
export type SetupAgentsCodeExchange = {
    authorized: true;
    expiresAt: number;
};
type TestAuthorizationProvider = () => Promise<void>;
/** Test-only in-memory seam. Authorization codes must never be supplied through argv or environment variables. */
export declare function setSetupAgentsAuthorizationTestProvider(provider?: TestAuthorizationProvider): void;
export declare function authorizeSetupAgents(input?: Partial<SetupAgentsAuthorizationInput>): Promise<void>;
/** Exchanges a browser-issued setup-agents code without prompting or retaining it. */
export declare function exchangeSetupAgentsCode(code: string, input?: Partial<Pick<SetupAgentsAuthorizationInput, 'endpoint' | 'fetchImpl'>>): Promise<SetupAgentsCodeExchange>;
/**
 * Returns whether this local OS user has activated this workspace.
 * The file records only activation metadata, never an OTP, setup-agents code, email, or bearer token.
 */
export declare function isSetupAgentsActivated(workspace: string, now?: number): boolean;
export declare function recordSetupAgentsActivation(workspace: string, activatedAt?: number): void;
/** Removes durable authorization for one workspace without touching other workspace activations. */
export declare function clearSetupAgentsActivation(workspace: string): void;
/** Existing paths use their realpath; missing paths retain their resolved path identity. */
export declare function canonicalWorkspacePath(workspace: string): string;
export declare function resolveAuthorizationEndpoints(endpoint?: string): SetupAgentsAuthorizationEndpoints;
export declare function isSetupAgentsCode(value: string): boolean;
export {};