Add Sandboxes documentation page - #24
Open
mmilutinovic371 wants to merge 3 commits into
Open
Conversation
Documents the DeepSands sandbox service ahead of release: plans/pricing, lifecycle and timeouts, filesystem persistence (only /workspace survives stop/start), isolation/networking, quotas, errors, Python SDK, and HTTP API. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Exact specs and hourly rates can change; link to the dashboard and catalog endpoint/SDK method instead of a table that will go stale. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The backend branch merged main since the page was first written, and fixed the fs-path-outside-/workspace bug from a 500 to a proper 400 -- update the docs to match instead of describing a bug that's gone. Also: drop the unreachable 403 row from the errors table, add the 400 row that's now common (bad path, empty command, timeout out of range), note the read-side 100 MiB cap symmetric to writes, and mention the fail_reason field GET/list now returns for a failed sandbox. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
New docs page for the DeepSands sandbox service (isolated microVMs for running untrusted code), added ahead of general release per mentor feedback that pre-release docs matter — especially the non-obvious details (lifespan,
/workspace-only persistence, isolation boundaries).sandboxes/overview.mdx, added to nav between GPU Instances and Hosted Agentsdeep-sandsservice) and thedeepinfra-pythonSDK source, not just the marketing blog post — plans/pricing table, lifecycle states, three independent timeout clocks (idle / 24h hard age / 7-day stopped retention), filesystem persistence model, isolation/networking, quotas, typed errors, Python SDK usage, and raw HTTP API examples/workspace(not/work) for all paths — the backend only accepts/workspace; the SDK's own README/examples currently use/work, which is a separate bug worth fixing in that repoTest plan
docs.jsonis well-formed JSONnpx mint broken-links— no broken linksmint dev(not run in this environment)