fix(tutorials): restore tutorial CI deps after agentex-sdk 0.11.5 (pytest + debugpy) (#379)

Author: smoreinis

examples/tutorials/run_agent_test.sh

@@ -259,16 +259,23 @@ run_test() {
     cd "$tutorial_path" || return 1
 
 
-    # Run the tests with retry mechanism
-    local -a pytest_cmd=("uv" "run" "pytest")
+    # Run the tests with retry mechanism.
+    #
+    # pytest is brought in explicitly via --with: the tutorials only list it
+    # under an optional `dev` extra (which `uv run` does not install), and it
+    # used to be pulled in transitively by agentex-sdk's runtime deps. Once
+    # agentex-sdk 0.11.5 dropped pytest as a runtime dep, `uv run pytest` could
+    # no longer find it ("Failed to spawn: pytest"). Requesting it directly is
+    # robust across all tutorials regardless of how each declares test deps.
+    local -a pytest_cmd=("uv" "run" "--with" "pytest" "--with" "pytest-asyncio" "pytest")
     if [ "$BUILD_CLI" = true ]; then
         local wheel_file
         wheel_file=$(ls /home/runner/work/*/*/dist/agentex_sdk-*.whl 2>/dev/null | head -n1)
         if [[ -z "$wheel_file" ]]; then
             wheel_file=$(ls "${SCRIPT_DIR}/../../dist/agentex_sdk-*.whl" 2>/dev/null | head -n1)
         fi
         if [[ -n "$wheel_file" ]]; then
-            pytest_cmd=("uv" "run" "--with" "$wheel_file" "pytest")
+            pytest_cmd=("uv" "run" "--with" "$wheel_file" "--with" "pytest" "--with" "pytest-asyncio" "pytest")
         fi
     fi
 

src/agentex/lib/utils/debug.py

@@ -6,8 +6,6 @@
 
 import os
 
-import debugpy  # type: ignore
-
 from agentex.lib.utils.logging import make_logger
 
 logger = make_logger(__name__)
@@ -30,6 +28,13 @@ def setup_debug_if_enabled() -> None:
         Any exception from debugpy setup (will bubble up naturally)
     """
     if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
+        # Imported lazily: debugpy is a development-only tool, so a normal
+        # worker startup must not require it to be installed.  Importing it at
+        # module scope forced it onto every worker (it used to be satisfied
+        # transitively via ipykernel; that dep was dropped in agentex-sdk
+        # 0.11.5, surfacing this as "No module named 'debugpy'").
+        import debugpy  # type: ignore
+
         debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5678"))
         debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "worker")
         wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"