fixup: default octet-stream upload to false; keep version check as guard

Default `useOctetStream` / `use_octet_stream` to `false` so file write
goes through `multipart/form-data` regardless of envd version. Callers
opt in explicitly; the existing envd version check remains and gates
the opt-in path so older envds fall back to multipart.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: mishushakov

packages/js-sdk/src/sandbox/filesystem/index.ts

@@ -29,6 +29,7 @@ import type { Timestamp } from '@bufbuild/protobuf/wkt'
 import { compareVersions } from 'compare-versions'
 import {
   ENVD_DEFAULT_USER,
+  ENVD_OCTET_STREAM_UPLOAD,
   ENVD_VERSION_RECURSIVE_WATCH,
 } from '../../envd/versions'
 import {
@@ -174,7 +175,8 @@ export interface FilesystemWriteOpts extends FilesystemRequestOpts {
   /**
    * When true, the upload uses `application/octet-stream` instead of `multipart/form-data`.
    *
-   * Defaults to `false`. Requires envd 0.5.7 or later.
+   * Defaults to `false`. Requires envd 0.5.7 or later — when not supported by
+   * the sandbox's envd version, the upload falls back to `multipart/form-data`.
    */
   useOctetStream?: boolean
 }
@@ -420,7 +422,10 @@ export class Filesystem {
       user = defaultUsername
     }
 
-    const useOctetStream = writeOpts?.useOctetStream ?? false
+    const supportsOctetStream =
+      compareVersions(this.envdApi.version, ENVD_OCTET_STREAM_UPLOAD) >= 0
+    const useOctetStream =
+      (writeOpts?.useOctetStream ?? false) && supportsOctetStream
 
     const results: WriteInfo[] = []
 

packages/python-sdk/e2b/sandbox_async/filesystem/filesystem.py

@@ -20,6 +20,7 @@
 from e2b.envd.rpc import authentication_header, handle_rpc_exception
 from e2b.envd.versions import (
     ENVD_DEFAULT_USER,
+    ENVD_OCTET_STREAM_UPLOAD,
     ENVD_VERSION_RECURSIVE_WATCH,
 )
 from e2b.exceptions import (
@@ -209,7 +210,7 @@ async def write(
         :param user: Run the operation as this user
         :param request_timeout: Timeout for the request in **seconds**
         :param gzip: Use gzip compression for the request
-        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later.
+        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later — when not supported, the upload falls back to `multipart/form-data`.
 
         :return: Information about the written file
         """
@@ -246,7 +247,7 @@ async def write_files(
         :param user: Run the operation as this user
         :param request_timeout: Timeout for the request
         :param gzip: Use gzip compression for the request
-        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later.
+        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later — when not supported, the upload falls back to `multipart/form-data`.
         :return: Information about the written files
         """
         username = user
@@ -256,6 +257,9 @@ async def write_files(
         if len(files) == 0:
             return []
 
+        supports_octet_stream = self._envd_version >= ENVD_OCTET_STREAM_UPLOAD
+        use_octet_stream = use_octet_stream and supports_octet_stream
+
         results: List[WriteInfo] = []
 
         if use_octet_stream:

packages/python-sdk/e2b/sandbox_sync/filesystem/filesystem.py

@@ -20,6 +20,7 @@
 from e2b.envd.rpc import authentication_header, handle_rpc_exception
 from e2b.envd.versions import (
     ENVD_DEFAULT_USER,
+    ENVD_OCTET_STREAM_UPLOAD,
     ENVD_VERSION_RECURSIVE_WATCH,
 )
 from e2b.exceptions import (
@@ -207,7 +208,7 @@ def write(
         :param user: Run the operation as this user
         :param request_timeout: Timeout for the request in **seconds**
         :param gzip: Use gzip compression for the request
-        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later.
+        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later — when not supported, the upload falls back to `multipart/form-data`.
 
         :return: Information about the written file
         """
@@ -242,7 +243,7 @@ def write_files(
         :param user: Run the operation as this user
         :param request_timeout: Timeout for the request
         :param gzip: Use gzip compression for the request
-        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later.
+        :param use_octet_stream: Upload using `application/octet-stream` instead of `multipart/form-data`. Defaults to `False`. Requires envd 0.5.7 or later — when not supported, the upload falls back to `multipart/form-data`.
         :return: Information about the written files
         """
         username = user
@@ -252,6 +253,9 @@ def write_files(
         if len(files) == 0:
             return []
 
+        supports_octet_stream = self._envd_version >= ENVD_OCTET_STREAM_UPLOAD
+        use_octet_stream = use_octet_stream and supports_octet_stream
+
         results: List[WriteInfo] = []
 
         if use_octet_stream: