/**
 * MCP Prompt/Response Hook Handlers - Wave 2 of T5237
 *
 * Handlers for onPromptSubmit, onResponseComplete, and system Notification
 * events that capture ALL gateway operations (read and write) to BRAIN.
 * By default, NO brain capture (too noisy). Enable via:
 *   - Config: brain.captureMcp = true  (checked first)
 *   - Env:    CLEO_BRAIN_CAPTURE_MCP=true  (overrides config)
 * Auto-registers on module load.
 *
 * Note: File-change Notification events (those with filePath + changeType) are
 * handled by file-hooks.ts. This module handles message-bearing system
 * notifications (Notification payloads with a message field).
 *
 * @task T166
 */
import type { NotificationPayload, PromptSubmitPayload, ResponseCompletePayload } from '../types.js';
/**
 * Handle PromptSubmit - optionally capture ALL gateway prompt events to BRAIN.
 *
 * No-op by default. Enable via brain.captureMcp config or CLEO_BRAIN_CAPTURE_MCP env.
 * For selective mutation-only capture, use work-capture-hooks.ts instead.
 */
export declare function handlePromptSubmit(projectRoot: string, payload: PromptSubmitPayload): Promise<void>;
/**
 * Handle ResponseComplete - optionally capture ALL gateway response events to BRAIN.
 *
 * No-op by default. Enable via brain.captureMcp config or CLEO_BRAIN_CAPTURE_MCP env.
 * For selective mutation-only capture, use work-capture-hooks.ts instead.
 */
export declare function handleResponseComplete(projectRoot: string, payload: ResponseCompletePayload): Promise<void>;
/**
 * Handle Notification — capture system notifications as BRAIN observations.
 *
 * Only fires for Notification payloads that carry a message field (i.e. system
 * notifications). File-change notifications (filePath + changeType) are
 * handled exclusively by file-hooks.ts and are skipped here to avoid
 * double-capture.
 *
 * Gated behind brain.autoCapture config. Never throws.
 *
 * @param projectRoot - Absolute path to the project root directory.
 * @param payload     - Notification event payload.
 *
 * @task T166
 */
export declare function handleSystemNotification(projectRoot: string, payload: NotificationPayload): Promise<void>;
//# sourceMappingURL=mcp-hooks.d.ts.map