import type { Annotation } from "@vincentt-xr/harness/events";
export declare function cursorPath(cwd: string): string;
/** Last-consumed annotation seq for this project (0 if none consumed yet). */
export declare function readCursor(cwd: string): Promise<number>;
/** Advance the cursor. Called ONLY after the annotation was handed off. */
export declare function writeCursor(cwd: string, seq: number): Promise<void>;
/**
 * Long-poll the relay for the next annotation after `after`. Resolves the
 * annotation, or null when the poll window elapsed with nothing new. Throws a
 * clear hint when no preview relay is running for this project.
 */
export declare function fetchNext(cwd: string, opts: {
    after: number;
    timeoutMs: number;
}): Promise<Annotation | null>;