import type { Task, TaskStatus } from "./types.js";
export declare function validateTaskId(taskId: string): boolean;
export declare function taskFilePath(tasksDir: string, taskId: string): string;
export declare function taskLockPath(tasksDir: string, taskId: string): string;
export declare function writeTask(taskPath: string, task: Task): void;
export declare function readTask(taskPath: string): Task | undefined;
export declare function listTasks(tasksDir: string): Task[];
export interface ClaimOptions {
    tasksDir: string;
    taskId: string;
    worker: string;
}
export interface ClaimResult {
    ok: boolean;
    task?: Task;
    claimToken?: string;
    reason?: string;
}
export declare function tryClaimTask(opts: ClaimOptions): ClaimResult;
export interface ClearLocksResult {
    removed: number;
    failures: Array<{
        path: string;
        error: string;
    }>;
}
export declare function clearAllLocks(tasksDir: string): number;
export declare function clearAllLocksDetailed(tasksDir: string): ClearLocksResult;
export interface TransitionOptions {
    tasksDir: string;
    taskId: string;
    from: TaskStatus;
    to: TaskStatus;
    claimToken: string;
    result?: string;
}
export interface TransitionResult {
    ok: boolean;
    task?: Task;
    reason?: string;
}
export declare function transitionTask(opts: TransitionOptions): TransitionResult;