export type LoopMode = "ralph" | "ultrawork" | "ultraqa";
export type ModeStateKey = LoopMode | "ponytail";
export declare function modeStatePath(cwd: string, mode: ModeStateKey): string;
export declare function agentStopLocksPath(cwd: string): string;
export declare function clearAgentStopMarkers(cwd: string, mode: LoopMode): void;
export declare function readModeStateJson<T>(cwd: string, mode: ModeStateKey): T | undefined;
export declare function writeModeStateJson<T>(cwd: string, mode: ModeStateKey, value: T): void;
export declare function clearModeState(cwd: string, mode: ModeStateKey): void;
/**
 * True when any loop mode (ralph/ultrawork/ultraqa) is currently active.
 * Single source of truth for mode-gated behaviour (e.g. team idle-nudge).
 * Pure, side-effect-free read.
 */
export declare function isLoopModeActive(cwd: string): boolean;