modAL 1.3.6.dev8__py3-none-any.whl → 1.3.6.dev10__py3-none-any.whl

modal/_utils/async_utils.py

@@ -345,12 +345,24 @@ def synchronize_api(obj, target_module=None):
 RETRY_N_ATTEMPTS_OVERRIDE: Optional[int] = None
 
 
-def retry(direct_fn=None, *, n_attempts=3, base_delay=0, delay_factor=2, timeout=90):
+def retry(
+    direct_fn=None,
+    *,
+    n_attempts=3,
+    base_delay=0,
+    delay_factor=2,
+    attempt_timeout: Optional[float] = 90,
+    attempt_timeout_factor=1,
+):
     """Decorator that calls an async function multiple times, with a given timeout.
 
     If a `base_delay` is provided, the function is given an exponentially
     increasing delay on each run, up until the maximum number of attempts.
 
+    If `attempt_timeout_factor` is set to a value > 1, the per-attempt timeout
+    increases exponentially (starting from `attempt_timeout`, multiplied by
+    `attempt_timeout_factor` after each failed attempt).
+
     Usage:
 
     ```
@@ -375,10 +387,11 @@ def retry(direct_fn=None, *, n_attempts=3, base_delay=0, delay_factor=2, timeout
                 local_n_attempts = n_attempts
 
             delay = base_delay
+            current_attempt_timeout = attempt_timeout
             for i in range(local_n_attempts):
                 t0 = time.time()
                 try:
-                    return await asyncio.wait_for(fn(*args, **kwargs), timeout=timeout)
+                    return await asyncio.wait_for(fn(*args, **kwargs), timeout=current_attempt_timeout)
                 except asyncio.CancelledError:
                     logger.debug(f"Function {fn} was cancelled")
                     raise
@@ -392,6 +405,8 @@ def retry(direct_fn=None, *, n_attempts=3, base_delay=0, delay_factor=2, timeout
                     )
                 await asyncio.sleep(delay)
                 delay *= delay_factor
+                if current_attempt_timeout is not None:
+                    current_attempt_timeout *= attempt_timeout_factor
 
         return f_wrapped
 

modal/_utils/blob_utils.py

@@ -58,7 +58,7 @@ MULTIPART_UPLOAD_THRESHOLD = 1024**3
 BLOCK_SIZE: int = 8 * 1024 * 1024
 
 
-@retry(n_attempts=3, base_delay=0.3, timeout=None)
+@retry(n_attempts=3, base_delay=0.3, attempt_timeout=None)
 async def _upload_to_s3_url(
     upload_url,
     payload: "BytesIOSegmentPayload",
@@ -310,7 +310,7 @@ async def blob_upload_file(
     return blob_id
 
 
-@retry(n_attempts=5, base_delay=0.1, timeout=None)
+@retry(n_attempts=5, base_delay=0.1, attempt_timeout=None)
 async def _download_from_url(download_url: str) -> bytes:
     async with ClientSessionRegistry.get_session().get(download_url) as s3_resp:
         # S3 signal to slow down request rate.

modal/_utils/grpc_utils.py

@@ -89,6 +89,10 @@ RETRYABLE_GRPC_STATUS_CODES = [
     Status.UNKNOWN,
 ]
 SERVER_RETRY_WARNING_TIME_INTERVAL = 30.0
+# Initial per-attempt timeout for TCP/TLS handshake in connect_channel.
+# Doubles each attempt (attempt_timeout_factor=2): 0.5 + 1 + 2 + 4 + 8 = 15.5s + ~1.5s inter-attempt delays.
+CONNECT_TIMEOUT = 0.5
+DEFAULT_MAX_RETRIES = 3
 
 
 @dataclass
@@ -117,7 +121,7 @@ class ConnectionManager:
             self._channels[server_url] = create_channel(server_url, self._metadata)
             try:
                 await connect_channel(self._channels[server_url])
-            except OSError as exc:
+            except (OSError, asyncio.TimeoutError) as exc:
                 raise ConnectionError("Could not connect to the Modal server.") from exc
         return self._channels[server_url]
 
@@ -221,7 +225,7 @@ def create_channel(
     return channel
 
 
-@retry(n_attempts=5, base_delay=0.1)
+@retry(n_attempts=5, base_delay=0.1, attempt_timeout=CONNECT_TIMEOUT, attempt_timeout_factor=2)
 async def connect_channel(channel: grpclib.client.Channel):
     """Connect to socket and raise exceptions when there is a connection issue."""
     await channel.__connect__()
@@ -246,7 +250,7 @@ class Retry:
     base_delay: float = 0.1
     max_delay: float = 1
     delay_factor: float = 2
-    max_retries: Optional[int] = 3
+    max_retries: Optional[int] = DEFAULT_MAX_RETRIES
     additional_status_codes: list = field(default_factory=list)
     attempt_timeout: Optional[float] = None  # timeout for each attempt
     total_timeout: Optional[float] = None  # timeout for the entire function call
@@ -257,7 +261,7 @@ class Retry:
 async def retry_transient_errors(
     fn: "grpclib.client.UnaryUnaryMethod[RequestType, ResponseType]",
     req: RequestType,
-    max_retries: Optional[int] = 3,
+    max_retries: Optional[int] = DEFAULT_MAX_RETRIES,
 ) -> ResponseType:
     """Minimum API version of _retry_transient_errors that works with grpclib.client.UnaryUnaryMethod.
 
@@ -373,7 +377,13 @@ async def _retry_transient_errors(
         try:
             with suppress_tb_frame():
                 return await fn_callable(req, metadata=attempt_metadata, timeout=timeout)
-        except (StreamTerminatedError, GRPCError, OSError, asyncio.TimeoutError, AttributeError) as exc:
+        except (
+            StreamTerminatedError,
+            GRPCError,
+            OSError,
+            asyncio.TimeoutError,
+            AttributeError,
+        ) as exc:
             # Note that we only catch AttributeError to handle a specific case that works around a bug
             # in grpclib<=0.4.7. See above (search for `write_appdata`).
 

modal/_utils/task_command_router_client.py

@@ -242,6 +242,44 @@ class TaskCommandRouterClient:
                 lambda: self._call_with_auth_retry(self._stub.TaskExecStart, request)
             )
 
