Skip to content

docs(sandbox-adapter): complete the Sandbox Adapter page - #384

Merged
eersnington merged 1 commit into
mainfrom
docs/sandbox-adapter
Nov 5, 2026
Merged

eersnington merged 1 commit into
mainfrom
docs/sandbox-adapter

Conversation

@eersnington

Copy link
Copy Markdown
Member

Documents @rivet-dev/sandbox-adapter for Actors that use a sandbox without Pi.

  • Use a sandbox from any Actor: examples/docs/sandbox-adapter/actor.ts
  • Provider imports, install lines, and credentials
  • Lifecycle, exec options and results, and file operations
  • Custom providers: examples/docs/sandbox-adapter/custom-provider.ts
  • Docker image requirements, with a command that checks an image

The image option on /agents/docs/sandboxes said an image only needs /bin/sh. It now links to the full list:

The image needs Used for
/bin/sh Everything
tail The idle process, unless keepImageEntrypoint is set
mkdir connect, mkdir, and exec
cat readFile, writeFile, and stopping a command
rm Cleaning up after exec
touch Stopping a command that is still starting
stat Pi's read and edit tools
A writable /tmp Finding a process to kill

@railway-app

railway-app Bot commented Nov 5, 2026

Copy link
Copy Markdown

This PR was not deployed automatically as @eersnington does not have access to the Railway project.

In order to get automatic PR deploys, please add @eersnington to your workspace on Railway.

@eersnington

Copy link
Copy Markdown
Member Author

skipping CI

@eersnington
eersnington merged commit 10cdce9 into main Nov 5, 2026
6 checks passed
@github-actions

github-actions Bot commented Nov 5, 2026

Copy link
Copy Markdown

📟 Pip-Boy · 961cd27

📦 Packages

Skipped: this PR doesn't change any published package.

🧹 Rust dependencies

Skipped: this PR doesn't change any Rust code or dependencies.

🦀 Binaries

Skipped: this PR doesn't change any Rust code.

⏱ Timing

job wall time slowest step
zizmor 16s checkout · 10s
changes 16s checkout · 13s
report 18s checkout · 8s
⏭ self-test — skipped
⏭ native · ${{ matrix.platform }} — skipped
⏭ hygiene — skipped
⏭ footprint — skipped
🔭 Full CI trace for this commit

One OpenTelemetry trace of CI and Pip-Boy for 961cd27: every job and step, with the sizes above attached. Run after CI finishes.

pnpm install --frozen-lockfile --filter 'pipboy...'
pnpm --filter pipboy pipboy trace --sha 961cd27b714dfa57fca1dd0b1a435eafe9c2ef01

Add --otlp <url> to send it to any OTLP/HTTP collector.

Agent instruction: From a rivet-dev/agents checkout, run the commands above, then read the trace file the last command prints. List the slowest jobs and steps and explain where CI time went.

@eersnington
eersnington deleted the docs/sandbox-adapter branch November 5, 2026 09:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant