modal 1.1.2.dev44__tar.gz → 1.1.3__tar.gz

{modal-1.1.2.dev44 → modal-1.1.3}/PKG-INFO

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

{modal-1.1.2.dev44 → modal-1.1.3}/modal/_functions.py

@@ -9,7 +9,7 @@ import warnings
 from collections.abc import AsyncGenerator, Sequence, Sized
 from dataclasses import dataclass
 from pathlib import PurePosixPath
-from typing import TYPE_CHECKING, Any, Callable, Optional, Union
+from typing import TYPE_CHECKING, Any, AsyncIterator, Callable, Optional, Union
 
 import typing_extensions
 from google.protobuf.message import Message
@@ -100,6 +100,10 @@ if TYPE_CHECKING:
     import modal.partial_function
 
 MAX_INTERNAL_FAILURE_COUNT = 8
+TERMINAL_STATUSES = (
+    api_pb2.GenericResult.GENERIC_STATUS_SUCCESS,
+    api_pb2.GenericResult.GENERIC_STATUS_TERMINATED,
+)
 
 
 @dataclasses.dataclass
@@ -300,11 +304,7 @@ class _Invocation:
 
         while True:
             item = await self._get_single_output(ctx.input_jwt)
-            if item.result.status in (
-                api_pb2.GenericResult.GENERIC_STATUS_SUCCESS,
-                api_pb2.GenericResult.GENERIC_STATUS_TERMINATED,
-            ):
-                # success or cancellations are "final" results
+            if item.result.status in TERMINAL_STATUSES:
                 return await _process_result(item.result, item.data_format, self.stub, self.client)
 
             if item.result.status != api_pb2.GenericResult.GENERIC_STATUS_INTERNAL_FAILURE:
@@ -360,6 +360,43 @@ class _Invocation:
                 if items_total is not None and items_received >= items_total:
                     break
 