+    async def container_create(self, request: sr_pb2.TaskContainerCreateRequest) -> sr_pb2.TaskContainerCreateResponse:
+        """Create an additional container via task command router."""
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskContainerCreate, request)
+            )
+
+    async def container_terminate(
+        self,
+        request: sr_pb2.TaskContainerTerminateRequest,
+    ) -> sr_pb2.TaskContainerTerminateResponse:
+        """Terminate an additional container via task command router."""
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskContainerTerminate, request)
+            )
+
+    async def container_wait(self, request: sr_pb2.TaskContainerWaitRequest) -> sr_pb2.TaskContainerWaitResponse:
+        """Wait for an additional container via task command router."""
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskContainerWait, request)
+            )
+
+    async def container_get(self, request: sr_pb2.TaskContainerGetRequest) -> sr_pb2.TaskContainerGetResponse:
+        """Get the latest tracked container for a logical name via task command router."""
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskContainerGet, request)
+            )
+
+    async def container_list(self, request: sr_pb2.TaskContainerListRequest) -> sr_pb2.TaskContainerListResponse:
+        """List sandbox containers via task command router."""
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskContainerList, request)
+            )
+
     async def exec_stdio_read(
         self,
         task_id: str,

modal/cli/shell.py

@@ -18,6 +18,7 @@ from ..mount import _Mount
 from ..runner import interactive_shell
 from ..sandbox import Sandbox
 from ..secret import Secret
+from ..stream_type import StreamType
 from ..volume import Volume
 from .container import exec
 from .import_refs import (
@@ -64,26 +65,75 @@ def _is_valid_modal_id(ref: str, prefix: str) -> bool:
     return ref.startswith(prefix) and len(ref[len(prefix) :]) > 0 and ref[len(prefix) :].isalnum()
 
 
+def _parse_sandbox_container_ref(ref: str) -> tuple[str, Optional[str]]:
+    """Parse a sandbox:container reference into (sandbox_id, container_name).
+
+    Supports the pattern `sb-xyz:container_name` for accessing sandbox containers.
+    Returns (ref, None) if no container name is specified.
+    """
+    if _is_valid_modal_id(ref, "sb-"):
+        return ref, None
+
+    if ":" in ref:
+        parts = ref.split(":", 1)
+        sandbox_id, container_name = parts[0], parts[1]
+        if _is_valid_modal_id(sandbox_id, "sb-") and container_name:
+            return sandbox_id, container_name
+
+    return ref, None
+
+
 def _is_running_container_ref(ref: Optional[str]) -> bool:
     if ref is None:
         return False
-    return _is_valid_modal_id(ref, "sb-") or _is_valid_modal_id(ref, "ta-")
+    sandbox_id, _ = _parse_sandbox_container_ref(ref)
+    return _is_valid_modal_id(sandbox_id, "sb-") or _is_valid_modal_id(ref, "ta-")
+
+
+def _start_shell_in_sandbox_container(sandbox_id: str, container_name: str, cmd: str, pty: bool) -> None:
+    """Shell into a named container within a sandbox."""
+    try:
+        sandbox = Sandbox.from_id(sandbox_id)
+    except NotFoundError:
+        raise ClickException(f"Sandbox '{sandbox_id}' not found (is it still running?)")
+    except Exception as e:
+        raise ClickException(f"Error connecting to Sandbox '{sandbox_id}': {str(e)}")
+
+    try:
+        sandbox_container = sandbox._experimental_containers.get(name=container_name)
+        if pty:
+            process = sandbox_container.exec(*shlex.split(cmd), pty=pty)
+            process.attach()
+        else:
+            process = sandbox_container.exec(
+                *shlex.split(cmd), pty=pty, stdout=StreamType.STDOUT, stderr=StreamType.STDOUT
+            )
+            process.wait()
+    except NotFoundError:
+        raise ClickException(f"Container '{container_name}' not found in Sandbox '{sandbox_id}'.")
+    except Exception as e:
+        raise ClickException(f"Error exec-ing into container '{container_name}' in Sandbox '{sandbox_id}': {str(e)}")
 
 
 def _start_shell_in_running_container(ref: str, cmd: str, pty: bool) -> None:
-    if _is_valid_modal_id(ref, "sb-"):
+    sandbox_id, container_name = _parse_sandbox_container_ref(ref)
+
+    if container_name is not None:
+        return _start_shell_in_sandbox_container(sandbox_id, container_name, cmd, pty)
+
+    if _is_valid_modal_id(sandbox_id, "sb-"):
         try:
-            sandbox = Sandbox.from_id(ref)
+            sandbox = Sandbox.from_id(sandbox_id)
             ref = sandbox._get_task_id()
-        except NotFoundError as e:
-            raise ClickException(f"Sandbox '{ref}' not found (is it still running?)")
+        except NotFoundError:
+            raise ClickException(f"Sandbox '{sandbox_id}' not found (is it still running?)")
         except Exception as e:
-            raise ClickException(f"Error connecting to Sandbox '{ref}': {str(e)}")
+            raise ClickException(f"Error connecting to Sandbox '{sandbox_id}': {str(e)}")
 
     assert _is_valid_modal_id(ref, "ta-")
     try:
         exec(container_id=ref, command=shlex.split(cmd), pty=pty)
-    except NotFoundError as e:
+    except NotFoundError:
         raise ClickException(f"Container '{ref}' not found (is it still running?)")
     except Exception as e:
         raise ClickException(f"Error connecting to container '{ref}': {str(e)}")

modal/client.pyi

@@ -35,7 +35,7 @@ class _Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.3.6.dev8",
+        version: str = "1.3.6.dev10",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -171,7 +171,7 @@ class Client:
         server_url: str,
         client_type: int,
         credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.3.6.dev8",
+        version: str = "1.3.6.dev10",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

modal/functions.pyi

@@ -408,7 +408,7 @@ class Function(
 
     _call_generator: ___call_generator_spec
 
-    class __remote_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class __remote_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> ReturnType_INNER:
             """Calls the function remotely, executing it with the given arguments and returning the execution's result."""
             ...
@@ -417,7 +417,7 @@ class Function(
             """Calls the function remotely, executing it with the given arguments and returning the execution's result."""
             ...
 
-    remote: __remote_spec[modal._functions.P, modal._functions.ReturnType]
+    remote: __remote_spec[modal._functions.ReturnType, modal._functions.P]
 
     class __remote_gen_spec(typing_extensions.Protocol):
         def __call__(self, /, *args, **kwargs) -> typing.Generator[typing.Any, None, None]:
@@ -444,7 +444,7 @@ class Function(
         """
         ...
 
-    class ___experimental_spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class ___experimental_spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """[Experimental] Calls the function with the given arguments, without waiting for the results.
 
@@ -467,7 +467,7 @@ class Function(
             """
             ...
 
-    _experimental_spawn: ___experimental_spawn_spec[modal._functions.P, modal._functions.ReturnType]
+    _experimental_spawn: ___experimental_spawn_spec[modal._functions.ReturnType, modal._functions.P]
 
     class ___spawn_map_inner_spec(typing_extensions.Protocol[P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> None: ...
@@ -475,7 +475,7 @@ class Function(
 
     _spawn_map_inner: ___spawn_map_inner_spec[modal._functions.P]
 
-    class __spawn_spec(typing_extensions.Protocol[P_INNER, ReturnType_INNER]):
+    class __spawn_spec(typing_extensions.Protocol[ReturnType_INNER, P_INNER]):
         def __call__(self, /, *args: P_INNER.args, **kwargs: P_INNER.kwargs) -> FunctionCall[ReturnType_INNER]:
             """Calls the function with the given arguments, without waiting for the results.
 
@@ -496,7 +496,7 @@ class Function(
             """
             ...
 
-    spawn: __spawn_spec[modal._functions.P, modal._functions.ReturnType]
+    spawn: __spawn_spec[modal._functions.ReturnType, modal._functions.P]
 
     def get_raw_f(self) -> collections.abc.Callable[..., typing.Any]:
         """Return the inner Python object wrapped by this Modal Function."""

modal/sandbox.py

@@ -35,7 +35,14 @@ from ._utils.name_utils import check_object_name
 from ._utils.task_command_router_client import TaskCommandRouterClient
 from .client import _Client
 from .container_process import _ContainerProcess
-from .exception import ClientClosed, Error, ExecutionError, InvalidError, SandboxTerminatedError, SandboxTimeoutError
+from .exception import (
+    ClientClosed,
+    Error,
+    ExecutionError,
+    InvalidError,
+    SandboxTerminatedError,
+    SandboxTimeoutError,
+)
 from .file_io import FileWatchEvent, FileWatchEventType, _FileIO, ls, mkdir, rm, watch
 from .gpu import GPU_T
 from .image import _Image
@@ -68,6 +75,16 @@ if TYPE_CHECKING:
     import modal.app
 
 
+def _result_returncode(result: Optional[api_pb2.GenericResult]) -> Optional[int]:
+    if result is None or result.status == api_pb2.GenericResult.GENERIC_STATUS_UNSPECIFIED:
+        return None
+    if result.status == api_pb2.GenericResult.GENERIC_STATUS_TIMEOUT:
+        return 124
+    if result.status == api_pb2.GenericResult.GENERIC_STATUS_TERMINATED:
+        return 137
+    return result.exitcode
+
+
 def _validate_exec_args(args: Sequence[str]) -> None:
     # Entrypoint args must be strings.
     if not all(isinstance(arg, str) for arg in args):
@@ -904,6 +921,12 @@ class _Sandbox(_Object, type_prefix="sb"):
             self._command_router_client = await TaskCommandRouterClient.try_init(self._client, task_id)
         return self._command_router_client
 
+    @property
+    def _experimental_containers(self) -> "_SandboxContainerManager":
+        """Manage additional containers running in this Sandbox."""
+        self._ensure_attached()
+        return _SandboxContainerManager(self)
+
     @overload
     async def exec(
         self,
@@ -1006,6 +1029,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         secrets: Optional[Collection[_Secret]] = None,
         text: bool = True,
         bufsize: Literal[-1, 1] = -1,
+        container_id: Optional[str] = None,
     ) -> Union[_ContainerProcess[bytes], _ContainerProcess[str]]:
         """Private method used internally.
 
@@ -1035,6 +1059,7 @@ class _Sandbox(_Object, type_prefix="sb"):
             "text": text,
             "bufsize": bufsize,
             "runtime_debug": config.get("function_runtime_debug"),
+            "container_id": container_id,
         }
         # NB: This must come after the task ID is set, since the sandbox must be
         # scheduled before we can create a router client.
@@ -1057,8 +1082,11 @@ class _Sandbox(_Object, type_prefix="sb"):
         text: bool = True,
         bufsize: Literal[-1, 1] = -1,
         runtime_debug: bool = False,
+        container_id: Optional[str] = None,
     ) -> Union[_ContainerProcess[bytes], _ContainerProcess[str]]:
         """Execute a command through the Modal server."""
+        if container_id:
+            raise RuntimeError("Internal error: additional container exec requires task command router support")
         req = api_pb2.ContainerExecRequest(
             task_id=task_id,
             command=args,
@@ -1097,6 +1125,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         text: bool = True,
         bufsize: Literal[-1, 1] = -1,
         runtime_debug: bool = False,
+        container_id: Optional[str] = None,
     ) -> Union[_ContainerProcess[bytes], _ContainerProcess[str]]:
         """Execute a command through a task command router running on the Modal worker."""
 
@@ -1134,6 +1163,7 @@ class _Sandbox(_Object, type_prefix="sb"):
             secret_ids=secret_ids,
             pty_info=pty_info,
             runtime_debug=runtime_debug,
+            container_id=container_id or "",
         )
         _ = await command_router_client.exec_start(start_req)
 
@@ -1332,17 +1362,7 @@ class _Sandbox(_Object, type_prefix="sb"):
     @property
     def returncode(self) -> Optional[int]:
         """Return code of the Sandbox process if it has finished running, else `None`."""
-        if self._result is None or self._result.status == api_pb2.GenericResult.GENERIC_STATUS_UNSPECIFIED:
-            return None
-
-        # Statuses are converted to exitcodes so we can conform to subprocess API.
-        # TODO: perhaps there should be a separate property that returns an enum directly?
-        elif self._result.status == api_pb2.GenericResult.GENERIC_STATUS_TIMEOUT:
-            return 124
-        elif self._result.status == api_pb2.GenericResult.GENERIC_STATUS_TERMINATED:
-            return 137
-        else:
-            return self._result.exitcode
+        return _result_returncode(self._result)
 
     @staticmethod
     async def list(
@@ -1382,4 +1402,224 @@ class _Sandbox(_Object, type_prefix="sb"):
             before_timestamp = resp.sandboxes[-1].created_at
 
 
+class _SandboxContainer:
+    """Handle to an additional container running in a Sandbox."""
+
+    _result: Optional[api_pb2.GenericResult]
+
+    def __init__(
+        self,
+        sandbox: _Sandbox,
+        container_id: str,
+        container_name: str,
+        result: Optional[api_pb2.GenericResult] = None,
+    ) -> None:
+        self._sandbox = sandbox
+        self._container_id = container_id
+        self._container_name = container_name
+        self._result = result
+
+    @property
+    def object_id(self) -> str:
+        return self._container_id
+
+    @property
+    def name(self) -> str:
+        return self._container_name
+
+    @staticmethod
+    def _from_container_info(sandbox: "_Sandbox", container_info: sr_pb2.TaskContainerInfo) -> "_SandboxContainer":
+        result = container_info.result if container_info.HasField("result") else None
+        return _SandboxContainer(sandbox, container_info.container_id, container_info.container_name, result)
+
+    async def _get_command_router(self) -> tuple[str, "TaskCommandRouterClient"]:
+        """Get task ID and command router client, raising if unavailable."""
+        task_id = await self._sandbox._get_task_id()
+        command_router_client = await self._sandbox._get_command_router_client(task_id)
+        if command_router_client is None:
+            raise RuntimeError("Internal error: additional container operations require task command router support")
+        return task_id, command_router_client
+
+    async def exec(
+        self,
+        *args: str,
+        stdout: StreamType = StreamType.PIPE,
+        stderr: StreamType = StreamType.PIPE,
+        timeout: Optional[int] = None,
+        workdir: Optional[str] = None,
+        env: Optional[dict[str, Optional[str]]] = None,
+        secrets: Optional[Collection[_Secret]] = None,
+        text: bool = True,
+        bufsize: Literal[-1, 1] = -1,
+        pty: bool = False,
+    ) -> Union[_ContainerProcess[bytes], _ContainerProcess[str]]:
+        pty_info = self._sandbox._default_pty_info() if pty else None
+        return await self._sandbox._exec(
+            *args,
+            pty_info=pty_info,
+            stdout=stdout,
+            stderr=stderr,
+            timeout=timeout,
+            workdir=workdir,
+            env=env,
+            secrets=secrets,
+            text=text,
+            bufsize=bufsize,
+            container_id=self._container_id,
+        )
+
+    async def wait(self, raise_on_termination: bool = True) -> None:
+        if self._result is not None and self._result.status != api_pb2.GenericResult.GENERIC_STATUS_UNSPECIFIED:
+            if self._result.status == api_pb2.GenericResult.GENERIC_STATUS_TERMINATED and raise_on_termination:
+                raise SandboxTerminatedError()
+            return
+
+        task_id, command_router_client = await self._get_command_router()
+        while True:
+            resp = await command_router_client.container_wait(
+                sr_pb2.TaskContainerWaitRequest(
+                    task_id=task_id,
+                    container_id=self._container_id,
+                    timeout=10,
+                )
+            )
+            if resp.result.status:
+                self._result = resp.result
+                if resp.result.status == api_pb2.GenericResult.GENERIC_STATUS_TERMINATED and raise_on_termination:
+                    raise SandboxTerminatedError()
+                return
+
+    async def poll(self) -> Optional[int]:
+        if self._result is not None and self._result.status != api_pb2.GenericResult.GENERIC_STATUS_UNSPECIFIED:
+            return _result_returncode(self._result)
+
+        task_id, command_router_client = await self._get_command_router()
+        resp = await command_router_client.container_wait(
+            sr_pb2.TaskContainerWaitRequest(
+                task_id=task_id,
+                container_id=self._container_id,
+                timeout=0,
+            )
+        )
+        if resp.result.status:
+            self._result = resp.result
+        return _result_returncode(self._result)
+
+    @overload
+    async def terminate(
+        self,
+        *,
+        wait: Literal[True],
+    ) -> int: ...
+
+    @overload
+    async def terminate(
+        self,
+        *,
+        wait: Literal[False] = False,
+    ) -> None: ...
+
+    async def terminate(
+        self,
+        *,
+        wait: bool = False,
+    ) -> int | None:
+        task_id, command_router_client = await self._get_command_router()
+        await command_router_client.container_terminate(
+            sr_pb2.TaskContainerTerminateRequest(
+                task_id=task_id,
+                container_id=self._container_id,
+            )
+        )
+        if wait:
+            await self.wait(raise_on_termination=False)
+            return _result_returncode(self._result)
+
+
+class _SandboxContainerManager:
+    """Creates and manages additional containers in a Sandbox."""
+
+    def __init__(self, sandbox: _Sandbox) -> None:
+        self._sandbox = sandbox
+
+    async def _get_command_router(self) -> tuple[str, "TaskCommandRouterClient"]:
+        """Get task ID and command router client, raising if unavailable."""
+        task_id = await self._sandbox._get_task_id()
+        command_router_client = await self._sandbox._get_command_router_client(task_id)
+        if command_router_client is None:
+            raise RuntimeError("Internal error: additional container operations require task command router support")
+        return task_id, command_router_client
+
+    async def create(
+        self,
+        *args: str,
+        name: str,
+        image: _Image,
+        env: Optional[dict[str, str]] = None,
+        secrets: Optional[Collection[_Secret]] = None,
+        workdir: Optional[str] = None,
+    ) -> _SandboxContainer:
+        if workdir is not None and not workdir.startswith("/"):
+            raise InvalidError(f"workdir must be an absolute path, got: {workdir}")
+        _validate_exec_args(args)
+
+        if image._mount_layers:
+            raise InvalidError(
+                "Sandbox._experimental_containers.create(image=...) only supports pre-built images. "
+                "When using `add_local*` methods, specify `copy=True` and call `.build()` before passing "
+                "the image to `._experimental_containers.create()`:\n\nE.g.\n"
+                'img = modal.Image.debian_slim().add_local_file("foo", "/foo", copy=True).build(app)\n'
+                'sandbox._experimental_containers.create(name="worker", image=img)'
+            )
+        if not image._object_id:
+            raise InvalidError(
+                "Sandbox._experimental_containers.create(image=...) currently only supports Images that are "
+                "either:\n"
+                "- prebuilt using `image.build()`\n"
+                "- referenced by id, e.g. `Image.from_id()`\n"
+                "- filesystem/directory snapshots e.g. created by `.snapshot_directory()` "
+                "or `.snapshot_filesystem()`\n"
+            )
+
+        secrets = secrets or []
+        secret_coros = [secret.hydrate(client=self._sandbox._client) for secret in secrets]
+        await TaskContext.gather(*secret_coros)
+
+        task_id, command_router_client = await self._get_command_router()
+
+        create_req = sr_pb2.TaskContainerCreateRequest(
+            task_id=task_id,
+            container_name=name,
+            image_id=image.object_id,
+            args=list(args),
+            env=env or {},
+            workdir=workdir or "",
+            secret_ids=[secret.object_id for secret in secrets],
+        )
+        create_resp = await command_router_client.container_create(create_req)
+        container_id = create_resp.container_id
+        container_name = create_resp.container_name or name
+        return _SandboxContainer(self._sandbox, container_id, container_name)
+
+    async def get(self, *, name: str, include_terminated: bool = False) -> "_SandboxContainer":
+        task_id, command_router_client = await self._get_command_router()
+        resp = await command_router_client.container_get(
+            sr_pb2.TaskContainerGetRequest(
+                task_id=task_id,
+                container_name=name,
+                include_terminated=include_terminated,
+            )
+        )
+        return _SandboxContainer._from_container_info(self._sandbox, resp.container)
+
+    async def list(self, include_terminated: bool = False) -> builtins.list[_SandboxContainer]:
+        task_id, command_router_client = await self._get_command_router()
+        resp = await command_router_client.container_list(
+            sr_pb2.TaskContainerListRequest(task_id=task_id, include_terminated=include_terminated)
+        )
+        return [_SandboxContainer._from_container_info(self._sandbox, container) for container in resp.containers]
+
+
+SandboxContainer = synchronize_api(_SandboxContainer)
+SandboxContainerManager = synchronize_api(_SandboxContainerManager)
 Sandbox = synchronize_api(_Sandbox)

modal/sandbox.pyi

@@ -22,11 +22,13 @@ import modal.snapshot
 import modal.stream_type
 import modal.volume
 import modal_proto.api_pb2
+import modal_proto.task_command_router_pb2
 import os
 import pathlib
 import typing
 import typing_extensions
 
+def _result_returncode(result: typing.Optional[modal_proto.api_pb2.GenericResult]) -> typing.Optional[int]: ...
 def _validate_exec_args(args: collections.abc.Sequence[str]) -> None: ...
 
 class DefaultSandboxNameOverride(str):
@@ -381,6 +383,11 @@ class _Sandbox(modal._object._Object):
     async def _get_command_router_client(
         self, task_id: str
     ) -> typing.Optional[modal._utils.task_command_router_client.TaskCommandRouterClient]: ...
+    @property
+    def _experimental_containers(self) -> _SandboxContainerManager:
+        """Manage additional containers running in this Sandbox."""
+        ...
+
     @typing.overload
     async def exec(
         self,
@@ -425,6 +432,7 @@ class _Sandbox(modal._object._Object):
         secrets: typing.Optional[collections.abc.Collection[modal.secret._Secret]] = None,
         text: bool = True,
         bufsize: typing.Literal[-1, 1] = -1,
+        container_id: typing.Optional[str] = None,
     ) -> typing.Union[modal.container_process._ContainerProcess[bytes], modal.container_process._ContainerProcess[str]]:
         """Private method used internally.
 
@@ -445,6 +453,7 @@ class _Sandbox(modal._object._Object):
         text: bool = True,
         bufsize: typing.Literal[-1, 1] = -1,
         runtime_debug: bool = False,
+        container_id: typing.Optional[str] = None,
     ) -> typing.Union[modal.container_process._ContainerProcess[bytes], modal.container_process._ContainerProcess[str]]:
         """Execute a command through the Modal server."""
         ...
@@ -463,6 +472,7 @@ class _Sandbox(modal._object._Object):
         text: bool = True,
         bufsize: typing.Literal[-1, 1] = -1,
         runtime_debug: bool = False,
+        container_id: typing.Optional[str] = None,
     ) -> typing.Union[modal.container_process._ContainerProcess[bytes], modal.container_process._ContainerProcess[str]]:
         """Execute a command through a task command router running on the Modal worker."""
         ...
@@ -546,6 +556,220 @@ class _Sandbox(modal._object._Object):
         """
         ...
 
+class _SandboxContainer:
+    """Handle to an additional container running in a Sandbox."""
+
+    _result: typing.Optional[modal_proto.api_pb2.GenericResult]
+
+    def __init__(
+        self,
+        sandbox: _Sandbox,
+        container_id: str,
+        container_name: str,
+        result: typing.Optional[modal_proto.api_pb2.GenericResult] = None,
+    ) -> None:
+        """Initialize self.  See help(type(self)) for accurate signature."""
+        ...
+
+    @property
+    def object_id(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @staticmethod
+    def _from_container_info(
+        sandbox: _Sandbox, container_info: modal_proto.task_command_router_pb2.TaskContainerInfo
+    ) -> _SandboxContainer: ...
+    async def _get_command_router(self) -> tuple[str, modal._utils.task_command_router_client.TaskCommandRouterClient]:
+        """Get task ID and command router client, raising if unavailable."""
+        ...
+
+    async def exec(
+        self,
+        *args: str,
+        stdout: modal.stream_type.StreamType = modal.stream_type.StreamType.PIPE,
+        stderr: modal.stream_type.StreamType = modal.stream_type.StreamType.PIPE,
+        timeout: typing.Optional[int] = None,
+        workdir: typing.Optional[str] = None,
+        env: typing.Optional[dict[str, typing.Optional[str]]] = None,
+        secrets: typing.Optional[collections.abc.Collection[modal.secret._Secret]] = None,
+        text: bool = True,
+        bufsize: typing.Literal[-1, 1] = -1,
+        pty: bool = False,
+    ) -> typing.Union[
+        modal.container_process._ContainerProcess[bytes], modal.container_process._ContainerProcess[str]
+    ]: ...
+    async def wait(self, raise_on_termination: bool = True) -> None: ...
+    async def poll(self) -> typing.Optional[int]: ...
+    @typing.overload
+    async def terminate(self, *, wait: typing.Literal[True]) -> int: ...
+    @typing.overload
+    async def terminate(self, *, wait: typing.Literal[False] = False) -> None: ...
+
+class _SandboxContainerManager:
+    """Creates and manages additional containers in a Sandbox."""
+    def __init__(self, sandbox: _Sandbox) -> None:
+        """Initialize self.  See help(type(self)) for accurate signature."""
+        ...
+
+    async def _get_command_router(self) -> tuple[str, modal._utils.task_command_router_client.TaskCommandRouterClient]:
+        """Get task ID and command router client, raising if unavailable."""
+        ...
+
+    async def create(
+        self,
+        *args: str,
+        name: str,
+        image: modal.image._Image,
+        env: typing.Optional[dict[str, str]] = None,
+        secrets: typing.Optional[collections.abc.Collection[modal.secret._Secret]] = None,
+        workdir: typing.Optional[str] = None,
+    ) -> _SandboxContainer: ...
+    async def get(self, *, name: str, include_terminated: bool = False) -> _SandboxContainer: ...
+    async def list(self, include_terminated: bool = False) -> list[_SandboxContainer]: ...
+
+class SandboxContainer:
+    """Handle to an additional container running in a Sandbox."""
+
+    _result: typing.Optional[modal_proto.api_pb2.GenericResult]
+
+    def __init__(
+        self,
+        sandbox: Sandbox,
+        container_id: str,
+        container_name: str,
+        result: typing.Optional[modal_proto.api_pb2.GenericResult] = None,
+    ) -> None: ...
+    @property
+    def object_id(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @staticmethod
+    def _from_container_info(
+        sandbox: Sandbox, container_info: modal_proto.task_command_router_pb2.TaskContainerInfo
+    ) -> SandboxContainer: ...
+
+    class ___get_command_router_spec(typing_extensions.Protocol):
+        def __call__(self, /) -> tuple[str, modal._utils.task_command_router_client.TaskCommandRouterClient]:
+            """Get task ID and command router client, raising if unavailable."""
+            ...
+
+        async def aio(self, /) -> tuple[str, modal._utils.task_command_router_client.TaskCommandRouterClient]:
+            """Get task ID and command router client, raising if unavailable."""
+            ...
+
+    _get_command_router: ___get_command_router_spec
+
+    class __exec_spec(typing_extensions.Protocol):
+        def __call__(
+            self,
+            /,
+            *args: str,
+            stdout: modal.stream_type.StreamType = modal.stream_type.StreamType.PIPE,
+            stderr: modal.stream_type.StreamType = modal.stream_type.StreamType.PIPE,
+            timeout: typing.Optional[int] = None,
+            workdir: typing.Optional[str] = None,
+            env: typing.Optional[dict[str, typing.Optional[str]]] = None,
+            secrets: typing.Optional[collections.abc.Collection[modal.secret.Secret]] = None,
+            text: bool = True,
+            bufsize: typing.Literal[-1, 1] = -1,
+            pty: bool = False,
+        ) -> typing.Union[
+            modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
+        ]: ...
+        async def aio(
+            self,
+            /,
+            *args: str,
+            stdout: modal.stream_type.StreamType = modal.stream_type.StreamType.PIPE,
+            stderr: modal.stream_type.StreamType = modal.stream_type.StreamType.PIPE,
+            timeout: typing.Optional[int] = None,
+            workdir: typing.Optional[str] = None,
+            env: typing.Optional[dict[str, typing.Optional[str]]] = None,
+            secrets: typing.Optional[collections.abc.Collection[modal.secret.Secret]] = None,
+            text: bool = True,
+            bufsize: typing.Literal[-1, 1] = -1,
+            pty: bool = False,
+        ) -> typing.Union[
+            modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
+        ]: ...
+
+    exec: __exec_spec
+
+    class __wait_spec(typing_extensions.Protocol):
+        def __call__(self, /, raise_on_termination: bool = True) -> None: ...
+        async def aio(self, /, raise_on_termination: bool = True) -> None: ...
+
+    wait: __wait_spec
+
+    class __poll_spec(typing_extensions.Protocol):
+        def __call__(self, /) -> typing.Optional[int]: ...
+        async def aio(self, /) -> typing.Optional[int]: ...
+
+    poll: __poll_spec
+
+    class __terminate_spec(typing_extensions.Protocol):
+        @typing.overload
+        def __call__(self, /, *, wait: typing.Literal[True]) -> int: ...
+        @typing.overload
+        def __call__(self, /, *, wait: typing.Literal[False] = False) -> None: ...
+        @typing.overload
+        async def aio(self, /, *, wait: typing.Literal[True]) -> int: ...
+        @typing.overload
+        async def aio(self, /, *, wait: typing.Literal[False] = False) -> None: ...
+
+    terminate: __terminate_spec
+
+class SandboxContainerManager:
+    """Creates and manages additional containers in a Sandbox."""
+    def __init__(self, sandbox: Sandbox) -> None: ...
+
+    class ___get_command_router_spec(typing_extensions.Protocol):
+        def __call__(self, /) -> tuple[str, modal._utils.task_command_router_client.TaskCommandRouterClient]:
+            """Get task ID and command router client, raising if unavailable."""
+            ...
+
+        async def aio(self, /) -> tuple[str, modal._utils.task_command_router_client.TaskCommandRouterClient]:
+            """Get task ID and command router client, raising if unavailable."""
+            ...
+
+    _get_command_router: ___get_command_router_spec
+
+    class __create_spec(typing_extensions.Protocol):
+        def __call__(
+            self,
+            /,
+            *args: str,
+            name: str,
+            image: modal.image.Image,
+            env: typing.Optional[dict[str, str]] = None,
+            secrets: typing.Optional[collections.abc.Collection[modal.secret.Secret]] = None,
+            workdir: typing.Optional[str] = None,
+        ) -> SandboxContainer: ...
+        async def aio(
+            self,
+            /,
+            *args: str,
+            name: str,
+            image: modal.image.Image,
+            env: typing.Optional[dict[str, str]] = None,
+            secrets: typing.Optional[collections.abc.Collection[modal.secret.Secret]] = None,
+            workdir: typing.Optional[str] = None,
+        ) -> SandboxContainer: ...
+
+    create: __create_spec
+
+    class __get_spec(typing_extensions.Protocol):
+        def __call__(self, /, *, name: str, include_terminated: bool = False) -> SandboxContainer: ...
+        async def aio(self, /, *, name: str, include_terminated: bool = False) -> SandboxContainer: ...
+
+    get: __get_spec
+
+    class __list_spec(typing_extensions.Protocol):
+        def __call__(self, /, include_terminated: bool = False) -> list[SandboxContainer]: ...
+        async def aio(self, /, include_terminated: bool = False) -> list[SandboxContainer]: ...
+
+    list: __list_spec
+
 class Sandbox(modal.object.Object):
     """A `Sandbox` object lets you interact with a running sandbox. This API is similar to Python's
     [asyncio.subprocess.Process](https://docs.python.org/3/library/asyncio-subprocess.html#asyncio.subprocess.Process).
@@ -1179,6 +1403,11 @@ class Sandbox(modal.object.Object):
 
     _get_command_router_client: ___get_command_router_client_spec
 
+    @property
+    def _experimental_containers(self) -> SandboxContainerManager:
+        """Manage additional containers running in this Sandbox."""
+        ...
+
     class __exec_spec(typing_extensions.Protocol):
         @typing.overload
         def __call__(
@@ -1265,6 +1494,7 @@ class Sandbox(modal.object.Object):
             secrets: typing.Optional[collections.abc.Collection[modal.secret.Secret]] = None,
             text: bool = True,
             bufsize: typing.Literal[-1, 1] = -1,
+            container_id: typing.Optional[str] = None,
         ) -> typing.Union[
             modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
         ]:
@@ -1287,6 +1517,7 @@ class Sandbox(modal.object.Object):
             secrets: typing.Optional[collections.abc.Collection[modal.secret.Secret]] = None,
             text: bool = True,
             bufsize: typing.Literal[-1, 1] = -1,
+            container_id: typing.Optional[str] = None,
         ) -> typing.Union[
             modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
         ]:
@@ -1313,6 +1544,7 @@ class Sandbox(modal.object.Object):
             text: bool = True,
             bufsize: typing.Literal[-1, 1] = -1,
             runtime_debug: bool = False,
+            container_id: typing.Optional[str] = None,
         ) -> typing.Union[
             modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
         ]:
@@ -1333,6 +1565,7 @@ class Sandbox(modal.object.Object):
             text: bool = True,
             bufsize: typing.Literal[-1, 1] = -1,
             runtime_debug: bool = False,
+            container_id: typing.Optional[str] = None,
         ) -> typing.Union[
             modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
         ]:
@@ -1357,6 +1590,7 @@ class Sandbox(modal.object.Object):
             text: bool = True,
             bufsize: typing.Literal[-1, 1] = -1,
             runtime_debug: bool = False,
+            container_id: typing.Optional[str] = None,
         ) -> typing.Union[
             modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
         ]:
@@ -1378,6 +1612,7 @@ class Sandbox(modal.object.Object):
             text: bool = True,
             bufsize: typing.Literal[-1, 1] = -1,
             runtime_debug: bool = False,
+            container_id: typing.Optional[str] = None,
         ) -> typing.Union[
             modal.container_process.ContainerProcess[bytes], modal.container_process.ContainerProcess[str]
         ]:

modal/volume.py

@@ -740,7 +740,7 @@ class _Volume(_Object, type_prefix="vo"):
         except modal.exception.NotFoundError as exc:
             raise FileNotFoundError(exc.args[0])
 
-        @retry(n_attempts=5, base_delay=0.1, timeout=None)
+        @retry(n_attempts=5, base_delay=0.1, attempt_timeout=None)
         async def read_block(block_url: str) -> bytes:
             async with ClientSessionRegistry.get_session().get(block_url) as get_response:
                 get_response.raise_for_status()
@@ -806,7 +806,7 @@ class _Volume(_Object, type_prefix="vo"):
         write_lock = asyncio.Lock()
         start_pos = fileobj.tell()
 
-        @retry(n_attempts=5, base_delay=0.1, timeout=None)
+        @retry(n_attempts=5, base_delay=0.1, attempt_timeout=None)
         async def download_block(idx, url) -> int:
             block_start_pos = start_pos + idx * BLOCK_SIZE
             num_bytes_written = 0
@@ -1369,7 +1369,7 @@ async def _put_missing_blocks(
         file_progress.pending_blocks.add(missing_block.block_index)
         task_progress_cb = functools.partial(progress_cb, task_id=file_progress.task_id)
 
-        @retry(n_attempts=11, base_delay=0.5, timeout=None)
+        @retry(n_attempts=11, base_delay=0.5, attempt_timeout=None)
         async def put_missing_block_attempt(payload: BytesIOSegmentPayload) -> bytes:
             with payload.reset_on_error(subtract_progress=True):
                 async with ClientSessionRegistry.get_session().put(

{modal-1.3.6.dev8.dist-info → modal-1.3.6.dev10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.3.6.dev8
+Version: 1.3.6.dev10
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0
@@ -36,7 +36,6 @@ Dynamic: license-file
 
 [![PyPI Version](https://img.shields.io/pypi/v/modal.svg)](https://pypi.org/project/modal/)
 [![License](https://img.shields.io/badge/license-apache_2.0-darkviolet.svg)](https://github.com/modal-labs/modal-client/blob/master/LICENSE)
-[![Tests](https://github.com/modal-labs/modal-client/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/modal-labs/modal-client/actions/workflows/ci-cd.yml)
 [![Slack](https://img.shields.io/badge/slack-join-blue.svg?logo=slack)](https://modal.com/slack)
 
 The [Modal](https://modal.com/) Python SDK provides convenient, on-demand

{modal-1.3.6.dev8.dist-info → modal-1.3.6.dev10.dist-info}/RECORD

@@ -26,7 +26,7 @@ modal/app.pyi,sha256=8lv2eLKP-y3BLT1irRnzdULSD45OgU4_VbCIYEy_Ic0,56387
 modal/billing.py,sha256=B2zXa7KeMnpqi2AQINycEk-KSXVYaLTTTAQTtuf2Gfs,257
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=-IxazxLhdkNFAHS2AP2FpyTVpCDVR58RF6ecSVV59r0,14862
-modal/client.pyi,sha256=LLr14WrQldwtchJ1O4Uxs-xsxuoMtZuWI-BB4qPvhls,14930
+modal/client.pyi,sha256=ut6XUIpQGf73KLfo5x6eTZc7OrQkbKHQoYeR42zmdo8,14932
 modal/cloud_bucket_mount.py,sha256=KkaJVy5vpO_u2NtDYtv1JM-M3y4J0UtWBapTDKpQRcA,6034
 modal/cloud_bucket_mount.pyi,sha256=mGDeEd1XvxGpCE6O5jRBSfIvMXvZ5AtIybea5k-0w9w,7560
 modal/cls.py,sha256=ozx5ZVGyG6w5SQ1ouj9Y6M3yPtnpL9PfblnmqFzf694,42338
@@ -43,7 +43,7 @@ modal/file_io.py,sha256=AKTaKR4y2JO1vsmJ8tRxMhgJtHmtb-TCe1ZZYDte-w4,22221
 modal/file_io.pyi,sha256=DPaq0BhySaiCX3g56QHhyIMdU1izbfWsjpSp30JoJUU,15745
 modal/file_pattern_matcher.py,sha256=A_Kdkej6q7YQyhM_2-BvpFmPqJ0oHb54B6yf9VqvPVE,8116
 modal/functions.py,sha256=kcNHvqeGBxPI7Cgd57NIBBghkfbeFJzXO44WW0jSmao,325
-modal/functions.pyi,sha256=jnC5QZvfs_yPPwXmEoHO16xUXzX448aP6eWawVmeGko,36498
+modal/functions.pyi,sha256=mwwTcswVuCRQeVJhqiBHCbVqKieOKH3z_cIca1NIQBk,36498
 modal/gpu.py,sha256=JW8C1hIObmXGduXWyJZysvAsLxyBEiaCmtnUAGFqh-8,6852
 modal/image.py,sha256=zgCZy0OZz010fRdlzOscD-cTbC-cCTT7mRWaANJRW7Y,109360
 modal/image.pyi,sha256=QAY8F2e2kkfQHOQnT2t4B1I-VbzvbNjksJHivx-ZA4k,78536
@@ -69,8 +69,8 @@ modal/retries.py,sha256=vPWWKP-FRolJwTBuLPXdWqHV7aJfSQFgEW7vhlBBXRQ,5067
 modal/runner.py,sha256=rz3th7ZtN-UlUe7RO38J89gg4XtFlbBrSq4cOGIl1Eg,29594
 modal/runner.pyi,sha256=UgV8jEjoRgnIowZHnOWrbGjZFsLCDm6D-4gpf77H4so,9517
 modal/running_app.py,sha256=v61mapYNV1-O-Uaho5EfJlryMLvIT9We0amUOSvSGx8,1188
-modal/sandbox.py,sha256=uFU5zT2lOgGeuZRqL8CEpzO6VVGQIS0zpibfc1FUxYA,58218
-modal/sandbox.pyi,sha256=LvF04EgeFCywCigcWZEEzgBRosEv5WrkPtCD4ggy--Q,66905
+modal/sandbox.py,sha256=lJlx5FHait0BYB2anXc0ciiy78NwAWwKYszQdA6jXhA,67572
+modal/sandbox.pyi,sha256=MLPfBwHxg6EpplMjky44lhNPDb0HDFxBuImJleTJvqU,76610
 modal/sandbox_fs.py,sha256=mEgfFKGgLFO7Ncvw_iQc54htHZ66E1i56ADNnXj9NHQ,13080
 modal/sandbox_fs.pyi,sha256=qr3PWlWwHqKRa_fPe9aI2ecj-iNF-NKY52GaL_MXc1U,21245
 modal/schedule.py,sha256=ng0g0AqNY5GQI9KhkXZQ5Wam5G42glbkqVQsNpBtbDE,3078
@@ -86,7 +86,7 @@ modal/snapshot.pyi,sha256=vMYDx1s9Ds4qtH-PXgB_9RzVuS5wsTchVcclR5Q-mmM,2014
 modal/stream_type.py,sha256=A6320qoAAWhEfwOCZfGtymQTu5AfLfJXXgARqooTPvY,417
 modal/token_flow.py,sha256=muvMsYAcLB2X1s61K-ChGNnu-vPpQUW1N8IYOrA8eho,7036
 modal/token_flow.pyi,sha256=5zdXJ5SLLHM4j6xSPuEvnpSeEJBbzE6NkSX-MSyE5wM,2282
-modal/volume.py,sha256=W55RPwGQfSeuZjZEyslsCtLnK-WOFTaBJm9jMYWVOYw,55699
+modal/volume.py,sha256=p4IV7_aEIX9HfjTr1qHN93b6WbXfTHhuC1JppmtQikk,55723
 modal/volume.pyi,sha256=34G4oA5WUL5Bs0kDlniUMuE_uWsxzbr9hLJFrY77yIo,56014
 modal/_output/__init__.py,sha256=xtGN6SPv2zvByrJ32JPao0yJKpxyCIZ-2JMTScrisuQ,28
 modal/_output/manager.py,sha256=8JGUm8S1PfiibvyI1t_pcniktZbe8KAV1TvLtoZ80rk,18161
@@ -105,9 +105,9 @@ modal/_runtime/user_code_event_loop.py,sha256=HwOuDyCZLOakr_DG7p2MrcscjSQNheIhBB
 modal/_runtime/user_code_imports.py,sha256=k_lyShheLnoaHmOcJQReYHabtsfjEE65kJD5k_GklwM,28630
 modal/_utils/__init__.py,sha256=waLjl5c6IPDhSsdWAm9Bji4e2PVxamYABKAze6CHVXY,28
 modal/_utils/app_utils.py,sha256=88BT4TPLWfYAQwKTHcyzNQRHg8n9B-QE2UyJs96iV-0,108
-modal/_utils/async_utils.py,sha256=NihG4l0HdoSCUxEjn8pYyPQH_NygT6f_MyBL37LrB1E,44775
+modal/_utils/async_utils.py,sha256=_TOC0EtzsUNrAZlAsInOIx4PiJBcoSCimj3zOZUUURQ,45268
 modal/_utils/auth_token_manager.py,sha256=QsDokl1c1dN9m6Z9N-Se-8cY3laphByjJtNdRXUTieI,5151
-modal/_utils/blob_utils.py,sha256=LIWNN7w0ma5IG1rP3gaOrn6YKcGTXMbI1_rSpJay8pY,23147
+modal/_utils/blob_utils.py,sha256=ddyCEebpbRmORcPPCY2YojpXxlm_Apa1n7Q6sZCiNkc,23163
 modal/_utils/browser_utils.py,sha256=Yqq0qU4Id6oaDOdeT1JEmbCN7vj4baNJJraJhRWU8ZI,1085
 modal/_utils/bytes_io_segment_payload.py,sha256=vaXPq8b52-x6G2hwE7SrjS58pg_aRm7gV3bn3yjmTzQ,4261
 modal/_utils/deprecation.py,sha256=-Bgg7jZdcJU8lROy18YyVnQYbM8hue-hVmwJqlWAGH0,5504
@@ -115,7 +115,7 @@ modal/_utils/docker_utils.py,sha256=h1uETghR40mp_y3fSWuZAfbIASH1HMzuphJHghAL6DU,
 modal/_utils/function_utils.py,sha256=GW2TjK_dIvB_yjjmzu3ozF9rgmcj73BWBXhQxkIkrlU,24079
 modal/_utils/git_utils.py,sha256=qtUU6JAttF55ZxYq51y55OR58B0tDPZsZWK5dJe6W5g,3182
 modal/_utils/grpc_testing.py,sha256=fZLyfMA5VYmIo-dUCcKQrVCH3ZKPT7K4_6ww373jt0Y,8697
-modal/_utils/grpc_utils.py,sha256=-5g-qg3xpfu_fGdPmLmaIi8lzkBOzS3SrnmJjhT8KKI,16627
+modal/_utils/grpc_utils.py,sha256=Ellqt21PdyiC1cB5E3HM0Gi67M864mjN2H3q989JGXY,17044
 modal/_utils/hash_utils.py,sha256=zg3J6OGxTFGSFri1qQ12giDz90lWk8bzaxCTUCRtiX4,3034
 modal/_utils/http_utils.py,sha256=yeTFsXYr0rYMEhB7vBP7audG9Uc7OLhzKBANFDZWVt0,2451
 modal/_utils/jwt_utils.py,sha256=fxH9plyrbAemTbjSsQtzIdDXE9QXxvMC4DiUZ16G0aA,1360
@@ -127,7 +127,7 @@ modal/_utils/pattern_utils.py,sha256=ZUffaECfe2iYBhH6cvCB-0-UWhmEBTZEl_TwG_So3ag
 modal/_utils/rand_pb_testing.py,sha256=oNtQB1BY9CDh7vDXEkJitCuCu9a2ufk0KRcEuZ15d0k,4229
 modal/_utils/sandbox_fs_utils.py,sha256=BZQXwfWMQHXTw_5u1ttbb2Ouxxbe3W7DaJDTJZPbMAs,6536
 modal/_utils/shell_utils.py,sha256=GjMrO1YxnBr4_UlpA2ZYQKCHxV78QTg0mqxAMHWGTE4,3427
-modal/_utils/task_command_router_client.py,sha256=BnlOtEtFTwJFDaCDMlu21PSj0Y4AloboyJObmnRCwqM,23347
+modal/_utils/task_command_router_client.py,sha256=VLzjgwdSFZvub6MxsjsWtx2a4UwI2SCbK5-K4GGpHz0,25363
 modal/_utils/time_utils.py,sha256=VVrIwm7YMv2vMznNGknkGzyATDp5iJ29F_7NZPfm5b0,7062
 modal/_vendor/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal/_vendor/a2wsgi_wsgi.py,sha256=Q1AsjpV_Q_vzQsz_cSqmP9jWzsGsB-ARFU6vpQYml8k,21878
@@ -163,7 +163,7 @@ modal/cli/queues.py,sha256=0sl1aydtudoH9RYLyUAK7FJSJ8oCtgYkkENQJ_7ifXc,6230
 modal/cli/run.py,sha256=kpdTvbNa3jvxJGYmIt6Eh5MJjLPctFusfK2Tq8jOWbM,21389
 modal/cli/secret.py,sha256=yBpjzzkbA2dNb_Q_2qqltMvCfhzUxDH7-xehLiqrvhI,8061
 modal/cli/selector.py,sha256=2P4fAgvntNLBJaMjZdDHHopCSoefHKpCMfKGzXzk9jc,4178
-modal/cli/shell.py,sha256=L5Dw8yeuu9-f6vNlBGbUT4oh9AVSK4GuB5J6m6vYLBk,12613
+modal/cli/shell.py,sha256=oJT5U7ZTW7KJZ2cFl44su_zrbsvaPJKWAWvwuCEX3CQ,14663
 modal/cli/token.py,sha256=KIEOgHJ-k1t2h6tolBmQJSSOJlpU3kvmH_IKQzaHhig,4098
 modal/cli/utils.py,sha256=aLTpttgH2lkOAC6HRtaAMCIKgo-zluvC_d-yQ3gsrz4,6462
 modal/cli/volume.py,sha256=Tp97ekMTEHT0NXwgyEudO8yIZ75OGOfjIfH44WS5r9Y,11026
@@ -174,7 +174,7 @@ modal/experimental/__init__.py,sha256=4UyAPlExXYM0tJH7s6WSDt2dIfSVXvzARkRLsLMyuq
 modal/experimental/flash.py,sha256=ATGhVO8AleJ-TOe2PGolI5T7zfCEtj0kl_ivMPp7Rqg,33362
 modal/experimental/flash.pyi,sha256=R4h2nQl7-oiwqq_twCp0YqID_LnPjPGqxywXvxbiLIk,17011
 modal/experimental/ipython.py,sha256=TrCfmol9LGsRZMeDoeMPx3Hv3BFqQhYnmD_iH0pqdhk,2904
-modal-1.3.6.dev8.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.3.6.dev10.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=5sVABw4uGUqPXjcWT0Nqjkpe5KLs89C3tFnla58-D0M,3756
 modal_docs/gen_cli_docs_main.py,sha256=UPGr7O1DYTIRLwfINe2rbdh89J3cPVTU1OWL-SjxnOQ,198
@@ -196,10 +196,10 @@ modal_proto/task_command_router_pb2.py,sha256=uSSR8Y9Yp07cIL60ds7__wUr5rj1uL2CQY
 modal_proto/task_command_router_pb2.pyi,sha256=utNwipYgMZUEUuWBE7sJ5cNjRctozHKPKDRpLy6cPLM,25667
 modal_proto/task_command_router_pb2_grpc.py,sha256=YoinPeLc-uwFShig8gE0MluOi6n-qqJZQ3YvnKwKUz8,23194
 modal_proto/task_command_router_pb2_grpc.pyi,sha256=VUSE5l1O6ATPT8Wbj4M3faMiIy5vFxSoS5ZlKfTEpHc,7449
-modal_version/__init__.py,sha256=TQcAaacjQbH68W3yWBnqkf13UFtTR4NEtj4t4iaD0kM,120
+modal_version/__init__.py,sha256=1Wfo-F7lJ0XaY1v8peKaecTUR3Pn0XJfD1xUVedGfLc,121
 modal_version/__main__.py,sha256=nLUbubxKx7GXNzJIkTB7M7_u8080LyLM0IS0rzFkC_c,119
-modal-1.3.6.dev8.dist-info/METADATA,sha256=LwbIIVZv_hDJcsQMQ4rillVUUikSOxTm_NB7O2kgv0w,2529
-modal-1.3.6.dev8.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.3.6.dev8.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.3.6.dev8.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.3.6.dev8.dist-info/RECORD,,
+modal-1.3.6.dev10.dist-info/METADATA,sha256=ESSWZgUHODQ12XLEpz04vhV9AFdMd98V_UZ466knejI,2365
+modal-1.3.6.dev10.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.3.6.dev10.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.3.6.dev10.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.3.6.dev10.dist-info/RECORD,,

modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.3.6.dev8"
+__version__ = "1.3.6.dev10"