diff --git a/docs/cli.md b/docs/cli.md index e5dc40cc..abdb9c6f 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -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: `, 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