export interface BuilderStatus {
    configured: boolean;
    builderEnabled: boolean;
    /**
     * True when `BUILDER_PRIVATE_KEY` is set at the deploy level. This is a
     * fallback credential; per-user/org Builder connections are still allowed
     * and take precedence for that request.
     */
    envManaged?: boolean;
    credentialSource?: "user" | "org" | "workspace" | "env";
    connectUrl: string;
    cliAuthUrl?: string;
    appHost: string;
    apiHost: string;
    branchProjectIdConfigured?: boolean;
    branchProjectId?: string;
    publicKeyConfigured: boolean;
    privateKeyConfigured: boolean;
    userId?: string;
    orgName?: string;
    /**
     * Builder space(s) the effective credential can reach, with real display
     * names derived from the Admin API. One entry today (a `bpk-` key is
     * space-scoped); the list shape lets the Sources drill-down show multiple
     * spaces later. Absent/empty when undeducible — fall back to `orgName`.
     */
    spaces?: Array<{
        id: string;
        name: string;
    }>;
    orgKind?: string;
    subscription?: string;
    subscriptionLevel?: string;
    subscriptionName?: string;
    isEnterprise?: boolean;
    isFreeAccount?: boolean;
    /**
     * Set when the OAuth callback ran but failed to persist credentials.
     * Surfaced as a one-shot row by the server so the connect-flow polling
     * can stop with a clear message instead of timing out at 5min.
     */
    connectError?: {
        message: string;
        at: number;
    };
    /**
     * Set when the currently effective Builder credential was rejected by
     * Builder's API. Unlike connectError, this describes the old credential pair
     * and should not abort a new reconnect attempt while the popup is open.
     */
    authError?: {
        message: string;
        at: number;
    };
}
/**
 * Fetches Builder connection status from the neutral connection-status route.
 * The legacy /_agent-native/builder/status route remains available for older
 * clients.
 * Re-fetches on window focus to detect post-redirect state changes.
 */
export declare function useBuilderStatus({ enabled, }?: {
    enabled?: boolean;
}): {
    status: BuilderStatus | null;
    loading: boolean;
    error: string | null;
    stale: boolean;
    refetch: () => Promise<void>;
};
export interface BuilderConnectFlowOptions {
    /** Skip server status polling for hosts that own provider routing. */
    enabled?: boolean;
    /** URL to synchronously open on start(). Defaults to the 302 shortcut. */
    popupUrl?: string;
    /** Low-cardinality label for the UI surface that opened Builder connect. */
    trackingSource?: string;
    /** Product flow that needed Builder connect, e.g. connect_llm. */
    trackingFlow?: string;
    /** Invoked after the status poll first sees `configured: true`. */
    onConnected?: (state: {
        orgName: string | null;
    }) => void | Promise<void>;
}
export interface BuilderConnectStartOptions {
    /** Override the hook-level source for this click. */
    trackingSource?: string;
    /** Override the hook-level flow for this click. */
    trackingFlow?: string;
}
export interface BuilderConnectFlow {
    configured: boolean;
    /** True after at least one successful Builder connection-status response. */
    statusResolved: boolean;
    /**
     * True when the deploy has BUILDER_PRIVATE_KEY set as a fallback. Connect
     * is still available so users can override the fallback with their own
     * Builder account.
     */
    envManaged: boolean;
    /**
     * True when the server has a Builder branch project configured for this
     * request. When false, the card surfaces a waitlist CTA instead of a Send
     * button.
     */
    builderEnabled: boolean;
    orgName: string | null;
    connecting: boolean;
    error: string | null;
    /**
     * True once the first Builder connection-status fetch has completed (successfully
     * or not). Consumers that accept an `initialConfigured` prop (e.g. agent
     * tool-call results rendered with server-side state) should treat
     * `configured`/`orgName` as authoritative only once this flips true —
     * otherwise the hook's starting `false` defaults would cause a flash
     * back to "Connect Builder" on first paint.
     */
    hasFetchedStatus: boolean;
    /** Open the popup and begin polling. Must be called from a user-gesture handler. */
    start: (options?: BuilderConnectStartOptions) => void;
}
export declare function withBuilderConnectTrackingParams(url: string, options?: {
    source?: string;
    flow?: string;
    app?: string;
    template?: string;
}): string;
export interface OpenBuilderConnectPopupOptions {
    url?: string;
    source?: string;
    flow?: string;
    features?: string;
}
export declare function openBuilderConnectPopup({ url, source, flow, features, }?: OpenBuilderConnectPopupOptions): Window | null;
export declare function useBuilderConnectFlow(opts?: BuilderConnectFlowOptions): BuilderConnectFlow;
//# sourceMappingURL=useBuilderStatus.d.ts.map