Document explorer metadata and server health protocol

This commit is contained in:
2026-11-07 01:40:56 +00:00
parent f80edfabab
commit b8313c9790
+10 -3
View File
@@ -601,9 +601,11 @@ sessions pipeline runs create. The protocol types are:
is `directory_listing: {"path", "home", "parent", "entries", "truncated"}`:
`path` is the absolute, cleaned directory (expressed under `home`), `parent` is
`null` at the home root, and each entry is
`{"name", "path", "is_dir", "is_git_repo", "hidden"}` — directories first,
then files, each group sorted case-insensitively. Files are names only (never
contents) and are not selectable; `is_git_repo` marks a directory containing
`{"name", "path", "is_dir", "is_git_repo", "hidden", "size", "modified"}` — directories first,
then files, each group sorted case-insensitively. `size` is file bytes (omitted
for directories); `modified` is the entry mtime in RFC3339 UTC. Both are omitted
when entry metadata is unavailable. Listings never include file contents;
`is_git_repo` marks a directory containing
`.git`; `hidden` marks a dot-name. Listing is confined to the home subtree:
the path is cleaned and its symlinks resolved first, so `..`, an absolute path
outside home, or a symlink that escapes home is refused with an `error` frame
@@ -612,6 +614,11 @@ sessions pipeline runs create. The protocol types are:
similar) are refused, permission problems are reported as
`permission denied: <path>`, and a reply carries at most 2000 entries with
`truncated: true` when more exist.
- `server_stats` returns `server_stats_result` with a `server_stats` snapshot of
host, CPU, memory, local storage, Pipelines data, process and GPU information.
Sampling is bounded to about three seconds; unavailable sections carry an
`error` or `reason`. GPU utilization is optional (macOS reports the device
name only). See [Server stats](notes/server-stats.md).
- `chat_adopt` takes a `session_id` that already exists on the configured
endpoint and records it in the operator session registry, using the endpoint's
own directory and title (never a guess or the server's working directory). The