modal 1.0.6.dev58__py3-none-any.whl → 1.2.3.dev7__py3-none-any.whl

modal_proto/task_command_router_pb2.py

@@ -0,0 +1,149 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: modal_proto/task_command_router.proto
+"""Generated protocol buffer code."""
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+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\x15modal_proto/api.proto\"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\"\x92\x03\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\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*\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\xf0\x04\n\x11TaskCommandRouter\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.TaskExecWaitResponseB&Z$github.com/modal-labs/modal/go/protob\x06proto3')
+
+_TASKEXECSTDERRCONFIG = DESCRIPTOR.enum_types_by_name['TaskExecStderrConfig']
+TaskExecStderrConfig = enum_type_wrapper.EnumTypeWrapper(_TASKEXECSTDERRCONFIG)
+_TASKEXECSTDIOFILEDESCRIPTOR = DESCRIPTOR.enum_types_by_name['TaskExecStdioFileDescriptor']
+TaskExecStdioFileDescriptor = enum_type_wrapper.EnumTypeWrapper(_TASKEXECSTDIOFILEDESCRIPTOR)
+_TASKEXECSTDOUTCONFIG = DESCRIPTOR.enum_types_by_name['TaskExecStdoutConfig']
+TaskExecStdoutConfig = enum_type_wrapper.EnumTypeWrapper(_TASKEXECSTDOUTCONFIG)
+TASK_EXEC_STDERR_CONFIG_DEVNULL = 0
+TASK_EXEC_STDERR_CONFIG_PIPE = 1
+TASK_EXEC_STDERR_CONFIG_STDOUT = 2
+TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDOUT = 0
+TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDERR = 1
+TASK_EXEC_STDOUT_CONFIG_DEVNULL = 0
+TASK_EXEC_STDOUT_CONFIG_PIPE = 1
+
+
+_TASKEXECPOLLREQUEST = DESCRIPTOR.message_types_by_name['TaskExecPollRequest']
+_TASKEXECPOLLRESPONSE = DESCRIPTOR.message_types_by_name['TaskExecPollResponse']
+_TASKEXECSTARTREQUEST = DESCRIPTOR.message_types_by_name['TaskExecStartRequest']
+_TASKEXECSTARTRESPONSE = DESCRIPTOR.message_types_by_name['TaskExecStartResponse']
+_TASKEXECSTDINWRITEREQUEST = DESCRIPTOR.message_types_by_name['TaskExecStdinWriteRequest']
+_TASKEXECSTDINWRITERESPONSE = DESCRIPTOR.message_types_by_name['TaskExecStdinWriteResponse']
+_TASKEXECSTDIOREADREQUEST = DESCRIPTOR.message_types_by_name['TaskExecStdioReadRequest']
+_TASKEXECSTDIOREADRESPONSE = DESCRIPTOR.message_types_by_name['TaskExecStdioReadResponse']
+_TASKEXECWAITREQUEST = DESCRIPTOR.message_types_by_name['TaskExecWaitRequest']
+_TASKEXECWAITRESPONSE = DESCRIPTOR.message_types_by_name['TaskExecWaitResponse']
+TaskExecPollRequest = _reflection.GeneratedProtocolMessageType('TaskExecPollRequest', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECPOLLREQUEST,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecPollRequest)
+  })
+_sym_db.RegisterMessage(TaskExecPollRequest)
+
+TaskExecPollResponse = _reflection.GeneratedProtocolMessageType('TaskExecPollResponse', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECPOLLRESPONSE,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecPollResponse)
+  })
+_sym_db.RegisterMessage(TaskExecPollResponse)
+
+TaskExecStartRequest = _reflection.GeneratedProtocolMessageType('TaskExecStartRequest', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECSTARTREQUEST,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecStartRequest)
+  })
+_sym_db.RegisterMessage(TaskExecStartRequest)
+
+TaskExecStartResponse = _reflection.GeneratedProtocolMessageType('TaskExecStartResponse', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECSTARTRESPONSE,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecStartResponse)
+  })
+_sym_db.RegisterMessage(TaskExecStartResponse)
+
+TaskExecStdinWriteRequest = _reflection.GeneratedProtocolMessageType('TaskExecStdinWriteRequest', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECSTDINWRITEREQUEST,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecStdinWriteRequest)
+  })
+_sym_db.RegisterMessage(TaskExecStdinWriteRequest)
+
+TaskExecStdinWriteResponse = _reflection.GeneratedProtocolMessageType('TaskExecStdinWriteResponse', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECSTDINWRITERESPONSE,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecStdinWriteResponse)
+  })
+_sym_db.RegisterMessage(TaskExecStdinWriteResponse)
+
+TaskExecStdioReadRequest = _reflection.GeneratedProtocolMessageType('TaskExecStdioReadRequest', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECSTDIOREADREQUEST,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecStdioReadRequest)
+  })
+_sym_db.RegisterMessage(TaskExecStdioReadRequest)
+
+TaskExecStdioReadResponse = _reflection.GeneratedProtocolMessageType('TaskExecStdioReadResponse', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECSTDIOREADRESPONSE,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecStdioReadResponse)
+  })
+_sym_db.RegisterMessage(TaskExecStdioReadResponse)
+
+TaskExecWaitRequest = _reflection.GeneratedProtocolMessageType('TaskExecWaitRequest', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECWAITREQUEST,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecWaitRequest)
+  })
+_sym_db.RegisterMessage(TaskExecWaitRequest)
+
+TaskExecWaitResponse = _reflection.GeneratedProtocolMessageType('TaskExecWaitResponse', (_message.Message,), {
+  'DESCRIPTOR' : _TASKEXECWAITRESPONSE,
+  '__module__' : 'modal_proto.task_command_router_pb2'
+  # @@protoc_insertion_point(class_scope:modal.task_command_router.TaskExecWaitResponse)
+  })
+_sym_db.RegisterMessage(TaskExecWaitResponse)
+
+_TASKCOMMANDROUTER = DESCRIPTOR.services_by_name['TaskCommandRouter']
+if _descriptor._USE_C_DESCRIPTORS == False:
+
+  DESCRIPTOR._options = None
+  DESCRIPTOR._serialized_options = b'Z$github.com/modal-labs/modal/go/proto'
+  _TASKEXECSTDERRCONFIG._serialized_start=1121
+  _TASKEXECSTDERRCONFIG._serialized_end=1250
+  _TASKEXECSTDIOFILEDESCRIPTOR._serialized_start=1252
+  _TASKEXECSTDIOFILEDESCRIPTOR._serialized_end=1369
+  _TASKEXECSTDOUTCONFIG._serialized_start=1371
+  _TASKEXECSTDOUTCONFIG._serialized_end=1464
+  _TASKEXECPOLLREQUEST._serialized_start=91
+  _TASKEXECPOLLREQUEST._serialized_end=146
+  _TASKEXECPOLLRESPONSE._serialized_start=148
+  _TASKEXECPOLLRESPONSE._serialized_end=219
+  _TASKEXECSTARTREQUEST._serialized_start=222
+  _TASKEXECSTARTREQUEST._serialized_end=624
+  _TASKEXECSTARTRESPONSE._serialized_start=626
+  _TASKEXECSTARTRESPONSE._serialized_end=649
+  _TASKEXECSTDINWRITEREQUEST._serialized_start=651
+  _TASKEXECSTDINWRITEREQUEST._serialized_end=755
+  _TASKEXECSTDINWRITERESPONSE._serialized_start=757
+  _TASKEXECSTDINWRITERESPONSE._serialized_end=785
+  _TASKEXECSTDIOREADREQUEST._serialized_start=788
+  _TASKEXECSTDIOREADREQUEST._serialized_end=945
+  _TASKEXECSTDIOREADRESPONSE._serialized_start=947
+  _TASKEXECSTDIOREADRESPONSE._serialized_end=988
+  _TASKEXECWAITREQUEST._serialized_start=990
+  _TASKEXECWAITREQUEST._serialized_end=1045
+  _TASKEXECWAITRESPONSE._serialized_start=1047
+  _TASKEXECWAITRESPONSE._serialized_end=1118
+  _TASKCOMMANDROUTER._serialized_start=1467
+  _TASKCOMMANDROUTER._serialized_end=2091
+# @@protoc_insertion_point(module_scope)

