modal 1.4.4.dev0__tar.gz → 1.4.4.dev2__tar.gz

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.4.4.dev0
+Version: 1.4.4.dev2
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/_runtime/user_code_imports.py

@@ -337,7 +337,7 @@ class _LifecycleManager:
         container_io_manager: "modal._runtime.container_io_manager.ContainerIOManager",
     ):
         # Identify the "enter" methods to run after resuming from a snapshot.
-        flash_entry = _FlashContainerEntry(self.function_def.http_config)
+        flash_entry = _FlashContainerEntry(self.function_def.http_config, is_server=self.function_def.is_server)
         if not self.function_def.is_auto_snapshot:
             post_snapshot_methods = _find_callables_for_obj(
                 self.user_cls_instance, _PartialFunctionFlags.ENTER_POST_SNAPSHOT

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/_server.py

@@ -24,6 +24,7 @@ def validate_http_server_config(
     proxy_regions: list[str],  # The regions to proxy the HTTP server to.
     startup_timeout: int,  # Maximum number of seconds to wait for the HTTP server to start.
     exit_grace_period: Optional[int],  # The time to wait for the HTTP server to exit gracefully.
+    is_server: bool = False,  # Whether this validates a `_experimental_server` config.
 ):
     if not isinstance(port, int) or port < 1 or port > 65535:
         raise InvalidError("Port must be a positive integer between 1 and 65535.")
@@ -31,10 +32,12 @@ def validate_http_server_config(
         raise InvalidError("The `startup_timeout` argument must be positive.")
     if exit_grace_period is not None and exit_grace_period < 0:
         raise InvalidError("The `exit_grace_period` argument must be non-negative.")
-    if exit_grace_period is not None and exit_grace_period > 25:
+    if not is_server and exit_grace_period is not None and exit_grace_period > 25:
         raise InvalidError("The `exit_grace_period` argument must not exceed 25 seconds.")
 
     if not proxy_regions:
+        if is_server:
+            raise InvalidError("The `routing_regions` argument must be non-empty.")
         raise InvalidError("The `proxy_regions` argument must be non-empty.")
 
 
@@ -47,7 +50,7 @@ class _Server:
     Instead, use the [`@app._experimental_server()`](https://modal.com/docs/reference/modal.App#server) decorator.
 
     ```python notest
-    @app._experimental_server(port=8000, proxy_regions=["us-east", "us-west"])
+    @app._experimental_server(port=8000, routing_regions=["us-east", "us-west"])
     class MyServer:
         @modal.enter()
         def start_server(self):

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/app.py

@@ -1156,7 +1156,7 @@ class _App:
         port: int = 8000,  # Port the HTTP server listens on
         startup_timeout: int = 30,  # Maximum startup time in seconds
         exit_grace_period: int = 0,  # Grace period for in-flight requests on shutdown
-        proxy_regions: Optional[Sequence[str]] = ["us-east"],  # Required: Regions to deploy proxy endpoints
+        routing_regions: list[str] = ["us-east"],  # Required: Regions to deploy proxy endpoints
         h2_enabled: bool = False,  # Enable HTTP/2
         target_concurrency: Optional[int] = None,  # Target concurrency for the server
         cloud: Optional[str] = None,  # Cloud provider (aws, gcp, oci, auto)
@@ -1178,7 +1178,7 @@ class _App:
         Example:
 
         ```python
-        @app._experimental_server(port=8000, proxy_regions=["us-east"])
+        @app._experimental_server(port=8000, routing_regions=["us-east"])
         class MyServer:
             @modal.enter()
             def start(self):
@@ -1195,9 +1195,10 @@ class _App:
         # Validate HTTP server config
         validate_http_server_config(
             port=port,
-            proxy_regions=proxy_regions,
+            proxy_regions=routing_regions,
             startup_timeout=startup_timeout,
             exit_grace_period=exit_grace_period,
+            is_server=True,
         )
 
         if target_concurrency is not None:
@@ -1206,7 +1207,7 @@ class _App:
 
         http_config = api_pb2.HTTPConfig(
             port=port,
-            proxy_regions=proxy_regions,
+            proxy_regions=routing_regions,
             startup_timeout=startup_timeout,
             exit_grace_period=exit_grace_period,
             h2_enabled=h2_enabled,

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/app.pyi

@@ -577,7 +577,7 @@ class _App:
         port: int = 8000,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
-        proxy_regions: typing.Optional[collections.abc.Sequence[str]] = ["us-east"],
+        routing_regions: list[str] = ["us-east"],
         h2_enabled: bool = False,
         target_concurrency: typing.Optional[int] = None,
         cloud: typing.Optional[str] = None,
@@ -599,7 +599,7 @@ class _App:
         Example:
 
         ```python
-        @app._experimental_server(port=8000, proxy_regions=["us-east"])
+        @app._experimental_server(port=8000, routing_regions=["us-east"])
         class MyServer:
             @modal.enter()
             def start(self):
@@ -1297,7 +1297,7 @@ class App:
         port: int = 8000,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
-        proxy_regions: typing.Optional[collections.abc.Sequence[str]] = ["us-east"],
+        routing_regions: list[str] = ["us-east"],
         h2_enabled: bool = False,
         target_concurrency: typing.Optional[int] = None,
         cloud: typing.Optional[str] = None,
@@ -1317,7 +1317,7 @@ class App:
         Example:
 
         ```python
-        @app._experimental_server(port=8000, proxy_regions=["us-east"])
+        @app._experimental_server(port=8000, routing_regions=["us-east"])
         class MyServer:
             @modal.enter()
             def start(self):

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/client.pyi

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

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/experimental/flash.py

@@ -37,6 +37,7 @@ class _FlashManager:
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
         h2_enabled: bool = False,
+        is_server: bool = False,
     ):
         self.client = client
         self.port = port
@@ -46,9 +47,11 @@ class _FlashManager:
         self.startup_timeout = startup_timeout
         self.exit_grace_period = exit_grace_period
         self.tunnel_manager = _forward_tunnel(port, h2_enabled=h2_enabled, client=client)
+        self.is_server = is_server
         self.stopped = False
         self.num_heartbeat_failures = 0
         self.task_id = os.environ["MODAL_TASK_ID"]
+        self.heartbeat_task = None
 
     async def is_port_connection_healthy(
         self, process: Optional[subprocess.Popen], timeout: float = 0.5
@@ -84,13 +87,22 @@ class _FlashManager:
         host = parsed_url.hostname
         port = parsed_url.port or 443
 
+        if self.is_server:
+            await self._start_server_tunnel()
+            return
+        await self._start_flash_registration(host, port)
+
+    async def _start_server_tunnel(self) -> None:
+        # Worker-side HTTP relay owns Flash registration and drain for server tasks.
+        logger.warning(f"[Modal Flash] Server tunnel opened at {self.tunnel.url}.")
+
+    async def _start_flash_registration(self, host: str, port: int) -> None:
         try:
             await self._wait_for_port_success(host, port)
         except (Exception, KeyboardInterrupt, asyncio.CancelledError):
             await self._deregister()
             await self.tunnel_manager.__aexit__(*sys.exc_info())
             raise
-
         self.heartbeat_task = asyncio.create_task(self._run_heartbeat(host, port))
         self.drain_task = asyncio.create_task(self._drain_container())
 
@@ -207,22 +219,24 @@ class _FlashManager:
             if self.heartbeat_task:
                 self.heartbeat_task.cancel()
                 try:
+                    # NOTE(gongy): We skip calling TunnelStop to avoid interrupting in-flight requests.
+                    # It is up to the user to wait after calling .stop() to drain in-flight requests.
                     await asyncio.wait_for(self.heartbeat_task, timeout=5)
+                    logger.warning(f"[Modal Flash] Stopping heartbeat task on {self.tunnel.url}.")
                 except (asyncio.TimeoutError, asyncio.CancelledError):
                     logger.warning("[Modal Flash] Heartbeat task did not stop within 5s.")
         except Exception as e:
             logger.error(f"[Modal Flash] Error stopping: {e}")
         self.stopped = True
-        logger.warning(f"[Modal Flash] No longer accepting new requests on {self.tunnel.url}.")
-
-        # NOTE(gongy): We skip calling TunnelStop to avoid interrupting in-flight requests.
-        # It is up to the user to wait after calling .stop() to drain in-flight requests.
 
     async def close(self):
         if not self.stopped:
             await self.stop()
 
-        await asyncio.sleep(self.exit_grace_period)
+        # Server tasks drain via the worker-side HTTP relay, so skip the
+        # Python-side sleep here to avoid double-counting the grace period.
+        if not self.is_server:
+            await asyncio.sleep(self.exit_grace_period)
 
         logger.warning(f"[Modal Flash] Closing tunnel on {self.tunnel.url}.")
         await self.tunnel_manager.__aexit__(*sys.exc_info())
@@ -239,6 +253,7 @@ async def flash_forward(
     startup_timeout: int = 30,
     exit_grace_period: int = 0,
     h2_enabled: bool = False,
+    is_server: bool = False,
 ) -> _FlashManager:
     """
     Forward a port to the Modal Flash service, exposing that port as a stable endpoint.
@@ -255,6 +270,7 @@ async def flash_forward(
         startup_timeout=startup_timeout,
         exit_grace_period=exit_grace_period,
         h2_enabled=h2_enabled,
+        is_server=is_server,
     )
     await manager._start()
     return manager
@@ -716,7 +732,7 @@ def _http_server(
         raise InvalidError(
             "Positional arguments are not allowed. Did you forget parentheses? Suggestion: `@modal.http_server()`."
         )
-    validate_http_server_config(port, proxy_regions, startup_timeout, exit_grace_period)
+    validate_http_server_config(port, proxy_regions, startup_timeout, exit_grace_period, is_server=False)
 
     from modal._partial_function import _PartialFunction, _PartialFunctionParams
 
@@ -757,9 +773,10 @@ class _FlashContainerEntry:
 
     flash_manager: Optional[FlashManager]  # type: ignore
 
-    def __init__(self, http_config: api_pb2.HTTPConfig):
+    def __init__(self, http_config: api_pb2.HTTPConfig, is_server: bool = False):
         self.http_config: api_pb2.HTTPConfig = http_config
         self.flash_manager = None
+        self.is_server = is_server
 
     def enter(self):
         if self.http_config != api_pb2.HTTPConfig():
@@ -775,6 +792,7 @@ class _FlashContainerEntry:
                     startup_timeout=self.http_config.startup_timeout,
                     exit_grace_period=self.http_config.exit_grace_period,
                     h2_enabled=self.http_config.h2_enabled,
+                    is_server=self.is_server,
                 )
             except Exception as e:
                 logger.warning(f"[Modal Flash] Startup failed: {e}")

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/experimental/flash.pyi

@@ -14,6 +14,7 @@ class _FlashManager:
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
         h2_enabled: bool = False,
+        is_server: bool = False,
     ):
         """Initialize self.  See help(type(self)) for accurate signature."""
         ...
@@ -22,6 +23,8 @@ class _FlashManager:
         self, process: typing.Optional[subprocess.Popen], timeout: float = 0.5
     ) -> tuple[bool, typing.Optional[Exception]]: ...
     async def _start(self): ...
+    async def _start_server_tunnel(self) -> None: ...
+    async def _start_flash_registration(self, host: str, port: int) -> None: ...
     async def _deregister(self): ...
     async def _drain_container(self):
         """Background task that checks if we've encountered too many failures and drains the container if so."""
@@ -43,6 +46,7 @@ class FlashManager:
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
         h2_enabled: bool = False,
+        is_server: bool = False,
     ): ...
 
     class __is_port_connection_healthy_spec(typing_extensions.Protocol):
@@ -61,6 +65,18 @@ class FlashManager:
 
     _start: ___start_spec
 
+    class ___start_server_tunnel_spec(typing_extensions.Protocol):
+        def __call__(self, /) -> None: ...
+        async def aio(self, /) -> None: ...
+
+    _start_server_tunnel: ___start_server_tunnel_spec
+
+    class ___start_flash_registration_spec(typing_extensions.Protocol):
+        def __call__(self, /, host: str, port: int) -> None: ...
+        async def aio(self, /, host: str, port: int) -> None: ...
+
+    _start_flash_registration: ___start_flash_registration_spec
+
     class ___deregister_spec(typing_extensions.Protocol):
         def __call__(self, /): ...
         async def aio(self, /): ...
@@ -114,6 +130,7 @@ class __flash_forward_spec(typing_extensions.Protocol):
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
         h2_enabled: bool = False,
+        is_server: bool = False,
     ) -> FlashManager:
         """Forward a port to the Modal Flash service, exposing that port as a stable endpoint.
         This is a highly experimental method that can break or be removed at any time without warning.
@@ -130,6 +147,7 @@ class __flash_forward_spec(typing_extensions.Protocol):
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
         h2_enabled: bool = False,
+        is_server: bool = False,
     ) -> FlashManager:
         """Forward a port to the Modal Flash service, exposing that port as a stable endpoint.
         This is a highly experimental method that can break or be removed at any time without warning.
@@ -450,7 +468,7 @@ class _FlashContainerEntry:
 
     flash_manager: typing.Optional[FlashManager]
 
-    def __init__(self, http_config: modal_proto.api_pb2.HTTPConfig):
+    def __init__(self, http_config: modal_proto.api_pb2.HTTPConfig, is_server: bool = False):
         """Initialize self.  See help(type(self)) for accurate signature."""
         ...
 

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/sandbox.py

@@ -1,6 +1,7 @@
 # Copyright Modal Labs 2022
 import asyncio
 import builtins
+import enum
 import json
 import os
 import time
@@ -75,11 +76,47 @@ _default_image: _Image = _Image.debian_slim()
 # e.g. 'runsc exec ...'. So we use 2**16 as the limit.
 ARG_MAX_BYTES = 2**16
 TTL_NO_EXPIRY_SENTINEL = -1
+_V1_SANDBOX_ID_ALPHABET = frozenset("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz")
+_ULID_ALPHABET = frozenset("0123456789ABCDEFGHJKMNPQRSTVWXYZ")
 
 if TYPE_CHECKING:
     import modal.app
 
 
+class SandboxVersion(enum.Enum):
+    V1 = 1
+    V2 = 2
+
+
+def _is_v1_sandbox_id(sandbox_id: str) -> bool:
+    prefix, separator, suffix = sandbox_id.partition("-")
+    return (
+        prefix == "sb"
+        and separator == "-"
+        and len(suffix) == 22
+        and all(ch in _V1_SANDBOX_ID_ALPHABET for ch in suffix)
+    )
+
+
+def _is_v2_sandbox_id(sandbox_id: str) -> bool:
+    prefix, separator, suffix = sandbox_id.partition("-")
+    return (
+        prefix == "sb"
+        and separator == "-"
+        and len(suffix) == 26
+        and suffix[0] in "01234567"
+        and all(ch in _ULID_ALPHABET for ch in suffix)
+    )
+
+
+def _get_sandbox_version(sandbox_id: str) -> SandboxVersion:
+    if _is_v2_sandbox_id(sandbox_id):
+        return SandboxVersion.V2
+    if _is_v1_sandbox_id(sandbox_id):
+        return SandboxVersion.V1
+    raise InvalidError(f"Invalid Sandbox ID: {sandbox_id!r}")
+
+
 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
@@ -669,8 +706,17 @@ class _Sandbox(_Object, type_prefix="sb"):
     ) -> "_Sandbox":
         """Create a sandbox using the V2 backend.
 
-        Features like tags, snapshots, exec, volumes, network file systems,
-        GPUs, custom domains, and proxies are not supported.
+        Supported features include exec, encrypted tunnels, wait/poll/terminate,
+        CPU and memory configuration, region placement,
+        and filesystem snapshots.
+
+        Features like tags, memory snapshots, volumes, network file systems, GPUs,
+        custom domains, OIDC identity tokens, and proxies are not supported.
+
+        V2 sandboxes created with this method are not currently returned by
+        `Sandbox.list()` and cannot be looked up with `Sandbox.from_name()`.
+        Store `sandbox.object_id` if you need to retrieve the sandbox later, and
+        use `Sandbox.from_id(sandbox.object_id)` to reattach.
         """
         from .app import _App
 
@@ -904,10 +950,18 @@ class _Sandbox(_Object, type_prefix="sb"):
         if client is None:
             client = await _Client.from_env()
 
+        sandbox_version = _get_sandbox_version(sandbox_id)
+        is_v2 = sandbox_version == SandboxVersion.V2
         req = api_pb2.SandboxWaitRequest(sandbox_id=sandbox_id, timeout=0)
-        resp = await client.stub.SandboxWait(req)
+        if is_v2:
+            assert client._auth_token_manager
+            auth_token = await client._auth_token_manager.get_token()
+            resp = await client.stub.SandboxWaitV2(req, metadata=[("x-modal-auth-token", auth_token)])
+        else:
+            resp = await client.stub.SandboxWait(req)
 
         obj = _Sandbox._new_hydrated(sandbox_id, client, None)
+        obj._is_v2 = is_v2
 
         if resp.result.status:
             obj._result = resp.result
@@ -951,11 +1005,9 @@ class _Sandbox(_Object, type_prefix="sb"):
         `timeout` If the snapshot does not return within that window, the call is cancelled
         and `modal.exception.TimeoutError` is raised.
         """
-        if os.environ.get("MODAL_USE_LEGACY_FILESYSTEM_SNAPSHOT") == "1":
+        if os.environ.get("MODAL_USE_LEGACY_FILESYSTEM_SNAPSHOT") == "1" and not self._is_v2:
             return await self._legacy_snapshot_filesystem(timeout)
 
-        self._ensure_v1("snapshot_filesystem")
-
         task_id = await self._get_task_id()
         command_router_client = await self._get_command_router_client(task_id)
 
@@ -998,7 +1050,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         # You can later mount this snapshot to another Sandbox:
         sandbox_session_2 = modal.Sandbox.create(...)
         sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-        sandbox_session_2.ls("/user_project")
+        sandbox_session_2.filesystem.list_files("/user_project")
         ```
         """
         self._ensure_v1("mount_image")
@@ -1069,7 +1121,7 @@ class _Sandbox(_Object, type_prefix="sb"):
         # You can later mount this snapshot to another Sandbox:
         sandbox_session_2 = modal.Sandbox.create(...)
         sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-        sandbox_session_2.ls("/user_project")
+        sandbox_session_2.filesystem.list_files("/user_project")
         ```
         """
         self._ensure_v1("snapshot_directory")

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/sandbox.pyi

@@ -1,5 +1,6 @@
 import _typeshed
 import collections.abc
+import enum
 import google.protobuf.message
 import modal._object
 import modal._tunnel
@@ -27,6 +28,13 @@ import pathlib
 import typing
 import typing_extensions
 
+class SandboxVersion(enum.Enum):
+    V1 = 1
+    V2 = 2
+
+def _is_v1_sandbox_id(sandbox_id: str) -> bool: ...
+def _is_v2_sandbox_id(sandbox_id: str) -> bool: ...
+def _get_sandbox_version(sandbox_id: str) -> SandboxVersion: ...
 def _result_returncode(result: typing.Optional[modal_proto.api_pb2.GenericResult]) -> typing.Optional[int]: ...
 def _validate_exec_args(args: collections.abc.Sequence[str]) -> None: ...
 
@@ -327,8 +335,17 @@ class _Sandbox(modal._object._Object):
     ) -> _Sandbox:
         """Create a sandbox using the V2 backend.
 
-        Features like tags, snapshots, exec, volumes, network file systems,
-        GPUs, custom domains, and proxies are not supported.
+        Supported features include exec, encrypted tunnels, wait/poll/terminate,
+        CPU and memory configuration, region placement,
+        and filesystem snapshots.
+
+        Features like tags, memory snapshots, volumes, network file systems, GPUs,
+        custom domains, OIDC identity tokens, and proxies are not supported.
+
+        V2 sandboxes created with this method are not currently returned by
+        `Sandbox.list()` and cannot be looked up with `Sandbox.from_name()`.
+        Store `sandbox.object_id` if you need to retrieve the sandbox later, and
+        use `Sandbox.from_id(sandbox.object_id)` to reattach.
         """
         ...
 
@@ -413,7 +430,7 @@ class _Sandbox(modal._object._Object):
         # You can later mount this snapshot to another Sandbox:
         sandbox_session_2 = modal.Sandbox.create(...)
         sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-        sandbox_session_2.ls("/user_project")
+        sandbox_session_2.filesystem.list_files("/user_project")
         ```
         """
         ...
@@ -439,7 +456,7 @@ class _Sandbox(modal._object._Object):
         # You can later mount this snapshot to another Sandbox:
         sandbox_session_2 = modal.Sandbox.create(...)
         sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-        sandbox_session_2.ls("/user_project")
+        sandbox_session_2.filesystem.list_files("/user_project")
         ```
         """
         ...
@@ -1209,8 +1226,17 @@ class Sandbox(modal.object.Object):
         ) -> Sandbox:
             """Create a sandbox using the V2 backend.
 
-            Features like tags, snapshots, exec, volumes, network file systems,
-            GPUs, custom domains, and proxies are not supported.
+            Supported features include exec, encrypted tunnels, wait/poll/terminate,
+            CPU and memory configuration, region placement,
+            and filesystem snapshots.
+
+            Features like tags, memory snapshots, volumes, network file systems, GPUs,
+            custom domains, OIDC identity tokens, and proxies are not supported.
+
+            V2 sandboxes created with this method are not currently returned by
+            `Sandbox.list()` and cannot be looked up with `Sandbox.from_name()`.
+            Store `sandbox.object_id` if you need to retrieve the sandbox later, and
+            use `Sandbox.from_id(sandbox.object_id)` to reattach.
             """
             ...
 
