Module●Since v0.6

experimental/sandbox

LangSmith Sandbox Module.

This module provides sandboxed code execution capabilities through the LangSmith Sandbox API.

import { ... } from "langsmith/experimental/sandbox";

Example

import { SandboxClient } from "langsmith/experimental/sandbox";

// Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment
const client = new SandboxClient();

const sandbox = await client.createSandbox("python-sandbox");
try {
  const result = await sandbox.run("python --version");
  console.log(result.stdout);
} finally {
  await sandbox.delete();
}

Classes

class

LangSmithDataplaneNotConfiguredError

Raised when dataplane_url is not available for the sandbox.

This occurs when the sandbox-router URL is not configured for the cluster.

class

LangSmithQuotaExceededError

Raised when organization quota limits are exceeded.

Users should contact support@langchain.dev to increase quotas.

class

LangSmithResourceAlreadyExistsError

Raised when creating a resource that already exists.

class

LangSmithResourceInUseError

Raised when deleting a resource that is still in use.

class

LangSmithResourceNameConflictError

Raised when updating a resource name to one that already exists.

class

LangSmithResourceNotFoundError

Raised when a resource is not found.

class

LangSmithResourceTimeoutError

Raised when an operation times out.

class

LangSmithSandboxAPIError

Raised when the API endpoint returns an unexpected error.

For example, this is raised for wrong URL or path.

class

LangSmithSandboxAuthenticationError

Raised when authentication fails (invalid or missing API key).

class

LangSmithSandboxConnectionError

Raised when connection to the sandbox server fails.

class

LangSmithSandboxCreationError

Raised when sandbox creation fails.

class

LangSmithSandboxError

Base exception for sandbox client errors.

class

LangSmithSandboxNotReadyError

Raised when attempting to interact with a sandbox that is not ready.

class

LangSmithSandboxOperationError

Raised when a sandbox operation fails (run, read, write).

class

LangSmithValidationError

Raised when request validation fails.

This includes:

Resource values exceeding server-defined limits (CPU, memory, storage)
Invalid resource units
Invalid name formats
Pool validation failures (e.g., template has volumes)

class

Sandbox

Represents an active sandbox for running commands and file operations.

This class is typically obtained from SandboxClient.createSandbox() and provides methods for command execution and file I/O within the sandbox environment.

class

SandboxClient

Client for interacting with the Sandbox Server API.

This client provides a simple interface for managing sandboxes and templates.