import type { PathInputFinding } from "../schema/findings.js";
export type ConfinedPathResult = {
    readonly ok: true;
    readonly relativePath: string;
} | {
    readonly ok: false;
    readonly finding: PathInputFinding;
};
/** Keep pi's @ convenience while rejecting an unprefixed absolute path. */
/** What a relative tool path is resolved against; named in the rejection so the caller can fix it. */
export type PathBase = "working-directory" | "worktreePath";
export declare function confinedPath(value: string, parameter: string, base: PathBase): ConfinedPathResult;