modal 1.5.1.dev7__tar.gz → 1.5.1.dev9__tar.gz

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modal
-Version: 1.5.1.dev7
+Version: 1.5.1.dev9
 Summary: Python client library for Modal
 Author-email: Modal Labs <support@modal.com>
 License-Expression: Apache-2.0
@@ -45,7 +45,7 @@ access to serverless cloud compute from Python scripts on your local computer.
 See the [online documentation](https://modal.com/docs/guide) for many
 [example applications](https://modal.com/docs/examples),
 a [user guide](https://modal.com/docs/guide), and the detailed
-[API reference](https://modal.com/docs/reference).
+[API reference](https://modal.com/docs/sdk/py/latest).
 
 ## Installation
 

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/README.md

@@ -12,7 +12,7 @@ access to serverless cloud compute from Python scripts on your local computer.
 See the [online documentation](https://modal.com/docs/guide) for many
 [example applications](https://modal.com/docs/examples),
 a [user guide](https://modal.com/docs/guide), and the detailed
-[API reference](https://modal.com/docs/reference).
+[API reference](https://modal.com/docs/sdk/py/latest).
 
 ## Installation
 

modal-1.5.1.dev9/modal/_billing.py

@@ -0,0 +1,155 @@
+# Copyright Modal Labs 2025
+from dataclasses import FrozenInstanceError, dataclass
+from datetime import datetime, timezone
+from decimal import Decimal
+from typing import Any, Iterable, TypedDict
+
+from modal_proto import api_pb2
+
+from ._utils.deprecation import deprecation_warning
+from .client import _Client
+
+BILLING_DOCSTRING = """
+            The `start` and `end` parameters are required to either have a UTC timezone or to be
+            timezone-naive (which will be interpreted as UTC times). The timestamps in the result will
+            be in UTC. Cost will be reported for full intervals, even if the provided `start` or `end`
+            parameters are partial: `start` will be rounded to the beginning of its interval, while
+            partial `end` intervals will be excluded.
+
+            Additional user-provided metadata can be included in the report if the objects have tags
+            and `tag_names` (i.e., keys) are specified in the request. Alternatively, pass `tag_names=["*"]`
+            to include all tags in the report. Note that tags will be attributed to the entire interval even
+            if they were added or removed at some point within it. If the tag name was not in use during an
+            interval, it will be absent from the tags dictionary in that output row.
+
+            In most cases, billing data will be available in the database that this API queries within
+            minutes, although there may be collection delays. If completeness is important for your use
+            case, we recommend leaving a buffer after the end of the query interval.
+"""
+
+
+class WorkspaceBillingReportItem(TypedDict):
+    object_id: str
+    description: str
+    environment_name: str
+    interval_start: datetime
+    cost: Decimal
+    tags: dict[str, str]
+
+
+@dataclass(slots=True, frozen=True)
+class BillingReportItem:
+    object_id: str
+    description: str
+    environment_name: str
+    interval_start: datetime
+    cost: Decimal
+    cost_by_resource: dict[str, Decimal]
+    tags: dict[str, str]
+
+    def __getitem__(self, key: str) -> Any:
+        """mdmd:ignore"""
+        if key not in self.__slots__:
+            raise KeyError(key)
+
+        return getattr(self, key)
+
+    def __setitem__(self, key: str, _: Any):
+        """mdmd:ignore"""
+        raise FrozenInstanceError(f"cannot assign to field {key!r}")
+
+    def keys(self) -> Iterable[str]:
+        """mdmd:ignore"""
+        yield from self.__slots__
+
+    def values(self) -> Iterable[Any]:
+        """mdmd:ignore"""
+        for k in self.__slots__:
+            yield getattr(self, k)
+
+    def items(self) -> Iterable[tuple[str, Any]]:
+        """mdmd:ignore"""
+        for k in self.__slots__:
+            yield k, getattr(self, k)
+
+    @classmethod
+    def _from_proto(cls, pb_item: api_pb2.WorkspaceBillingReportItem) -> "BillingReportItem":
+        return cls(
+            object_id=pb_item.object_id,
+            description=pb_item.description,
+            environment_name=pb_item.environment_name,
+            interval_start=pb_item.interval.ToDatetime().replace(tzinfo=timezone.utc),
+            cost=Decimal(pb_item.cost),
+            cost_by_resource={k: Decimal(v) for k, v in pb_item.cost_by_resource.items()},
+            tags=dict(pb_item.tags),
+        )
+
+
+async def _workspace_billing_report(
+    *,
+    start: datetime,  # Start of the report, inclusive
+    end: datetime | None = None,  # End of the report, exclusive
+    resolution: str = "d",  # Resolution, e.g. "d" for daily or "h" for hourly
+    tag_names: list[str] | None = None,  # Optional additional metadata to include
+    client: _Client | None = None,
+) -> list[WorkspaceBillingReportItem]:
+    """Generate a tabular report of workspace usage by object and time.
+
+    The result will be a list of dictionaries for each interval (determined by `resolution`)
+    between the `start` and `end` limits. The dictionary represents a single Modal object
+    that billing can be attributed to (e.g., an App) along with metadata (including user-defined
+    tags) for identifying that object. The dictionary also contains a breakdown of the cost value
+    attributed to individual resources (for an App, this can be CPU, Memory, specific GPU types,
+    etc.). The specific resource types included in the breakdown are subject to change as
+    Modal's billing model evolves.
+
+    The `start` and `end` parameters are required to either have a UTC timezone or to be
+    timezone-naive (which will be interpreted as UTC times). The timestamps in the result will
+    be in UTC. Cost will be reported for full intervals, even if the provided `start` or `end`
+    parameters are partial: `start` will be rounded to the beginning of its interval, while
+    partial `end` intervals will be excluded.
+
+    Additional user-provided metadata can be included in the report if the objects have tags
+    and `tag_names` (i.e., keys) are specified in the request. Alternatively, pass `tag_names=["*"]`
+    to include all tags in the report. Note that tags will be attributed to the entire interval even
+    if they were added or removed at some point within it. If the tag name was not in use during an
+    interval, it will be absent from the tags dictionary in that output row.
+
+    In most cases, billing data will be available in the database that this API queries within
+    minutes, although there may be collection delays. If completeness is important for your use
+    case, we recommend leaving a buffer after the end of the query interval.
+
+    It's also possible to generate reports using the
+    [`modal billing report`](https://modal.com/docs/cli/latest/billing) CLI command. The CLI
+    has a few convenience features for generating reports across relative time ranges.
+
+    """
+
+    deprecation_warning(
+        (2026, 6, 18),
+        "`workspace_billing_report()` is deprecated. Use `Workspace.billing.report()` instead.",
+    )
+
+    from ._workspace import _Workspace
+
+    data = await _Workspace.from_context(client=client).billing.report(
+        start=start,
+        end=end,
+        resolution=resolution,
+        tag_names=tag_names,
+    )
+
+    res: list[WorkspaceBillingReportItem] = []
+    for datum in data:
+        item: WorkspaceBillingReportItem = {
+            "object_id": datum.object_id,
+            "description": datum.description,
+            "environment_name": datum.environment_name,
+            "interval_start": datum.interval_start,
+            "cost": Decimal(datum.cost),
+            "tags": dict(datum.tags),
+        }
+
+        res.append(item)
+
+    return res

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_environments.py

@@ -3,6 +3,7 @@ import asyncio
 import builtins
 from collections.abc import Iterable, Mapping
 from dataclasses import dataclass
+from datetime import datetime, timezone
 from typing import Literal
 
 from google.protobuf.empty_pb2 import Empty
@@ -12,6 +13,7 @@ from synchronicity import classproperty
 
 from modal_proto import api_pb2
 
+from ._billing import BILLING_DOCSTRING, BillingReportItem
 from ._load_context import LoadContext
 from ._object import _Object
 from ._resolver import Resolver
@@ -318,7 +320,7 @@ class _Environment(_Object, type_prefix="en"):
     # def settings(self) -> EnvironmentSettings:
     #     return self._settings
 
-    def _hydrate_metadata(self, metadata: Message):
+    def _hydrate_metadata(self, metadata: Message | None):
         # Overridden concrete implementation of base class method
         assert metadata and isinstance(metadata, api_pb2.EnvironmentMetadata)
         self._name = metadata.name or None
@@ -392,6 +394,80 @@ class _Environment(_Object, type_prefix="en"):
             client=client,
         )
 
+    @property
+    def billing(self) -> "_EnvironmentBillingManager":
+        return _EnvironmentBillingManager(self)
+
+
+class _EnvironmentBillingManager:
+    """mdmd:namespace
+    Namespace for Environment billing APIs
+    """
+
+    def __init__(self, environment: _Environment):
+        """mdmd:ignore"""
+        self._environment = environment
+
+    async def report(
+        self,
+        *,
+        start: datetime,  # Start of the report, inclusive
+        end: datetime | None = None,  # End of the report, exclusive
+        resolution: str = "d",  # Resolution, e.g. "d" for daily or "h" for hourly
+        tag_names: list[str] | None = None,  # Optional additional metadata to include
+    ) -> list[BillingReportItem]:
+        (
+            """Return a report of workspace usage by object and time, scoped to the calling Environment.
+
+            The result will be a list of dataclasses for each interval (determined by `resolution`)
+            between the `start` and `end` limits. Each item represents a single (Modal object, time interval)
+            pair that billing can be attributed to (e.g., an App) along with metadata (including user-defined
+            tags) to identify that object. The dataclass also contains a breakdown of the cost value
+            attributed to individual resources (for an App, this can be CPU, Memory, specific GPU types,
+            etc.). The specific resource types included in the breakdown are subject to change as
+            Modal's billing model evolves.
+
+            It's also possible to generate reports using the
+            [`modal environment billing report`](https://modal.com/docs/cli/latest/environment#modal-environment-billing-report)
+            CLI command.  The CLI has a few convenience features for generating
+            reports across relative time ranges.
+
+            """
+            + BILLING_DOCSTRING
+        )
+
+        if tag_names is None:
+            tag_names = []
+
+        if end is None:
+            end = datetime.now(timezone.utc)
+
+        if start.tzinfo is None:
+            start = start.replace(tzinfo=timezone.utc)
+        elif start.tzinfo != timezone.utc:
+            raise InvalidError("Timezone-aware 'start' parameter must be in UTC.")
+
+        if end.tzinfo is None:
+            end = end.replace(tzinfo=timezone.utc)
+        elif end.tzinfo != timezone.utc:
+            raise InvalidError("Timezone-aware 'end' parameter must be in UTC.")
+
+        if not self._environment.is_hydrated:
+            await self._environment.hydrate()
+
+        request = api_pb2.WorkspaceBillingReportRequest(
+            resolution=resolution,
+            tag_names=tag_names,
+            environment_ids=[self._environment.object_id],
+        )
+        request.start_timestamp.FromDatetime(start)
+        request.end_timestamp.FromDatetime(end)
+
+        return [
+            BillingReportItem._from_proto(pb_item)
+            async for pb_item in self._environment.client.stub.WorkspaceBillingReport.unary_stream(request)
+        ]
+
 
 ENVIRONMENT_CACHE: dict[str, _Environment] = {}
 

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_functions.py

@@ -1912,9 +1912,9 @@ class _Function(typing.Generic[P, ReturnType, OriginalReturnType], _Object, type
             **kwargs: Keyword arguments forwarded to the remote function.
 
         Returns:
-            A [`modal.FunctionCall`](https://modal.com/docs/reference/modal.FunctionCall) object
+            A [`modal.FunctionCall`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall) object
             that can later be polled or waited for using
-            [`.get(timeout=...)`](https://modal.com/docs/reference/modal.FunctionCall#get).
+            [`.get(timeout=...)`](https://modal.com/docs/sdk/py/latest/modal.FunctionCall#get).
         """
         self._check_no_web_url("spawn")
         if self._is_generator:
@@ -2065,7 +2065,7 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         """Returns a structure representing the call graph from a given root
         call ID, along with the status of execution for each node.
 
-        See [`modal.call_graph`](https://modal.com/docs/reference/modal.call_graph) reference page
+        See [`modal.call_graph`](https://modal.com/docs/sdk/py/latest/modal.call_graph) reference page
         for documentation on the structure of the returned `InputInfo` items.
 
         Returns:
@@ -2083,7 +2083,7 @@ class _FunctionCall(typing.Generic[ReturnType], _Object, type_prefix="fc"):
         terminate_containers: bool = False,
     ):
         """Cancels the function call, which will stop its execution and mark its inputs as
-        [`TERMINATED`](https://modal.com/docs/reference/modal.call_graph#modalcall_graphinputstatus).
+        [`TERMINATED`](https://modal.com/docs/sdk/py/latest/modal.call_graph#modalcall_graphinputstatus).
 
         If `terminate_containers=True` - the containers running the cancelled inputs are all terminated
         causing any non-cancelled inputs on those containers to be rescheduled in new containers.

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_grpc_client.py

@@ -1,6 +1,6 @@
 # Copyright Modal Labs 2025
 from collections.abc import Collection, Mapping
-from typing import TYPE_CHECKING, Any, Generic, Literal, TypeVar, overload
+from typing import TYPE_CHECKING, Any, AsyncGenerator, Generic, Literal, TypeVar, overload
 
 import grpclib.client
 from google.protobuf.message import Message
@@ -178,9 +178,9 @@ class UnaryStreamWrapper(Generic[RequestType, ResponseType]):
 
     async def unary_stream(
         self,
-        request,
+        request: RequestType,
         metadata: Any | None = None,
-    ):
+    ) -> AsyncGenerator[ResponseType, None]:
         from .client import _Client
 
         if self.client._snapshotted:

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_partial_function.py

@@ -477,7 +477,7 @@ def _wsgi_app(
     Web Server Gateway Interface (WSGI) is a standard for synchronous Python web apps.
     It has been [succeeded by the ASGI interface](https://asgi.readthedocs.io/en/latest/introduction.html#wsgi-compatibility)
     which is compatible with ASGI and supports additional functionality such as web sockets.
-    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/reference/modal.asgi_app).
+    Modal supports ASGI via [`asgi_app`](https://modal.com/docs/sdk/py/latest/modal.asgi_app).
 
     Examples:
         ```python

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_server.py

@@ -49,7 +49,7 @@ class _Server:
     See [lifecycle hooks](https://modal.com/docs/guide/lifecycle-functions) for more information.
 
     Generally, you will not construct a Server directly.
-    Instead, use the [`@app.server()`](https://modal.com/docs/reference/modal.App#server) decorator.
+    Instead, use the [`@app.server()`](https://modal.com/docs/sdk/py/latest/modal.App#server) decorator.
 
     ```python notest
     @app.server(port=8000, routing_region="us-east")

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_utils/task_command_router_client.py

@@ -491,6 +491,27 @@ class TaskCommandRouterClient:
                 lambda: self._call_with_auth_retry(self._stub.SandboxStdinWriteV2, request)
             )
 
+    async def sandbox_wait_until_ready(self, task_id: str, timeout: float) -> sr_pb2.SandboxWaitUntilReadyTcrResponse:
+        """Wait until the sandbox's readiness probe reports ready.
+
+        Args:
+            task_id: The task ID hosting the sandbox.
+            timeout: Maximum time in seconds for the worker to wait.
+        Raises:
+            TimeoutError: If the sandbox does not become ready within `timeout`.
+        """
+        request = sr_pb2.SandboxWaitUntilReadyTcrRequest(task_id=task_id, timeout=timeout)
+        with grpc_error_converter():
+            try:
+                return await asyncio.wait_for(
+                    call_with_retries_on_transient_errors(
+                        lambda: self._call_with_auth_retry(self._stub.SandboxWaitUntilReady, request, timeout=timeout),
+                    ),
+                    timeout=timeout,
+                )
+            except asyncio.TimeoutError:
+                raise ModalTimeoutError("Timeout expired")
+
     async def exec_poll(self, task_id: str, exec_id: str, deadline: float | None = None) -> sr_pb2.TaskExecPollResponse:
         """Poll for the exit status of an exec'd command, properly retrying on transient errors.
 
@@ -784,6 +805,12 @@ class TaskCommandRouterClient:
                 lambda: self._call_with_auth_retry(self._stub.TaskUnmountDirectory, request)
             )
 
+    async def set_network_access(self, request: sr_pb2.TaskSetNetworkAccessRequest):
+        with grpc_error_converter():
+            return await call_with_retries_on_transient_errors(
+                lambda: self._call_with_auth_retry(self._stub.TaskSetNetworkAccess, request)
+            )
+
     async def _snapshot_with_deadline(self, rpc, request, *, timeout: float, **kwargs):
         # helper method for snapshot_directory and snapshot_filesystem to handle grpc
         # deadlines in a consistent way, converting any error to TimeoutError after passing

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_utils/time_utils.py

@@ -256,3 +256,26 @@ def timestamp_to_localized_str(ts: float, isotz: bool = True) -> str | None:
             return f"{dt:%Y-%m-%d %H:%M %Z}"
     else:
         return None
+
+
+def format_interval(
+    dt: datetime,
+    *,
+    tz: tzinfo | None = None,
+    isoformat: bool = False,
+    show_date_only: bool = False,
+) -> str:
+    if tz is not None:
+        dt = dt.astimezone(tz)
+    else:
+        # Strip UTC tzinfo so isoformat() doesn't append +00:00
+        dt = dt.replace(tzinfo=None)
+    if isoformat:
+        # Full ISO format for machine-readable output
+        return dt.isoformat()
+    elif show_date_only:
+        # Just the date for daily resolution
+        return dt.strftime("%Y-%m-%d")
+    else:
+        # Date and time without seconds for hourly resolution
+        return dt.strftime("%Y-%m-%dT%H:%M")

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/_workspace.py

@@ -1,13 +1,15 @@
 # Copyright Modal Labs 2025
 import builtins
 from dataclasses import dataclass
-from datetime import datetime
+from datetime import datetime, timezone
 from typing import Literal, Optional
 
 from google.protobuf.empty_pb2 import Empty
 
+from modal.exception import InvalidError
 from modal_proto import api_pb2
 
+from ._billing import BILLING_DOCSTRING, BillingReportItem
 from ._load_context import LoadContext
 from ._object import _Object
 from ._resolver import Resolver
@@ -114,3 +116,76 @@ class _Workspace(_Object, type_prefix="ac"):
             hydrate_lazily=True,
             load_context_overrides=LoadContext(client=client),
         )
+
+    @property
+    def billing(self) -> "_WorkspaceBillingManager":
+        return _WorkspaceBillingManager(self)
+
+
+class _WorkspaceBillingManager:
+    """mdmd:namespace
+    Namespace for Workspace billing APIs
+    """
+
+    def __init__(self, workspace: _Workspace):
+        """mdmd:hidden"""
+        self._workspace = workspace
+
+    async def report(
+        self,
+        *,
+        start: datetime,  # Start of the report, inclusive
+        end: datetime | None = None,  # End of the report, exclusive
+        resolution: str = "d",  # Resolution, e.g. "d" for daily or "h" for hourly
+        tag_names: list[str] | None = None,  # Optional additional metadata to include
+    ) -> list[BillingReportItem]:
+        (
+            """Return a report of workspace usage by object and time.
+
+            The result will be a list of dataclasses for each interval (determined by `resolution`)
+            between the `start` and `end` limits. Each item represents a single (Modal object, time interval)
+            pair that billing can be attributed to (e.g., an App) along with metadata (including user-defined
+            tags) to identify that object. The dataclass also contains a breakdown of the cost value
+            attributed to individual resources (for an App, this can be CPU, Memory, specific GPU types,
+            etc.). The specific resource types included in the breakdown are subject to change as
+            Modal's billing model evolves.
+
+            It's also possible to generate reports using the
+            [`modal billing report`](https://modal.com/docs/cli/latest/billing#modal-billing-report)
+            CLI command. The CLI has a few convenience features for generating reports across relative
+            time ranges.
+
+            """
+            + BILLING_DOCSTRING
+        )
+
+        if tag_names is None:
+            tag_names = []
+
+        if end is None:
+            end = datetime.now(timezone.utc)
+
+        if start.tzinfo is None:
+            start = start.replace(tzinfo=timezone.utc)
+        elif start.tzinfo != timezone.utc:
+            raise InvalidError("Timezone-aware 'start' parameter must be in UTC.")
+
+        if end.tzinfo is None:
+            end = end.replace(tzinfo=timezone.utc)
+        elif end.tzinfo != timezone.utc:
+            raise InvalidError("Timezone-aware 'end' parameter must be in UTC.")
+
+        if not self._workspace.is_hydrated:
+            await self._workspace.hydrate()
+
+        request = api_pb2.WorkspaceBillingReportRequest(
+            resolution=resolution,
+            tag_names=tag_names,
+        )
+        request.start_timestamp.FromDatetime(start)
+        request.end_timestamp.FromDatetime(end)
+
+        return [
+            BillingReportItem._from_proto(pb_item)
+            async for pb_item in self._workspace.client.stub.WorkspaceBillingReport.unary_stream(request)
+        ]

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/app.py

@@ -710,7 +710,7 @@ class _App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/reference/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -1066,7 +1066,7 @@ class _App:
         max_inputs: int | None = None,
     ) -> Callable[[CLS_T | _PartialFunction], CLS_T]:
         """
-        Decorator to register a new Modal [Cls](https://modal.com/docs/reference/modal.Cls) with this App.
+        Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.
@@ -1290,6 +1290,7 @@ class _App:
         scaleup_window: int | None = None,  # Stabilization window (seconds) of sustained demand before scaling up
         scaledown_window: int | None = None,  # Max idle time before scaling down (seconds)
         proxy: _Proxy | None = None,  # Modal Proxy to use in front of this server
+        unauthenticated: bool = False,  # Whether the endpoint requires proxy authentication, required by default.
         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
@@ -1334,10 +1335,11 @@ class _App:
             scaledown_window: Max idle time before scaling down (seconds).
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
+            unauthenticated: Whether the endpoint requires proxy authentication, required by default.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2 in the container.
+            h2_enabled: Enable HTTP/2.
             target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             cloud: Cloud provider (aws, gcp, oci, auto).
             region: Region(s) to run on.
@@ -1385,6 +1387,7 @@ class _App:
             startup_timeout=startup_timeout,
             exit_grace_period=exit_grace_period,
             h2_enabled=h2_enabled,
+            unauthenticated=unauthenticated,
         )
 
         # Build secrets list

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/app.pyi

@@ -494,7 +494,7 @@ class _App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/reference/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -683,7 +683,7 @@ class _App:
         _experimental_restrict_output: bool = False,
         max_inputs: typing.Optional[int] = None,
     ) -> collections.abc.Callable[[typing.Union[CLS_T, modal._partial_function._PartialFunction]], CLS_T]:
-        """Decorator to register a new Modal [Cls](https://modal.com/docs/reference/modal.Cls) with this App.
+        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.
@@ -751,6 +751,7 @@ class _App:
         scaleup_window: typing.Optional[int] = None,
         scaledown_window: typing.Optional[int] = None,
         proxy: typing.Optional[modal.proxy._Proxy] = None,
+        unauthenticated: bool = False,
         port: int = 8000,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
@@ -795,10 +796,11 @@ class _App:
             scaledown_window: Max idle time before scaling down (seconds).
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
+            unauthenticated: Whether the endpoint requires proxy authentication, required by default.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2 in the container.
+            h2_enabled: Enable HTTP/2.
             target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             cloud: Cloud provider (aws, gcp, oci, auto).
             region: Region(s) to run on.
@@ -1495,7 +1497,7 @@ class App:
         Modal functions can also be used as CLI entrypoints, but unlike `local_entrypoint`,
         those functions are executed remotely directly.
 
-        Note that an explicit [`app.run()`](https://modal.com/docs/reference/modal.App#run) is not needed, as an
+        Note that an explicit [`app.run()`](https://modal.com/docs/sdk/py/latest/modal.App#run) is not needed, as an
         [app](https://modal.com/docs/guide/apps) is automatically created for you.
 
         Args:
@@ -1684,7 +1686,7 @@ class App:
         _experimental_restrict_output: bool = False,
         max_inputs: typing.Optional[int] = None,
     ) -> collections.abc.Callable[[typing.Union[CLS_T, modal.partial_function.PartialFunction]], CLS_T]:
-        """Decorator to register a new Modal [Cls](https://modal.com/docs/reference/modal.Cls) with this App.
+        """Decorator to register a new Modal [Cls](https://modal.com/docs/sdk/py/latest/modal.Cls) with this App.
 
         Args:
             image: The image to run as the container for the class service.
@@ -1752,6 +1754,7 @@ class App:
         scaleup_window: typing.Optional[int] = None,
         scaledown_window: typing.Optional[int] = None,
         proxy: typing.Optional[modal.proxy.Proxy] = None,
+        unauthenticated: bool = False,
         port: int = 8000,
         startup_timeout: int = 30,
         exit_grace_period: int = 0,
@@ -1794,10 +1797,11 @@ class App:
             scaledown_window: Max idle time before scaling down (seconds).
             proxy: Modal Proxy to use in front of this server.
             port: Port the HTTP server listens on.
+            unauthenticated: Whether the endpoint requires proxy authentication, required by default.
             startup_timeout: Maximum startup time in seconds.
             exit_grace_period: Grace period for in-flight requests on shutdown.
             routing_region: Region to route Server requests through.
-            h2_enabled: Enable HTTP/2 in the container.
+            h2_enabled: Enable HTTP/2.
             target_concurrency: Target concurrency for the server; 0 disables autoscaling.
             cloud: Cloud provider (aws, gcp, oci, auto).
             region: Region(s) to run on.

{modal-1.5.1.dev7 → modal-1.5.1.dev9}/modal/billing.py

@@ -1,10 +1,11 @@
 # Copyright Modal Labs 2025
-from ._billing import WorkspaceBillingReportItem, _workspace_billing_report
+from ._billing import BillingReportItem, WorkspaceBillingReportItem, _workspace_billing_report
 from ._utils.async_utils import synchronize_api
 
-workspace_billing_report = synchronize_api(_workspace_billing_report)
+workspace_billing_report = synchronize_api(_workspace_billing_report, target_module=__name__)
 
 __all__ = [
     "workspace_billing_report",
     "WorkspaceBillingReportItem",
+    "BillingReportItem",
 ]