/** * Tool Annotation Assessor * Verifies MCP tools have proper annotations per Policy #17 * * Checks: * - readOnlyHint presence and accuracy * - destructiveHint presence and accuracy * - Tool behavior inference from name patterns * - Annotation misalignment detection * - Description poisoning detection (Issue #8) * * Reference: Anthropic MCP Directory Policy #17 * * This module orchestrates annotation assessment by coordinating: * - BehaviorInference: Infers expected behavior from tool names * - AnnotationDeceptionDetector: Detects keyword-based misalignments * - DescriptionPoisoningDetector: Detects malicious content in descriptions * * Refactored in Issue #105 to delegate to extracted helper modules: * - AlignmentChecker: Tool alignment assessment and metrics * - ExplanationGenerator: Explanation and recommendation generation * - EventEmitter: Progress event emission * - ClaudeIntegration: Claude-enhanced behavior inference */ import { BaseAssessor } from "./BaseAssessor.js"; import { AssessmentContext } from "../AssessmentOrchestrator.js"; import type { ToolAnnotationAssessment, AssessmentConfiguration } from "../../../lib/assessmentTypes.js"; import type { ClaudeCodeBridge } from "../lib/claudeCodeBridge.js"; import { type CompiledPatterns, type ServerPersistenceContext } from "../config/annotationPatterns.js"; import { type EnhancedToolAnnotationResult } from "./annotations/index.js"; /** * Enhanced tool annotation result with Claude inference * Re-exported for backwards compatibility */ export { EnhancedToolAnnotationResult }; /** * Enhanced assessment with Claude integration */ export interface EnhancedToolAnnotationAssessment extends ToolAnnotationAssessment { toolResults: EnhancedToolAnnotationResult[]; claudeEnhanced: boolean; highConfidenceMisalignments: EnhancedToolAnnotationResult[]; } export declare class ToolAnnotationAssessor extends BaseAssessor { private claudeBridge?; private compiledPatterns; private persistenceContext?; constructor(config: AssessmentConfiguration); /** * Get the detected persistence context (for testing/debugging) */ getPersistenceContext(): ServerPersistenceContext | undefined; /** * Set custom compiled patterns for behavior inference */ setPatterns(patterns: CompiledPatterns): void; /** * Set Claude Code Bridge for enhanced behavior inference */ setClaudeBridge(bridge: ClaudeCodeBridge): void; /** * Check if Claude enhancement is available */ isClaudeEnabled(): boolean; /** * Run tool annotation assessment */ assess(context: AssessmentContext): Promise; } //# sourceMappingURL=ToolAnnotationAssessor.d.ts.map