refactor: no comments left - one-line module docstrings, contracts on public fields only; jobs/job.py; example config and README

src/beaver_gateway/agents/base.py

@@ -17,9 +17,8 @@ from pydantic import BaseModel, ConfigDict
 class ExposedMcp:
     """Reference to an ``McpServer`` (by name) exposed to a single agent.
 
-    ``tools`` is an allowlist of tool names (``None`` = every tool);
-    ``deny`` is a tuple of ``fnmatch`` patterns removed on top of that,
-    e.g. ``("delete_*",)``.
+    ``tools`` allowlists tool names (``None`` = all); ``deny`` removes
+    ``fnmatch`` patterns on top, e.g. ``("delete_*",)``.
     """
 
     name: str