GitHub
Main Docs

Deep Agents

LangChain

LangGraph

Integrations

LangSmith

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

index

Copy

import { ... } from "@langchain/sandbox-standard-tests";

Functions

function

sandboxStandardTests

function

withRetry→ Promise<T>

Interfaces

Type Aliases

View source on GitHub

interface

SandboxInstanceV2

Interface for sandbox instances used in standard tests (v2).

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

V2 uses Result types for better error handling.

interface

StandardTestsConfig

Configuration for the standard sandbox test suite.

interface

SuiteFn: string, fn: () => void)

A describe / suite function accepted by the standard tests.

interface

TestFn: string, fn: () => void | Promise<void>, timeout?: number)

An it / test function accepted by the standard tests.

interface

TestRunner

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.

Interface for sandbox instances used in standard tests (v1).

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

typeAlias

AnySandboxInstance: SandboxInstanceV1 | SandboxInstanceV2

Union type for any sandbox instance (v1 or v2).

typeAlias

ExpectFn: (value: unknown)

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.

typeAlias

HookFn: (fn: () => void | Promise<void>, timeout?: number)

A beforeAll / afterAll hook function.

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.

Menu

index

Functions

Interfaces

Type Aliases