import type { ToolAnnotations } from '@modelcontextprotocol/server';
import type { ToolEffects } from './types.js';
/** Protocol hints describe effects; they neither authorize calls nor enforce access. */
export declare function toToolAnnotations({ effect, idempotent, openWorld }: ToolEffects): ToolAnnotations;
/** Claude Code reads this tools/list `_meta` key to load a tool upfront when it defers MCP tools. */
export declare const ALWAYS_LOAD_META_KEY = "anthropic/alwaysLoad";
/** Claude Code adds this tools/list `_meta` text to tool search matching only; the model never sees it. */
export declare const SEARCH_HINT_META_KEY = "anthropic/searchHint";
/** Client loading and search hints advertised in a tool's `_meta`. */
export declare function toToolMeta({ alwaysLoad, searchHint, }: {
    alwaysLoad?: boolean;
    searchHint?: string;
}): Record<string, unknown> | undefined;