modAL 1.4.3.dev11__py3-none-any.whl → 1.4.3.dev13__py3-none-any.whl

modal/_runtime/execution_context.py

@@ -10,10 +10,13 @@ from .container_io_manager import _ContainerIOManager
 
 
 def is_local() -> bool:
-    """Returns if we are currently on the machine launching/deploying a Modal app
+    """Indicate the execution context of the current process.
+
+    Note: this function specifically returns False when the current process is
+    running a Modal Function and True in all other cases. It will return True
+    when called from a child process of a Function or inside a Modal Sandbox,
+    even though those processes are running on Modal hardware.
 
-    Returns `True` when executed locally on the user's machine.
-    Returns `False` when executed from a Modal container in the cloud.
     """
     return not _ContainerIOManager._singleton
 

modal/_runtime/execution_context.pyi

@@ -4,10 +4,12 @@ import typing
 import typing_extensions
 
 def is_local() -> bool:
-    """Returns if we are currently on the machine launching/deploying a Modal app
+    """Indicate the execution context of the current process.
 
-    Returns `True` when executed locally on the user's machine.
-    Returns `False` when executed from a Modal container in the cloud.
+    Note: this function specifically returns False when the current process is
+    running a Modal Function and True in all other cases. It will return True
+    when called from a child process of a Function or inside a Modal Sandbox,
+    even though those processes are running on Modal hardware.
     """
     ...
 

modal/_serialization.py

@@ -12,6 +12,8 @@ from modal.config import config
 try:
     import cbor2  # type: ignore
 except ImportError:  # pragma: no cover - optional dependency
+    # cbor2 is a required dependency of modal as a library, but it won't
+    # be available in containers using a legacy (pre 2025.06) image builder version
     cbor2 = None
 
 import google.protobuf.message
@@ -374,7 +376,7 @@ def serialize_data_format(obj: Any, data_format: int) -> bytes:
             raise InvalidError("CBOR support requires the 'cbor2' package to be installed.")
         try:
             return cbor2.dumps(obj)
-        except cbor2.CBOREncodeTypeError:
+        except cbor2.CBOREncodeError:
             try:
                 typename = f"{type(obj).__module__}.{type(obj).__name__}"
             except Exception:

modal/_utils/sandbox_fs_utils.py

@@ -255,6 +255,36 @@ def make_make_directory_command(remote_path: str, create_parents: bool) -> str:
     return json.dumps({"MakeDirectory": {"path": remote_path, "parents": create_parents}})
 
 
+def raise_stat_error(returncode: int, stderr: Union[str, bytes], remote_path: str) -> NoReturn:
+    if payload := try_parse_error_payload(stderr):
+        logger.debug(
+            f"sandbox-fs-tools stat error: path={remote_path}, "
+            f"error_kind={payload.error_kind}, message={payload.message}, detail={payload.detail}"
+        )
+        if payload.error_kind == "NotFound":
+            raise SandboxFilesystemNotFoundError(f"{payload.message}: {remote_path}")
+        if payload.error_kind == "NotDirectory":
+            raise SandboxFilesystemNotADirectoryError(f"{payload.message}: {remote_path}")
+        if payload.error_kind == "PermissionDenied":
+            raise SandboxFilesystemPermissionError(f"{payload.message}: {remote_path}")
+        raise SandboxFilesystemError(payload.message)
+
+    if stderr_text := _stderr_to_text(stderr):
+        logger.debug(f"Unstructured modal-sandbox-fs-tools stderr: {stderr_text}")
+    raise SandboxFilesystemError(f"Operation on '{remote_path}' failed with exit code {returncode}")
+
+
+def make_stat_command(remote_path: str) -> str:
+    """Build the JSON command string for a Stat operation.
+
+    The returned JSON must match the `Command` enum in the modal-sandbox-fs-tools
+    Rust crate (crates/modal-sandbox-fs-tools/src/lib.rs). Treat changes to
+    this schema like protobuf changes: fields must not be removed or renamed,
+    only added with backwards-compatible defaults.
+    """
+    return json.dumps({"Stat": {"path": remote_path}})
+
+
 def validate_absolute_remote_path(remote_path: str, operation: str) -> None:
     if not PurePosixPath(remote_path).is_absolute():
         raise InvalidError(f"Sandbox.filesystem.{operation}() currently only supports absolute remote_path values")

modal/app.py

