/**
 * Tool Metadata Contract & Validation
 *
 * Provides Zod-based validation for tool metadata.
 */
import { z } from 'zod';
import { Result } from './core.js';
/**
 * Tool Metadata Schema
 *
 * All tools must specify whether they use knowledge enhancement.
 * @internal - Only used internally for validation
 */
declare const ToolMetadataSchema: z.ZodObject<{
    /** Whether this tool uses knowledge enhancement (required) */
    knowledgeEnhanced: z.ZodBoolean;
}, "strip", z.ZodTypeAny, {
    knowledgeEnhanced: boolean;
}, {
    knowledgeEnhanced: boolean;
}>;
export type ToolMetadata = z.infer<typeof ToolMetadataSchema>;
/**
 * Interface for tool validation that includes all necessary properties
 */
export interface ValidatableTool {
    name: string;
    metadata: ToolMetadata;
}
/**
 * Interface for comprehensive validation report
 */
export interface ValidationReport {
    summary: {
        totalTools: number;
        validTools: number;
        invalidTools: number;
        compliancePercentage: number;
    };
    validTools: string[];
    invalidTools: Array<{
        name: string;
        issues: string[];
        suggestions: string[];
    }>;
    metadataErrors: Array<{
        name: string;
        error: string;
    }>;
}
/**
 * Validates all tool metadata and returns comprehensive report
 * Centralized validation logic for use by CLI commands
 */
export declare function validateAllToolMetadata(tools: ValidatableTool[]): Promise<Result<ValidationReport>>;
export {};
//# sourceMappingURL=tool-metadata.d.ts.map