import { TeamshareApi, type DocumentJob } from '../api';
export interface DocJobOutcome {
    jobId: string;
    kind: string;
    status: 'succeeded' | 'failed' | 'skipped';
    detail?: string;
    versionNumber?: number;
}
export type DocJobLogger = (line: string) => void;
/**
 * Execute one claimed job. Never throws: every failure path reports
 * `fail` back to the API so the UI can show the reason and offer a retry.
 */
export declare function runDocumentJob(api: TeamshareApi, job: DocumentJob, log?: DocJobLogger): Promise<DocJobOutcome>;
/**
 * Process queued jobs for a project. Used by the CLI/driver; the claim is
 * atomic so two bridges racing the same job cannot both convert it.
 *
 * @param jobId  convert exactly this job (already claimed by the caller)
 * @param max    stop after this many jobs (safety cap for a wake-driven run)
 */
export declare function processDocumentJobs(api: TeamshareApi, opts?: {
    projectId?: string;
    jobId?: string;
    max?: number;
    log?: DocJobLogger;
}): Promise<DocJobOutcome[]>;