/**
 * Where a log's comments live, decided by how the log was opened. A run
 * directory keeps them beside `notes.md` and `annotations.jsonl`; a loose
 * statelog file gets a sidecar next to it. Stdin and remote logs have no
 * comments in this version. The CLI records the chosen path in the session
 * registry, because it cannot be told from the statelog path alone.
 */
export type CommentsSource = {
    kind: "runDir";
    dir: string;
} | {
    kind: "file";
    path: string;
};
export declare function commentsPathFor(source: CommentsSource): string;
/** The source for a statelog path the viewer was handed: a run directory's
 *  `statelog.jsonl` keeps comments in the directory; any other file gets a
 *  sidecar. */
export declare function commentsSourceForStatelog(statelogPath: string): CommentsSource;
/** The lock a write to this comments file takes: a run directory's own `.lock`,
 *  or `<sidecar>.lock` for a loose file, so no `.lock` is left in whatever
 *  folder holds the statelog. */
export declare function commentsLockFor(commentsPath: string): string;