@@ -1243,8 +1269,17 @@ class Sandbox(modal.object.Object):
         ) -> Sandbox:
             """Create a sandbox using the V2 backend.
 
-            Features like tags, snapshots, exec, volumes, network file systems,
-            GPUs, custom domains, and proxies are not supported.
+            Supported features include exec, encrypted tunnels, wait/poll/terminate,
+            CPU and memory configuration, region placement,
+            and filesystem snapshots.
+
+            Features like tags, memory snapshots, volumes, network file systems, GPUs,
+            custom domains, OIDC identity tokens, and proxies are not supported.
+
+            V2 sandboxes created with this method are not currently returned by
+            `Sandbox.list()` and cannot be looked up with `Sandbox.from_name()`.
+            Store `sandbox.object_id` if you need to retrieve the sandbox later, and
+            use `Sandbox.from_id(sandbox.object_id)` to reattach.
             """
             ...
 
@@ -1408,7 +1443,7 @@ class Sandbox(modal.object.Object):
             # You can later mount this snapshot to another Sandbox:
             sandbox_session_2 = modal.Sandbox.create(...)
             sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-            sandbox_session_2.ls("/user_project")
+            sandbox_session_2.filesystem.list_files("/user_project")
             ```
             """
             ...
@@ -1433,7 +1468,7 @@ class Sandbox(modal.object.Object):
             # You can later mount this snapshot to another Sandbox:
             sandbox_session_2 = modal.Sandbox.create(...)
             sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-            sandbox_session_2.ls("/user_project")
+            sandbox_session_2.filesystem.list_files("/user_project")
             ```
             """
             ...
@@ -1474,7 +1509,7 @@ class Sandbox(modal.object.Object):
             # You can later mount this snapshot to another Sandbox:
             sandbox_session_2 = modal.Sandbox.create(...)
             sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-            sandbox_session_2.ls("/user_project")
+            sandbox_session_2.filesystem.list_files("/user_project")
             ```
             """
             ...
