/**
 * Rich errors and MCP tool error payloads so clients can show actionable messages
 * (missing paths, storage permissions, errno hints).
 */
/** Error with structured `context` for MCP JSON responses */
export declare class ContextualError extends Error {
    readonly context: Record<string, unknown>;
    constructor(message: string, context: Record<string, unknown>, cause?: Error);
}
export declare function getErrnoCode(err: unknown): string | undefined;
/**
 * Ensure audit `path` exists and is a file or directory; otherwise throw ContextualError.
 */
export declare function assertAuditPathExists(auditPath: string): Promise<{
    isFile: boolean;
}>;
/**
 * Shape returned as JSON in MCP CallTool error content.
 */
export declare function formatMcpToolErrorPayload(tool: string, error: unknown): Record<string, unknown>;
//# sourceMappingURL=mcpToolErrors.d.ts.map