Capture Process Scenario
capture_process_scenarioRun a chosen command under a PTY and return process capture Evidence with residual unknowns, including terminal size, timeout, and finalization controls.
Instructions
Run one caller-selected command under a PTY and return process capture Evidence with residual unknowns. The renderer admits at most 1,000,000 combined terminal cells, computed as columns × (rows + scrollback); every resize uses the selected scrollback and must fit the same budget. Supply a smaller terminal shape when that product is too large; dimensions are never clamped. A command name resolves through the inherited PATH; the working directory defaults to the caller's current directory; host environment variables are inherited with scenario overrides. Environment keys cannot contain '=' or NUL, and REA_PROCESS_RUN_ID is reserved for process ownership. Filesystem snapshots are opt-in through filesystem_observation_paths. A positive finalization_ms makes a timeout or idle deadline send SIGTERM to the captured root through its start identity, keep observing, and send SIGKILL once after the interval; exit.finalization records each attempt with its delivery result and the observed exit, and cancellation still ends the run at once. The target runs with the current user's permissions; this is not a security sandbox.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"events": [],
"limits": {
"files": 10000,
"processes": 1000,
"file_bytes": 10000000,
"output_bytes": 1000000,
"filesystem_depth": 16
},
"terminal": {
"rows": 24,
"columns": 80,
"scrollback": 1000
},
"arguments": [],
"settle_ms": 100,
"executable": "/usr/bin/true",
"timeout_ms": 30000,
"environment": {},
"normalization": {
"pids": true,
"paths": false,
"ports": true,
"patterns": [],
"time_bucket_ms": 10
},
"finalization_ms": 1500,
"idle_timeout_ms": 30000,
"working_directory": "/tmp",
"filesystem_observation_paths": []
},
"name": "capture_process_scenario"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | No | ||
| limits | No | Resource budgets that bound execution and retained output for this operation. | |
| terminal | No | The visible terminal and scrollback together must use at most 1,000,000 xterm renderer cells: columns × (rows + scrollback). Resize events use the same scrollback and limit. | |
| arguments | No | ||
| settle_ms | No | ||
| executable | Yes | Command name or executable path to run. | |
| timeout_ms | No | ||
| environment | No | ||
| normalization | No | ||
| finalization_ms | No | Milliseconds a target may keep running after SIGTERM when timeout_ms or idle_timeout_ms fires, before SIGKILL; 0 sends SIGKILL immediately. Both signals reach the captured root only while its launch-time start identity still matches; cancellation ends the run at once. | |
| idle_timeout_ms | No | ||
| working_directory | No | ||
| filesystem_observation_paths | No |