Document explorer metadata and server health protocol
This commit is contained in:
+10
-3
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user