@@ -379,6 +379,7 @@ class _App:
     async def run(
         self,
         *,
+        name: Optional[str] = None,
         client: Optional[_Client] = None,
         detach: bool = False,
         interactive: bool = False,
@@ -426,7 +427,7 @@ class _App:
         from .runner import _run_app  # Defer import of runner.py, which imports a lot from Rich
 
         async with _run_app(
-            self, client=client, detach=detach, interactive=interactive, environment_name=environment_name
+            self, name=name, client=client, detach=detach, interactive=interactive, environment_name=environment_name
         ):
             yield self
 

modal/app.pyi

@@ -256,6 +256,7 @@ class _App:
     def run(
         self,
         *,
+        name: typing.Optional[str] = None,
         client: typing.Optional[modal.client._Client] = None,
         detach: bool = False,
         interactive: bool = False,
@@ -864,6 +865,7 @@ class App:
             self,
             /,
             *,
+            name: typing.Optional[str] = None,
             client: typing.Optional[modal.client.Client] = None,
             detach: bool = False,
             interactive: bool = False,
@@ -913,6 +915,7 @@ class App:
             self,
             /,
             *,
+            name: typing.Optional[str] = None,
             client: typing.Optional[modal.client.Client] = None,
             detach: bool = False,
             interactive: bool = False,

modal/cli/_help.py

@@ -5,11 +5,12 @@ from __future__ import annotations
 
 import inspect
 import os
+import shutil
 import sys
 from typing import Any, Optional
 
 import click
-from rich.console import Console
+from rich.console import Console, Group, RenderableType
 from rich.markdown import Markdown
 from rich.padding import Padding
 from rich.panel import Panel
@@ -24,6 +25,7 @@ _OPTION_METAVAR_STYLE = "dim"
 _ERROR_STYLE = "red"
 
 _MAX_HELP_WIDTH = 80
+_HELP_PADDING = 1
 
 
 def use_rich_style() -> bool:
@@ -34,25 +36,24 @@ def use_rich_style() -> bool:
     return sys.stdout.isatty()
 
 
-def _make_console(file: Optional[Any] = None) -> Console:
-    return Console(file=file, highlight=False)
+def _make_help_console() -> Console:
+    columns, _ = shutil.get_terminal_size()
+    return Console(highlight=False, width=min(_MAX_HELP_WIDTH, columns))
 
 
-def _render_usage(cmd: click.Command, ctx: click.Context, console: Console) -> None:
+def _build_usage(cmd: click.Command, ctx: click.Context) -> RenderableType:
     pieces = " ".join(cmd.collect_usage_pieces(ctx))
     usage = Text()
     usage.append("Usage: ", style=_HEADING_STYLE)
     usage.append(f"{ctx.command_path} {pieces}".rstrip())
-    console.print(usage)
-    console.print()
+    return usage
 
 
-def _render_help_text(cmd: click.Command, console: Console) -> None:
+def _build_help_text(cmd: click.Command) -> Optional[RenderableType]:
     text = cmd.help or cmd.short_help or ""
     if not text:
-        return
-    console.print(Padding(Markdown(inspect.cleandoc(text)), (0, 2)))
-    console.print()
+        return None
+    return Markdown(inspect.cleandoc(text))
 
 
 def _option_label(param: click.Parameter, ctx: click.Context) -> Text:
@@ -73,7 +74,7 @@ def _option_label(param: click.Parameter, ctx: click.Context) -> Text:
     return text
 
 
-def _render_options(cmd: click.Command, ctx: click.Context, console: Console) -> None:
+def _build_options(cmd: click.Command, ctx: click.Context) -> Optional[RenderableType]:
     rows: list[tuple[Text, str]] = []
     for param in cmd.get_params(ctx):
         rec = param.get_help_record(ctx)
@@ -81,22 +82,20 @@ def _render_options(cmd: click.Command, ctx: click.Context, console: Console) ->
             continue
         rows.append((_option_label(param, ctx), rec[1] or ""))
     if not rows:
-        return
+        return None
 
-    console.print(Text("Options", style=_HEADING_STYLE))
     table = Table(box=None, show_header=False, pad_edge=False, padding=(0, 2))
     table.add_column(no_wrap=True)  # styling lives in the Text cells
     table.add_column(overflow="fold")
     for label, help_str in rows:
         table.add_row(label, help_str)
-    console.print(table)
-    console.print()
+    return Group(Text("Options", style=_HEADING_STYLE), table)
 
 
-def _render_epilog(cmd: click.Command, console: Console) -> None:
-    if cmd.epilog:
-        console.print(cmd.epilog)
-        console.print()
+def _build_epilog(cmd: click.Command) -> Optional[RenderableType]:
+    if not cmd.epilog:
+        return None
+    return Text(cmd.epilog)
 
 
 def _group_commands_by_panel(group: click.Group) -> dict[str, list[tuple[str, click.Command]]]:
@@ -109,23 +108,25 @@ def _group_commands_by_panel(group: click.Group) -> dict[str, list[tuple[str, cl
     return panels
 
 
-def _render_commands(group: click.Group, console: Console) -> None:
+def _build_commands(group: click.Group, available_width: int) -> Optional[RenderableType]:
     panels = _group_commands_by_panel(group)
     if not panels:
-        return
+        return None
 
     # We want the name / description columns to be the same widths across groups
     name_width = max(len(name) for items in panels.values() for name, _ in items)
-    table_width = min(_MAX_HELP_WIDTH, console.width)
 
+    parts: list[RenderableType] = []
     for panel_name, items in panels.items():
-        console.print(Text(panel_name.ljust(table_width), style=f"{_HEADING_STYLE} underline"))
-        _render_command_table(console, items, name_width, table_width)
-        console.print()
+        if parts:
+            parts.append(Text(""))
+        parts.append(Text(panel_name.ljust(available_width), style=f"{_HEADING_STYLE} underline"))
+        parts.append(_build_command_table(items, name_width, available_width))
+    return Group(*parts)
 
 
 def build_command_table(name_width: int, table_width: Optional[int] = None) -> Table:
-    kwargs: dict[str, Any] = {"box": None, "show_header": False, "pad_edge": False, "padding": (0, 2)}
+    kwargs: dict[str, Any] = {"box": None, "show_header": False, "pad_edge": True, "padding": (0, 1)}
     if table_width is not None:
         kwargs["width"] = table_width
     table = Table(**kwargs)
@@ -137,16 +138,39 @@ def build_command_table(name_width: int, table_width: Optional[int] = None) -> T
     return table
 
 
-def _render_command_table(
-    console: Console,
+def _build_command_table(
     items: list[tuple[str, click.Command]],
     name_width: int,
     table_width: int,
-) -> None:
+) -> Table:
     table = build_command_table(name_width, table_width)
     for name, sub in items:
         table.add_row(name, sub.get_short_help_str(limit=80))
-    console.print(table)
+    return table
+
+
+def _available_width(console: Console) -> int:
+    return min(_MAX_HELP_WIDTH, console.width) - _HELP_PADDING * 2
+
+
+def _emit(
+    console: Console,
+    sections: list[Optional[RenderableType]],
+    formatter: click.HelpFormatter,
+) -> None:
+    parts: list[RenderableType] = []
+    for section in sections:
+        if section is None:
+            continue
+        if parts:
+            parts.append(Text(""))
+        parts.append(section)
+    if parts:
+        # Always pad with a blank line before the next prompt
+        parts.append(Text(""))
+    with console.capture() as capture:
+        console.print(Padding(Group(*parts), (0, _HELP_PADDING)))
+    formatter.write(capture.get())
 
 
 # -- Public Command / Group subclasses ---------------------------------------
@@ -162,13 +186,17 @@ class ModalCommand(click.Command):
     def format_help(self, ctx: click.Context, formatter: click.HelpFormatter) -> None:
         if not use_rich_style():
             return super().format_help(ctx, formatter)
-        console = _make_console()
-        with console.capture() as capture:
-            _render_usage(self, ctx, console)
-            _render_help_text(self, console)
-            _render_options(self, ctx, console)
-            _render_epilog(self, console)
-        formatter.write(capture.get())
+        console = _make_help_console()
+        _emit(
+            console,
+            [
+                _build_usage(self, ctx),
+                _build_help_text(self),
+                _build_options(self, ctx),
+                _build_epilog(self),
+            ],
+            formatter,
+        )
 
 
 class ModalGroup(click.Group):
@@ -209,22 +237,25 @@ class ModalGroup(click.Group):
     def format_help(self, ctx: click.Context, formatter: click.HelpFormatter) -> None:
         if not use_rich_style():
             return super().format_help(ctx, formatter)
-        console = _make_console()
-        with console.capture() as capture:
-            _render_usage(self, ctx, console)
-            _render_help_text(self, console)
-            _render_options(self, ctx, console)
-            _render_commands(self, console)
-            _render_epilog(self, console)
-        formatter.write(capture.get())
+        console = _make_help_console()
+        _emit(
+            console,
+            [
+                _build_usage(self, ctx),
+                _build_help_text(self),
+                _build_options(self, ctx),
+                _build_commands(self, _available_width(console)),
+                _build_epilog(self),
+            ],
+            formatter,
+        )
 
 
 # -- Error rendering ---------------------------------------------------------
 
 
 def _render_click_exception(exc: click.ClickException, file: Any) -> None:
-    console = _make_console(file if file is not None else sys.stderr)
-    title = "Error"
+    console = Console(file=file if file is not None else sys.stderr, highlight=False)
 
     if isinstance(exc, click.UsageError) and exc.ctx is not None:
         ctx = exc.ctx
@@ -236,7 +267,7 @@ def _render_click_exception(exc: click.ClickException, file: Any) -> None:
     console.print(
         Panel(
             Text(exc.format_message()),
-            title=title,
+            title="Error",
             title_align="left",
             border_style=_ERROR_STYLE,
             expand=True,

modal/cli/run.py

@@ -235,6 +235,7 @@ def _make_click_function(app, signature: CliRunnableSignature, inner: Callable[[
         output_mgr.set_timestamps(ctx.obj["show_timestamps"])
         with run_app(
             app,
+            name=ctx.obj["name"],
             detach=ctx.obj["detach"],
             environment_name=ctx.obj["env"],
             interactive=ctx.obj["interactive"],
@@ -365,6 +366,7 @@ def _get_click_command_for_local_entrypoint(app: App, entrypoint: LocalEntrypoin
         output_mgr.set_timestamps(ctx.obj["show_timestamps"])
         with run_app(
             app,
+            name=ctx.obj["name"],
             detach=ctx.obj["detach"],
             environment_name=ctx.obj["env"],
             interactive=ctx.obj["interactive"],
@@ -448,6 +450,7 @@ class RunGroup(ModalGroup):
     cls=RunGroup,
     subcommand_metavar="FUNC_REF",
 )
+@click.option("-n", "--name", help="Name for this run of the App.")
 @click.option("-w", "--write-result", help="Write return value (which must be str or bytes) to this local path.")
 @click.option("-q", "--quiet", is_flag=True, help="Don't show Modal progress indicators.")
 @click.option("-d", "--detach", is_flag=True, help="Don't stop the app if the local process dies or disconnects.")
@@ -458,6 +461,7 @@ class RunGroup(ModalGroup):
 @click.pass_context
 def run(
     ctx: click.Context,
+    name: Optional[str],
     write_result: Optional[str],
     detach: bool,
     quiet: bool,
@@ -498,6 +502,7 @@ def run(
     ```
     """
     ctx.ensure_object(dict)
+    ctx.obj["name"] = name
     ctx.obj["result_path"] = write_result
     ctx.obj["detach"] = detach  # if subcommand would be a click command...
     ctx.obj["show_progress"] = False if quiet else True
@@ -573,6 +578,7 @@ def deploy(
 
 @click.command("serve", cls=ModalCommand, no_args_is_help=True)
 @click.argument("app_ref")
+@click.option("-n", "--name", help="Name for this run of the App.")
 @click.option("--timeout", default=None, type=float)
 @click.option("-e", "--env", default=None, help=ENV_OPTION_HELP)
 @click.option(
@@ -585,6 +591,7 @@ def deploy(
 @click.option("--timestamps", is_flag=True, default=False, help="Show timestamps for each log line.")
 def serve(
     app_ref: str,
+    name: Optional[str] = None,
     timeout: Optional[float] = None,
     env: Optional[str] = None,
     use_module_mode: bool = False,
@@ -611,7 +618,7 @@ def serve(
     app = import_app_from_ref(import_ref, base_cmd="modal serve")
     if app.description is None:
         app.set_description(_get_clean_app_description(app_ref))
-    with serve_app(app, import_ref, environment_name=env):
+    with serve_app(app, import_ref, name=name, environment_name=env):
         if timeout is None:
             timeout = config["serve_timeout"]
         if timeout is None:

modal/cli/utils.py

@@ -162,11 +162,10 @@ def display_table(
         output.print(table)
 
 
-ENV_OPTION_HELP = """Environment to interact with.
-
-If not specified, Modal will use the default environment of your current profile, or the `MODAL_ENVIRONMENT` variable.
-Otherwise, raises an error if the workspace has multiple environments.
-"""
+ENV_OPTION_HELP = (
+    "Environment to interact with. If unspecified, defers to `MODAL_ENVIRONMENT`, "
+    "your active local profile, or your workspace default, in that order."
+)
 
 
 def env_option(func):

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.3.dev11",
+        version: str = "1.4.3.dev13",
     ):
         """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.3.dev11",
+        version: str = "1.4.3.dev13",
     ):
         """mdmd:hidden
         The Modal client object is not intended to be instantiated directly by users.

modal/functions.pyi

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

modal/runner.py

@@ -360,6 +360,7 @@ async def _status_based_disconnect(client: _Client, app_id: str, exc_info: Optio
 async def _run_app(
     app: "modal.app._App",
     *,
+    name: Optional[str] = None,
     client: Optional[_Client] = None,
     detach: bool = False,
     environment_name: Optional[str] = None,
@@ -380,7 +381,9 @@ async def _run_app(
             "You should not use `app.run` or `run_app` within a Modal `local_entrypoint`"
         )
 
-    if app.description is None:
+    if name:
+        app.set_description(name)
+    elif app.description is None:
         import __main__
 
         if "__file__" in dir(__main__):

modal/runner.pyi

@@ -75,6 +75,7 @@ async def _status_based_disconnect(
 def _run_app(
     app: modal.app._App,
     *,
+    name: typing.Optional[str] = None,
     client: typing.Optional[modal.client._Client] = None,
     detach: bool = False,
     environment_name: typing.Optional[str] = None,
@@ -170,6 +171,7 @@ class __run_app_spec(typing_extensions.Protocol):
         /,
         app: modal.app.App,
         *,
+        name: typing.Optional[str] = None,
         client: typing.Optional[modal.client.Client] = None,
         detach: bool = False,
         environment_name: typing.Optional[str] = None,
@@ -184,6 +186,7 @@ class __run_app_spec(typing_extensions.Protocol):
         /,
         app: modal.app.App,
         *,
+        name: typing.Optional[str] = None,
         client: typing.Optional[modal.client.Client] = None,
         detach: bool = False,
         environment_name: typing.Optional[str] = None,

modal/sandbox_fs.py

@@ -18,11 +18,13 @@ from ._utils.sandbox_fs_utils import (
     make_make_directory_command,
     make_read_file_command,
     make_remove_command,
+    make_stat_command,
     make_write_file_command,
     raise_list_files_error,
     raise_make_directory_error,
     raise_read_file_error,
     raise_remove_error,
+    raise_stat_error,
     raise_write_file_error,
     translate_exec_errors,
     validate_absolute_remote_path,
@@ -419,6 +421,57 @@ class _SandboxFilesystem:
         if returncode != 0:
             raise_remove_error(returncode, stderr, remote_path)
 
+    async def stat(self, remote_path: str) -> FileInfo:
+        """Return metadata for a single file, directory, or symlink in the Sandbox.
+
+        `remote_path` must be an absolute path in the Sandbox. If `remote_path` is a symlink, the returned
+        `FileInfo` object describes the symlink, not the target it points to.
+
+        **Raises**
+
+        - `SandboxFilesystemNotFoundError`: the path does not exist.
+        - `SandboxFilesystemNotADirectoryError`: a non-leaf component of the path is not a directory.
+        - `SandboxFilesystemPermissionError`: a component of the path is not searchable.
+        - `SandboxFilesystemError`: the command fails for any other reason.
+
+        **Usage**
+
+        ```python fixture:sandbox
+        sandbox.filesystem.write_text("Hello, world!\\n", "/tmp/hello.txt")
+        info = sandbox.filesystem.stat("/tmp/hello.txt")
+        print(info.size, info.permissions, info.modified_time)
+        ```
+        """
+        validate_absolute_remote_path(remote_path, "stat")
+
+        t0 = time.monotonic()
+        with translate_exec_errors("stat", remote_path):
+            process = await self._sandbox.exec(_SANDBOX_FS_TOOLS_PATH, make_stat_command(remote_path))
+            stdout, stderr, returncode = await asyncio.gather(
+                process.stdout.read(), process.stderr.read(), process.wait()
+            )
+
+        if returncode != 0:
+            raise_stat_error(returncode, stderr, remote_path)
+
+        entry = json.loads(stdout)
+        result = FileInfo(
+            name=entry["name"],
+            path=entry["path"],
+            type=FileType(entry["type"]),
+            size=entry["size"],
+            mode=entry["mode"],
+            permissions=entry["permissions"],
+            owner=entry["owner"],
+            group=entry["group"],
+            modified_time=entry["modified_time"],
+            symlink_target=entry.get("symlink_target"),
+        )
+
+        dur_s = max(time.monotonic() - t0, 0.001)
+        logger.debug(f"sandbox stat {remote_path}: ({dur_s:.2f}s)")
+        return result
+
     async def write_bytes(self, data: Union[bytes, bytearray, memoryview], remote_path: str) -> None:
         """Write binary content to a file in the Sandbox.
 

modal/sandbox_fs.pyi

@@ -270,6 +270,29 @@ class _SandboxFilesystem:
         """
         ...
 
+    async def stat(self, remote_path: str) -> FileInfo:
+        """Return metadata for a single file, directory, or symlink in the Sandbox.
+
+        `remote_path` must be an absolute path in the Sandbox. If `remote_path` is a symlink, the returned
+        `FileInfo` object describes the symlink, not the target it points to.
+
+        **Raises**
+
+        - `SandboxFilesystemNotFoundError`: the path does not exist.
+        - `SandboxFilesystemNotADirectoryError`: a non-leaf component of the path is not a directory.
+        - `SandboxFilesystemPermissionError`: a component of the path is not searchable.
+        - `SandboxFilesystemError`: the command fails for any other reason.
+
+        **Usage**
+
+        ```python fixture:sandbox
+        sandbox.filesystem.write_text("Hello, world!\n", "/tmp/hello.txt")
+        info = sandbox.filesystem.stat("/tmp/hello.txt")
+        print(info.size, info.permissions, info.modified_time)
+        ```
+        """
+        ...
+
     async def write_bytes(self, data: typing.Union[bytes, bytearray, memoryview], remote_path: str) -> None:
         """Write binary content to a file in the Sandbox.
 
@@ -719,6 +742,55 @@ class SandboxFilesystem:
 
     remove: __remove_spec
 
+    class __stat_spec(typing_extensions.Protocol):
+        def __call__(self, /, remote_path: str) -> FileInfo:
+            """Return metadata for a single file, directory, or symlink in the Sandbox.
+
+            `remote_path` must be an absolute path in the Sandbox. If `remote_path` is a symlink, the returned
+            `FileInfo` object describes the symlink, not the target it points to.
+
+            **Raises**
+
+            - `SandboxFilesystemNotFoundError`: the path does not exist.
+            - `SandboxFilesystemNotADirectoryError`: a non-leaf component of the path is not a directory.
+            - `SandboxFilesystemPermissionError`: a component of the path is not searchable.
+            - `SandboxFilesystemError`: the command fails for any other reason.
+
+            **Usage**
+
+            ```python fixture:sandbox
+            sandbox.filesystem.write_text("Hello, world!\n", "/tmp/hello.txt")
+            info = sandbox.filesystem.stat("/tmp/hello.txt")
+            print(info.size, info.permissions, info.modified_time)
+            ```
+            """
+            ...
+
+        async def aio(self, /, remote_path: str) -> FileInfo:
+            """Return metadata for a single file, directory, or symlink in the Sandbox.
+
+            `remote_path` must be an absolute path in the Sandbox. If `remote_path` is a symlink, the returned
+            `FileInfo` object describes the symlink, not the target it points to.
+
+            **Raises**
+
+            - `SandboxFilesystemNotFoundError`: the path does not exist.
+            - `SandboxFilesystemNotADirectoryError`: a non-leaf component of the path is not a directory.
+            - `SandboxFilesystemPermissionError`: a component of the path is not searchable.
+            - `SandboxFilesystemError`: the command fails for any other reason.
+
+            **Usage**
+
+            ```python fixture:sandbox
+            sandbox.filesystem.write_text("Hello, world!\n", "/tmp/hello.txt")
+            info = sandbox.filesystem.stat("/tmp/hello.txt")
+            print(info.size, info.permissions, info.modified_time)
+            ```
+            """
+            ...
+
+    stat: __stat_spec
+
     class __write_bytes_spec(typing_extensions.Protocol):
         def __call__(self, /, data: typing.Union[bytes, bytearray, memoryview], remote_path: str) -> None:
             """Write binary content to a file in the Sandbox.

modal/serving.py

@@ -93,6 +93,7 @@ async def _serve_app(
     app: "modal.app._App",
     import_ref: ImportRef,
     *,
+    name: Optional[str] = None,
     _watcher: Optional[AsyncGenerator[set[str], None]] = None,  # for testing
     environment_name: Optional[str] = None,
 ) -> AsyncGenerator["modal.app._App", None]:
@@ -101,7 +102,9 @@ async def _serve_app(
 
     client = await _Client.from_env()
 
-    async with _run_app(app, client=client, environment_name=environment_name, deployment_strategy="recreate"):
+    async with _run_app(
+        app, name=name, client=client, environment_name=environment_name, deployment_strategy="recreate"
+    ):
         if _watcher is not None:
             watcher = _watcher  # Only used by tests
         else:

modal/serving.pyi

@@ -29,6 +29,7 @@ def _serve_app(
     app: modal.app._App,
     import_ref: modal.cli.import_refs.ImportRef,
     *,
+    name: typing.Optional[str] = None,
     _watcher: typing.Optional[collections.abc.AsyncGenerator[set[str], None]] = None,
     environment_name: typing.Optional[str] = None,
 ) -> typing.AsyncContextManager[modal.app._App]: ...
@@ -40,6 +41,7 @@ class __serve_app_spec(typing_extensions.Protocol):
         app: modal.app.App,
         import_ref: modal.cli.import_refs.ImportRef,
         *,
+        name: typing.Optional[str] = None,
         _watcher: typing.Optional[typing.Generator[set[str], None, None]] = None,
         environment_name: typing.Optional[str] = None,
     ) -> synchronicity.combined_types.AsyncAndBlockingContextManager[modal.app.App]: ...
@@ -49,6 +51,7 @@ class __serve_app_spec(typing_extensions.Protocol):
         app: modal.app.App,
         import_ref: modal.cli.import_refs.ImportRef,
         *,
+        name: typing.Optional[str] = None,
         _watcher: typing.Optional[collections.abc.AsyncGenerator[set[str], None]] = None,
         environment_name: typing.Optional[str] = None,
     ) -> typing.AsyncContextManager[modal.app.App]: ...

modal/volume.py

@@ -31,7 +31,15 @@ from synchronicity.async_wrap import asynccontextmanager
 
 import modal.exception
 import modal_proto.api_pb2
-from modal.exception import AlreadyExistsError, ConflictError, InvalidError, NotFoundError, VolumeUploadTimeoutError
+from modal.exception import (
+    AlreadyExistsError,
+    ConflictError,
+    ExecutionError,
+    InvalidError,
+    NotFoundError,
+    ServiceError,
+    VolumeUploadTimeoutError,
+)
 from modal_proto import api_pb2
 
 from ._load_context import LoadContext
@@ -75,6 +83,26 @@ from .config import logger
 VOLUME_PUT_FILE_CLIENT_TIMEOUT = 60 * 60
 
 
+async def _raise_on_block_response_error(response) -> None:
+    """Raise a picklable Modal exception on error.
+
+    We avoid `aiohttp.ClientResponse.raise_for_status()` because the resulting
+    `ClientResponseError` is not picklable, which breaks result serialization
+    when raised from within a Modal function.
+    """
+    if response.status < 400:
+        return
+
+    try:
+        body = await response.text()
+    except Exception:
+        body = "<unavailable>"
+
+    if response.status == 503:
+        raise ServiceError(f"Service temporarily unavailable: {body}")
+    raise ExecutionError(f"Request failed with status {response.status} {response.reason}: {body}")
+
+
 def _validate_volume_version(
     requested_version: int,
     actual_version: int,
@@ -742,7 +770,7 @@ class _Volume(_Object, type_prefix="vo"):
         @retry(n_attempts=5, base_delay=0.1, attempt_timeout=None)
         async def read_block(block_url: str) -> bytes:
             async with ClientSessionRegistry.get_session().get(block_url) as get_response:
-                get_response.raise_for_status()
+                await _raise_on_block_response_error(get_response)
                 return await get_response.content.read()
 
         async def iter_urls() -> AsyncGenerator[str]:
@@ -811,7 +839,7 @@ class _Volume(_Object, type_prefix="vo"):
             num_bytes_written = 0
 
             async with download_semaphore, ClientSessionRegistry.get_session().get(url) as get_response:
-                get_response.raise_for_status()
+                await _raise_on_block_response_error(get_response)
                 async for chunk in get_response.content.iter_any():
                     num_chunk_bytes_written = 0
 
@@ -1377,7 +1405,7 @@ async def _put_missing_blocks(
                     missing_block.put_url,
                     data=payload,
                 ) as response:
-                    response.raise_for_status()
+                    await _raise_on_block_response_error(response)
                     return await response.content.read()
 
         async with put_semaphore:

modal/volume.pyi

@@ -15,6 +15,15 @@ import synchronicity.combined_types
 import typing
 import typing_extensions
 
+async def _raise_on_block_response_error(response) -> None:
+    """Raise a picklable Modal exception on error.
+
+    We avoid `aiohttp.ClientResponse.raise_for_status()` because the resulting
+    `ClientResponseError` is not picklable, which breaks result serialization
+    when raised from within a Modal function.
+    """
+    ...
+
 def _validate_volume_version(requested_version: int, actual_version: int, volume_name: str) -> None:
     """Validate that the returned volume version matches the requested version."""
     ...

{modal-1.4.3.dev11.dist-info → modal-1.4.3.dev13.dist-info}/METADATA

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

{modal-1.4.3.dev11.dist-info → modal-1.4.3.dev13.dist-info}/RECORD

@@ -14,19 +14,19 @@ modal/_object.py,sha256=144YrNnTG77vK_PAHRU9GFxHBOlt2PWFgTUXpgX4BQk,14315
 modal/_partial_function.py,sha256=gJbvXIbxkXgVE6eXOJDmvufTPdrOV5DFNBumgNEI1aU,34756
 modal/_resolver.py,sha256=u9GdlHo3Ul_40B97LH0vSrjtEJB__WeRf-Oo79vSmPE,5516
 modal/_resources.py,sha256=Lan7aiWN2IdbIeJIIrmQZqt-BLnW2K5rMk5mB0kjc4k,1785
-modal/_serialization.py,sha256=Yc4czrt8x3xkX43oJngb7BSI4zPgtBVuifYrxTCdsAQ,26451
+modal/_serialization.py,sha256=KQHv6rHoJHwXSNnsB6KVZVQH5EeS80Sa4bu7ykVmHF4,26604
 modal/_server.py,sha256=RLuY_VK5Kor_8VzhcIYKMqNc0_ITe2gWl26OusdFkyc,10049
 modal/_traceback.py,sha256=N0EumYnHHqPHkmP2L6cJKjTpoxc8QYmiofROmdgSthQ,6238
 modal/_tunnel.py,sha256=ixQGklCn6eV2TekgET8o0ZD9dEo36Iw_grUsg-S5Bhg,7084
 modal/_tunnel.pyi,sha256=FoedJzHymbPk4Bmnbszm6uhay2rMq1JS9mIiHELYf3k,13804
 modal/_type_manager.py,sha256=DWjgmjYJuOagw2erin506UUbG2H5UzZCFEekS-7hmfA,9087
 modal/_watcher.py,sha256=LerzeKqyGKOlPw9caRGnIyjcZTFXe5YvmeZ2grT2_q8,3539
-modal/app.py,sha256=I6wpFPPonC61nJ7lACwM5uqStf-IqNEq81L983QOvcc,62584
-modal/app.pyi,sha256=mysbOCD6OjZi938NeMY40RpdpQbnI43Bb4s5P79x5OQ,53773
+modal/app.py,sha256=wnguq9LvxEKSYvy2EMs5wWWKV8WJSnszCjaL8t_rb2A,62631
+modal/app.pyi,sha256=-9667eLtUgoinLTRrJ-Z3SOgMR0S89Qw_vpwEZfp2Pk,53910
 modal/billing.py,sha256=B2zXa7KeMnpqi2AQINycEk-KSXVYaLTTTAQTtuf2Gfs,257
 modal/call_graph.py,sha256=1g2DGcMIJvRy-xKicuf63IVE98gJSnQsr8R_NVMptNc,2581
 modal/client.py,sha256=jjT4eLFHGcvIF6Xw4kPptIx-VmExtphRN8XJ1JA7fWI,15502
-modal/client.pyi,sha256=TESKhuxg_HRtpCQCyKVfNaY3aoAEnHhn6KRAAtASauw,15703
+modal/client.pyi,sha256=oOJ_0UgersqG_9eUWIT8rAsyMXy6rK6wrZp-Rec7Gy8,15703
 modal/cloud_bucket_mount.py,sha256=KkaJVy5vpO_u2NtDYtv1JM-M3y4J0UtWBapTDKpQRcA,6034
 modal/cloud_bucket_mount.pyi,sha256=mGDeEd1XvxGpCE6O5jRBSfIvMXvZ5AtIybea5k-0w9w,7560
 modal/cls.py,sha256=Yrl5b_tQhZMhc5avInM-i5UlGuqeog6Gs4rX2d9lLjI,40390
@@ -43,7 +43,7 @@ modal/file_io.py,sha256=45gO6ScEPKrE-KTQ619RwejaqoHUregwMgKcVktfoAk,22275
 modal/file_io.pyi,sha256=DPaq0BhySaiCX3g56QHhyIMdU1izbfWsjpSp30JoJUU,15745
 modal/file_pattern_matcher.py,sha256=A_Kdkej6q7YQyhM_2-BvpFmPqJ0oHb54B6yf9VqvPVE,8116
 modal/functions.py,sha256=EZRcHFfnoYbvawUJnAHF5nIvoo9GX2Djy7mUmOCXmXc,258
-modal/functions.pyi,sha256=_sZ27MFClkElRg0iyVXmn9pGXwm9F-r49sHjrYhH4Sg,34255
+modal/functions.pyi,sha256=m2uNU9DMi9LWprk9PJykCM1Zs_oEG2-Vl2FaJMGSNpY,34255
 modal/image.py,sha256=EHdzQMPBXtbwHBajZJAC-uLCypF-DoNbB0vMWVfaZ5c,112579
 modal/image.pyi,sha256=zYiJsc5tEhGev_rT9R3cGpyQJf-Hm08OJl37sV4E_fk,79377
 modal/io_streams.py,sha256=JcYbvvjMZFugv53yHc9Id0N4nIvDMwV63ZtnN1bPmZc,30940
@@ -65,28 +65,28 @@ modal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 modal/queue.py,sha256=yd-V0Fds5RrmQqg-Pe9kF7kY-tcvrktxwmwzJT-XTxA,27247
 modal/queue.pyi,sha256=XFkassplPM8wsu-ef_dvls1-0vPfT3H4VdOchVFcsvU,40199
 modal/retries.py,sha256=vPWWKP-FRolJwTBuLPXdWqHV7aJfSQFgEW7vhlBBXRQ,5067
-modal/runner.py,sha256=yIB1PE5EGdvLWPPymyT4P0KYliREnFf-MAtULl3tVN0,30062
-modal/runner.pyi,sha256=ySefjmlMQ5FsvJgJkCWiUZKvcPNfEqdB5hwxI1fGtDo,9445
+modal/runner.py,sha256=P1R9n1O2Mrv_J0RIxqAz_oyioE9W2l5pmEykLaHBCrY,30143
+modal/runner.pyi,sha256=7QHbZawq1P5N9DiSrrEYtXtBCDAWlRibNonBO0q6MdM,9570
 modal/running_app.py,sha256=v61mapYNV1-O-Uaho5EfJlryMLvIT9We0amUOSvSGx8,1188
 modal/sandbox.py,sha256=byesQYe1QWRNB6yA3eTpr8TUIlb398U9kSoSm77X9P0,83622
 modal/sandbox.pyi,sha256=fDUIw3NsJPBRZ198lEo_Bw9WfESsqmUWcFLRnow8F-0,86546
-modal/sandbox_fs.py,sha256=IfsbUfYO1whNENRLP1UukH5TdYsdctveE1hvIPoKoGA,19789
-modal/sandbox_fs.pyi,sha256=0PlbdZmBERFbQ2ZgwHnqBZybD6SVOmWecBDuHQa3ZY8,31826
+modal/sandbox_fs.py,sha256=R-uYmsPkUWua5dWzh8DhCdCIa6FvHNJFYtXbffnONa0,21891
+modal/sandbox_fs.pyi,sha256=zsSDGNSTkjo_gJYQH3J7if8Y6J8_Uy4f9u0CypCo5uc,34946
 modal/schedule.py,sha256=ng0g0AqNY5GQI9KhkXZQ5Wam5G42glbkqVQsNpBtbDE,3078
 modal/scheduler_placement.py,sha256=BAREdOY5HzHpzSBqt6jDVR6YC_jYfHMVqOzkyqQfngU,1235
 modal/secret.py,sha256=N44g75jJ8r8kcit4U_m5Vu9AdQwi9pXFehpKviP8amQ,18655
 modal/secret.pyi,sha256=DqG0o5ndliJNO71vNRe9Ee_6ioTgsLKzHkr7S5ru8eI,21488
 modal/server.py,sha256=zWoDdtwCEKsKbFfWC4l7-NkpnJJybweC284VIoCavrI,164
 modal/server.pyi,sha256=d_boB2FhK2b3C_G7YPM9oeWlCWEZhBCxbeebAKcrY-Q,5242
-modal/serving.py,sha256=akauomk_rQNabYKXhgp6SGxBU4cFontanDqMfAkk7Ng,4188
-modal/serving.pyi,sha256=eNqF_bhO_JQ0EDpqvSjSUdNs48vv7AcPXinp7GEs5wI,1966
+modal/serving.py,sha256=zhAVUyztbB-mVz0ddYs349t1BYTmoWHaE2G8IdTNAMM,4245
+modal/serving.pyi,sha256=imGbIuEVwqJJgJURC-k3p9kQT6hYA4try7guI-AWZOs,2091
 modal/snapshot.py,sha256=vIKxA1XRRsH8cFcpSUqC9M8NccKIaYaDpmiEC2clNks,2297
 modal/snapshot.pyi,sha256=vMYDx1s9Ds4qtH-PXgB_9RzVuS5wsTchVcclR5Q-mmM,2014
 modal/stream_type.py,sha256=A6320qoAAWhEfwOCZfGtymQTu5AfLfJXXgARqooTPvY,417
 modal/token_flow.py,sha256=muvMsYAcLB2X1s61K-ChGNnu-vPpQUW1N8IYOrA8eho,7036
 modal/token_flow.pyi,sha256=5zdXJ5SLLHM4j6xSPuEvnpSeEJBbzE6NkSX-MSyE5wM,2282
-modal/volume.py,sha256=AmpakUZKJueLAVzAEkx46rMBAlr8XEWns7FWEGdeznU,55633
-modal/volume.pyi,sha256=AkEAVascR5GO30s1cRIZYcF8ehT6jPs-G1miOBUcIRA,55857
+modal/volume.py,sha256=N8QBz-KJ59O79eSOaetatoVO_fev_ywOQZjsnihKu6I,56426
+modal/volume.pyi,sha256=nOTgO1HThjldwxcUSw8S534BMNYooDGK1sI4ySnHQ6o,56189
 modal/_output/__init__.py,sha256=xtGN6SPv2zvByrJ32JPao0yJKpxyCIZ-2JMTScrisuQ,28
 modal/_output/manager.py,sha256=8JGUm8S1PfiibvyI1t_pcniktZbe8KAV1TvLtoZ80rk,18161
 modal/_output/pty.py,sha256=wniYe_MW9_pEhCjDgRyrruYJNNtZoAJ0MuOOl3UrGI0,10174
@@ -96,8 +96,8 @@ modal/_runtime/__init__.py,sha256=MIEP8jhXUeGq_eCjYFcqN5b1bxBM4fdk0VESpjWR0fc,28
 modal/_runtime/asgi.py,sha256=1d6PG6pxQAOg1FZTeB6YW_86zAw4OxnY-uOjaaGzyxA,22808
 modal/_runtime/container_io_manager.py,sha256=EQF1aAtzb0A2chhr0B8es_G0rawbBUKZaFu0-p6dsQU,52102
 modal/_runtime/container_io_manager.pyi,sha256=qwnmErhulV_2OYRWbw8wM3vw6r2Pub1W98NccrKrXaY,22701
-modal/_runtime/execution_context.py,sha256=AYrNQRHHXEqX2MwMf8zxelKZnYf25RE_B-NRLWf93n8,3521
-modal/_runtime/execution_context.pyi,sha256=FVzakehz72ndL-ufe8-EC7TM4IHO_MEBcAdgWuU4W9k,2426
+modal/_runtime/execution_context.py,sha256=vanzJeaTpknTB2-DJQIpPjCJGTfn8gqiQlqGOfkxn2g,3665
+modal/_runtime/execution_context.pyi,sha256=i30NeuFxr7wcaqIUnLN9-fh_LqpcMe-KZ6Cn0VXZvcU,2569
 modal/_runtime/gpu_memory_snapshot.py,sha256=vRLzSVZckD7xYjahrXlRPExuoOdDwTTKIaEMsWDTrzM,12113
 modal/_runtime/telemetry.py,sha256=T1RoAGyjBDr1swiM6pPsGRSITm7LI5FDK18oNXxY08U,5163
 modal/_runtime/user_code_event_loop.py,sha256=HwOuDyCZLOakr_DG7p2MrcscjSQNheIhBBuLgB5I3Cc,3014
@@ -124,7 +124,7 @@ modal/_utils/name_utils.py,sha256=CIQL0Y4z47tq0rfNL2Kdo5dxsGrxoN2hR9Ko0HapeE4,25
 modal/_utils/package_utils.py,sha256=jYE7WFVzYWIfO0ZJhno_BYHb6Skp48uupOiw1a3yWzw,2056
 modal/_utils/pattern_utils.py,sha256=ZUffaECfe2iYBhH6cvCB-0-UWhmEBTZEl_TwG_So3ag,6714
 modal/_utils/rand_pb_testing.py,sha256=OYfbSeEXNMgwy-nAi4hHbgZdb08Ss3BV6TyJp6-gwNs,4360
-modal/_utils/sandbox_fs_utils.py,sha256=ldHfvdfsTXnMmZHgGlJS-wThCBykLr1oDKJkZ6qo8Xg,12411
+modal/_utils/sandbox_fs_utils.py,sha256=lfYcYA8wQgnUWtSC0UxRzrEThFWOY5ppuA0GJeYzhrg,13914
 modal/_utils/shell_utils.py,sha256=GjMrO1YxnBr4_UlpA2ZYQKCHxV78QTg0mqxAMHWGTE4,3427
 modal/_utils/task_command_router_client.py,sha256=t2DCt2zPcULqXZJH6JWnWT_wx-g8DRQpPjnSb9bc5dw,28288
 modal/_utils/time_utils.py,sha256=PBMHCGzysBVaEnsjc0BSf0bPdSOSXeV11rtTAu5vvus,8451
@@ -143,7 +143,7 @@ modal/builder/README.md,sha256=9tK76KP0Uph7O0M5oUgsSwEZDj5y-dcUPsnpR0Sc-Ik,854
 modal/builder/base-images.json,sha256=9zgY2-a2U_iEBBe60VNLQvErJQosRhQuXXRqcG6mHGg,1348
 modal/cli/__init__.py,sha256=6FRleWQxBDT19y7OayO4lBOzuL6Bs9r0rLINYYYbHwQ,769
 modal/cli/_download.py,sha256=5PQL3tkTJkG-Wb6I0vxfHY4L8kUzd4Fy83jlT6vh9Og,5062
-modal/cli/_help.py,sha256=jvho74ebwwXO41bNmcDS6QRGIPznoFB_mT0AI_6K2Xg,9288
+modal/cli/_help.py,sha256=5-qhkf9vdF1ziaupWlfthuWu-roNFJFRLkQzbVdecDg,10034
 modal/cli/_traceback.py,sha256=QxR4xmA-cmT6Uyh6VLp5fgxwSI13QaF6MM63v2WSZ2U,5982
 modal/cli/app.py,sha256=9mTkT2JZaGs2_GomWMk_WIXAuP4HelmgyqLUWhc-gwk,21990
 modal/cli/billing.py,sha256=afXmnVmak5gzPF9n-3v_WQ7jTr2idyZCKk7gKRKuYmo,5727
@@ -162,12 +162,12 @@ modal/cli/logo.py,sha256=plv82syvPb8j3qrR1A_nojZwp823t3VEXaDlrx1jkt0,3221
 modal/cli/network_file_system.py,sha256=GbbgzZ86iprMfV3e7mmLpwp_JWoBxEp1tB_XeBEt_GE,7588
 modal/cli/profile.py,sha256=S0DZL42eeXbNgGFxHcQG_KMRH946U7V1wW4EIeRjX04,3308
 modal/cli/queues.py,sha256=jv3sAK1YGMaXo2G011mvwYIZVQtKJH2HLPI5m4CTniI,6567
-modal/cli/run.py,sha256=_8rJAqBhxWNAY8VWUq2ZPoRvigYjTceoGjkjnEWMkw0,22351
+modal/cli/run.py,sha256=9f5vxIrc-0USOavm6yPMpTf0SJFDaKJHrHyRhb1n25A,22650
 modal/cli/secret.py,sha256=4VLo0Sgnpoxm_qZxNOFZkip92faynowtwGYan9qVckg,8254
 modal/cli/selector.py,sha256=OJr9Ua3K_l-qu3N3-I8z8oVq8lBakws2-XgfheR5p-c,4741
 modal/cli/shell.py,sha256=bzFy3G2wW7kSJSD5I-xnR41CghmKeBbZeEVZgWr_oZ0,14724
 modal/cli/token.py,sha256=Km7V7pHXsNKyjOCEdioQT8-o04Rh2-PzmNpiL1_i8tw,4352
-modal/cli/utils.py,sha256=NMlMfTxXRBnaRjRkX-GXAEA2jX90nEIZ4GUzQevwuFc,6370
+modal/cli/utils.py,sha256=CUNFXLcV8EJymZCTXettHDJTDBJi73uHMywayr0ytow,6305
 modal/cli/volume.py,sha256=tdewchdKd3sUpFof0jfSKDX3tPk-TziSUzxpRbwTVb4,11513
 modal/cli/programs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal/cli/programs/run_jupyter.py,sha256=IJw8nds8Cjl9j4dxBqMGxhz-bIyVX0kle7jbt8HFOhM,2688
@@ -176,7 +176,7 @@ modal/experimental/__init__.py,sha256=Wb1YoAKAnNxH_0c2wA0T12I7bSu9PSO2nS_LuLska7
 modal/experimental/flash.py,sha256=ATGhVO8AleJ-TOe2PGolI5T7zfCEtj0kl_ivMPp7Rqg,33362
 modal/experimental/flash.pyi,sha256=R4h2nQl7-oiwqq_twCp0YqID_LnPjPGqxywXvxbiLIk,17011
 modal/experimental/ipython.py,sha256=TrCfmol9LGsRZMeDoeMPx3Hv3BFqQhYnmD_iH0pqdhk,2904
-modal-1.4.3.dev11.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
+modal-1.4.3.dev13.dist-info/licenses/LICENSE,sha256=psuoW8kuDP96RQsdhzwOqi6fyWv0ct8CR6Jr7He_P_k,10173
 modal_docs/__init__.py,sha256=svYKtV8HDwDCN86zbdWqyq5T8sMdGDj0PVlzc2tIxDM,28
 modal_docs/gen_cli_docs.py,sha256=bfUSLscHfoQoKkKjIqJvQMe3fURzqcQK7gF1h9WQLtM,3742
 modal_docs/gen_cli_docs_main.py,sha256=UPGr7O1DYTIRLwfINe2rbdh89J3cPVTU1OWL-SjxnOQ,198
@@ -194,14 +194,14 @@ modal_proto/api_pb2_grpc.pyi,sha256=qDqqKIs18olWaoBjLOJ8Z6Gn8_GjpNn3Z1Pw1yG_M4I,
 modal_proto/modal_api_grpc.py,sha256=bBPhTehvCriGANMHxXNxKa58ew_2QbSvO88zhKCr4CE,24177
 modal_proto/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 modal_proto/task_command_router_grpc.py,sha256=i5ho152oU3hgfY3DZLXdT44ogcMy7rQUfGcEbmi0vXc,14477
-modal_proto/task_command_router_pb2.py,sha256=cFzU-s7Y1cnqUHIVrSFauBQ37Xv_jEQRDTHSNb-70t0,28015
-modal_proto/task_command_router_pb2.pyi,sha256=0fjfaucVSziP8VCLMalnqTaSfPCDjwMsWlD3EDQA_sk,30466
+modal_proto/task_command_router_pb2.py,sha256=6TY5umHeqYdFNuRaOoZP2YfUbtCxRHqyi27CBZKLV_M,28101
+modal_proto/task_command_router_pb2.pyi,sha256=PYljoZVw16_d4Hn-9cD6SDssmYsvVqx_HOgEEUGYBLk,31452
 modal_proto/task_command_router_pb2_grpc.py,sha256=XVmcdxLnK_IY3trlF6nLmzFhqSG-bbYNABC7xIs6fT8,28732
 modal_proto/task_command_router_pb2_grpc.pyi,sha256=og_J8CxYeAV0ikpHXZMvr_uC15UD3I3fgyyAO2pGm1E,8981
-modal_version/__init__.py,sha256=yRwV3aDQyH5zSEI0qg__V1CgMd-dxzN2Y2TPsMMH5vQ,121
+modal_version/__init__.py,sha256=RN59WVKtaDa4sk1gZLix2zOhp6cMeZyiQXIL_DExp_U,121
 modal_version/__main__.py,sha256=nLUbubxKx7GXNzJIkTB7M7_u8080LyLM0IS0rzFkC_c,119
-modal-1.4.3.dev11.dist-info/METADATA,sha256=yBw9sX-TvJ8clh7hc46K5NHNKkAjx90i3qv3OEZcNc0,2339
-modal-1.4.3.dev11.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-modal-1.4.3.dev11.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
-modal-1.4.3.dev11.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
-modal-1.4.3.dev11.dist-info/RECORD,,
+modal-1.4.3.dev13.dist-info/METADATA,sha256=Ei1LsDqnltoMGnOnGkAcSm8M8b5gQMUsbueBXX9whO4,2339
+modal-1.4.3.dev13.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+modal-1.4.3.dev13.dist-info/entry_points.txt,sha256=An-wYgeEUnm6xzrAP9_NTSTSciYvvEWsMZILtYrvpAI,46
+modal-1.4.3.dev13.dist-info/top_level.txt,sha256=4BWzoKYREKUZ5iyPzZpjqx4G8uB5TWxXPDwibLcVa7k,43
+modal-1.4.3.dev13.dist-info/RECORD,,

modal_proto/task_command_router_pb2.py

@@ -17,7 +17,7 @@ from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
 from modal_proto import api_pb2 as modal__proto_dot_api__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n%modal_proto/task_command_router.proto\x12\x19modal.task_command_router\x1a\x1bgoogle/protobuf/empty.proto\x1a\x15modal_proto/api.proto\"X\n\x1aSandboxStdinWriteV2Request\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0e\n\x06offset\x18\x02 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\x12\x0b\n\x03\x65of\x18\x04 \x01(\x08\"\x1d\n\x1bSandboxStdinWriteV2Response\"\x8c\x01\n\x19SandboxStdioReadV2Request\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0e\n\x06offset\x18\x02 \x01(\x04\x12N\n\x0f\x66ile_descriptor\x18\x03 \x01(\x0e\x32\x35.modal.task_command_router.SandboxStdioFileDescriptor\"*\n\x1aSandboxStdioReadV2Response\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\"\x83\x02\n\x1aTaskContainerCreateRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\x12\x10\n\x08image_id\x18\x03 \x01(\t\x12\x0c\n\x04\x61rgs\x18\x05 \x03(\t\x12K\n\x03\x65nv\x18\x06 \x03(\x0b\x32>.modal.task_command_router.TaskContainerCreateRequest.EnvEntry\x12\x0f\n\x07workdir\x18\x07 \x01(\t\x12\x12\n\nsecret_ids\x18\x08 \x03(\t\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"K\n\x1bTaskContainerCreateResponse\x12\x14\n\x0c\x63ontainer_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\"^\n\x17TaskContainerGetRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\x12\x1a\n\x12include_terminated\x18\x03 \x01(\x08\"[\n\x18TaskContainerGetResponse\x12?\n\tcontainer\x18\x01 \x01(\x0b\x32,.modal.task_command_router.TaskContainerInfo\"~\n\x11TaskContainerInfo\x12\x14\n\x0c\x63ontainer_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\x12\x0e\n\x06status\x18\x03 \x01(\t\x12+\n\x06result\x18\x04 \x01(\x0b\x32\x1b.modal.client.GenericResult\"G\n\x18TaskContainerListRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x1a\n\x12include_terminated\x18\x02 \x01(\x08\"]\n\x19TaskContainerListResponse\x12@\n\ncontainers\x18\x01 \x03(\x0b\x32,.modal.task_command_router.TaskContainerInfo\"F\n\x1dTaskContainerTerminateRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x14\n\x0c\x63ontainer_id\x18\x02 \x01(\t\" \n\x1eTaskContainerTerminateResponse\"R\n\x18TaskContainerWaitRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x14\n\x0c\x63ontainer_id\x18\x02 \x01(\t\x12\x0f\n\x07timeout\x18\x03 \x01(\x02\"H\n\x19TaskContainerWaitResponse\x12+\n\x06result\x18\x01 \x01(\x0b\x32\x1b.modal.client.GenericResult\"7\n\x13TaskExecPollRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\"G\n\x14TaskExecPollResponse\x12\x0e\n\x04\x63ode\x18\x01 \x01(\x05H\x00\x12\x10\n\x06signal\x18\x02 \x01(\x05H\x00\x42\r\n\x0b\x65xit_status\"\x9b\x04\n\x14TaskExecStartRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x14\n\x0c\x63ommand_args\x18\x03 \x03(\t\x12\x46\n\rstdout_config\x18\x04 \x01(\x0e\x32/.modal.task_command_router.TaskExecStdoutConfig\x12\x46\n\rstderr_config\x18\x05 \x01(\x0e\x32/.modal.task_command_router.TaskExecStderrConfig\x12\x19\n\x0ctimeout_secs\x18\x06 \x01(\rH\x00\x88\x01\x01\x12\x14\n\x07workdir\x18\x07 \x01(\tH\x01\x88\x01\x01\x12\x12\n\nsecret_ids\x18\x08 \x03(\t\x12,\n\x08pty_info\x18\t \x01(\x0b\x32\x15.modal.client.PTYInfoH\x02\x88\x01\x01\x12\x15\n\rruntime_debug\x18\n \x01(\x08\x12\x14\n\x0c\x63ontainer_id\x18\x0b \x01(\t\x12\x45\n\x03\x65nv\x18\x0c \x03(\x0b\x32\x38.modal.task_command_router.TaskExecStartRequest.EnvEntry\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x0f\n\r_timeout_secsB\n\n\x08_workdirB\x0b\n\t_pty_info\"\x17\n\x15TaskExecStartResponse\"h\n\x19TaskExecStdinWriteRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x04 \x01(\x0c\x12\x0b\n\x03\x65of\x18\x05 \x01(\x08\"\x1c\n\x1aTaskExecStdinWriteResponse\"\x9d\x01\n\x18TaskExecStdioReadRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12O\n\x0f\x66ile_descriptor\x18\x04 \x01(\x0e\x32\x36.modal.task_command_router.TaskExecStdioFileDescriptor\")\n\x19TaskExecStdioReadResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\"7\n\x13TaskExecWaitRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\"G\n\x14TaskExecWaitResponse\x12\x0e\n\x04\x63ode\x18\x01 \x01(\x05H\x00\x12\x10\n\x06signal\x18\x02 \x01(\x05H\x00\x42\r\n\x0b\x65xit_status\"L\n\x19TaskMountDirectoryRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\x0c\x12\x10\n\x08image_id\x18\x03 \x01(\t\"R\n\x1cTaskSnapshotDirectoryRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\x0c\x12\x13\n\x0bsnapshot_id\x18\x03 \x01(\t\"1\n\x1dTaskSnapshotDirectoryResponse\x12\x10\n\x08image_id\x18\x01 \x01(\t\"<\n\x1bTaskUnmountDirectoryRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\x0c*p\n\x1aSandboxStdioFileDescriptor\x12(\n$SANDBOX_STDIO_FILE_DESCRIPTOR_STDOUT\x10\x00\x12(\n$SANDBOX_STDIO_FILE_DESCRIPTOR_STDERR\x10\x01*\x81\x01\n\x14TaskExecStderrConfig\x12#\n\x1fTASK_EXEC_STDERR_CONFIG_DEVNULL\x10\x00\x12 \n\x1cTASK_EXEC_STDERR_CONFIG_PIPE\x10\x01\x12\"\n\x1eTASK_EXEC_STDERR_CONFIG_STDOUT\x10\x02*u\n\x1bTaskExecStdioFileDescriptor\x12*\n&TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDOUT\x10\x00\x12*\n&TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDERR\x10\x01*]\n\x14TaskExecStdoutConfig\x12#\n\x1fTASK_EXEC_STDOUT_CONFIG_DEVNULL\x10\x00\x12 \n\x1cTASK_EXEC_STDOUT_CONFIG_PIPE\x10\x01\x32\xea\x0e\n\x11TaskCommandRouter\x12\x84\x01\n\x13SandboxStdinWriteV2\x12\x35.modal.task_command_router.SandboxStdinWriteV2Request\x1a\x36.modal.task_command_router.SandboxStdinWriteV2Response\x12\x83\x01\n\x12SandboxStdioReadV2\x12\x34.modal.task_command_router.SandboxStdioReadV2Request\x1a\x35.modal.task_command_router.SandboxStdioReadV2Response0\x01\x12\x84\x01\n\x13TaskContainerCreate\x12\x35.modal.task_command_router.TaskContainerCreateRequest\x1a\x36.modal.task_command_router.TaskContainerCreateResponse\x12{\n\x10TaskContainerGet\x12\x32.modal.task_command_router.TaskContainerGetRequest\x1a\x33.modal.task_command_router.TaskContainerGetResponse\x12~\n\x11TaskContainerList\x12\x33.modal.task_command_router.TaskContainerListRequest\x1a\x34.modal.task_command_router.TaskContainerListResponse\x12\x8d\x01\n\x16TaskContainerTerminate\x12\x38.modal.task_command_router.TaskContainerTerminateRequest\x1a\x39.modal.task_command_router.TaskContainerTerminateResponse\x12~\n\x11TaskContainerWait\x12\x33.modal.task_command_router.TaskContainerWaitRequest\x1a\x34.modal.task_command_router.TaskContainerWaitResponse\x12o\n\x0cTaskExecPoll\x12..modal.task_command_router.TaskExecPollRequest\x1a/.modal.task_command_router.TaskExecPollResponse\x12r\n\rTaskExecStart\x12/.modal.task_command_router.TaskExecStartRequest\x1a\x30.modal.task_command_router.TaskExecStartResponse\x12\x81\x01\n\x12TaskExecStdinWrite\x12\x34.modal.task_command_router.TaskExecStdinWriteRequest\x1a\x35.modal.task_command_router.TaskExecStdinWriteResponse\x12\x80\x01\n\x11TaskExecStdioRead\x12\x33.modal.task_command_router.TaskExecStdioReadRequest\x1a\x34.modal.task_command_router.TaskExecStdioReadResponse0\x01\x12o\n\x0cTaskExecWait\x12..modal.task_command_router.TaskExecWaitRequest\x1a/.modal.task_command_router.TaskExecWaitResponse\x12\x62\n\x12TaskMountDirectory\x12\x34.modal.task_command_router.TaskMountDirectoryRequest\x1a\x16.google.protobuf.Empty\x12\x8a\x01\n\x15TaskSnapshotDirectory\x12\x37.modal.task_command_router.TaskSnapshotDirectoryRequest\x1a\x38.modal.task_command_router.TaskSnapshotDirectoryResponse\x12\x66\n\x14TaskUnmountDirectory\x12\x36.modal.task_command_router.TaskUnmountDirectoryRequest\x1a\x16.google.protobuf.EmptyB&Z$github.com/modal-labs/modal/go/protob\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n%modal_proto/task_command_router.proto\x12\x19modal.task_command_router\x1a\x1bgoogle/protobuf/empty.proto\x1a\x15modal_proto/api.proto\"X\n\x1aSandboxStdinWriteV2Request\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0e\n\x06offset\x18\x02 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\x12\x0b\n\x03\x65of\x18\x04 \x01(\x08\"\x1d\n\x1bSandboxStdinWriteV2Response\"\x8c\x01\n\x19SandboxStdioReadV2Request\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0e\n\x06offset\x18\x02 \x01(\x04\x12N\n\x0f\x66ile_descriptor\x18\x03 \x01(\x0e\x32\x35.modal.task_command_router.SandboxStdioFileDescriptor\"*\n\x1aSandboxStdioReadV2Response\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\"\x83\x02\n\x1aTaskContainerCreateRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\x12\x10\n\x08image_id\x18\x03 \x01(\t\x12\x0c\n\x04\x61rgs\x18\x05 \x03(\t\x12K\n\x03\x65nv\x18\x06 \x03(\x0b\x32>.modal.task_command_router.TaskContainerCreateRequest.EnvEntry\x12\x0f\n\x07workdir\x18\x07 \x01(\t\x12\x12\n\nsecret_ids\x18\x08 \x03(\t\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"K\n\x1bTaskContainerCreateResponse\x12\x14\n\x0c\x63ontainer_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\"^\n\x17TaskContainerGetRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\x12\x1a\n\x12include_terminated\x18\x03 \x01(\x08\"[\n\x18TaskContainerGetResponse\x12?\n\tcontainer\x18\x01 \x01(\x0b\x32,.modal.task_command_router.TaskContainerInfo\"~\n\x11TaskContainerInfo\x12\x14\n\x0c\x63ontainer_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63ontainer_name\x18\x02 \x01(\t\x12\x0e\n\x06status\x18\x03 \x01(\t\x12+\n\x06result\x18\x04 \x01(\x0b\x32\x1b.modal.client.GenericResult\"G\n\x18TaskContainerListRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x1a\n\x12include_terminated\x18\x02 \x01(\x08\"]\n\x19TaskContainerListResponse\x12@\n\ncontainers\x18\x01 \x03(\x0b\x32,.modal.task_command_router.TaskContainerInfo\"F\n\x1dTaskContainerTerminateRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x14\n\x0c\x63ontainer_id\x18\x02 \x01(\t\" \n\x1eTaskContainerTerminateResponse\"R\n\x18TaskContainerWaitRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x14\n\x0c\x63ontainer_id\x18\x02 \x01(\t\x12\x0f\n\x07timeout\x18\x03 \x01(\x02\"H\n\x19TaskContainerWaitResponse\x12+\n\x06result\x18\x01 \x01(\x0b\x32\x1b.modal.client.GenericResult\"7\n\x13TaskExecPollRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\"G\n\x14TaskExecPollResponse\x12\x0e\n\x04\x63ode\x18\x01 \x01(\x05H\x00\x12\x10\n\x06signal\x18\x02 \x01(\x05H\x00\x42\r\n\x0b\x65xit_status\"\x9b\x04\n\x14TaskExecStartRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x14\n\x0c\x63ommand_args\x18\x03 \x03(\t\x12\x46\n\rstdout_config\x18\x04 \x01(\x0e\x32/.modal.task_command_router.TaskExecStdoutConfig\x12\x46\n\rstderr_config\x18\x05 \x01(\x0e\x32/.modal.task_command_router.TaskExecStderrConfig\x12\x19\n\x0ctimeout_secs\x18\x06 \x01(\rH\x00\x88\x01\x01\x12\x14\n\x07workdir\x18\x07 \x01(\tH\x01\x88\x01\x01\x12\x12\n\nsecret_ids\x18\x08 \x03(\t\x12,\n\x08pty_info\x18\t \x01(\x0b\x32\x15.modal.client.PTYInfoH\x02\x88\x01\x01\x12\x15\n\rruntime_debug\x18\n \x01(\x08\x12\x14\n\x0c\x63ontainer_id\x18\x0b \x01(\t\x12\x45\n\x03\x65nv\x18\x0c \x03(\x0b\x32\x38.modal.task_command_router.TaskExecStartRequest.EnvEntry\x1a*\n\x08\x45nvEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x0f\n\r_timeout_secsB\n\n\x08_workdirB\x0b\n\t_pty_info\"\x17\n\x15TaskExecStartResponse\"h\n\x19TaskExecStdinWriteRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12\x0c\n\x04\x64\x61ta\x18\x04 \x01(\x0c\x12\x0b\n\x03\x65of\x18\x05 \x01(\x08\"\x1c\n\x1aTaskExecStdinWriteResponse\"\x9d\x01\n\x18TaskExecStdioReadRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\x12\x0e\n\x06offset\x18\x03 \x01(\x04\x12O\n\x0f\x66ile_descriptor\x18\x04 \x01(\x0e\x32\x36.modal.task_command_router.TaskExecStdioFileDescriptor\")\n\x19TaskExecStdioReadResponse\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\"7\n\x13TaskExecWaitRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0f\n\x07\x65xec_id\x18\x02 \x01(\t\"G\n\x14TaskExecWaitResponse\x12\x0e\n\x04\x63ode\x18\x01 \x01(\x05H\x00\x12\x10\n\x06signal\x18\x02 \x01(\x05H\x00\x42\r\n\x0b\x65xit_status\"L\n\x19TaskMountDirectoryRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\x0c\x12\x10\n\x08image_id\x18\x03 \x01(\t\"|\n\x1cTaskSnapshotDirectoryRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\x0c\x12\x13\n\x0bsnapshot_id\x18\x03 \x01(\t\x12\x18\n\x0bttl_seconds\x18\x04 \x01(\x03H\x00\x88\x01\x01\x42\x0e\n\x0c_ttl_seconds\"1\n\x1dTaskSnapshotDirectoryResponse\x12\x10\n\x08image_id\x18\x01 \x01(\t\"<\n\x1bTaskUnmountDirectoryRequest\x12\x0f\n\x07task_id\x18\x01 \x01(\t\x12\x0c\n\x04path\x18\x02 \x01(\x0c*p\n\x1aSandboxStdioFileDescriptor\x12(\n$SANDBOX_STDIO_FILE_DESCRIPTOR_STDOUT\x10\x00\x12(\n$SANDBOX_STDIO_FILE_DESCRIPTOR_STDERR\x10\x01*\x81\x01\n\x14TaskExecStderrConfig\x12#\n\x1fTASK_EXEC_STDERR_CONFIG_DEVNULL\x10\x00\x12 \n\x1cTASK_EXEC_STDERR_CONFIG_PIPE\x10\x01\x12\"\n\x1eTASK_EXEC_STDERR_CONFIG_STDOUT\x10\x02*u\n\x1bTaskExecStdioFileDescriptor\x12*\n&TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDOUT\x10\x00\x12*\n&TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDERR\x10\x01*]\n\x14TaskExecStdoutConfig\x12#\n\x1fTASK_EXEC_STDOUT_CONFIG_DEVNULL\x10\x00\x12 \n\x1cTASK_EXEC_STDOUT_CONFIG_PIPE\x10\x01\x32\xea\x0e\n\x11TaskCommandRouter\x12\x84\x01\n\x13SandboxStdinWriteV2\x12\x35.modal.task_command_router.SandboxStdinWriteV2Request\x1a\x36.modal.task_command_router.SandboxStdinWriteV2Response\x12\x83\x01\n\x12SandboxStdioReadV2\x12\x34.modal.task_command_router.SandboxStdioReadV2Request\x1a\x35.modal.task_command_router.SandboxStdioReadV2Response0\x01\x12\x84\x01\n\x13TaskContainerCreate\x12\x35.modal.task_command_router.TaskContainerCreateRequest\x1a\x36.modal.task_command_router.TaskContainerCreateResponse\x12{\n\x10TaskContainerGet\x12\x32.modal.task_command_router.TaskContainerGetRequest\x1a\x33.modal.task_command_router.TaskContainerGetResponse\x12~\n\x11TaskContainerList\x12\x33.modal.task_command_router.TaskContainerListRequest\x1a\x34.modal.task_command_router.TaskContainerListResponse\x12\x8d\x01\n\x16TaskContainerTerminate\x12\x38.modal.task_command_router.TaskContainerTerminateRequest\x1a\x39.modal.task_command_router.TaskContainerTerminateResponse\x12~\n\x11TaskContainerWait\x12\x33.modal.task_command_router.TaskContainerWaitRequest\x1a\x34.modal.task_command_router.TaskContainerWaitResponse\x12o\n\x0cTaskExecPoll\x12..modal.task_command_router.TaskExecPollRequest\x1a/.modal.task_command_router.TaskExecPollResponse\x12r\n\rTaskExecStart\x12/.modal.task_command_router.TaskExecStartRequest\x1a\x30.modal.task_command_router.TaskExecStartResponse\x12\x81\x01\n\x12TaskExecStdinWrite\x12\x34.modal.task_command_router.TaskExecStdinWriteRequest\x1a\x35.modal.task_command_router.TaskExecStdinWriteResponse\x12\x80\x01\n\x11TaskExecStdioRead\x12\x33.modal.task_command_router.TaskExecStdioReadRequest\x1a\x34.modal.task_command_router.TaskExecStdioReadResponse0\x01\x12o\n\x0cTaskExecWait\x12..modal.task_command_router.TaskExecWaitRequest\x1a/.modal.task_command_router.TaskExecWaitResponse\x12\x62\n\x12TaskMountDirectory\x12\x34.modal.task_command_router.TaskMountDirectoryRequest\x1a\x16.google.protobuf.Empty\x12\x8a\x01\n\x15TaskSnapshotDirectory\x12\x37.modal.task_command_router.TaskSnapshotDirectoryRequest\x1a\x38.modal.task_command_router.TaskSnapshotDirectoryResponse\x12\x66\n\x14TaskUnmountDirectory\x12\x36.modal.task_command_router.TaskUnmountDirectoryRequest\x1a\x16.google.protobuf.EmptyB&Z$github.com/modal-labs/modal/go/protob\x06proto3')
 
 _SANDBOXSTDIOFILEDESCRIPTOR = DESCRIPTOR.enum_types_by_name['SandboxStdioFileDescriptor']
 SandboxStdioFileDescriptor = enum_type_wrapper.EnumTypeWrapper(_SANDBOXSTDIOFILEDESCRIPTOR)
@@ -297,14 +297,14 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _TASKCONTAINERCREATEREQUEST_ENVENTRY._serialized_options = b'8\001'
   _TASKEXECSTARTREQUEST_ENVENTRY._options = None
   _TASKEXECSTARTREQUEST_ENVENTRY._serialized_options = b'8\001'
-  _SANDBOXSTDIOFILEDESCRIPTOR._serialized_start=2957
-  _SANDBOXSTDIOFILEDESCRIPTOR._serialized_end=3069
-  _TASKEXECSTDERRCONFIG._serialized_start=3072
-  _TASKEXECSTDERRCONFIG._serialized_end=3201
-  _TASKEXECSTDIOFILEDESCRIPTOR._serialized_start=3203
-  _TASKEXECSTDIOFILEDESCRIPTOR._serialized_end=3320
-  _TASKEXECSTDOUTCONFIG._serialized_start=3322
-  _TASKEXECSTDOUTCONFIG._serialized_end=3415
+  _SANDBOXSTDIOFILEDESCRIPTOR._serialized_start=2999
+  _SANDBOXSTDIOFILEDESCRIPTOR._serialized_end=3111
+  _TASKEXECSTDERRCONFIG._serialized_start=3114
+  _TASKEXECSTDERRCONFIG._serialized_end=3243
+  _TASKEXECSTDIOFILEDESCRIPTOR._serialized_start=3245
+  _TASKEXECSTDIOFILEDESCRIPTOR._serialized_end=3362
+  _TASKEXECSTDOUTCONFIG._serialized_start=3364
+  _TASKEXECSTDOUTCONFIG._serialized_end=3457
   _SANDBOXSTDINWRITEV2REQUEST._serialized_start=120
   _SANDBOXSTDINWRITEV2REQUEST._serialized_end=208
   _SANDBOXSTDINWRITEV2RESPONSE._serialized_start=210
@@ -362,11 +362,11 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _TASKMOUNTDIRECTORYREQUEST._serialized_start=2682
   _TASKMOUNTDIRECTORYREQUEST._serialized_end=2758
   _TASKSNAPSHOTDIRECTORYREQUEST._serialized_start=2760
-  _TASKSNAPSHOTDIRECTORYREQUEST._serialized_end=2842
-  _TASKSNAPSHOTDIRECTORYRESPONSE._serialized_start=2844
-  _TASKSNAPSHOTDIRECTORYRESPONSE._serialized_end=2893
-  _TASKUNMOUNTDIRECTORYREQUEST._serialized_start=2895
-  _TASKUNMOUNTDIRECTORYREQUEST._serialized_end=2955
-  _TASKCOMMANDROUTER._serialized_start=3418
-  _TASKCOMMANDROUTER._serialized_end=5316
+  _TASKSNAPSHOTDIRECTORYREQUEST._serialized_end=2884
+  _TASKSNAPSHOTDIRECTORYRESPONSE._serialized_start=2886
+  _TASKSNAPSHOTDIRECTORYRESPONSE._serialized_end=2935
+  _TASKUNMOUNTDIRECTORYREQUEST._serialized_start=2937
+  _TASKUNMOUNTDIRECTORYREQUEST._serialized_end=2997
+  _TASKCOMMANDROUTER._serialized_start=3460
+  _TASKCOMMANDROUTER._serialized_end=5358
 # @@protoc_insertion_point(module_scope)

modal_proto/task_command_router_pb2.pyi

@@ -691,18 +691,35 @@ class TaskSnapshotDirectoryRequest(google.protobuf.message.Message):
     TASK_ID_FIELD_NUMBER: builtins.int
     PATH_FIELD_NUMBER: builtins.int
     SNAPSHOT_ID_FIELD_NUMBER: builtins.int
+    TTL_SECONDS_FIELD_NUMBER: builtins.int
     task_id: builtins.str
     path: builtins.bytes
     snapshot_id: builtins.str
     """A unique ID to ensure idempotency of directory snapshot requests."""
+    ttl_seconds: builtins.int
+    """Lifetime for the resulting image, in seconds. When set, the
+    image's expires_at is a hard cutoff: it is fixed at creation time
+    and is not extended on use.
+
+    When unset, the resulting image gets the legacy retention policy:
+    a 30-day TTL that is bumped forward by 30 days on every use, so
+    active images effectively never expire.
+
+    Sentinel: -1 means "no expiry" (the image never expires).
+    0 and other negative values are invalid and rejected by the
+    server.
+    """
     def __init__(
         self,
         *,
         task_id: builtins.str = ...,
         path: builtins.bytes = ...,
         snapshot_id: builtins.str = ...,
+        ttl_seconds: builtins.int | None = ...,
     ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["path", b"path", "snapshot_id", b"snapshot_id", "task_id", b"task_id"]) -> None: ...
+    def HasField(self, field_name: typing_extensions.Literal["_ttl_seconds", b"_ttl_seconds", "ttl_seconds", b"ttl_seconds"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing_extensions.Literal["_ttl_seconds", b"_ttl_seconds", "path", b"path", "snapshot_id", b"snapshot_id", "task_id", b"task_id", "ttl_seconds", b"ttl_seconds"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["_ttl_seconds", b"_ttl_seconds"]) -> typing_extensions.Literal["ttl_seconds"] | None: ...
 
 global___TaskSnapshotDirectoryRequest = TaskSnapshotDirectoryRequest
 

modal_version/__init__.py

@@ -1,4 +1,4 @@
 # Copyright Modal Labs 2026
 """Supplies the current version of the modal client library."""
 
-__version__ = "1.4.3.dev11"
+__version__ = "1.4.3.dev13"