Update README.md

README.md

@@ -73,25 +73,33 @@ This project follows a decoupled client-server architecture, where the model and
 
 ## 🚀 How to Use
 
-Interact with the API by making HTTP requests to its endpoints.
+Interact with the API by making HTTP requests to its endpoints. The typical workflow is to start a session, run steps in a loop, and then end the session.
 
 ### 1. Start a New Session
 This will initialize a new set of tracker and controller instances on the server.
+
+**Request:**
 ```bash
 curl -X POST "https://adam-it-baseer-server.hf.space/start_session"
 ```
 
-Response: `{"session_id": "your-new-session-id"}`
+**Example Response:**
+```json
+{
+  "session_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
+}
+```
 
 ### 2. Run a Simulation Step
 
-Send the current camera view and vehicle measurements to be processed.
+Send the current camera view and vehicle measurements to be processed. The API will return control commands and a full analysis.
 
+**Request:**
 ```bash
 curl -X POST "https://adam-it-baseer-server.hf.space/run_step" \
   -H "Content-Type: application/json" \
   -d '{
-    "session_id": "your-new-session-id",
+    "session_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
     "image_b64": "your-base64-encoded-bgr-image-string",
     "measurements": {
       "pos_global": [105.0, -20.0],
@@ -102,12 +110,57 @@ curl -X POST "https://adam-it-baseer-server.hf.space/run_step" \
   }'
 ```
 
+**Example Response:**
+```json
+{
+  "control_commands": {
+    "steer": 0.05,
+    "throttle": 0.6,
+    "brake": false
+  },
+  "scene_analysis": {
+    "is_junction": 0.02,
+    "traffic_light_state": 0.95,
+    "stop_sign": 0.01
+  },
+  "predicted_waypoints": [
+    [1.0, 0.05],
+    [2.0, 0.06],
+    [3.0, 0.07],
+    [4.0, 0.07],
+    [5.0, 0.08],
+    [6.0, 0.08],
+    [7.0, 0.09],
+    [8.0, 0.09],
+    [9.0, 0.10],
+    [10.0, 0.10]
+  ],
+  "dashboard_b64": "a-very-long-base64-string-representing-the-dashboard-image...",
+  "reason": "Red Light"
+}
+```
+
+**Response Fields:**
+- **`control_commands`**: The final commands to be applied to the vehicle.
+- **`scene_analysis`**: Probabilities for different road hazards. A high `traffic_light_state` value (e.g., > 0.5) indicates a red light.
+- **`predicted_waypoints`**: The model's intended path, relative to the vehicle.
+- **`dashboard_b64`**: A Base64-encoded JPEG image of the full dashboard view, which can be directly displayed in a client application.
+- **`reason`**: A human-readable string explaining the primary reason for the control action (e.g., "Following ID 12", "Red Light", "Cruising").
+
 ### 3. End the Session
 
 This will clean up the session data from the server.
 
+**Request:**
 ```bash
-curl -X POST "https://adam-it-baseer-server.hf.space/end_session?session_id=your-new-session-id"
+curl -X POST "https://adam-it-baseer-server.hf.space/end_session?session_id=a1b2c3d4-e5f6-7890-1234-567890abcdef"
+```
+
+**Example Response:**
+```json
+{
+  "message": "Session a1b2c3d4-e5f6-7890-1234-567890abcdef ended."
+}
 ```
 
 ---