+    async def enumerate(self, start_index: int, end_index: int):
+        """Iterate over the results of the function call in the range [start_index, end_index)."""
+        limit = 49
+        current_index = start_index
+        while current_index < end_index:
+            # batch_end_indx is inclusive, so we subtract 1 to get the last index in the batch.
+            batch_end_index = min(current_index + limit, end_index) - 1
+            request = api_pb2.FunctionGetOutputsRequest(
+                function_call_id=self.function_call_id,
+                timeout=0,
+                last_entry_id="0-0",
+                clear_on_success=False,
+                requested_at=time.time(),
+                start_idx=current_index,
+                end_idx=batch_end_index,
+            )
+            response: api_pb2.FunctionGetOutputsResponse = await retry_transient_errors(
+                self.stub.FunctionGetOutputs,
+                request,
+                attempt_timeout=ATTEMPT_TIMEOUT_GRACE_PERIOD,
+            )
+
+            outputs = list(response.outputs)
+            outputs.sort(key=lambda x: x.idx)
+            for output in outputs:
+                if output.idx != current_index:
+                    break
+                result = await _process_result(output.result, output.data_format, self.stub, self.client)
+                yield output.idx, result
+                current_index += 1
+
+            # We're missing current_index, so we need to poll the function for the next result
+            if len(outputs) < (batch_end_index - current_index + 1):
+                result = await self.poll_function(index=current_index)
+                yield current_index, result
+                current_index += 1
+
 
 class _InputPlaneInvocation:
     """Internal client representation of a single-input call to a Modal Function using the input
@@ -374,6 +411,7 @@ class _InputPlaneInvocation:
         client: _Client,
         input_item: api_pb2.FunctionPutInputsItem,
         function_id: str,
+        retry_policy: api_pb2.FunctionRetryPolicy,
         input_plane_region: str,
     ):
         self.stub = stub
@@ -381,6 +419,7 @@ class _InputPlaneInvocation:
         self.attempt_token = attempt_token
         self.input_item = input_item
         self.function_id = function_id
+        self.retry_policy = retry_policy
         self.input_plane_region = input_plane_region
 
     @staticmethod
@@ -416,11 +455,15 @@ class _InputPlaneInvocation:
         response = await retry_transient_errors(stub.AttemptStart, request, metadata=metadata)
         attempt_token = response.attempt_token
 
-        return _InputPlaneInvocation(stub, attempt_token, client, input_item, function_id, input_plane_region)
+        return _InputPlaneInvocation(
+            stub, attempt_token, client, input_item, function_id, response.retry_policy, input_plane_region
+        )
 
     async def run_function(self) -> Any:
+        # User errors including timeouts are managed by the user-specified retry policy.
+        user_retry_manager = RetryManager(self.retry_policy)
+
         # This will retry when the server returns GENERIC_STATUS_INTERNAL_FAILURE, i.e. lost inputs or worker preemption
-        # TODO(ryan): add logic to retry for user defined retry policy
         internal_failure_count = 0
         while True:
             await_request = api_pb2.AttemptAwaitRequest(
@@ -437,32 +480,48 @@ class _InputPlaneInvocation:
             )
 
             if await_response.HasField("output"):
+                if await_response.output.result.status in TERMINAL_STATUSES:
+                    return await _process_result(
+                        await_response.output.result, await_response.output.data_format, self.client.stub, self.client
+                    )
+
                 if await_response.output.result.status == api_pb2.GenericResult.GENERIC_STATUS_INTERNAL_FAILURE:
                     internal_failure_count += 1
                     # Limit the number of times we retry
                     if internal_failure_count < MAX_INTERNAL_FAILURE_COUNT:
                         # For system failures on the server, we retry immediately,
                         # and the failure does not count towards the retry policy.
-                        retry_request = api_pb2.AttemptRetryRequest(
-                            function_id=self.function_id,
-                            parent_input_id=current_input_id() or "",
-                            input=self.input_item,
-                            attempt_token=self.attempt_token,
-                        )
-                        # TODO(ryan): Add exponential backoff?
-                        retry_response = await retry_transient_errors(
-                            self.stub.AttemptRetry,
-                            retry_request,
-                            metadata=metadata,
-                        )
-                        self.attempt_token = retry_response.attempt_token
+                        self.attempt_token = await self._retry_input(metadata)
                         continue
 
-                control_plane_stub = self.client.stub
-                # Note: Blob download is done on the control plane stub, not the input plane stub!
-                return await _process_result(
-                    await_response.output.result, await_response.output.data_format, control_plane_stub, self.client
-                )
+                # We add delays between retries for non-internal failures.
+                delay_ms = user_retry_manager.get_delay_ms()
+                if delay_ms is None:
+                    # No more retries either because we reached the retry limit or user didn't set a retry policy
+                    # and the limit defaulted to 0.
+                    # An unsuccessful status should raise an error when it's converted to an exception.
+                    # Note: Blob download is done on the control plane stub not the input plane stub!
+                    return await _process_result(
+                        await_response.output.result, await_response.output.data_format, self.client.stub, self.client
+                    )
+                await asyncio.sleep(delay_ms / 1000)
+
+            await self._retry_input(metadata)
+
+    async def _retry_input(self, metadata: list[tuple[str, str]]) -> str:
+        retry_request = api_pb2.AttemptRetryRequest(
+            function_id=self.function_id,
+            parent_input_id=current_input_id() or "",
+            input=self.input_item,
+            attempt_token=self.attempt_token,
+        )
+        # TODO(ryan): Add exponential backoff?
+        retry_response = await retry_transient_errors(
+            self.stub.AttemptRetry,
+            retry_request,
+            metadata=metadata,
+        )
+        return retry_response.attempt_token
 
     async def run_generator(self):
         items_received = 0
@@ -1865,6 +1924,36 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         """
         return await self._invocation().poll_function(timeout=timeout, index=index)
 