@@ -1491,7 +1526,7 @@ class Sandbox(modal.object.Object):
             # You can later mount this snapshot to another Sandbox:
             sandbox_session_2 = modal.Sandbox.create(...)
             sandbox_session_2.mount_image("/user_project", user_project_snapshot)
-            sandbox_session_2.ls("/user_project")
+            sandbox_session_2.filesystem.list_files("/user_project")
             ```
             """
             ...

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal/server.pyi

@@ -14,7 +14,7 @@ class Server:
     Instead, use the [`@app._experimental_server()`](https://modal.com/docs/reference/modal.App#server) decorator.
 
     ```python notest
-    @app._experimental_server(port=8000, proxy_regions=["us-east", "us-west"])
+    @app._experimental_server(port=8000, routing_regions=["us-east", "us-west"])
     class MyServer:
         @modal.enter()
         def start_server(self):

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.4.4.dev0
+Version: 1.4.4.dev2
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0

{modal-1.4.4.dev0 → modal-1.4.4.dev2}/modal_proto/api_grpc.py

@@ -263,6 +263,10 @@ class ModalClientBase(abc.ABC):
     async def EndpointCreate(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.EndpointCreateRequest, modal_proto.api_pb2.EndpointCreateResponse]') -> None:
         pass
 
+    @abc.abstractmethod
+    async def EndpointList(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.EndpointListRequest, modal_proto.api_pb2.EndpointListResponse]') -> None:
+        pass
+
     @abc.abstractmethod
     async def EnvironmentCreate(self, stream: 'grpclib.server.Stream[modal_proto.api_pb2.EnvironmentCreateRequest, google.protobuf.empty_pb2.Empty]') -> None:
         pass
