import { z } from "zod";
/**
 * Generic ToolRegistry — track registered tools by category.
 *
 * Each MCP server declares its own category const array (typed),
 * passes a category resolver, and uses this registry to decide
 * which tools to actually load on `server.tool()` based on env-driven
 * allowlist/denylist.
 */
export interface ToolEntry<TCategory extends string> {
    name: string;
    description: string;
    category: TCategory;
}
export interface RegistryConfig {
    /** Allowlist categories (when set, only these load). */
    enabledCategories?: string[] | null;
    /** Denylist categories (ignored when enabledCategories is set). */
    disabledCategories?: string[] | null;
    /** Categories that are always enabled regardless of toggles. */
    alwaysEnabled?: string[];
}
export declare class ToolRegistry<TCategory extends string = string> {
    private cfg;
    private tools;
    private alwaysEnabled;
    constructor(cfg?: RegistryConfig);
    register(name: string, description: string, category: TCategory): boolean;
    isEnabled(category: TCategory): boolean;
    list(): ToolEntry<TCategory>[];
    search(query: string, category?: string, limit?: number): ToolEntry<TCategory>[];
    summary(allCategories: readonly TCategory[]): {
        total: number;
        enabledCategories: TCategory[];
        categoryBreakdown: {
            [k: string]: number;
        };
    };
}
/**
 * Factory for the `search-tools` meta-tool schema + handler.
 * Pass the registry and the categories array; receive a `{schema, handler}` pair
 * that can be registered with `server.tool(name, description, schema.shape, handler)`.
 */
export declare function createSearchToolsMetaTool<TCategory extends string>(registry: ToolRegistry<TCategory>, categories: readonly TCategory[], hint?: string): {
    schema: z.ZodObject<{
        query: z.ZodString;
        category: z.ZodOptional<z.ZodEnum<{
            [x: string]: string;
        }>>;
        limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
    }, z.core.$strip>;
    handler: (params: z.infer<z.ZodObject<{
        query: z.ZodString;
        category: z.ZodOptional<z.ZodEnum<{
            [x: string]: string;
        }>>;
        limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
    }, z.core.$strip>>) => Promise<{
        query: string;
        matchCount: number;
        summary: {
            total: number;
            enabledCategories: TCategory[];
            categoryBreakdown: {
                [k: string]: number;
            };
        };
        matches: {
            name: string;
            description: string;
            category: TCategory;
        }[];
    }>;
};
/**
 * Parse a comma-separated env var into a lowercase string array, or null when unset.
 * Used for `<PREFIX>_TOOLS` and `<PREFIX>_DISABLE` env vars.
 */
export declare function parseEnvList(raw: string | undefined): string[] | null;
//# sourceMappingURL=registry.d.ts.map