Skip to contents

List or stop gptr's background jobs and child processes

Source: R/proc-supervise.R
gptr_jobs.Rd

Lists the job table of this R process: background sessions, peter$bg() jobs, Shiny artifacts, the MCP server started by gptr_mcp_serve(), sub-agent workers and subscription-CLI children. A finished job whose stop was requested reads stopped or aborted, never error. Unavailable status information is shown as unknown.

Usage

gptr_jobs(kill = FALSE)

Arguments

kill

TRUE stops every job (sessions are canceled, processes are killed together with their process tree) and returns the table of what was stopped, invisibly.

Value

A gptr_jobs data frame with the columns id, kind (session, bg, artifact, mcp_serve, worker, cli), name, pid, status and started.

Options

Options of the transport and process layer (?gptr_options collects every option):

  • gptr.max_active (8): concurrent HTTP transfers (global).

  • gptr.connect_timeout (20), gptr.first_byte_timeout (120), gptr.idle_timeout (90): seconds; there is no total timeout on streams.

  • gptr.max_retry_delay (60): seconds; a longer retry-after fails fast.

  • gptr.max_attempts (4): transport attempts per request.

  • gptr.wire_log (FALSE): TRUE writes one redacted JSON line per request start and end to <workspace root>/cache/tmp/wire-<session id>.jsonl; a path must lie inside the workspace root or tempdir().

  • gptr.supervise (NULL): processx supervision of children; NULL means on, except under R CMD check.

  • gptr.stdin_timeout (60): seconds a child may take to accept pending stdin bytes.

Examples

gptr_jobs()
#> # 0 rows