Rename error handlers to match main SDK conventions

Align with e2b-dev/E2B#1419, which names the health-check-aware
error wrappers handle*Error / handle_*_exception:
- JS: formatRequestError -> handleRequestError
- Python: _raise_if_sandbox_killed -> _handle_connection_error

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: mishushakov

js/src/sandbox.ts

@@ -279,7 +279,7 @@ export class Sandbox extends BaseSandbox {
 
       return execution
     } catch (error) {
-      throw await this.formatRequestError(error)
+      throw await this.handleRequestError(error)
     }
   }
 
@@ -318,7 +318,7 @@ export class Sandbox extends BaseSandbox {
 
       return await res.json()
     } catch (error) {
-      throw await this.formatRequestError(error)
+      throw await this.handleRequestError(error)
     }
   }
 
@@ -354,7 +354,7 @@ export class Sandbox extends BaseSandbox {
         throw error
       }
     } catch (error) {
-      throw await this.formatRequestError(error)
+      throw await this.handleRequestError(error)
     }
   }
 
@@ -389,7 +389,7 @@ export class Sandbox extends BaseSandbox {
 
       return await res.json()
     } catch (error) {
-      throw await this.formatRequestError(error)
+      throw await this.handleRequestError(error)
     }
   }
 
@@ -425,7 +425,7 @@ export class Sandbox extends BaseSandbox {
         throw error
       }
     } catch (error) {
-      throw await this.formatRequestError(error)
+      throw await this.handleRequestError(error)
     }
   }
 
@@ -435,7 +435,7 @@ export class Sandbox extends BaseSandbox {
    * `TimeoutError`. Otherwise falls back to formatting request timeouts and
    * re-throwing the original error.
    */
-  private async formatRequestError(error: unknown): Promise<unknown> {
+  private async handleRequestError(error: unknown): Promise<unknown> {
     if (
       isConnectionClosedError(error) &&
       // If the state check itself fails we can't tell whether the sandbox

python/e2b_code_interpreter/code_interpreter_async.py

@@ -84,7 +84,7 @@ def _client(self) -> AsyncClient:
             transport=get_transport(self.connection_config, http2=False),
         )
 
-    async def _raise_if_sandbox_killed(self, err: Exception) -> None:
+    async def _handle_connection_error(self, err: Exception) -> None:
         """
         Raises a descriptive exception if the connection error was caused by
         the sandbox being killed mid-request. If the sandbox is still running
@@ -236,7 +236,7 @@ async def run_code(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            await self._raise_if_sandbox_killed(err)
+            await self._handle_connection_error(err)
             raise
 
     async def create_code_context(
@@ -285,7 +285,7 @@ async def create_code_context(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            await self._raise_if_sandbox_killed(err)
+            await self._handle_connection_error(err)
             raise
 
     async def remove_code_context(
@@ -320,7 +320,7 @@ async def remove_code_context(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            await self._raise_if_sandbox_killed(err)
+            await self._handle_connection_error(err)
             raise
 
     async def list_code_contexts(self) -> List[Context]:
@@ -351,7 +351,7 @@ async def list_code_contexts(self) -> List[Context]:
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            await self._raise_if_sandbox_killed(err)
+            await self._handle_connection_error(err)
             raise
 
     async def restart_code_context(
@@ -385,5 +385,5 @@ async def restart_code_context(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            await self._raise_if_sandbox_killed(err)
+            await self._handle_connection_error(err)
             raise

python/e2b_code_interpreter/code_interpreter_sync.py

@@ -78,7 +78,7 @@ def _client(self) -> Client:
         # cancelled reliably.
         return Client(transport=get_transport(self.connection_config, http2=False))
 
-    def _raise_if_sandbox_killed(self, err: Exception) -> None:
+    def _handle_connection_error(self, err: Exception) -> None:
         """
         Raises a descriptive exception if the connection error was caused by
         the sandbox being killed mid-request. If the sandbox is still running
@@ -229,7 +229,7 @@ def run_code(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            self._raise_if_sandbox_killed(err)
+            self._handle_connection_error(err)
             raise
 
     def create_code_context(
@@ -278,7 +278,7 @@ def create_code_context(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            self._raise_if_sandbox_killed(err)
+            self._handle_connection_error(err)
             raise
 
     def remove_code_context(
@@ -313,7 +313,7 @@ def remove_code_context(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            self._raise_if_sandbox_killed(err)
+            self._handle_connection_error(err)
             raise
 
     def list_code_contexts(self) -> List[Context]:
@@ -344,7 +344,7 @@ def list_code_contexts(self) -> List[Context]:
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            self._raise_if_sandbox_killed(err)
+            self._handle_connection_error(err)
             raise
 
     def restart_code_context(
@@ -379,5 +379,5 @@ def restart_code_context(
         except httpx.TimeoutException:
             raise format_request_timeout_error()
         except (httpx.ReadError, httpx.RemoteProtocolError) as err:
-            self._raise_if_sandbox_killed(err)
+            self._handle_connection_error(err)
             raise