index

Run the standard sandbox integration tests against a provider.

A single shared sandbox is created in beforeAll and reused for the majority of tests (command execution, file operations). Tests that inherently need their own sandbox (lifecycle close/init, initialFiles) create a temporary one and destroy it immediately, so the concurrent sandbox count never exceeds 2 (shared + 1 temporary).

Retry an async operation with a fixed delay between attempts.

Useful for working around transient sandbox concurrency limits: when a provider rejects creation because the organisation has too many running sandboxes, waiting a short while and retrying usually succeeds once a previous sandbox finishes shutting down.

Interface for sandbox instances used in standard tests.

Extends the canonical SandboxBackendProtocol from deepagents with test-specific properties (isRunning, initialize) and makes uploadFiles/downloadFiles required (they are optional in the base protocol).

Configuration for the standard sandbox test suite.

A describe / suite function accepted by the standard tests.

An it / test function accepted by the standard tests.

Test-runner primitives required by the standard test suite.

Pass the primitives from your test framework (Vitest, Jest, …) when importing from the root entry point. The @langchain/sandbox-standard-tests/vitest sub-export fills these in automatically.

An expect function.

The return type is intentionally any — every test framework exposes its own matcher API and fully typing it would couple the package to a specific runner.

A beforeAll / afterAll hook function.