/**
 * Automatically detects if a string is too long for shell argument limits.
 * If too long, writes it to a temp file and returns `@<path>`.
 * Otherwise, returns the original string.
 *
 * NOTE: Callers MUST clean up the temp file (unlinkSync) after use.
 * Temp files are written to os.tmpdir() with no automatic cleanup.
 *
 * Works well with tools that support @file syntax (like curl or custom pi tools).
 */
export declare function wrapLongArg(text: string): string;