run
Execute notebook cells with automatic dependency re-execution, handle timeouts, and receive condensed outputs including images.
Instructions
Execute cells on the notebook's persistent kernel.
Default (no `cells`): every stale cell in document order — minimal
recompute after edits. With `cells`: exactly those cells, even if fresh
(API calls, randomness), preceded by their stale ancestors so inputs are
trustworthy (`fresh_deps=false` skips the ancestor pass). Outputs are
persisted and returned condensed; charts come back as images; `quiet`
collapses ok cells to status lines. If everything finishes within
`wait_seconds` you get full results; otherwise execution continues in the
background — watch it via notebook_overview / read_cells (live output),
stop it via interrupt.Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| cells | No | ||
| quiet | No | ||
| fresh_deps | No | ||
| wait_seconds | No | ||
| timeout_seconds | No |