chore: Improve default error handling

[Alexj9837]

Fixes #1379
Fixes #1409

Both issues related to error handling in the REST client.

1379 - Catches 'UnauthorisedAccessErrorexplicitly instead of string-matching onBlueskyRemoteControlError`.

1409 - Expands the exception hierarchy so each
HTTP status code raises a distinct typed exception rather than bundling
everything into BlueskyRemoteControlError.
Tests

Update tests to match new exception signatures
Add missing coverage for 422 non-list detail response
Add missing coverage for streaming error in run command

[codecov]

Codecov Report

❌ Patch coverage is 87.17949% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.22%. Comparing base (af06958) to head (5281e75).

Files with missing lines	Patch %	Lines
src/blueapi/client/rest.py	84.00%	4 Missing ⚠️
src/blueapi/client/client.py	80.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1491      +/-   ##
==========================================
- Coverage   95.27%   95.22%   -0.05%     
==========================================
  Files          43       43              
  Lines        3173     3184      +11     
==========================================
+ Hits         3023     3032       +9     
- Misses        150      152       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[tpoliaw]

It wasn't mentioned in the original issue but the controller env -r code path doesn't seem to be catching the same errors.

$ uv run blueapi controller env -r

Reloading environment
Traceback (most recent call last):
  File "/dls/athena/blueapi/src/blueapi/client/client.py", line 663, in reload_environment
    status = self._rest.delete_environment()
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/src/blueapi/client/rest.py", line 272, in delete_environment
    return self._request_and_deserialize(
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/observability_utils/tracing/decorators.py", line 151, in wrapper
    return func(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/src/blueapi/client/rest.py", line 318, in _request_and_deserialize
    raise exception
blueapi.client.rest.UnauthorisedAccessError: (401, '{"detail":"Not authenticated"}')

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/dls/athena/blueapi/.venv/bin/blueapi", line 10, in <module>
    sys.exit(main())
             ^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/click/core.py", line 1485, in __call__
    return self.main(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/click/core.py", line 1406, in main
    rv = self.invoke(ctx)
         ^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/click/core.py", line 1873, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/click/core.py", line 1873, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/click/core.py", line 1269, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/click/core.py", line 824, in invoke
    return callback(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/click/decorators.py", line 46, in new_func
    return f(get_current_context().obj, *args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/src/blueapi/cli/cli.py", line 245, in wrapper
    raise e
  File "/dls/athena/blueapi/src/blueapi/cli/cli.py", line 235, in wrapper
    return func(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/src/blueapi/cli/cli.py", line 471, in env
    status = client.reload_environment(timeout=timeout)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/.venv/lib/python3.11/site-packages/observability_utils/tracing/decorators.py", line 151, in wrapper
    return func(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^
  File "/dls/athena/blueapi/src/blueapi/client/client.py", line 665, in reload_environment
    raise BlueskyRemoteControlError(
blueapi.client.rest.BlueskyRemoteControlError: Failed to tear down the environment

Any chance of handling this error in the same way as the others?

[tpoliaw]

Much better errors for the main error cases, thanks.

[abbiemery]

Very nit: Could you remove the issue numbers in the PR title and just make sure they are linked in the commit message when you squash it? Also capitalise the "I" in improve.

[tpoliaw]

I think this is enough of an improvement that it can go in and any further changes can be their own PR.