Export SDK error classes from @cloudflare/sandbox root

[zllovesuki]

Summary

Fixes #517.

The published package already contains the SDK's concrete error classes internally, but the root @cloudflare/sandbox entrypoint did not re-export many of them. That made exact error handling awkward for consumers because instanceof checks from the package root failed at import time.

This PR makes the root package export the full existing SDK error-class surface, including:

• SandboxError
• SessionAlreadyExistsError
• SessionDestroyedError
• ProcessNotFoundError

and the rest of the concrete SDK error classes already exposed by the internal errors barrel.

Changes

• re-export all existing SDK error classes from @cloudflare/sandbox
• add a regression test to verify the root exports match the internal errors barrel
• add a patch changeset

Result

Consumers can now do:

import { SessionAlreadyExistsError } from "@cloudflare/sandbox";

if (error instanceof SessionAlreadyExistsError) {
  // ...
}

Testing

• npm run check
• npm test -w @cloudflare/sandbox

npm run check still reports two existing Biome warnings in packages/sandbox-container tests, but the command completes successfully.

---

[changeset-bot]

🦋 Changeset detected

Latest commit: 6cc1995

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@cloudflare/sandbox	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/cloudflare/sandbox-sdk/@cloudflare/sandbox@518

commit: 6cc1995

[github-actions]

📦 Preview Build

Version: 0.0.0-pr-518-6cc1995

Install the SDK preview:

npm i https://pkg.pr.new/cloudflare/sandbox-sdk/@cloudflare/sandbox@518

🐳 Docker images were not rebuilt — no container changes detected. Use the latest release images from Docker Hub.