Merge branch 'develop' into 62-appify-the-demo

README.md

@@ -34,6 +34,7 @@ The app follows a layered architecture connecting the user, AI services, and rob
 ## Installation
 
 > [!IMPORTANT]
+> Before using this app, you need to install [Reachy Mini's SDK](https://github.com/pollen-robotics/reachy_mini/).<br>
 > Windows support is currently experimental and has not been extensively tested. Use with caution.
 
 ### Using uv
@@ -159,6 +160,15 @@ By default, the app runs in console mode for direct audio interaction. Use the `
   reachy-mini-conversation-app --no-camera
   ```
 
+### Troubleshooting
+
+- Timeout error:
+If you get an error like this:
+  ```bash
+  TimeoutError: Timeout while waiting for connection with the server.
+  ```
+It probably means that the Reachy Mini's daemon isn't running. Install [Reachy Mini's SDK](https://github.com/pollen-robotics/reachy_mini/) and start the daemon.
+
 ## LLM tools exposed to the assistant
 
 | Tool | Action | Dependencies |

src/reachy_mini_conversation_app/moves.py

@@ -723,13 +723,45 @@ class MovementManager:
         logger.debug("Move worker started")
 
     def stop(self) -> None:
-        """Request the worker thread to stop and wait for it to exit."""
+        """Request the worker thread to stop and wait for it to exit.
+
+        Before stopping, resets the robot to a neutral position.
+        """
+        if self._thread is None or not self._thread.is_alive():
+            logger.debug("Move worker not running; stop() ignored")
+            return
+
+        logger.info("Stopping movement manager and resetting to neutral position...")
+
+        # Clear any queued moves and stop current move
+        self.clear_move_queue()
+
+        # Stop the worker thread first so it doesn't interfere
         self._stop_event.set()
         if self._thread is not None:
             self._thread.join()
             self._thread = None
         logger.debug("Move worker stopped")
 
+        # Reset to neutral position using goto_target (same approach as wake_up)
+        try:
+            neutral_head_pose = create_head_pose(0, 0, 0, 0, 0, 0, degrees=True)
+            neutral_antennas = [0.0, 0.0]
+            neutral_body_yaw = 0.0
+
+            # Use goto_target directly on the robot
+            self.current_robot.goto_target(
+                head=neutral_head_pose,
+                antennas=neutral_antennas,
+                duration=2.0,
+                body_yaw=neutral_body_yaw,
+            )
+
+            logger.info("Reset to neutral position completed")
+
+        except Exception as e:
+            logger.error(f"Failed to reset to neutral position: {e}")
+
     def get_status(self) -> Dict[str, Any]:
         """Return a lightweight status snapshot for observability."""
         with self._status_lock: