fix: Add missing run.sh script for x402 sample

samples/python/scenarios/a2a/human-present/x402/README.md

@@ -66,7 +66,7 @@ GOOGLE_API_KEY variable in one of two ways.
 You can execute the following command to run all of the steps in one terminal:
 
 ```sh
-samples/python/scenarios/a2a/human-present/cards/run.sh --payment-method x402
+samples/python/scenarios/a2a/human-present/x402/run.sh
 ```
 
 Or you can run each server in its own terminal (ensure `PAYMENT_METHOD=x402` is set for all processes):

samples/python/scenarios/a2a/human-present/x402/run.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+
+# A script to automate the execution of the x402 payment example.
+# It starts all necessary servers and agents in the background,
+# and then runs the client.
+
+# Exit immediately if any command exits with a non-zero status.
+set -e
+
+# Default payment method
+PAYMENT_METHOD="X402"
+
+# Parse command-line arguments
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --payment-method) PAYMENT_METHOD="${2:?--payment-method requires an argument}"; shift ;;
+        *) echo "Unknown parameter passed: \"$1\""; exit 1 ;;
+    esac
+    shift
+done
+
+export PAYMENT_METHOD
+
+# The directory containing the agents.
+AGENTS_DIR="samples/python/src/roles"
+# A directory to store logs.
+LOG_DIR=".logs"
+
+if [ ! -d "$AGENTS_DIR" ]; then
+  echo "Error: Directory '$AGENTS_DIR' not found."
+  echo "Please run this script from the root of the repository."
+  exit 1
+fi
+
+if [ -f .env ]; then
+  set -a
+  source .env
+  set +a
+fi
+
+USE_VERTEXAI=$(printf "%s" "${GOOGLE_GENAI_USE_VERTEXAI}" | tr '[:upper:]' '[:lower:]')
+if [ -z "${GOOGLE_API_KEY}" ] && [ "${USE_VERTEXAI}" != "true" ]; then
+  echo "Please set your GOOGLE_API_KEY environment variable before running."
+  echo "Alternatively, set GOOGLE_GENAI_USE_VERTEXAI=true to use Vertex AI with ADC."
+  exit 1
+fi
+
+# Set up and activate a virtual environment.
+echo "Setting up the Python virtual environment..."
+
+if [ ! -d ".venv" ]; then
+  uv venv
+fi
+
+# Detect the correct activation script path based on the operating system
+case "$OSTYPE" in
+  msys* | cygwin*)
+    # Windows (Git Bash, MSYS2, or Cygwin)
+    source .venv/Scripts/activate
+    ;;
+  *)
+    # Unix/Linux/macOS
+    source .venv/bin/activate
+    ;;
+esac
+echo "Virtual environment activated."
+
+echo "Installing project in editable mode..."
+uv pip install -e .
+
+# Create a directory for log files.
+mkdir -p "$LOG_DIR"
+
+# This function is called automatically when the script exits (for any reason)
+# to ensure all background processes are terminated.
+cleanup() {
+  echo ""
+  echo "Shutting down background processes..."
+  if [ ${#pids[@]} -ne 0 ]; then
+    # Kill all processes using their PIDs stored in the array.
+    # The 2>/dev/null suppresses "Terminated" messages or errors if a process is already gone.
+    kill "${pids[@]}" 2>/dev/null
+    wait "${pids[@]}" 2>/dev/null
+  fi
+  echo "Cleanup complete."
+}
+
+# Trap the EXIT signal to call the cleanup function. This ensures cleanup
+# runs whether the script finishes successfully, fails, or is interrupted.
+trap cleanup EXIT
+
+# Explicitly sync to ensures the virtual environment is up to date.
+echo "Syncing virtual environment with uv sync..."
+if uv sync --package ap2-samples; then
+  echo "Virtual environment synced successfully."
+else
+  echo "Error: uv sync failed. Aborting deployment."
+  exit 1
+fi
+
+# Clear old logs.
+echo "Clearing the logs directory..."
+if [ -d "$LOG_DIR" ]; then
+  rm -f "$LOG_DIR"/*
+fi
+
+# Start all the remote agents & servers.
+pids=()
+
+echo ""
+echo "Starting remote servers and agents as background processes..."
+
+# uv sync is explicitly run before starting any agents.
+# Prevent servers starting in parallel from colliding by trying to sync again.
+UV_RUN_CMD="uv run --no-sync"
+
+if [ -f ".env" ]; then
+  UV_RUN_CMD="$UV_RUN_CMD --env-file .env"
+fi
+
+echo "-> Starting the Merchant Agent (port:8001 log:$LOG_DIR/merchant_agent.log)..."
+$UV_RUN_CMD --package ap2-samples python -m roles.merchant_agent >"$LOG_DIR/merchant_agent.log" 2>&1 &
+pids+=($!)
+
+echo "-> Starting the Credentials Provider (port:8002 log:$LOG_DIR/credentials_provider_agent.log)..."
+$UV_RUN_CMD --package ap2-samples python -m roles.credentials_provider_agent >"$LOG_DIR/credentials_provider_agent.log" 2>&1 &
+pids+=($!)
+
+echo "-> Starting the Card Processor Agent (port:8003 log:$LOG_DIR/mpp_agent.log)..."
+$UV_RUN_CMD --package ap2-samples python -m roles.merchant_payment_processor_agent >"$LOG_DIR/mpp_agent.log" 2>&1 &
+pids+=($!)
+
+echo ""
+echo "All remote servers are starting."
+
+echo "Starting the Shopping Agent..."
+$UV_RUN_CMD --package ap2-samples adk web --host 0.0.0.0 "$AGENTS_DIR"