import type { Stagehand } from '@browserbasehq/stagehand';
import type { Credentials } from './auth.js';
/**
 * Recorded login step from the Chrome extension's step recorder.
 * {username} and {password} in `value` are substituted at replay time.
 */
export interface LoginStep {
    action: 'fill' | 'click' | 'wait';
    selector: string;
    value?: string;
    ms?: number;
}
/**
 * AI-guided login using Stagehand act/extract.
 *
 * @param loginInstructions - Optional natural language description of the login flow.
 *   When provided, an initial stagehand.act() is called with these instructions to
 *   navigate the UI (e.g. "click Sign In in the nav, fill email, click Continue").
 *   The standard 3-step credential fill follows immediately after.
 * @param opts - Optional tenant/project/job IDs for writing AUTH_STEP CrawlEvidence.
 */
export declare function loginWithStagehand(stagehand: Stagehand, creds: Credentials, startUrl: string, captchaOpts?: {
    apiKey?: string;
    provider?: '2captcha' | 'capsolver';
}, emailOtpOpts?: {
    apiKey?: string;
    inboxId?: string;
}, loginInstructions?: string, opts?: {
    tenantId?: string;
    projectId?: string;
    jobId?: string;
}): Promise<boolean>;