/**
 * NotebookLM Audio Overview generation + download (issue #11).
 *
 * 2026-05 Studio UX (verified live in DE/EN locales):
 *   - The "Audio Overview" entry is a `<div role="button">` with a Material-
 *     Symbols `audio_magic_eraser` icon. *One click* on it kicks off
 *     generation; there is no separate "Generate" step unless the user
 *     opens the per-card "Anpassen" sub-dialog first.
 *   - While generating, NotebookLM shows a "Audio-Zusammenfassung wird … —
 *     Kommen Sie in ein paar Minuten wieder" tile with a spinner.
 *   - When generation completes, NotebookLM mounts an `artifact-library-item`
 *     tile with a Play button (`button.artifact-action-button`, locale-bound
 *     aria-label "Wiedergeben"/"Play"/…) and a three-dot menu containing
 *     "Download" / "Herunterladen" / "Télécharger" / …. There is *no real*
 *     `<audio>` element in the DOM.
 *
 * Two operations:
 *   - `generateAudioOverview(page, opts)` — async by default: returns
 *     immediately with `status: "started"` after triggering the generation,
 *     so the caller doesn't block for the 5–10 minute render. Pass
 *     `waitForCompletion: true` for the legacy synchronous behaviour.
 *   - `downloadAudioOverview(page, destDir)` — opens the three-dot menu on
 *     the completed audio tile, clicks the "Download" item, and persists
 *     the file via Patchright's `download` event.
 *
 * Companion: `getAudioStatus(page)` — non-blocking status probe for callers
 * that want to poll without holding open a long-running RPC.
 */
import type { Page } from "patchright";
export type AudioStatus = "ready" | "in_progress" | "not_started";
export interface GenerateAudioOptions {
    /** Optional focus prompt fed into the customise dialog before generation. */
    customPrompt?: string;
    /**
     * If `true`, block until the audio tile is ready (legacy behaviour). If
     * `false` (default), return immediately after triggering generation —
     * callers poll via `get_audio_status`.
     */
    waitForCompletion?: boolean;
    /** How long to wait when `waitForCompletion=true`. Default 10 min. */
    timeoutMs?: number;
}
export interface AudioGenerationResult {
    status: AudioStatus | "started" | "error";
    /** True when an Audio Overview already existed before this call. */
    alreadyExisted?: boolean;
    message?: string;
}
export declare function generateAudioOverview(page: Page, options?: GenerateAudioOptions): Promise<AudioGenerationResult>;
/**
 * Non-blocking status probe used by the `get_audio_status` MCP tool.
 */
export declare function getAudioStatusOnPage(page: Page): Promise<AudioGenerationResult>;
export interface DownloadAudioResult {
    success: boolean;
    filePath?: string;
    message?: string;
}
/**
 * Download the completed Audio Overview. Strategy:
 *   1. Verify the audio tile exists (else surface a clear error).
 *   2. Click the per-tile three-dot "Mehr"/"More" button to open the menu.
 *   3. Click the "Download" / "Herunterladen" / … menu item.
 *   4. Capture the resulting `download` event and save to `destinationDir`.
 */
export declare function downloadAudioOverview(page: Page, destinationDir: string, preferredFileName?: string): Promise<DownloadAudioResult>;
//# sourceMappingURL=audio.d.ts.map