Open-source, secure environment with real-world tools for enterprise-grade agents.
Python agentaiai-agentai-agentscode-interpretercopilotdevelopmentdevtoolsgptgpt-4javascriptllmnextjsopenaipythonreactsoftwaretypescript
# Generated from filesystem/filesystem.proto. DO NOT EDIT.
# Generated by protoc-gen-py v0.6.0 with parameter "".
# ruff: noqa: PGH004
# ruff: noqa
# fmt: off
from __future__ import annotations
from typing import Literal, NoReturn, TYPE_CHECKING, TypeAlias
from protobuf import Enum, Message
from protobuf._codegen import file_desc
from protobuf.wkt.google.protobuf import timestamp_pb
if TYPE_CHECKING:
from protobuf import DescFile, Oneof
from protobuf.wkt.google.protobuf.timestamp_pb import Timestamp
_MoveRequestFields: TypeAlias = Literal["source", "destination"]
class MoveRequest(Message[_MoveRequestFields]):
"""
```proto
message filesystem.MoveRequest
```
Attributes:
source:
```proto
string source = 1;
```
destination:
```proto
string destination = 2;
```
"""
__slots__ = ("source", "destination")
if TYPE_CHECKING:
def __init__(
self,
*,
source: str = "",
destination: str = "",
) -> None:
pass
source: str
destination: str
_MoveResponseFields: TypeAlias = Literal["entry"]
class MoveResponse(Message[_MoveResponseFields]):
"""
```proto
message filesystem.MoveResponse
```
Attributes:
entry:
```proto
optional filesystem.EntryInfo entry = 1;
```
"""
__slots__ = ("entry",)
if TYPE_CHECKING:
def __init__(
self,
*,
entry: EntryInfo | None = None,
) -> None:
pass
entry: EntryInfo | None
_MakeDirRequestFields: TypeAlias = Literal["path"]
class MakeDirRequest(Message[_MakeDirRequestFields]):
"""
```proto
message filesystem.MakeDirRequest
```
Attributes:
path:
```proto
string path = 1;
```
"""
__slots__ = ("path",)
if TYPE_CHECKING:
def __init__(
self,
*,
path: str = "",
) -> None:
pass
path: str
_MakeDirResponseFields: TypeAlias = Literal["entry"]
class MakeDirResponse(Message[_MakeDirResponseFields]):
"""
```proto
message filesystem.MakeDirResponse
```
Attributes:
entry:
```proto
optional filesystem.EntryInfo entry = 1;
```
"""
__slots__ = ("entry",)
if TYPE_CHECKING:
def __init__(
self,
*,
entry: EntryInfo | None = None,
) -> None:
pass
entry: EntryInfo | None
_RemoveRequestFields: TypeAlias = Literal["path"]
class RemoveRequest(Message[_RemoveRequestFields]):
"""
```proto
message filesystem.RemoveRequest
```
Attributes:
path:
```proto
string path = 1;
```
"""
__slots__ = ("path",)
if TYPE_CHECKING:
def __init__(
self,
*,
path: str = "",
) -> None:
pass
path: str
_RemoveResponseFields: TypeAlias = NoReturn
class RemoveResponse(Message[_RemoveResponseFields]):
"""
```proto
message filesystem.RemoveResponse
```
"""
__slots__ = ()
if TYPE_CHECKING:
def __init__(
self,
) -> None:
pass
_StatRequestFields: TypeAlias = Literal["path"]
class StatRequest(Message[_StatRequestFields]):
"""
```proto
message filesystem.StatRequest
```
Attributes:
path:
```proto
string path = 1;
```
"""
__slots__ = ("path",)
if TYPE_CHECKING:
def __init__(
self,
*,
path: str = "",
) -> None:
pass
path: str
_StatResponseFields: TypeAlias = Literal["entry"]
class StatResponse(Message[_StatResponseFields]):
"""
```proto
message filesystem.StatResponse
```
Attributes:
entry:
```proto
optional filesystem.EntryInfo entry = 1;
```
"""
__slots__ = ("entry",)
if TYPE_CHECKING:
def __init__(
self,
*,
entry: EntryInfo | None = None,
) -> None:
pass
entry: EntryInfo | None
_EntryInfoFields: TypeAlias = Literal["name", "type", "path", "size", "mode", "permissions", "owner", "group", "modified_time", "symlink_target", "metadata", "is_symlink"]
class EntryInfo(Message[_EntryInfoFields]):
"""
```proto
message filesystem.EntryInfo
```
Attributes:
name:
```proto
string name = 1;
```
type:
```proto
filesystem.FileType type = 2;
```
path:
```proto
string path = 3;
```
size:
```proto
int64 size = 4;
```
mode:
```proto
uint32 mode = 5;
```
permissions:
```proto
string permissions = 6;
```
owner:
```proto
string owner = 7;
```
group:
```proto
string group = 8;
```
modified_time:
```proto
optional google.protobuf.Timestamp modified_time = 9;
```
symlink_target:
If the entry is a symlink, this field contains the target of the symlink.
```proto
optional string symlink_target = 10;
```
metadata:
User-defined metadata stored as extended attributes (xattrs) on the file.
Keys live under the `user.e2b.` xattr namespace; the prefix is stripped here.
Plain `user.*` xattrs written by other tooling are not reflected.
```proto
map<string, string> metadata = 11;
```
is_symlink:
True when the entry itself is a symlink; type then describes the symlink's target.
```proto
bool is_symlink = 12;
```
"""
__slots__ = ("name", "type", "path", "size", "mode", "permissions", "owner", "group", "modified_time", "symlink_target", "metadata", "is_symlink")
if TYPE_CHECKING:
def __init__(
self,
*,
name: str = "",
type: FileType | None = None,
path: str = "",
size: int = 0,
mode: int = 0,
permissions: str = "",
owner: str = "",
group: str = "",
modified_time: Timestamp | None = None,
symlink_target: str | None = None,
metadata: dict[str, str] | None = None,
is_symlink: bool = False,
) -> None:
pass
name: str
type: FileType
path: str
size: int
mode: int
permissions: str
owner: str
group: str
modified_time: Timestamp | None
symlink_target: str
metadata: dict[str, str]
is_symlink: bool
_ListDirRequestFields: TypeAlias = Literal["path", "depth"]
class ListDirRequest(Message[_ListDirRequestFields]):
"""
```proto
message filesystem.ListDirRequest
```
Attributes:
path:
```proto
string path = 1;
```
depth:
```proto
uint32 depth = 2;
```
"""
__slots__ = ("path", "depth")
if TYPE_CHECKING:
def __init__(
self,
*,
path: str = "",
depth: int = 0,
) -> None:
pass
path: str
depth: int
_ListDirResponseFields: TypeAlias = Literal["entries"]
class ListDirResponse(Message[_ListDirResponseFields]):
"""
```proto
message filesystem.ListDirResponse
```
Attributes:
entries:
```proto
repeated filesystem.EntryInfo entries = 1;
```
"""
__slots__ = ("entries",)
if TYPE_CHECKING:
def __init__(
self,
*,
entries: list[EntryInfo] | None = None,
) -> None:
pass
entries: list[EntryInfo]
_WatchDirRequestFields: TypeAlias = Literal["path", "recursive", "include_entry", "allow_network_mounts"]
class WatchDirRequest(Message[_WatchDirRequestFields]):
"""
```proto
message filesystem.WatchDirRequest
```
Attributes:
path:
```proto
string path = 1;
```
recursive:
```proto
bool recursive = 2;
```
include_entry:
If true, each FilesystemEvent includes the EntryInfo of the affected entry, when available.
```proto
bool include_entry = 3;
```
allow_network_mounts:
If true, allows watching paths on network filesystem mounts (NFS, CIFS, SMB, FUSE).
Events on network mounts may be unreliable or not delivered at all.
```proto
bool allow_network_mounts = 4;
```
"""
__slots__ = ("path", "recursive", "include_entry", "allow_network_mounts")
if TYPE_CHECKING:
def __init__(
self,
*,
path: str = "",
recursive: bool = False,
include_entry: bool = False,
allow_network_mounts: bool = False,
) -> None:
pass
path: str
recursive: bool
include_entry: bool
allow_network_mounts: bool
_FilesystemEventFields: TypeAlias = Literal["name", "type", "entry"]
class FilesystemEvent(Message[_FilesystemEventFields]):
"""
```proto
message filesystem.FilesystemEvent
```
Attributes:
name:
```proto
string name = 1;
```
type:
```proto
filesystem.EventType type = 2;
```
entry:
Info of the entry that triggered the event. Only populated when include_entry
was requested and the entry could be stat-ed (e.g. not set for remove/rename-away
events, where the entry no longer exists at this path).
```proto
optional filesystem.EntryInfo entry = 3;
```
"""
__slots__ = ("name", "type", "entry")
if TYPE_CHECKING:
def __init__(
self,
*,
name: str = "",
type: EventType | None = None,
entry: EntryInfo | None = None,
) -> None:
pass
name: str
type: EventType
entry: EntryInfo | None
_WatchDirResponseFields: TypeAlias = Literal["start", "filesystem", "keepalive"]
class WatchDirResponse(Message[_WatchDirResponseFields]):
"""
```proto
message filesystem.WatchDirResponse
```
Attributes:
event:
```proto
oneof event
```
"""
__slots__ = ("event",)
if TYPE_CHECKING:
def __init__(
self,
*,
event: Oneof[Literal["start"], WatchDirResponse.StartEvent] | Oneof[Literal["filesystem"], FilesystemEvent] | Oneof[Literal["keepalive"], WatchDirResponse.KeepAlive] | None = None,
) -> None:
pass
event: Oneof[Literal["start"], WatchDirResponse.StartEvent] | Oneof[Literal["filesystem"], FilesystemEvent] | Oneof[Literal["keepalive"], WatchDirResponse.KeepAlive] | None
_StartEventFields: TypeAlias = NoReturn
class StartEvent(Message[_StartEventFields]):
"""
```proto
message filesystem.WatchDirResponse.StartEvent
```
"""
__slots__ = ()
if TYPE_CHECKING:
def __init__(
self,
) -> None:
pass
_KeepAliveFields: TypeAlias = NoReturn
class KeepAlive(Message[_KeepAliveFields]):
"""
```proto
message filesystem.WatchDirResponse.KeepAlive
```
"""
__slots__ = ()
if TYPE_CHECKING:
def __init__(
self,
) -> None:
pass
_CreateWatcherRequestFields: TypeAlias = Literal["path", "recursive", "include_entry", "allow_network_mounts"]
class CreateWatcherRequest(Message[_CreateWatcherRequestFields]):
"""
```proto
message filesystem.CreateWatcherRequest
```
Attributes:
path:
```proto
string path = 1;
```
recursive:
```proto
bool recursive = 2;
```
include_entry:
If true, each FilesystemEvent includes the EntryInfo of the affected entry, when available.
```proto
bool include_entry = 3;
```
allow_network_mounts:
If true, allows watching paths on network filesystem mounts (NFS, CIFS, SMB, FUSE).
Events on network mounts may be unreliable or not delivered at all.
```proto
bool allow_network_mounts = 4;
```
"""
__slots__ = ("path", "recursive", "include_entry", "allow_network_mounts")
if TYPE_CHECKING:
def __init__(
self,
*,
path: str = "",
recursive: bool = False,
include_entry: bool = False,
allow_network_mounts: bool = False,
) -> None:
pass
path: str
recursive: bool
include_entry: bool
allow_network_mounts: bool
_CreateWatcherResponseFields: TypeAlias = Literal["watcher_id"]
class CreateWatcherResponse(Message[_CreateWatcherResponseFields]):
"""
```proto
message filesystem.CreateWatcherResponse
```
Attributes:
watcher_id:
```proto
string watcher_id = 1;
```
"""
__slots__ = ("watcher_id",)
if TYPE_CHECKING:
def __init__(
self,
*,
watcher_id: str = "",
) -> None:
pass
watcher_id: str
_GetWatcherEventsRequestFields: TypeAlias = Literal["watcher_id"]
class GetWatcherEventsRequest(Message[_GetWatcherEventsRequestFields]):
"""
```proto
message filesystem.GetWatcherEventsRequest
```
Attributes:
watcher_id:
```proto
string watcher_id = 1;
```
"""
__slots__ = ("watcher_id",)
if TYPE_CHECKING:
def __init__(
self,
*,
watcher_id: str = "",
) -> None:
pass
watcher_id: str
_GetWatcherEventsResponseFields: TypeAlias = Literal["events"]
class GetWatcherEventsResponse(Message[_GetWatcherEventsResponseFields]):
"""
```proto
message filesystem.GetWatcherEventsResponse
```
Attributes:
events:
```proto
repeated filesystem.FilesystemEvent events = 1;
```
"""
__slots__ = ("events",)
if TYPE_CHECKING:
def __init__(
self,
*,
events: list[FilesystemEvent] | None = None,
) -> None:
pass
events: list[FilesystemEvent]
_RemoveWatcherRequestFields: TypeAlias = Literal["watcher_id"]
class RemoveWatcherRequest(Message[_RemoveWatcherRequestFields]):
"""
```proto
message filesystem.RemoveWatcherRequest
```
Attributes:
watcher_id:
```proto
string watcher_id = 1;
```
"""
__slots__ = ("watcher_id",)
if TYPE_CHECKING:
def __init__(
self,
*,
watcher_id: str = "",
) -> None:
pass
watcher_id: str
_RemoveWatcherResponseFields: TypeAlias = NoReturn
class RemoveWatcherResponse(Message[_RemoveWatcherResponseFields]):
"""
```proto
message filesystem.RemoveWatcherResponse
```
"""
__slots__ = ()
if TYPE_CHECKING:
def __init__(
self,
) -> None:
pass
class FileType(Enum):
"""
```proto
enum filesystem.FileType
```
Attributes:
UNSPECIFIED:
```proto
FILE_TYPE_UNSPECIFIED = 0
```
FILE:
```proto
FILE_TYPE_FILE = 1
```
DIRECTORY:
```proto
FILE_TYPE_DIRECTORY = 2
```
SYMLINK:
```proto
FILE_TYPE_SYMLINK = 3
```
"""
UNSPECIFIED = 0
FILE = 1
DIRECTORY = 2
SYMLINK = 3
class EventType(Enum):
"""
```proto
enum filesystem.EventType
```
Attributes:
UNSPECIFIED:
```proto
EVENT_TYPE_UNSPECIFIED = 0
```
CREATE:
```proto
EVENT_TYPE_CREATE = 1
```
WRITE:
```proto
EVENT_TYPE_WRITE = 2
```
REMOVE:
```proto
EVENT_TYPE_REMOVE = 3
```
RENAME:
```proto
EVENT_TYPE_RENAME = 4
```
CHMOD:
```proto
EVENT_TYPE_CHMOD = 5
```
"""
UNSPECIFIED = 0
CREATE = 1
WRITE = 2
REMOVE = 3
RENAME = 4
CHMOD = 5
_DESC = file_desc(
b'\n\x1bfilesystem/filesystem.proto\x12\nfilesystem\x1a\x1fgoogle/protobuf/timestamp.proto"G\n\x0bMoveRequest\x12\x16\n\x06source\x18\x01 \x01(\tR\x06source\x12 \n\x0bdestination\x18\x02 \x01(\tR\x0bdestination";\n\x0cMoveResponse\x12+\n\x05entry\x18\x01 \x01(\x0b2\x15.filesystem.EntryInfoR\x05entry"$\n\x0eMakeDirRequest\x12\x12\n\x04path\x18\x01 \x01(\tR\x04path">\n\x0fMakeDirResponse\x12+\n\x05entry\x18\x01 \x01(\x0b2\x15.filesystem.EntryInfoR\x05entry"#\n\rRemoveRequest\x12\x12\n\x04path\x18\x01 \x01(\tR\x04path"\x10\n\x0eRemoveResponse"!\n\x0bStatRequest\x12\x12\n\x04path\x18\x01 \x01(\tR\x04path";\n\x0cStatResponse\x12+\n\x05entry\x18\x01 \x01(\x0b2\x15.filesystem.EntryInfoR\x05entry"\xf0\x03\n\tEntryInfo\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12(\n\x04type\x18\x02 \x01(\x0e2\x14.filesystem.FileTypeR\x04type\x12\x12\n\x04path\x18\x03 \x01(\tR\x04path\x12\x12\n\x04size\x18\x04 \x01(\x03R\x04size\x12\x12\n\x04mode\x18\x05 \x01(\rR\x04mode\x12 \n\x0bpermissions\x18\x06 \x01(\tR\x0bpermissions\x12\x14\n\x05owner\x18\x07 \x01(\tR\x05owner\x12\x14\n\x05group\x18\x08 \x01(\tR\x05group\x12?\n\rmodified_time\x18\t \x01(\x0b2\x1a.google.protobuf.TimestampR\x0cmodifiedTime\x12*\n\x0esymlink_target\x18\n \x01(\tH\x00R\rsymlinkTarget\x88\x01\x01\x12?\n\x08metadata\x18\x0b \x03(\x0b2#.filesystem.EntryInfo.MetadataEntryR\x08metadata\x12\x1d\n\nis_symlink\x18\x0c \x01(\x08R\tisSymlink\x1a;\n\rMetadataEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n\x05value\x18\x02 \x01(\tR\x05value:\x028\x01B\x11\n\x0f_symlink_target":\n\x0eListDirRequest\x12\x12\n\x04path\x18\x01 \x01(\tR\x04path\x12\x14\n\x05depth\x18\x02 \x01(\rR\x05depth"B\n\x0fListDirResponse\x12/\n\x07entries\x18\x01 \x03(\x0b2\x15.filesystem.EntryInfoR\x07entries"\x9a\x01\n\x0fWatchDirRequest\x12\x12\n\x04path\x18\x01 \x01(\tR\x04path\x12\x1c\n\trecursive\x18\x02 \x01(\x08R\trecursive\x12#\n\rinclude_entry\x18\x03 \x01(\x08R\x0cincludeEntry\x120\n\x14allow_network_mounts\x18\x04 \x01(\x08R\x12allowNetworkMounts"\x8c\x01\n\x0fFilesystemEvent\x12\x12\n\x04name\x18\x01 \x01(\tR\x04name\x12)\n\x04type\x18\x02 \x01(\x0e2\x15.filesystem.EventTypeR\x04type\x120\n\x05entry\x18\x03 \x01(\x0b2\x15.filesystem.EntryInfoH\x00R\x05entry\x88\x01\x01B\x08\n\x06_entry"\xfe\x01\n\x10WatchDirResponse\x12?\n\x05start\x18\x01 \x01(\x0b2\'.filesystem.WatchDirResponse.StartEventH\x00R\x05start\x12=\n\nfilesystem\x18\x02 \x01(\x0b2\x1b.filesystem.FilesystemEventH\x00R\nfilesystem\x12F\n\tkeepalive\x18\x03 \x01(\x0b2&.filesystem.WatchDirResponse.KeepAliveH\x00R\tkeepalive\x1a\x0c\n\nStartEvent\x1a\x0b\n\tKeepAliveB\x07\n\x05event"\x9f\x01\n\x14CreateWatcherRequest\x12\x12\n\x04path\x18\x01 \x01(\tR\x04path\x12\x1c\n\trecursive\x18\x02 \x01(\x08R\trecursive\x12#\n\rinclude_entry\x18\x03 \x01(\x08R\x0cincludeEntry\x120\n\x14allow_network_mounts\x18\x04 \x01(\x08R\x12allowNetworkMounts"6\n\x15CreateWatcherResponse\x12\x1d\n\nwatcher_id\x18\x01 \x01(\tR\twatcherId"8\n\x17GetWatcherEventsRequest\x12\x1d\n\nwatcher_id\x18\x01 \x01(\tR\twatcherId"O\n\x18GetWatcherEventsResponse\x123\n\x06events\x18\x01 \x03(\x0b2\x1b.filesystem.FilesystemEventR\x06events"5\n\x14RemoveWatcherRequest\x12\x1d\n\nwatcher_id\x18\x01 \x01(\tR\twatcherId"\x17\n\x15RemoveWatcherResponse*i\n\x08FileType\x12\x19\n\x15FILE_TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0eFILE_TYPE_FILE\x10\x01\x12\x17\n\x13FILE_TYPE_DIRECTORY\x10\x02\x12\x15\n\x11FILE_TYPE_SYMLINK\x10\x03*\x98\x01\n\tEventType\x12\x1a\n\x16EVENT_TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11EVENT_TYPE_CREATE\x10\x01\x12\x14\n\x10EVENT_TYPE_WRITE\x10\x02\x12\x15\n\x11EVENT_TYPE_REMOVE\x10\x03\x12\x15\n\x11EVENT_TYPE_RENAME\x10\x04\x12\x14\n\x10EVENT_TYPE_CHMOD\x10\x052\x9f\x05\n\nFilesystem\x129\n\x04Stat\x12\x17.filesystem.StatRequest\x1a\x18.filesystem.StatResponse\x12B\n\x07MakeDir\x12\x1a.filesystem.MakeDirRequest\x1a\x1b.filesystem.MakeDirResponse\x129\n\x04Move\x12\x17.filesystem.MoveRequest\x1a\x18.filesystem.MoveResponse\x12B\n\x07ListDir\x12\x1a.filesystem.ListDirRequest\x1a\x1b.filesystem.ListDirResponse\x12?\n\x06Remove\x12\x19.filesystem.RemoveRequest\x1a\x1a.filesystem.RemoveResponse\x12G\n\x08WatchDir\x12\x1b.filesystem.WatchDirRequest\x1a\x1c.filesystem.WatchDirResponse0\x01\x12T\n\rCreateWatcher\x12 .filesystem.CreateWatcherRequest\x1a!.filesystem.CreateWatcherResponse\x12]\n\x10GetWatcherEvents\x12#.filesystem.GetWatcherEventsRequest\x1a$.filesystem.GetWatcherEventsResponse\x12T\n\rRemoveWatcher\x12 .filesystem.RemoveWatcherRequest\x1a!.filesystem.RemoveWatcherResponseBi\n\x0ecom.filesystemB\x0fFilesystemProtoP\x01\xa2\x02\x03FXX\xaa\x02\nFilesystem\xca\x02\nFilesystem\xe2\x02\x16Filesystem\\GPBMetadata\xea\x02\nFilesystemb\x06proto3',
[
timestamp_pb.desc(),
],
{
"MoveRequest": MoveRequest,
"MoveResponse": MoveResponse,
"MakeDirRequest": MakeDirRequest,
"MakeDirResponse": MakeDirResponse,
"RemoveRequest": RemoveRequest,
"RemoveResponse": RemoveResponse,
"StatRequest": StatRequest,
"StatResponse": StatResponse,
"EntryInfo": EntryInfo,
"ListDirRequest": ListDirRequest,
"ListDirResponse": ListDirResponse,
"WatchDirRequest": WatchDirRequest,
"FilesystemEvent": FilesystemEvent,
"WatchDirResponse": WatchDirResponse,
"WatchDirResponse.StartEvent": WatchDirResponse.StartEvent,
"WatchDirResponse.KeepAlive": WatchDirResponse.KeepAlive,
"CreateWatcherRequest": CreateWatcherRequest,
"CreateWatcherResponse": CreateWatcherResponse,
"GetWatcherEventsRequest": GetWatcherEventsRequest,
"GetWatcherEventsResponse": GetWatcherEventsResponse,
"RemoveWatcherRequest": RemoveWatcherRequest,
"RemoveWatcherResponse": RemoveWatcherResponse,
"FileType": FileType,
"EventType": EventType,
},
)
def desc() -> DescFile:
"""Returns the descriptor for the file `filesystem/filesystem.proto`."""
return _DESC