+    @live_method_gen
+    async def iter(self, *, start: int = 0, end: Optional[int] = None) -> AsyncIterator[ReturnType]:
+        """Iterate in-order over the results of the function call.
+
+        Optionally, specify a range [start, end) to iterate over.
+
+        Example:
+        ```python
+        @app.function()
+        def my_func(a):
+            return a ** 2
+
+
+        @app.local_entrypoint()
+        def main():
+            fc = my_func.spawn_map([1, 2, 3, 4])
+            assert list(fc.iter()) == [1, 4, 9, 16]
+            assert list(fc.iter(start=1, end=3)) == [4, 9]
+        ```
+
+        If `end` is not provided, it will iterate over all results.
+        """
+        num_inputs = await self.num_inputs()
+        if end is None:
+            end = num_inputs
+        if start < 0 or end > num_inputs:
+            raise ValueError(f"Invalid index range: {start} to {end} for {num_inputs} inputs")
+        async for _, item in self._invocation().enumerate(start_index=start, end_index=end):
+            yield item
+
     async def get_call_graph(self) -> list[InputInfo]:
         """Returns a structure representing the call graph from a given root
         call ID, along with the status of execution for each node.
@@ -1926,6 +2015,7 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         fc: _FunctionCall[Any] = _FunctionCall._from_loader(_load, rep, hydrate_lazily=True)
         # We already know the object ID, so we can set it directly
         fc._object_id = function_call_id
+        fc._client = client
         return fc
 
     @staticmethod

{modal-1.1.2.dev44 → modal-1.1.3}/modal/app.py

@@ -641,7 +641,7 @@ class _App:
         scaledown_window: Optional[int] = None,  # Max time (in seconds) a container can remain idle while scaling down.
         proxy: Optional[_Proxy] = None,  # Reference to a Modal Proxy to use in front of this function.
         retries: Optional[Union[int, Retries]] = None,  # Number of times to retry each input in case of failure.
-        timeout: int = 300,  # Maximum execution time of the function in seconds.
+        timeout: int = 300,  # Maximum execution time in seconds.
         name: Optional[str] = None,  # Sets the Modal name of the function within the app
         is_generator: Optional[
             bool
@@ -869,7 +869,7 @@ class _App:
         scaledown_window: Optional[int] = None,  # Max time (in seconds) a container can remain idle while scaling down.
         proxy: Optional[_Proxy] = None,  # Reference to a Modal Proxy to use in front of this function.
         retries: Optional[Union[int, Retries]] = None,  # Number of times to retry each input in case of failure.
-        timeout: int = 300,  # Maximum execution time of the function in seconds.
+        timeout: int = 300,  # Maximum execution time in seconds; applies independently to startup and each input.
         cloud: Optional[str] = None,  # Cloud provider to run the function on. Possible values are aws, gcp, oci, auto.
         region: Optional[Union[str, Sequence[str]]] = None,  # Region or regions to run the function on.
         enable_memory_snapshot: bool = False,  # Enable memory checkpointing for faster cold starts.

{modal-1.1.2.dev44 → modal-1.1.3}/modal/client.pyi

@@ -29,11 +29,7 @@ class _Client:
     _snapshotted: bool
 
     def __init__(
-        self,
-        server_url: str,
-        client_type: int,
-        credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.1.2.dev44",
+        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "1.1.3"
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.
@@ -160,11 +156,7 @@ class Client:
     _snapshotted: bool
 
     def __init__(
-        self,
-        server_url: str,
-        client_type: int,
-        credentials: typing.Optional[tuple[str, str]],
-        version: str = "1.1.2.dev44",
+        self, server_url: str, client_type: int, credentials: typing.Optional[tuple[str, str]], version: str = "1.1.3"
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

{modal-1.1.2.dev44 → modal-1.1.3}/modal/dict.py

@@ -81,6 +81,8 @@ class _DictManager:
         Note that this method does not return a local instance of the Dict. You can use
         `modal.Dict.from_name` to perform a lookup after creation.
 
+        Added in v1.1.2.
+
         """
         check_object_name(name, "Dict")
         client = await _Client.from_env() if client is None else client
