export interface RunGoBinaryOptions {
    /** Arguments to pass to the binary */
    args?: string[];
    /** Working directory for the process */
    cwd?: string;
    /** Environment variables to pass to the process */
    env?: Record<string, string>;
    /** Forward stdout/stderr to parent process while capturing (default: true) */
    forwardOutput?: boolean;
    /** Maximum stderr buffer size in bytes (default: 1MB) */
    maxStderrSize?: number;
    /** Maximum stdout buffer size in bytes (default: 10MB) */
    maxStdoutSize?: number;
    /** Timeout in milliseconds (default: 5 minutes) */
    timeout?: number;
}
export interface GoBinaryResult<T = unknown> {
    /** Parsed JSON output */
    data: T;
    /** Execution time in milliseconds */
    executionTime: number;
    /** Exit code */
    exitCode: number;
    /** Raw stderr content */
    stderr: string;
    /** Raw stdout content */
    stdout: string;
}
/**
 * Error thrown when a Go binary execution fails.
 */
export declare class GoBinaryError extends Error {
    readonly code: string;
    readonly exitCode?: number;
    readonly stdout?: string;
    readonly stderr?: string;
    constructor(message: string, code: string, exitCode?: number, stdout?: string, stderr?: string);
}
export declare function runGoBinary<T = unknown>(binaryPath: string, options?: RunGoBinaryOptions): Promise<GoBinaryResult<T>>;