fix(ci): tutorial tests look for heavy wheel at adk/dist/, pass both wheels to uv

The tutorial test workflow boots an agentex agent via `uv run --with <wheel>
agentex agents run ...`. After the package split:

- The slim `agentex_sdk_client-*.whl` ships from `dist/` (root)
- The heavy `agentex_sdk-*.whl` (which provides the `agentex` CLI) now
  ships from `adk/dist/`

Old workflow ran `uv build` at root (produces slim only) and the script
hunted for `dist/agentex_sdk-*.whl` (heavy) — which doesn't exist there
anymore. CI saw "❌ No built wheel found in dist/agentex_sdk-*.whl".

Also: heavy pins `agentex-sdk-client>=0.11.4,<0.12` as a runtime dep, and
the slim isn't on PyPI yet, so uv must resolve the slim from the LOCAL
wheel too. Single `--with` isn't enough; need both.

Fixes:
- `.github/workflows/agentex-tutorials-test.yml`: build both packages
  in the "Build AgentEx SDK" step.
- `examples/tutorials/run_agent_test.sh`: three sites (agent run, pytest
  invocation, check_built_wheel) now find both wheels at their new paths
  (slim at `dist/agentex_sdk_client-*.whl`, heavy at
  `adk/dist/agentex_sdk-*.whl`) and pass both to `uv run --with`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: max-parke-scale

.github/workflows/agentex-tutorials-test.yml

@@ -124,10 +124,13 @@ jobs:
 
       - name: Build AgentEx SDK
         run: |
-          echo "🔨 Building AgentEx SDK wheel..."
-          uv build
-          echo "✅ SDK built successfully"
+          echo "🔨 Building slim agentex-sdk-client wheel (root)..."
+          uv build --wheel
+          echo "🔨 Building heavy agentex-sdk wheel (adk/)..."
+          (cd adk && uv build --wheel)
+          echo "✅ Both SDK wheels built successfully"
           ls -la dist/
+          ls -la adk/dist/
 
       - name: Test Tutorial
         id: run-test

examples/tutorials/run_agent_test.sh

