import type { StorageClient } from "../storage/client.js";
import { type GrantScope } from "../search/postgresIndex.js";
export interface IndexEntry {
    name: string;
    title: string;
    summary: string;
    updated: string;
}
/**
 * Append or update an entry in index.md.
 * Reads current index, upserts the row for `name`, then writes back.
 * Safe to call fire-and-forget; retries once on write conflict.
 *
 * No-op when the Postgres index is configured — see indexFileIsAuthoritative().
 */
export declare function upsertIndexEntry(drive: StorageClient, entry: IndexEntry): Promise<void>;
/**
 * Remove an entry from index.md by filename.
 *
 * No-op when the Postgres index is configured — see indexFileIsAuthoritative().
 */
export declare function removeIndexEntry(drive: StorageClient, name: string): Promise<void>;
export interface FreshIndexOptions {
    userId?: string;
    grantScopes?: GrantScope[];
}
/**
 * Build index.md content fresh from the live page index — the same source
 * list_pages/search_pages read from — rather than the stale stored blob
 * (GH #397). Used by export_wiki when includeSystem is requested; not on any
 * per-write hot path.
 */
export declare function buildFreshIndexContent(drive: StorageClient, options?: FreshIndexOptions): Promise<string>;
//# sourceMappingURL=index.d.ts.map