36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
# Files panel
|
|
|
|
The chat Files panel lists and navigates the active session's server working
|
|
directory, with filtering, hidden files, sorting, and list/grid presentation
|
|
(`app/lib/features/chat/files/`). The follow-up slice adds file opening, viewing,
|
|
downloading and image thumbnails.
|
|
|
|
Server side:
|
|
|
|
- Directory listings (`list_directory`) include file `size` (bytes) and RFC3339 UTC
|
|
`modified` metadata for files; directories carry neither.
|
|
- `GET /files?path=...` serves one regular file for the client files panel. Paths may be
|
|
absolute or `~`-prefixed and are resolved through the operator home directory; cleaned
|
|
paths and symlinks must stay inside that home subtree. Directories, special files and
|
|
escape paths are refused. Add `download=1` for attachment disposition.
|
|
|
|
## Viewing and downloads
|
|
|
|
Files now open in the shared artifact viewer (images, SVG icons in an inert
|
|
HTML frame, text/code, markdown, JSON, tables, HTML, audio and video). PDFs open
|
|
through the platform handler. Unknown files show metadata and host-native Open
|
|
externally/Download actions. Every file has separate Open and Download menu
|
|
items, including PDFs; folders have neither. Downloads reuse the artifact
|
|
save bridge on native platforms and attachment URLs on web. Viewer downloads
|
|
also use attachment URLs.
|
|
|
|
Image tiles decode at 56 logical pixels (maximum scale 4), show a loading
|
|
placeholder and error glyph, and evict decoded cache entries when scrolled out.
|
|
Sorting runs once per panel rebuild. Breadcrumbs navigate to ancestors; filters
|
|
stay synchronized with folder navigation, and filtered empty states differ from
|
|
empty folders. Sizes use binary units and mtimes use compact local timestamps.
|
|
|
|
The capture fixture uses `files=1`; see app/tool/capture/README.md for bundling
|
|
its static files. PDF/video fixture entries only show types/menus and do not
|
|
provide playable sample bytes.
|