import type { ProfileId } from '../profiles/index.js';
export type DocSource = {
    slug: string;
    label: string;
    maxPages?: number;
};
export declare const PROFILE_DOC_SOURCES: Partial<Record<ProfileId, DocSource[]>>;
export declare const DOCS_SYNC_MANIFEST_FILENAME = "setup-agents-docs-sync-manifest.json";
export type DocsSyncManifestEntry = {
    profile: ProfileId;
    slug: string;
    sourceUrl: string;
    scope: string;
    fetchedAt: string;
    contentDigest: string;
    parserVersion: '1';
    contamination: 'clean';
    status: 'success' | 'failure' | 'partial';
    pages: number;
    error?: string;
};
export type SyncResult = {
    profile: ProfileId;
    synced: number;
    failed: number;
    files: string[];
    errors: string[];
};
export declare function syncProfileDocs(cwd: string, profile: ProfileId, options?: {
    force?: boolean;
    maxPagesPerSource?: number;
}): Promise<SyncResult>;
export declare function listSyncableProfiles(): ProfileId[];
export declare function getSyncStatus(cwd: string): Record<string, {
    syncedAt: string;
    pages: number;
}>;
export type DocIndexEntry = {
    heading: string;
    level: number;
    line: number;
    endLine: number;
};
export type DocIndex = {
    file: string;
    title: string;
    totalLines: number;
    sections: DocIndexEntry[];
};
export declare function generateDocIndex(filePath: string): DocIndex | null;
export declare function renderDocIndexAsMarkdown(index: DocIndex): string;
export declare function generateAndWriteIndex(filePath: string): string | null;