/**
 * MCP Tool Registry
 *
 * Provides:
 * - createToolRegistry: Builds one validated source of truth for tool metadata.
 * - listRegisteredTools: Produces MCP list-tools output with complete annotations.
 * - getRegisteredTool: Resolves the sole handler and policy mapping for a tool.
 */
import type { PolicyRiskLevel } from "../core/policy/types.js";
/** MCP annotations used by Codex to reason about side effects. */
export interface ToolAnnotations {
    title: string;
    readOnlyHint: boolean;
    destructiveHint: boolean;
    idempotentHint: boolean;
    openWorldHint: boolean;
}
/** Minimal tool declaration accepted by the MCP SDK. */
export interface ToolDefinition {
    name: string;
    description: string;
    inputSchema: Record<string, unknown>;
    annotations?: Partial<ToolAnnotations>;
}
/** Context supplied by the MCP request adapter to registered handlers. */
export interface ToolExecutionContext<TResult> {
    dispatch: (name: string, args: Record<string, unknown>) => Promise<TResult>;
}
/** Complete internal contract for one listed and callable tool. */
export interface RegisteredTool<TResult = unknown> extends ToolDefinition {
    annotations: ToolAnnotations;
    policyAction: string;
    riskLevel: PolicyRiskLevel;
    handler: (args: Record<string, unknown>, context: ToolExecutionContext<TResult>) => Promise<TResult>;
}
/**
 * Builds and validates the complete MCP registry.
 *
 * @param definitions - Public tool declarations.
 * @returns Name-keyed registry with one fixed-name handler per declaration.
 */
export declare function createToolRegistry<TResult>(definitions: readonly ToolDefinition[]): ReadonlyMap<string, RegisteredTool<TResult>>;
/** Returns one registered tool or throws a stable unknown-tool error. */
export declare function getRegisteredTool<TResult>(registry: ReadonlyMap<string, RegisteredTool<TResult>>, name: string): RegisteredTool<TResult>;
/** Produces MCP list-tools output without internal handler/policy fields. */
export declare function listRegisteredTools<TResult>(registry: ReadonlyMap<string, RegisteredTool<TResult>>): ToolDefinition[];
//# sourceMappingURL=tool-registry.d.ts.map