import { type HandoffSummarizer } from "./generate.js";
import type { CreateHandoffInput, CreateHandoffResult, Handoff, HandoffIndex, HandoffPointer, HandoffState } from "./types.js";
/** Recompute active index from on-disk handoff files. */
export declare function rebuildIndex(cwd: string): HandoffIndex;
export interface CreateOptions {
    summarizer?: HandoffSummarizer;
    allowAutoLlm?: boolean;
}
/**
 * Create a handoff: deterministic by default.
 * Writes `.omp/handoffs/<id>.md`. `--llm` requires an injected summarizer.
 */
export declare function createHandoff(cwd: string, input?: CreateHandoffInput, opts?: CreateOptions): Promise<CreateHandoffResult>;
/** Read a handoff by id. Prefers `.md`, falls back to legacy `.json`. */
export declare function readHandoff(cwd: string, id: string): Handoff | null;
export interface ListHandoffsOptions {
    all?: boolean;
    state?: HandoffState;
}
/** List handoffs. Default: active only, scanned from disk. */
export declare function listHandoffs(cwd: string, opts?: ListHandoffsOptions): Handoff[];
/** Active handoff pointers for context surfacing. */
export declare function listHandoffPointers(cwd: string): HandoffPointer[];
export declare function closeHandoff(cwd: string, id: string): Handoff;
export declare function archiveHandoff(cwd: string, id: string): Handoff;
export interface PruneOptions {
    olderThanDays?: number;
}
/**
 * Remove stale closed/archived handoff files and repair the active index.
 * Never deletes active handoffs.
 */
export declare function pruneHandoffs(cwd: string, opts?: PruneOptions): {
    removed: string[];
    kept: number;
};