account_usage
ChatGPTReturn current account-cycle usage and reset dates, effective calls remaining, plan limits, and the optional shared Free anti-abuse allowance. This introspection call is not itself metered.
activity_recent
ChatGPTReturn privacy-safe recent VARUA Remote Control operation metadata for recovery, optionally filtered by tool, device, or lower timestamp bound. Arguments, environment values, paths, and raw command output are never returned.
capabilities
ChatGPTDescribe VARUA Remote Control capabilities and their safety/metering metadata
device_health
ChatGPTAsk a connected VARUA Remote Control agent for its health report
devices
ChatGPTList registered devices and the capabilities each agent advertises
filesystem_copy
ChatGPTCopy an authorized regular file or, with recursive=true, a bounded directory tree to a destination that must not already exist. Directory copies reject protected paths, symlinks, and unsupported entries.
filesystem_list
ChatGPTList bounded entries in one authorized directory on a connected device
filesystem_mkdir
ChatGPTCreate a directory tree inside an authorized root
filesystem_move
ChatGPTMove a path between authorized locations without overwriting the destination. Optional source hash/kind preconditions require a current VARUA Remote Control agent.
filesystem_patch
ChatGPTApply exact UTF-8 text edits only if the file still matches the SHA-256 returned by filesystem_read. All occurrence checks pass before replacement, and failed preconditions leave the original untouched.
filesystem_patch_many
ChatGPTApply SHA-256-guarded exact text edits across 1-32 authorized UTF-8 files. VARUA Remote Control validates every hash and occurrence precondition before mutating any file and rolls back already-swapped files if a commit step fails.
filesystem_read
ChatGPTRead bounded UTF-8 file content from an authorized root. Supports 1-based line windows or tail reads and returns a SHA-256 for safe follow-up patching.
filesystem_read_many
ChatGPTRead up to 32 authorized files in one logical call. Use paths for simple shared limits or files for per-file line/tail/byte ranges. Individual failures are isolated instead of failing the whole batch.
filesystem_remove
ChatGPTRemove an authorized file, symlink, or directory. Recursive directory removal requires recursive=true, refuses allowed roots, preflights protected descendants, and supports optional hash/kind stale-state guards.
filesystem_search
ChatGPTSearch authorized directory trees by entry name with strict traversal bounds
filesystem_stat
ChatGPTReturn rich metadata for one authorized path, including creation/modification times and, for regular files, SHA-256 plus UTF-8 line count when bounded
filesystem_write
ChatGPTRewrite or append bounded UTF-8 content inside an authorized root. Optional preconditions make creates and rewrites stale-safe; checked preconditions require a current VARUA Remote Control agent.
get_profile
ChatGPTReturn the VARUA Remote Control profile represented by the current authenticated credentials. The opaque id remains stable across token refresh, reconnection, and display-metadata changes.
health
ChatGPTReport VARUA Remote Control gateway health
process_batch_status
ChatGPTReturn sanitized progress and child process handles for one managed process batch without reading child output. This control operation is quota-neutral.
process_batch_stop
ChatGPTCancel queued work and terminate active process trees in one managed process batch. This lifecycle-control operation is quota-neutral.
process_batch_wait
ChatGPTWait up to 10 seconds for a managed process batch to finish and return sanitized progress without reading child output. This control operation is quota-neutral.
process_info
ChatGPTInspect one process without exposing command-line arguments or environment variables
process_list
ChatGPTList bounded process metadata without command-line arguments or environment variables
process_managed_list
ChatGPTList VARUA Remote Control-managed long-running processes visible under the active security profile. Use this to recover process handles after a stream interruption or transient agent↔gateway reconnect. This control operation is quota-neutral.
process_read
ChatGPTWait for buffered output or completion from a managed process. Managed processes survive transient agent↔gateway reconnects. Output is retained in a bounded replay buffer: omit cursors for normal continuation, use cursor 0 after a stream/reconnect failure to replay retained output, or tail_bytes for the newest output. This is quota-neutral control traffic; use wait_ms instead of sleep polling.
process_run
ChatGPTRun one short process expected to finish within 10 seconds. For long-running commands use process_start plus process_read with wait_ms; never use process_run sleep merely to wait.
process_run_many
ChatGPTStart 1-16 independent managed commands, each with an explicit program and optional argument array, under one approved working directory. Bounded concurrency defaults to 4 and is capped at 8. Returns immediately with a stable batch id and child process handles. Child output remains in the normal replay-safe process buffers. Use a non-sensitive idempotency_key for retry safety after transport failures.
process_start
ChatGPTStart a long-running managed process and return immediately with a stable process handle. Managed processes survive transient agent↔gateway reconnects. For retry safety after a transport failure, provide a non-sensitive idempotency_key; the same key and request returns the existing process instead of starting a duplicate. Prefer this for builds, tests, servers, and commands that may exceed 10 seconds.
process_status
ChatGPTReturn current status, exit code and elapsed time for one managed process without reading or advancing any output cursor. Managed processes survive transient agent↔gateway reconnects. This control operation is quota-neutral.
process_stop
ChatGPTStop and remove a managed process, returning its remaining bounded output. This control operation is quota-neutral.
process_wait
ChatGPTWait up to 10 seconds for a managed process to finish and return status, exit code and elapsed time without reading or advancing stdout/stderr cursors. Use this quota-neutral control call when only completion matters.
search_list
ChatGPTList resumable search sessions visible under the active security profile. Use this after a stream or transient gateway reconnect to rediscover search handles. This recovery/control operation is quota-neutral.
search_read
ChatGPTWait for and read progressive results from an existing search. Search sessions survive transient agent↔gateway reconnects, so the same search_id can resume afterward. This control operation is quota-neutral; prefer wait_ms over polling loops.
search_start
ChatGPTStart a resumable filename or content search under an authorized root and return a small first page when available. Git ignore rules are honored by default. Keep the returned search_id and continue with search_read only when more results are needed.
search_stop
ChatGPTStop an existing search without returning its accumulated results. This control operation is quota-neutral.
terminal_interact
ChatGPTWrite bounded input to a persistent terminal and wait for bounded output in the same call. Prefer this for REPLs and interactive shells instead of separate write/read chatter.
terminal_list
ChatGPTList persistent shell sessions owned by a locally execution-approved agent. Shell sessions survive transient agent↔gateway reconnects; use this quota-neutral recovery call to rediscover session handles afterward.
terminal_read
ChatGPTRead bounded retained output from a persistent shell session, optionally waiting up to 10 seconds. Shell sessions survive transient agent↔gateway reconnects. Omit cursor for normal continuation, use cursor 0 after a stream/reconnect failure to replay retained output, or tail_bytes for the newest output. Prefer wait_ms over separate sleep commands.
terminal_start
ChatGPTStart a persistent shell session inside an approved working directory
terminal_stop
ChatGPTStop and remove a persistent shell session, returning its remaining buffered output
terminal_write
ChatGPTLow-level write-only input to a persistent shell session. Prefer terminal_interact when you need output in the same operation.
work_context
ChatGPTSummarize one authorized work location plus active VARUA Remote Control processes, searches, terminals rooted there and optional detected version-control context. This generic recovery tool does not return command arguments, environments, process output, or file contents.