import { CallToolResult } from "../../../../confluent/schema.js";
import { ToolCategory, ToolConfig } from "../../../../confluent/tools/base-tools.js";
import { ToolMetadataHandler } from "../../../../confluent/tools/tool-metadata-handler.js";
import { ServerRuntime } from "../../../../server-runtime.js";
/**
 * Config-coaching tool: given a tool name, returns the YAML each configured
 * connection is missing to enable it.
 *
 * Where {@link ExplainDisabledToolsHandler} answers "which tools are off and
 * why?" across the whole catalog, this tool inverts the question — "I want
 * *this* tool; what do I add to my config?" — and hands back a ready-to-paste
 * YAML fragment derived from the gap between the connection's current shape and
 * the tool's predicate requirement.
 *
 * The mechanism is the same verdict map every diagnostic surface reads:
 * {@link BaseToolHandler.connectionVerdicts} turns the target handler's
 * `predicate` into a per-connection `PredicateResult`; a disabled verdict
 * carries a {@link ToolDisabledReason}, which {@link adviceForReason} maps to
 * the YAML that closes that specific gap. The tool only suggests — it never
 * mutates config, and (per the issue's out-of-scope note) it assumes the
 * schema in `models.ts` keeps the suggested YAML valid rather than re-parsing
 * it.
 *
 * Always enabled (predicate = `alwaysEnabled`): an operator must be able to ask
 * how to fix a config that left the tool they want disabled.
 *
 * The tool catalog is supplied through the thunk that {@link
 * ToolMetadataHandler} owns, for the ESM-cycle reason documented there.
 */
export declare class ConfigHelpHandler extends ToolMetadataHandler {
    handle(runtime: ServerRuntime, toolArguments?: Record<string, unknown>): CallToolResult;
    getToolConfig(): ToolConfig;
    /**
     * Resolve a tool name (the `tools/list` string, i.e. a {@link ToolName}
     * enum *value*) to its handler. Linear scan over the catalog; the catalog is
     * small and this runs once per invocation.
     */
    private findHandler;
    readonly category = ToolCategory.McpServerDiagnostics;
    readonly predicate: import("../../../../confluent/tools/connection-predicates.js").ConnectionPredicate;
}
//# sourceMappingURL=config-help-handler.d.ts.map