/**
 * Product seams for the studio media library. A product such as gtm-agent
 * implements these against its `/api/generations`, `/api/media/save`, and
 * `/api/generations/bulk-delete` routes. The ports themselves are never fetched
 * by the shell; note the assembled screens ALSO require the host to serve
 * `StudioComposer`'s `/api/generate` and `/api/media-models` (see
 * `../studio-react/index.tsx`), and `useStudioGenerations` polls its
 * `generationsEndpoint` (default `/api/generations`).
 */
import type { Generation } from './generation';
export type MediaTypeFilter = 'all' | 'image' | 'video' | 'speech';
export declare const MEDIA_TYPE_FILTERS: readonly {
    value: MediaTypeFilter;
    label: string;
}[];
export interface GenerationPageQuery {
    /** Trimmed prompt search; '' means no filter. Goes on the wire as `q`. */
    q: string;
    type: MediaTypeFilter;
    /** null for the first page; otherwise the server's opaque cursor. */
    cursor: string | null;
    signal: AbortSignal;
}
export interface GenerationPage {
    items: Generation[];
    nextCursor?: string;
}
export type FetchGenerationsPage = (query: GenerationPageQuery) => Promise<GenerationPage>;
export interface VaultSaveResult {
    generationId: string;
    vaultPath: string;
}
export type SaveGenerationsToVault = (input: {
    generations: readonly Generation[];
    path: string;
    signal?: AbortSignal;
}) => Promise<readonly VaultSaveResult[]>;
/** The shell may invoke this during page teardown (the `pagehide`/unmount flush
 *  of a deferred delete). Implementations must use unload-survivable transport
 *  such as `fetch(..., { keepalive: true })` or `navigator.sendBeacon`, and keep
 *  the payload within the keepalive transport's approximately 64 KB bound. */
export type DeleteGenerations = (ids: readonly string[]) => Promise<void>;
export type DownloadGenerations = (generations: readonly Generation[]) => void | Promise<void>;
/** Every media action a tile / viewer / batch bar can offer. An ABSENT member
 *  hides its control — a product with no vault endpoint must not render a
 *  "Save to vault" button that does nothing. */
export interface StudioMediaActions {
    download?: DownloadGenerations;
    save?: SaveGenerationsToVault;
    remove?: DeleteGenerations;
    vaultHref?: (filePath?: string | null) => string;
    /** Intercept the vault link for SPA nav; the href stays for middle-click. */
    onOpenVault?: (generation: Generation) => void;
}