feat(sdk): improve python REST client transport error diagnostics

[BloggerBust]

Refs #2872

Description

This PR improves failure diagnostics in the Python SDK REST client by expanding
the set of transport level exceptions captured and enriching the resulting
ApiException message with request context.

Specifically, when low level urllib3 transport errors occur, such as timeouts,
connection failures, protocol errors, the raised exception now includes:

• the underlying exception type
• the original error message
• HTTP method
• request URL
• configured request timeout

This makes timeout and connectivity failures significantly easier to diagnose
without changing retry behavior or public APIs.

This addresses part of the diagnostics concerns raised in #2872.

Type of change

• Bug fix (non-breaking change which fixes an issue)

What's Changed

• Expand the set of urllib3 transport exceptions handled by the REST client
• Improve error messages for transport failures with request context
• Apply the change via the existing Python SDK patching mechanism

[vercel]

@BloggerBust is attempting to deploy a commit to the Hatchet Team on Vercel.

A member of the Team first needs to authorize it.

[mrkaye97]

nice, thanks! mind posting some example errors that are raised here, if possible? (you might be able to simulate them by just raising from inside one of these methods)

[BloggerBust]

@mrkaye97 no problem! Here are a few simulated examples by raising inside
RESTClientObject.request() (monkeypatching pool_manager.request), showing
the resulting ApiException.reason:

SSLError
bad handshake
method=GET
url=https://example.com/test
timeout=(1, 2)

ConnectTimeoutError
(None, 'connect timed out')
method=GET
url=https://example.com/test
timeout=(1, 2)

ReadTimeoutError
None: read timed out
method=GET
url=https://example.com/test
timeout=(1, 2)

ProtocolError
('connection aborted', OSError('boom'))
method=GET
url=https://example.com/test
timeout=(1, 2)

[mrkaye97]

Nice, thanks! This looks good to me - would you mind bumping the patch version of the package and writing a changelog entry here? Then I'll get this shipped. Thanks for the fix!

[BloggerBust]

Bumped Python SDK patch version to 1.22.16 and added a changelog entry. Thanks!