export interface HerdrExecResult {
    code: number;
    stdout: string;
    stderr: string;
    killed?: boolean;
}
/** Mutable-array executor, compatible with a bound `pi.exec`. Args are copied by createHerdrClient. */
export type HerdrExecutor<Options> = (command: string, args: string[], options: Options) => Promise<HerdrExecResult>;
export interface HerdrClient<Options> {
    exec(args: readonly string[], options: Options): Promise<HerdrExecResult>;
    run(args: readonly string[], options: Options): Promise<string>;
    json(args: readonly string[], options: Options): Promise<Record<string, unknown>>;
}
export interface StartPiAgentOptions<Options> {
    name: string;
    pane: string;
    args: readonly string[];
    options: Options;
    delay?: (milliseconds: number) => Promise<void>;
    onPaneBusy?: () => Promise<string>;
    shouldRetry?: (result: HerdrExecResult) => boolean;
}
/** Start a Pi agent in a Herdr pane, retrying only transient pane contention. */
export declare function startPiAgent<Options>(client: Pick<HerdrClient<Options>, "exec">, input: StartPiAgentOptions<Options>): Promise<HerdrExecResult>;
export declare function createHerdrClient<Options>(execute: HerdrExecutor<Options>): HerdrClient<Options>;
export declare function herdrCommandFailure(args: readonly string[], result: HerdrExecResult): string;
export declare function hasHerdrErrorCode(result: Pick<HerdrExecResult, "stdout" | "stderr">, expected: string): boolean;
/** Lock a Herdr worktree checkout path while mutating it via the Herdr CLI. */
export declare function withWorktreeLock<T>(checkout: string, operation: () => Promise<T>): Promise<T>;