@@ -1183,6 +1187,12 @@ class ModalClientBase(abc.ABC):
                 modal_proto.api_pb2.EndpointCreateRequest,
                 modal_proto.api_pb2.EndpointCreateResponse,
             ),
+            '/modal.client.ModalClient/EndpointList': grpclib.const.Handler(
+                self.EndpointList,
+                grpclib.const.Cardinality.UNARY_UNARY,
+                modal_proto.api_pb2.EndpointListRequest,
+                modal_proto.api_pb2.EndpointListResponse,
+            ),
             '/modal.client.ModalClient/EnvironmentCreate': grpclib.const.Handler(
                 self.EnvironmentCreate,
                 grpclib.const.Cardinality.UNARY_UNARY,
@@ -2383,6 +2393,12 @@ class ModalClientStub:
             modal_proto.api_pb2.EndpointCreateRequest,
             modal_proto.api_pb2.EndpointCreateResponse,
         )
+        self.EndpointList = grpclib.client.UnaryUnaryMethod(
+            channel,
+            '/modal.client.ModalClient/EndpointList',
+            modal_proto.api_pb2.EndpointListRequest,
+            modal_proto.api_pb2.EndpointListResponse,
+        )
         self.EnvironmentCreate = grpclib.client.UnaryUnaryMethod(
             channel,
             '/modal.client.ModalClient/EnvironmentCreate',