@@ -126,18 +126,26 @@ start_agent() {
 
     if [ "$BUILD_CLI" = true ]; then
 
-        # Use wheel from dist directory at repo root
-        local wheel_file=$(ls /home/runner/work/*/*/dist/agentex_sdk-*.whl 2>/dev/null | head -n1)
-        if [[ -z "$wheel_file" ]]; then
-            echo -e "${RED}❌ No built wheel found in dist/agentex_sdk-*.whl${NC}"
-            echo -e "${YELLOW}💡 Please build the local SDK first by running: uv build${NC}"
-            echo -e "${YELLOW}💡 From the repo root directory${NC}"
+        # Heavy ADK wheel ships from adk/dist/; slim client wheel ships from dist/.
+        # We need both: heavy pins agentex-sdk-client which isn't on PyPI yet,
+        # so uv must resolve both from local wheels rather than the registry.
+        local heavy_wheel=$(ls /home/runner/work/*/*/adk/dist/agentex_sdk-*.whl 2>/dev/null | head -n1)
+        local slim_wheel=$(ls /home/runner/work/*/*/dist/agentex_sdk_client-*.whl 2>/dev/null | head -n1)
+        if [[ -z "$heavy_wheel" ]]; then
+            echo -e "${RED}❌ No built heavy wheel found in adk/dist/agentex_sdk-*.whl${NC}"
+            echo -e "${YELLOW}💡 Build it first: (cd adk && uv build --wheel)${NC}"
+            cd "$original_dir"
+            return 1
+        fi
+        if [[ -z "$slim_wheel" ]]; then
+            echo -e "${RED}❌ No built slim wheel found in dist/agentex_sdk_client-*.whl${NC}"
+            echo -e "${YELLOW}💡 Build it first: uv build --wheel${NC}"
             cd "$original_dir"
             return 1
         fi
 
-        # Use the built wheel
-        uv run --with "$wheel_file" agentex agents run --manifest "$manifest_path" > "$logfile" 2>&1 &
+        # Pass both wheels so the local heavy resolves its slim dep locally
+        uv run --with "$heavy_wheel" --with "$slim_wheel" agentex agents run --manifest "$manifest_path" > "$logfile" 2>&1 &
     else
         uv run agentex agents run --manifest manifest.yaml > "$logfile" 2>&1 &
     fi
@@ -269,13 +277,17 @@ run_test() {
     # 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)
+        local heavy_wheel slim_wheel
+        heavy_wheel=$(ls /home/runner/work/*/*/adk/dist/agentex_sdk-*.whl 2>/dev/null | head -n1)
+        if [[ -z "$heavy_wheel" ]]; then
+            heavy_wheel=$(ls "${SCRIPT_DIR}/../../adk/dist/agentex_sdk-*.whl" 2>/dev/null | head -n1)
+        fi
+        slim_wheel=$(ls /home/runner/work/*/*/dist/agentex_sdk_client-*.whl 2>/dev/null | head -n1)
+        if [[ -z "$slim_wheel" ]]; then
+            slim_wheel=$(ls "${SCRIPT_DIR}/../../dist/agentex_sdk_client-*.whl" 2>/dev/null | head -n1)
         fi
-        if [[ -n "$wheel_file" ]]; then
-            pytest_cmd=("uv" "run" "--with" "$wheel_file" "--with" "pytest" "--with" "pytest-asyncio" "pytest")
+        if [[ -n "$heavy_wheel" && -n "$slim_wheel" ]]; then
+            pytest_cmd=("uv" "run" "--with" "$heavy_wheel" "--with" "$slim_wheel" "--with" "pytest" "--with" "pytest-asyncio" "pytest")
         fi
     fi
 
@@ -350,7 +362,7 @@ execute_tutorial_test() {
     fi
 }
 
-# Function to check if built wheel is available
+# Function to check if both built wheels are available
 check_built_wheel() {
 
     # Navigate to the repo root (two levels up from examples/tutorials)
@@ -362,19 +374,26 @@ check_built_wheel() {
         return 1
     }
 
-    # Check if wheel exists in dist directory at repo root
-    local wheel_file=$(ls /home/runner/work/*/*/dist/agentex_sdk-*.whl 2>/dev/null | head -n1)
-    if [[ -z "$wheel_file" ]]; then
-        echo -e "${RED}❌ No built wheel found in dist/agentex_sdk-*.whl${NC}"
-        echo -e "${YELLOW}💡 Please build the local SDK first by running: uv build${NC}"
-        echo -e "${YELLOW}💡 From the repo root directory${NC}"
+    # Heavy ADK wheel + slim client wheel — we need both because heavy pins
+    # agentex-sdk-client which isn't on PyPI yet.
+    local heavy_wheel=$(ls /home/runner/work/*/*/adk/dist/agentex_sdk-*.whl 2>/dev/null | head -n1)
+    local slim_wheel=$(ls /home/runner/work/*/*/dist/agentex_sdk_client-*.whl 2>/dev/null | head -n1)
+    if [[ -z "$heavy_wheel" ]]; then
+        echo -e "${RED}❌ No built heavy wheel found in adk/dist/agentex_sdk-*.whl${NC}"
+        echo -e "${YELLOW}💡 Build it first: (cd adk && uv build --wheel)${NC}"
+        cd "$original_dir"
+        return 1
+    fi
+    if [[ -z "$slim_wheel" ]]; then
+        echo -e "${RED}❌ No built slim wheel found in dist/agentex_sdk_client-*.whl${NC}"
+        echo -e "${YELLOW}💡 Build it first: uv build --wheel${NC}"
         cd "$original_dir"
         return 1
     fi
 
-    # Test the wheel by running agentex --help
-    if ! uv run --with "$wheel_file" agentex --help >/dev/null 2>&1; then
-        echo -e "${RED}❌ Failed to run agentex with built wheel${NC}"
+    # Test the heavy wheel by running agentex --help (uses both wheels for resolution)
+    if ! uv run --with "$heavy_wheel" --with "$slim_wheel" agentex --help >/dev/null 2>&1; then
+        echo -e "${RED}❌ Failed to run agentex with built wheels${NC}"
         cd "$original_dir"
         return 1
     fi