/**
 * Handle paths, supporting ~ expansion
 * @param filePath File path
 * @param workdir Working directory
 * @returns Resolved absolute path
 */
export declare function resolvePath(filePath: string, workdir: string): string;
/**
 * Get relative path for display, use relative path if shorter and not in parent directory.
 *
 * The returned path is always normalized to forward slashes (posix) regardless of
 * platform. This keeps display output consistent across Windows/Unix so that logs,
 * LLM context, and tests don't need platform-specific branches — `path.relative`
 * and `path.join` produce backslashes on Windows, which we collapse here.
 *
 * @param filePath Absolute path
 * @param workdir Working directory
 * @returns Path for display (relative or absolute), always forward-slash
 */
export declare function getDisplayPath(filePath: string, workdir: string): string;
/**
 * Convert backslashes to forward slashes for shell compatibility on Windows.
 * On Windows, os.tmpdir() returns paths with backslashes (e.g., C:\Users\foo\Temp),
 * which are treated as escape characters when interpolated into shell command strings.
 * Returns the path as-is on non-Windows platforms.
 */
export declare function toPosixPath(p: string): string;