Enforce agent manager helper boundaries

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

CONTRIBUTING.md

@@ -77,6 +77,7 @@ This runs lint, format checks, compile checks, tests, and package build.
 - Prefer deterministic unit tests over network-dependent tests.
 - Preserve architectural guardrails with focused tests. Current guard suites include:
   - `tests/test_agent_examples_coverage.py` (agent task example coverage enforcement),
+  - `tests/test_agent_helper_boundary.py` (agent manager boundary enforcement for shared request/response helpers),
   - `tests/test_agent_operation_metadata_usage.py` (shared agent operation-metadata usage enforcement),
   - `tests/test_agent_payload_helper_usage.py` (shared agent start-payload helper usage enforcement),
   - `tests/test_agent_start_helper_usage.py` (shared agent start-request helper usage enforcement),

tests/test_agent_helper_boundary.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.architecture
+
+
+AGENT_MANAGER_DIRS = (
+    Path("hyperbrowser/client/managers/sync_manager/agents"),
+    Path("hyperbrowser/client/managers/async_manager/agents"),
+)
+
+
+def test_agent_managers_use_shared_helper_boundaries():
+    violating_modules: list[str] = []
+    for base_dir in AGENT_MANAGER_DIRS:
+        for module_path in sorted(base_dir.glob("*.py")):
+            if module_path.name == "__init__.py":
+                continue
+            module_text = module_path.read_text(encoding="utf-8")
+            if (
+                "_client.transport.get(" in module_text
+                or "_client.transport.post(" in module_text
+                or "_client.transport.put(" in module_text
+                or "parse_response_model(" in module_text
+            ):
+                violating_modules.append(module_path.as_posix())
+
+    assert violating_modules == []

tests/test_architecture_marker_usage.py

@@ -7,6 +7,7 @@
 
 ARCHITECTURE_GUARD_MODULES = (
     "tests/test_agent_examples_coverage.py",
+    "tests/test_agent_helper_boundary.py",
     "tests/test_agent_operation_metadata_usage.py",
     "tests/test_agent_payload_helper_usage.py",
     "tests/test_agent_start_helper_usage.py",