harness-filesystem/dev.ai.elements.harness.filesystem

Package-level declarations

Types

class DocumentFolder(context: Context, document: DocumentFile) : FolderNode

A FolderNode over a Storage Access Framework document (a folder the user picked, or a file in it).

class FileSystem(root: File, cwd: File = root, val readOnly: Boolean = false, val approveChanges: Boolean = true, val deniedPatterns: List<String> = emptyList(), val protectedPatterns: List<String> = DEFAULT_PROTECTED, val contentHashes: Boolean = true, val maxReadLines: Int = 2000, val maxListResults: Int = 1000, val maxSearchResults: Int = 1000, val maxFindResults: Int = 1000, mounts: suspend () -> List<Mount> = { emptyList() }) : Capability

Sandboxed file tools over one directory tree (an app workspace), with the tools, arguments and output format of Pydantic AI Harness FileSystem: read_file, write_file, edit_file, list_directory, search_files, find_files, create_directory, file_info.

FolderNode

interface FolderNode

A node of a folder tree that is not a local path, e.g. a folder the user shared through the Storage Access Framework (DocumentFolder). FileSystem serves it with the same tools as the workspace.

Mount

data class Mount(val name: String, val root: FolderNode, val writable: Boolean = true)

A folder mounted into FileSystem at /mnt/<name>; writable false makes it read-only.

SharedFolder

data class SharedFolder(val name: String, val uri: String, val writable: Boolean)

A folder the user shared with the agent.

SharedFolders

class SharedFolders(context: Context)

Folders the user shares with the agent through the Storage Access Framework, mounted into FileSystem at /mnt/<name>: