refactor: optimize error handling patterns

[tofarr]

• Add consistent error handling decorators for each module type
• Create base OpenHandsError class for standardized exceptions
• Improve error messages and logging
• Add proper type hints
• Reduce code duplication in error handling

Using OpenHands to DRY up the codebase

• Include this change in the Release Notes. If checked, you must provide an end-user friendly description for your change below

---

This was written by OpenHands in response to the prompt:

The directory OpenHands/openhands contains python packages and modules where much of the error handling uses a syntax that is more verbose than necessary. For example, different exception types are handled using the exact same code repeated. Please find instances of this and replace them with the shorter syntax.

I'm pretty sure it did not hit every file - maybe I need to go through package by package.

---

Link of any specific issues this addresses

---

To run this PR locally, use the following command:

docker run -it --rm   -p 3000:3000   -v /var/run/docker.sock:/var/run/docker.sock   --add-host host.docker.internal:host-gateway   -e SANDBOX_RUNTIME_CONTAINER_IMAGE=ghcr.io/all-hands-ai/runtime:7f658c3-nikolaik   --name openhands-app-7f658c3   ghcr.io/all-hands-ai/runtime:7f658c3