/**
 * @license
 * Copyright 2025 Vybestack LLC
 * SPDX-License-Identifier: Apache-2.0
 */
import type { Config } from '../config/config.js';
/**
 * Collects LSP diagnostics for a file and formats them for LLM consumption.
 *
 * @plan PLAN-20250212-LSP.P31
 * @requirement REQ-DIAG-010
 *
 * This helper:
 * - Checks if LSP client is alive
 * - Calls checkFile() with a timeout to prevent hangs
 * - Filters diagnostics by configured severities
 * - Limits diagnostics per maxDiagnosticsPerFile
 * - Formats with <diagnostics> XML tags
 * - Returns null if no diagnostics or LSP unavailable
 *
 * The caller should wrap this in try-catch to satisfy REQ-GRACE-050/055.
 *
 * @param config - The Config instance to get LSP client and settings
 * @param absolutePath - The absolute path of the file to check
 * @returns Formatted diagnostics block or null if none
 */
export declare function collectLspDiagnosticsBlock(config: Config, absolutePath: string): Promise<string | null>;