modal_proto/task_command_router_pb2.pyi

@@ -0,0 +1,333 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+import builtins
+import collections.abc
+import google.protobuf.descriptor
+import google.protobuf.internal.containers
+import google.protobuf.internal.enum_type_wrapper
+import google.protobuf.message
+import modal_proto.api_pb2
+import sys
+import typing
+
+if sys.version_info >= (3, 10):
+    import typing as typing_extensions
+else:
+    import typing_extensions
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+class _TaskExecStderrConfig:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _TaskExecStderrConfigEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_TaskExecStderrConfig.ValueType], builtins.type):  # noqa: F821
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    TASK_EXEC_STDERR_CONFIG_DEVNULL: _TaskExecStderrConfig.ValueType  # 0
+    """The output will be discarded."""
+    TASK_EXEC_STDERR_CONFIG_PIPE: _TaskExecStderrConfig.ValueType  # 1
+    """The output will be streamed to the client."""
+    TASK_EXEC_STDERR_CONFIG_STDOUT: _TaskExecStderrConfig.ValueType  # 2
+    """A special value that can be used to indicate that the stderr stream should
+    be merged with the stdout stream.
+    """
+
+class TaskExecStderrConfig(_TaskExecStderrConfig, metaclass=_TaskExecStderrConfigEnumTypeWrapper): ...
+
+TASK_EXEC_STDERR_CONFIG_DEVNULL: TaskExecStderrConfig.ValueType  # 0
+"""The output will be discarded."""
+TASK_EXEC_STDERR_CONFIG_PIPE: TaskExecStderrConfig.ValueType  # 1
+"""The output will be streamed to the client."""
+TASK_EXEC_STDERR_CONFIG_STDOUT: TaskExecStderrConfig.ValueType  # 2
+"""A special value that can be used to indicate that the stderr stream should
+be merged with the stdout stream.
+"""
+global___TaskExecStderrConfig = TaskExecStderrConfig
+
+class _TaskExecStdioFileDescriptor:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _TaskExecStdioFileDescriptorEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_TaskExecStdioFileDescriptor.ValueType], builtins.type):  # noqa: F821
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDOUT: _TaskExecStdioFileDescriptor.ValueType  # 0
+    """Read from stdout."""
+    TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDERR: _TaskExecStdioFileDescriptor.ValueType  # 1
+    """Read from stderr."""
+
+class TaskExecStdioFileDescriptor(_TaskExecStdioFileDescriptor, metaclass=_TaskExecStdioFileDescriptorEnumTypeWrapper): ...
+
+TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDOUT: TaskExecStdioFileDescriptor.ValueType  # 0
+"""Read from stdout."""
+TASK_EXEC_STDIO_FILE_DESCRIPTOR_STDERR: TaskExecStdioFileDescriptor.ValueType  # 1
+"""Read from stderr."""
+global___TaskExecStdioFileDescriptor = TaskExecStdioFileDescriptor
+
+class _TaskExecStdoutConfig:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _TaskExecStdoutConfigEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_TaskExecStdoutConfig.ValueType], builtins.type):  # noqa: F821
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    TASK_EXEC_STDOUT_CONFIG_DEVNULL: _TaskExecStdoutConfig.ValueType  # 0
+    """The output will be discarded."""
+    TASK_EXEC_STDOUT_CONFIG_PIPE: _TaskExecStdoutConfig.ValueType  # 1
+    """The output will be streamed to the client."""
+
+class TaskExecStdoutConfig(_TaskExecStdoutConfig, metaclass=_TaskExecStdoutConfigEnumTypeWrapper): ...
+
+TASK_EXEC_STDOUT_CONFIG_DEVNULL: TaskExecStdoutConfig.ValueType  # 0
+"""The output will be discarded."""
+TASK_EXEC_STDOUT_CONFIG_PIPE: TaskExecStdoutConfig.ValueType  # 1
+"""The output will be streamed to the client."""
+global___TaskExecStdoutConfig = TaskExecStdoutConfig
+
+class TaskExecPollRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    TASK_ID_FIELD_NUMBER: builtins.int
+    EXEC_ID_FIELD_NUMBER: builtins.int
+    task_id: builtins.str
+    """The ID of the task running the exec'd command."""
+    exec_id: builtins.str
+    """The execution ID of the command to wait on."""
+    def __init__(
+        self,
+        *,
+        task_id: builtins.str = ...,
+        exec_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["exec_id", b"exec_id", "task_id", b"task_id"]) -> None: ...
+
+global___TaskExecPollRequest = TaskExecPollRequest
+
+class TaskExecPollResponse(google.protobuf.message.Message):
+    """The response to a TaskExecPollRequest. If the exec'd command has not
+    completed, exit_status will be unset.
+    """
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    CODE_FIELD_NUMBER: builtins.int
+    SIGNAL_FIELD_NUMBER: builtins.int
+    code: builtins.int
+    """The exit code of the command."""
+    signal: builtins.int
+    """The signal that terminated the command."""
+    def __init__(
+        self,
+        *,
+        code: builtins.int = ...,
+        signal: builtins.int = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing_extensions.Literal["code", b"code", "exit_status", b"exit_status", "signal", b"signal"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing_extensions.Literal["code", b"code", "exit_status", b"exit_status", "signal", b"signal"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["exit_status", b"exit_status"]) -> typing_extensions.Literal["code", "signal"] | None: ...
+
+global___TaskExecPollResponse = TaskExecPollResponse
+
+class TaskExecStartRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    TASK_ID_FIELD_NUMBER: builtins.int
+    EXEC_ID_FIELD_NUMBER: builtins.int
+    COMMAND_ARGS_FIELD_NUMBER: builtins.int
+    STDOUT_CONFIG_FIELD_NUMBER: builtins.int
+    STDERR_CONFIG_FIELD_NUMBER: builtins.int
+    TIMEOUT_SECS_FIELD_NUMBER: builtins.int
+    WORKDIR_FIELD_NUMBER: builtins.int
+    SECRET_IDS_FIELD_NUMBER: builtins.int
+    PTY_INFO_FIELD_NUMBER: builtins.int
+    RUNTIME_DEBUG_FIELD_NUMBER: builtins.int
+    task_id: builtins.str
+    """The ID of the task to execute the command in."""
+    exec_id: builtins.str
+    """Execution ID. This ID will be used to identify the execution for other
+    requests and ensure exec commands are idempotent.
+    """
+    @property
+    def command_args(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """Command arguments to execute."""
+    stdout_config: global___TaskExecStdoutConfig.ValueType
+    """Configures how the stdout of the command will be handled."""
+    stderr_config: global___TaskExecStderrConfig.ValueType
+    """Configures how the stderr of the command will be handled."""
+    timeout_secs: builtins.int
+    """Timeout in seconds for the exec'd command to exit. If the command does not
+    exit within this duration, the command will be killed. This is NOT the
+    timeout for the ExecStartRequest RPC to complete.
+    """
+    workdir: builtins.str
+    """Working directory for the command."""
+    @property
+    def secret_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """Secret IDs to mount into the task."""
+    @property
+    def pty_info(self) -> modal_proto.api_pb2.PTYInfo:
+        """PTY info for the command."""
+    runtime_debug: builtins.bool
+    """Enable debugging capabilities on the container runtime. Used only for
+    internal debugging.
+    """
+    def __init__(
+        self,
+        *,
+        task_id: builtins.str = ...,
+        exec_id: builtins.str = ...,
+        command_args: collections.abc.Iterable[builtins.str] | None = ...,
+        stdout_config: global___TaskExecStdoutConfig.ValueType = ...,
+        stderr_config: global___TaskExecStderrConfig.ValueType = ...,
+        timeout_secs: builtins.int | None = ...,
+        workdir: builtins.str | None = ...,
+        secret_ids: collections.abc.Iterable[builtins.str] | None = ...,
+        pty_info: modal_proto.api_pb2.PTYInfo | None = ...,
+        runtime_debug: builtins.bool = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing_extensions.Literal["_pty_info", b"_pty_info", "_timeout_secs", b"_timeout_secs", "_workdir", b"_workdir", "pty_info", b"pty_info", "timeout_secs", b"timeout_secs", "workdir", b"workdir"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing_extensions.Literal["_pty_info", b"_pty_info", "_timeout_secs", b"_timeout_secs", "_workdir", b"_workdir", "command_args", b"command_args", "exec_id", b"exec_id", "pty_info", b"pty_info", "runtime_debug", b"runtime_debug", "secret_ids", b"secret_ids", "stderr_config", b"stderr_config", "stdout_config", b"stdout_config", "task_id", b"task_id", "timeout_secs", b"timeout_secs", "workdir", b"workdir"]) -> None: ...
+    @typing.overload
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["_pty_info", b"_pty_info"]) -> typing_extensions.Literal["pty_info"] | None: ...
+    @typing.overload
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["_timeout_secs", b"_timeout_secs"]) -> typing_extensions.Literal["timeout_secs"] | None: ...
+    @typing.overload
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["_workdir", b"_workdir"]) -> typing_extensions.Literal["workdir"] | None: ...
+
+global___TaskExecStartRequest = TaskExecStartRequest
+
+class TaskExecStartResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+
+global___TaskExecStartResponse = TaskExecStartResponse
+
+class TaskExecStdinWriteRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    TASK_ID_FIELD_NUMBER: builtins.int
+    EXEC_ID_FIELD_NUMBER: builtins.int
+    OFFSET_FIELD_NUMBER: builtins.int
+    DATA_FIELD_NUMBER: builtins.int
+    EOF_FIELD_NUMBER: builtins.int
+    task_id: builtins.str
+    """The ID of the task running the exec'd command."""
+    exec_id: builtins.str
+    """The execution ID of the command to write to."""
+    offset: builtins.int
+    """The offset to start writing to. This is used to resume writing from the
+    last write position if the connection is closed and reopened.
+    """
+    data: builtins.bytes
+    eof: builtins.bool
+    """If true, close the stdin stream after writing any provided data.
+    This signals EOF to the exec'd process.
+    """
+    def __init__(
+        self,
+        *,
+        task_id: builtins.str = ...,
+        exec_id: builtins.str = ...,
+        offset: builtins.int = ...,
+        data: builtins.bytes = ...,
+        eof: builtins.bool = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["data", b"data", "eof", b"eof", "exec_id", b"exec_id", "offset", b"offset", "task_id", b"task_id"]) -> None: ...
+
+global___TaskExecStdinWriteRequest = TaskExecStdinWriteRequest
+
+class TaskExecStdinWriteResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    def __init__(
+        self,
+    ) -> None: ...
+
+global___TaskExecStdinWriteResponse = TaskExecStdinWriteResponse
+
+class TaskExecStdioReadRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    TASK_ID_FIELD_NUMBER: builtins.int
+    EXEC_ID_FIELD_NUMBER: builtins.int
+    OFFSET_FIELD_NUMBER: builtins.int
+    FILE_DESCRIPTOR_FIELD_NUMBER: builtins.int
+    task_id: builtins.str
+    """The ID of the task running the exec'd command."""
+    exec_id: builtins.str
+    """The execution ID of the command to read from."""
+    offset: builtins.int
+    """The offset to start reading from. This is used to resume reading from the
+    last read position if the connection is closed and reopened.
+    """
+    file_descriptor: global___TaskExecStdioFileDescriptor.ValueType
+    """Which file descriptor to read from."""
+    def __init__(
+        self,
+        *,
+        task_id: builtins.str = ...,
+        exec_id: builtins.str = ...,
+        offset: builtins.int = ...,
+        file_descriptor: global___TaskExecStdioFileDescriptor.ValueType = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["exec_id", b"exec_id", "file_descriptor", b"file_descriptor", "offset", b"offset", "task_id", b"task_id"]) -> None: ...
+
+global___TaskExecStdioReadRequest = TaskExecStdioReadRequest
+
+class TaskExecStdioReadResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    DATA_FIELD_NUMBER: builtins.int
+    data: builtins.bytes
+    """The data read from the file descriptor."""
+    def __init__(
+        self,
+        *,
+        data: builtins.bytes = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["data", b"data"]) -> None: ...
+
+global___TaskExecStdioReadResponse = TaskExecStdioReadResponse
+
+class TaskExecWaitRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    TASK_ID_FIELD_NUMBER: builtins.int
+    EXEC_ID_FIELD_NUMBER: builtins.int
+    task_id: builtins.str
+    """The ID of the task running the exec'd command."""
+    exec_id: builtins.str
+    """The execution ID of the command to wait on."""
+    def __init__(
+        self,
+        *,
+        task_id: builtins.str = ...,
+        exec_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["exec_id", b"exec_id", "task_id", b"task_id"]) -> None: ...
+
+global___TaskExecWaitRequest = TaskExecWaitRequest
+
+class TaskExecWaitResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    CODE_FIELD_NUMBER: builtins.int
+    SIGNAL_FIELD_NUMBER: builtins.int
+    code: builtins.int
+    """The exit code of the command."""
+    signal: builtins.int
+    """The signal that terminated the command."""
+    def __init__(
+        self,
+        *,
+        code: builtins.int = ...,
+        signal: builtins.int = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing_extensions.Literal["code", b"code", "exit_status", b"exit_status", "signal", b"signal"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing_extensions.Literal["code", b"code", "exit_status", b"exit_status", "signal", b"signal"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["exit_status", b"exit_status"]) -> typing_extensions.Literal["code", "signal"] | None: ...
+
+global___TaskExecWaitResponse = TaskExecWaitResponse