Module background_shell 

Explicit, in-process background jobs for ctx_shell.

The MCP request may complete immediately, but the child keeps the exact timeout, allow-list, path-jail and process-group policy of foreground shell execution. Jobs intentionally live in the daemon: restarting it invalidates outstanding jobs rather than silently orphaning subprocesses.

Enums

ForegroundResult

Outcome of a foreground run that is allowed to detach on a soft cap.

JobState

Functions

cancel

run_foreground_or_detach

Run command as a managed background job but block up to soft_cap waiting for it to finish, so fast commands still return their output inline.

start

status