import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
import type { ServerRequest, ServerNotification } from "@modelcontextprotocol/sdk/types.js";
/** Shorthand for the extra parameter that every tool handler receives. */
export type ToolExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
export declare function clampRadius(value: number): number;
/**
 * Send a progress notification if the client requested one (via progressToken).
 * No-op when the client didn't ask for progress — safe to call unconditionally.
 */
export declare function sendProgress(extra: ToolExtra, progress: number, total: number, message?: string): Promise<void>;
/** Send an info-level log message to the client. */
export declare function logInfo(extra: ToolExtra, data: string): Promise<void>;