Tools
Processes & evaluation
Process tools require command exposure and remain subject to approval, cancellation, deadlines, output limits, and session evidence.
Choose the narrowest operation
run_command | Execute a shell command when shell semantics are required. |
run_process | Execute an argv array without shell parsing. |
run_package_script | Run a declared package script after discovery. |
node_eval / python_eval | Use managed language runtimes for computed inspection. |
Long-lived and interactive work
pty_session and pty_resize manage terminal processes that need later input. Background jobs must remain addressable by a stable handle; do not orphan servers or watchers.
Output and cancellation
Large output spills to an artifact reference. Cancellation applies to the tracked process tree, not just a parent PID. Timeouts and terminal status are retained in the session.
Verification
For behavioral changes, run the actual changed path. A successful compiler invocation proves compilation, not user-visible behavior.