modal 1.4.4.dev0__tar.gz → 1.4.4.dev1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.4.4.dev0
+Version: 1.4.4.dev1
 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.dev1}/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.dev1}/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.dev1}/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.dev1}/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.dev1}/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.dev1",
     ):
         """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.dev1",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

{modal-1.4.4.dev0 → modal-1.4.4.dev1}/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,6 +47,7 @@ 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"]
@@ -222,7 +224,10 @@ class _FlashManager:
         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 +244,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 +261,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 +723,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 +764,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 +783,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.dev1}/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."""
         ...
@@ -43,6 +44,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):
@@ -114,6 +116,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 +133,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 +454,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.dev1}/modal/sandbox.py

@@ -669,8 +669,12 @@ 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.
         """
         from .app import _App
 
@@ -951,11 +955,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)
 

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

@@ -327,8 +327,12 @@ 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.
         """
         ...
 
@@ -1209,8 +1213,12 @@ 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.
             """
             ...
 
@@ -1243,8 +1251,12 @@ 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.
             """
             ...
 

{modal-1.4.4.dev0 → modal-1.4.4.dev1}/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.dev1}/modal.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.4.4.dev0
+Version: 1.4.4.dev1
 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.dev1}/modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.4.4.dev0"
+__version__ = "1.4.4.dev1"