Secure, Fast, and Extensible Sandbox runtime for AI agents.
Merge main into command exit-code fix, preserving both execution contracts
leo pein94e83f430439
diff --cc docs/architecture/data-plane/execd.mdindex f402e47be,85cf948d0..738894536--- a/docs/architecture/data-plane/execd.md+++ b/docs/architecture/data-plane/execd.md@@@ -58,8 -58,8 +58,10 @@@ Execution modesForeground `stdout` and `stderr` event text preserves the command's line endings (`\n`, `\r`, or `\r\n`). Concatenate event text for each stream to reconstruct its output; the last event may be an unterminated fragment.+A successful foreground `POST /command` ends with `execution_complete` carrying `exit_code: 0`. This optional field is omitted from background startup acknowledgements and code execution events; absence is not an exit status. Non-zero command exits retain `error.exit_code` on the `error` event. Older execd versions omit the successful exit code, so clients may retain their existing foreground-only completion inference. A stream that ends before a terminal event does not establish success.++ Bash-session runs stream one merged `stdout` event stream (session stderr is merged into it) with the same line-ending contract: event text preserves `\n`, `\r`, or `\r\n`, and concatenating event text reconstructs the run's output. Blank lines are preserved as events containing only the line ending, and the final event may be an unterminated fragment.+Sessions use Bash when the image provides it and fall back to POSIX `sh` on minimal images — commands sent to a fallback session must be `sh`-compatible. Windows sandboxes are supported (environment names are case-insensitive; batch files require shell syntax).## Code execution