@@ -132,6 +134,8 @@ class _DictManager:
         dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
         ```
 
+        Added in v1.1.2.
+
         """
         client = await _Client.from_env() if client is None else client
         if max_objects is not None and max_objects < 0:
@@ -192,6 +196,9 @@ class _DictManager:
         ```python notest
         await modal.Dict.objects.delete("my-dict", environment_name="dev")
         ```
+
+        Added in v1.1.2.
+
         """
         try:
             obj = await _Dict.from_name(name, environment_name=environment_name).hydrate(client)

{modal-1.1.2.dev44 → modal-1.1.3}/modal/dict.pyi

@@ -66,6 +66,8 @@ class _DictManager:
 
         Note that this method does not return a local instance of the Dict. You can use
         `modal.Dict.from_name` to perform a lookup after creation.
+
+        Added in v1.1.2.
         """
         ...
 
@@ -98,6 +100,8 @@ class _DictManager:
         ```python
         dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -125,6 +129,8 @@ class _DictManager:
         ```python notest
         await modal.Dict.objects.delete("my-dict", environment_name="dev")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -167,6 +173,8 @@ class DictManager:
 
             Note that this method does not return a local instance of the Dict. You can use
             `modal.Dict.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -202,6 +210,8 @@ class DictManager:
 
             Note that this method does not return a local instance of the Dict. You can use
             `modal.Dict.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -238,6 +248,8 @@ class DictManager:
             ```python
             dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -271,6 +283,8 @@ class DictManager:
             ```python
             dicts = modal.Dict.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -302,6 +316,8 @@ class DictManager:
             ```python notest
             await modal.Dict.objects.delete("my-dict", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -330,6 +346,8 @@ class DictManager:
             ```python notest
             await modal.Dict.objects.delete("my-dict", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 

{modal-1.1.2.dev44 → modal-1.1.3}/modal/functions.pyi

@@ -788,6 +788,55 @@ class FunctionCall(typing.Generic[modal._functions.ReturnType], modal.object.Obj
 
     get: __get_spec[modal._functions.ReturnType, typing_extensions.Self]
 
+    class __iter_spec(typing_extensions.Protocol[ReturnType_INNER, SUPERSELF]):
+        def __call__(self, /, *, start: int = 0, end: typing.Optional[int] = None) -> typing.Iterator[ReturnType_INNER]:
+            """Iterate in-order over the results of the function call.
+
+            Optionally, specify a range [start, end) to iterate over.
+
+            Example:
+            ```python
+            @app.function()
+            def my_func(a):
+                return a ** 2
+
+
+            @app.local_entrypoint()
+            def main():
+                fc = my_func.spawn_map([1, 2, 3, 4])
+                assert list(fc.iter()) == [1, 4, 9, 16]
+                assert list(fc.iter(start=1, end=3)) == [4, 9]
+            ```
+
+            If `end` is not provided, it will iterate over all results.
+            """
+            ...
+
+        def aio(self, /, *, start: int = 0, end: typing.Optional[int] = None) -> typing.AsyncIterator[ReturnType_INNER]:
+            """Iterate in-order over the results of the function call.
+
+            Optionally, specify a range [start, end) to iterate over.
+
+            Example:
+            ```python
+            @app.function()
+            def my_func(a):
+                return a ** 2
+
+
+            @app.local_entrypoint()
+            def main():
+                fc = my_func.spawn_map([1, 2, 3, 4])
+                assert list(fc.iter()) == [1, 4, 9, 16]
+                assert list(fc.iter(start=1, end=3)) == [4, 9]
+            ```
+
+            If `end` is not provided, it will iterate over all results.
+            """
+            ...
+
+    iter: __iter_spec[modal._functions.ReturnType, typing_extensions.Self]
+
     class __get_call_graph_spec(typing_extensions.Protocol[SUPERSELF]):
         def __call__(self, /) -> list[modal.call_graph.InputInfo]:
             """Returns a structure representing the call graph from a given root

{modal-1.1.2.dev44 → modal-1.1.3}/modal/image.py

@@ -1356,7 +1356,8 @@ class _Image(_Object, type_prefix="im"):
         image = modal.Image.debian_slim().uv_sync()
         ```
 
-        The `pyproject.toml` and `uv.lock` in `uv_project_dir` are automatically added to the build context.
+        The `pyproject.toml` and `uv.lock` in `uv_project_dir` are automatically added to the build context. The
+        `uv_project_dir` is relative to the current working directory of where `modal` is called.
 
         Added in v1.1.0.
         """

{modal-1.1.2.dev44 → modal-1.1.3}/modal/image.pyi

@@ -524,7 +524,8 @@ class _Image(modal._object._Object):
         image = modal.Image.debian_slim().uv_sync()
         ```
 
-        The `pyproject.toml` and `uv.lock` in `uv_project_dir` are automatically added to the build context.
+        The `pyproject.toml` and `uv.lock` in `uv_project_dir` are automatically added to the build context. The
+        `uv_project_dir` is relative to the current working directory of where `modal` is called.
 
         Added in v1.1.0.
         """
@@ -1368,7 +1369,8 @@ class Image(modal.object.Object):
         image = modal.Image.debian_slim().uv_sync()
         ```
 
-        The `pyproject.toml` and `uv.lock` in `uv_project_dir` are automatically added to the build context.
+        The `pyproject.toml` and `uv.lock` in `uv_project_dir` are automatically added to the build context. The
+        `uv_project_dir` is relative to the current working directory of where `modal` is called.
 
         Added in v1.1.0.
         """

{modal-1.1.2.dev44 → modal-1.1.3}/modal/parallel_map.py

@@ -673,9 +673,11 @@ async def _map_invocation_inputplane(
     # any reason).
     max_inputs_outstanding = MAX_INPUTS_OUTSTANDING_DEFAULT
 
-    # Input plane does not yet return a retry policy. So we currently disable retries.
+    # Set a default retry policy to construct an instance of _MapItemsManager.
+    # We'll update the retry policy with the actual user-specified retry policy
+    # from the server in the first MapStartOrContinue response.
     retry_policy = api_pb2.FunctionRetryPolicy(
-        retries=0,  # Input plane does not yet return a retry policy. So only retry server failures for now.
+        retries=0,
         initial_delay_ms=1000,
         max_delay_ms=1000,
         backoff_coefficient=1.0,
@@ -771,10 +773,17 @@ async def _map_invocation_inputplane(
 
             map_items_manager.handle_put_continue_response(response_items_idx_tuple)
 
+            # Set the function call id and actual retry policy with the data from the first response.
+            # This conditional is skipped for subsequent iterations of this for-loop.
             if function_call_id is None:
                 function_call_id = response.function_call_id
                 function_call_id_received.set()
                 max_inputs_outstanding = response.max_inputs_outstanding or MAX_INPUTS_OUTSTANDING_DEFAULT
+                map_items_manager.set_retry_policy(response.retry_policy)
+                # Update the retry policy for the first batch of inputs.
+                # Subsequent batches will have the correct user-specified retry policy
+                # set by the updated _MapItemsManager.
+                map_items_manager.update_items_retry_policy(response.retry_policy)
         yield
 
     async def check_lost_inputs():
@@ -1475,6 +1484,9 @@ class _MapItemContext:
             retry_count=self.retry_manager.retry_count,
         )
 
+    def set_retry_policy(self, retry_policy: api_pb2.FunctionRetryPolicy):
+        self.retry_manager = RetryManager(retry_policy)
+
     def handle_retry_response(self, input_jwt: str):
         self.input_jwt.set_result(input_jwt)
         self.state = _MapItemState.WAITING_FOR_OUTPUT
@@ -1511,6 +1523,9 @@ class _MapItemsManager:
         self._sync_client_retries_enabled = sync_client_retries_enabled
         self._is_input_plane_instance = is_input_plane_instance
 
+    def set_retry_policy(self, retry_policy: api_pb2.FunctionRetryPolicy):
+        self._retry_policy = retry_policy
+
     async def add_items(self, items: list[api_pb2.FunctionPutInputsItem]):
         for item in items:
             # acquire semaphore to limit the number of inputs in progress
@@ -1540,6 +1555,10 @@ class _MapItemsManager:
     async def prepare_items_for_retry(self, retriable_idxs: list[int]) -> list[api_pb2.FunctionRetryInputsItem]:
         return [await self._item_context[idx].prepare_item_for_retry() for idx in retriable_idxs]
 
+    def update_items_retry_policy(self, retry_policy: api_pb2.FunctionRetryPolicy):
+        for ctx in self._item_context.values():
+            ctx.set_retry_policy(retry_policy)
+
     def get_input_jwts_waiting_for_output(self) -> list[str]:
         """
         Returns a list of input_jwts for inputs that are waiting for output.

{modal-1.1.2.dev44 → modal-1.1.3}/modal/parallel_map.pyi

@@ -406,6 +406,7 @@ class _MapItemContext:
         ...
 
     async def prepare_item_for_retry(self) -> modal_proto.api_pb2.FunctionRetryInputsItem: ...
+    def set_retry_policy(self, retry_policy: modal_proto.api_pb2.FunctionRetryPolicy): ...
     def handle_retry_response(self, input_jwt: str): ...
     async def create_map_start_or_continue_item(self, idx: int) -> modal_proto.api_pb2.MapStartOrContinueItem: ...
 
@@ -422,11 +423,13 @@ class _MapItemsManager:
         """Initialize self.  See help(type(self)) for accurate signature."""
         ...
 
+    def set_retry_policy(self, retry_policy: modal_proto.api_pb2.FunctionRetryPolicy): ...
     async def add_items(self, items: list[modal_proto.api_pb2.FunctionPutInputsItem]): ...
     async def add_items_inputplane(self, items: list[modal_proto.api_pb2.MapStartOrContinueItem]): ...
     async def prepare_items_for_retry(
         self, retriable_idxs: list[int]
     ) -> list[modal_proto.api_pb2.FunctionRetryInputsItem]: ...
+    def update_items_retry_policy(self, retry_policy: modal_proto.api_pb2.FunctionRetryPolicy): ...
     def get_input_jwts_waiting_for_output(self) -> list[str]:
         """Returns a list of input_jwts for inputs that are waiting for output."""
         ...

{modal-1.1.2.dev44 → modal-1.1.3}/modal/queue.py

@@ -79,6 +79,8 @@ class _QueueManager:
         Note that this method does not return a local instance of the Queue. You can use
         `modal.Queue.from_name` to perform a lookup after creation.
 
+        Added in v1.1.2.
+
         """
         check_object_name(name, "Queue")
         client = await _Client.from_env() if client is None else client
@@ -130,6 +132,8 @@ class _QueueManager:
         queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
         ```
 
+        Added in v1.1.2.
+
         """
         client = await _Client.from_env() if client is None else client
         if max_objects is not None and max_objects < 0:
@@ -190,6 +194,9 @@ class _QueueManager:
         ```python notest
         await modal.Queue.objects.delete("my-queue", environment_name="dev")
         ```
+
+        Added in v1.1.2.
+
         """
         try:
             obj = await _Queue.from_name(name, environment_name=environment_name).hydrate(client)

{modal-1.1.2.dev44 → modal-1.1.3}/modal/queue.pyi

@@ -64,6 +64,8 @@ class _QueueManager:
 
         Note that this method does not return a local instance of the Queue. You can use
         `modal.Queue.from_name` to perform a lookup after creation.
+
+        Added in v1.1.2.
         """
         ...
 
@@ -96,6 +98,8 @@ class _QueueManager:
         ```python
         queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -123,6 +127,8 @@ class _QueueManager:
         ```python notest
         await modal.Queue.objects.delete("my-queue", environment_name="dev")
         ```
+
+        Added in v1.1.2.
         """
         ...
 
@@ -165,6 +171,8 @@ class QueueManager:
 
             Note that this method does not return a local instance of the Queue. You can use
             `modal.Queue.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -200,6 +208,8 @@ class QueueManager:
 
             Note that this method does not return a local instance of the Queue. You can use
             `modal.Queue.from_name` to perform a lookup after creation.
+
+            Added in v1.1.2.
             """
             ...
 
@@ -236,6 +246,8 @@ class QueueManager:
             ```python
             queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -269,6 +281,8 @@ class QueueManager:
             ```python
             queues = modal.Queue.objects.list(max_objects=10, created_before="2025-01-01")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -300,6 +314,8 @@ class QueueManager:
             ```python notest
             await modal.Queue.objects.delete("my-queue", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...
 
@@ -328,6 +344,8 @@ class QueueManager:
             ```python notest
             await modal.Queue.objects.delete("my-queue", environment_name="dev")
             ```
+
+            Added in v1.1.2.
             """
             ...