Inspect and retrieve files from your running app

Read and export files from approved Android app directories to investigate logs, caches, and other local data.

FileSystem tools help you inspect the files behind a problem and retrieve them for closer analysis. Start with read-only access to approved directories; enable file changes only when a local debugging workflow needs them.

Install

Published artifact: ai.ansight:ansight-tools-filesystem-android.

dependencies {
    debugImplementation("ai.ansight:ansight-tools-filesystem-android:1.6.3")
}

Register the Suite

import ai.ansight.runtime.AnsightOptions
import ai.ansight.tools.filesystem.withFileSystemTools

val options = AnsightOptions.createBuilder()
    .withFileSystemTools {
        addRoot("exports", application.filesDir.resolve("exports"))
    }
    .withReadOnlyToolAccess()
    .build()

Registration API

withFileSystemTools(...): registers the suite.
AndroidFileSystemToolsOptions.createBuilder(): creates a suite options builder.
addRoot(alias, path): exposes an additional approved root.

Specific Concerns

All access is constrained to approved roots.
File contents are sensitive even when only read tools are enabled.
files.push_file, files.copy_file, and files.move_file use Write.
files.delete_file uses Critical and requires withAllToolAccess().
files.begin_binary_download streams bytes over the binary transfer channel.

Tool Matrix

Name	Id	Policy	Description
`List Directory`	`files.list_directory`	`Read`	Lists files and folders inside approved roots.
`Read File`	`files.read_file`	`Read`	Reads a constrained file.
`Get File Checksum`	`files.get_file_checksum`	`Read`	Computes file checksums without returning contents.
`Download File`	`files.download_file`	`Read`	Downloads chunks through JSON fallback.
`Begin Binary Download`	`files.begin_binary_download`	`Read`	Starts binary WebSocket download for a constrained file.
`Push File`	`files.push_file`	`Write`	Writes caller-provided content into an approved root.
`Copy File`	`files.copy_file`	`Write`	Copies a constrained file.
`Move File`	`files.move_file`	`Write`	Moves or renames a constrained file.
`Delete File`	`files.delete_file`	`Critical`	Deletes a constrained file.

Tool Details

Use read tools for inspection and download. Enable write and critical tools only for specific local repair workflows.