Build Live Files and Viewers
Browse, preview, transfer, snapshot, inspect, and attach live app files from the Ansight Studio Build workspace.
The Build Files panel works with roots advertised by the connected app’s file tools. It is designed for app-owned diagnostic files and sandbox content, not arbitrary access to the host or device filesystem.
Browse the App Sandbox
Build can:
- switch between advertised root aliases
- navigate to a relative path or move to the parent folder
- filter the current listing by name or relative path
- include or hide dotfiles and other hidden entries
- refresh the current folder
- show name, kind, modified time, and size
- open folders and preview files in place
The exact roots and operations depend on the SDK file provider and tool guard.
File Actions
| Action | Behavior |
|---|---|
| Open | Downloads a temporary preview and opens it in the Build viewer. |
| Download | Saves the selected app file through Studio’s file-download flow. |
| Upload | Selects a host file and pushes it into the current app folder when write access is allowed. |
| Save snapshot | Stores the selected file, folder, or current folder as session evidence for Replay. |
| Add to chat | Saves a replay-backed file snapshot and adds a removable attachment to the selected Build task. |
Built-In Viewers
| Content | Viewer features |
|---|---|
| Source code and text | Syntax-aware source view, line numbers, target-line focus, truncation notice, and language label. |
| Markdown | Syntax-aware source preview with line numbers and target-line focus. Agent activity renders supported Markdown separately. |
| JSON and XML | Tree, pretty, and source modes with structured parse fallback. |
| Property lists | Parsed property-list structure with source fallback when needed. |
| CSV | Tabular preview with a row-limit notice for large files. |
| SQLite | Schema objects, table paging, SQL execution, query results, and push-back to the originating device when write access is available. |
| Images | In-place image preview for supported image types. |
| In-place continuous PDF rendering. | |
| GLB | In-place 3D GLB preview. |
File Information and External Apps
The viewer can show:
- type, MIME type, format, size, and file attributes
- full path and containing folder
- created, modified, and accessed timestamps
- SHA-256 and MD5 checksums
- compatible host applications
- actions to open in the default or selected host application
- Reveal in Finder for the local preview file
SQLite Round Trip
When a SQLite file came from a live app and the file provider allows writes, the viewer exposes Push to device. This replaces the originating device file with the local preview copy. Treat it as a write operation: close active database handles where possible and use it only in an approved development build.
Preview Safeguards
Build bounds preview work to keep the workspace responsive:
- text previews read up to 4 MB and render up to 8,000 lines
- images are previewed up to 16 MB
- PDF and GLB binary previews are prepared up to 64 MB
- large structured trees and tables show a truncation notice
Use Open with or the default host application when a file exceeds an in-place preview limit.
Tool and Security Requirements
- Listing and previewing require the corresponding file read scopes.
- Upload and SQLite push-back require write access.
- Snapshots require the app/session artifact flow.
- Add to chat requires an open or new Build task.
- Submitted file attachments are explicit snapshots; Build does not silently attach the whole sandbox.