---
title: "TypeScript sandbox SDK."
description: "Generated TypeScript sandbox SDK with typed provider inputs and the complete shared lifecycle. Review authentication, compatibility, and package provenance."
canonical: "https://wildflower.computer/sdk/typescript/"
openapi_version: "0.8.0"
source_revision: "788b7325a454b8b753a7d614247d5694bad5c967"
---

# TypeScript sandbox SDK.

Generated TypeScript sandbox SDK with typed provider inputs and the complete shared lifecycle. The generated client is version 0.8.0 and calls the Wildflower Computer API v1 contract.

## Create, execute, and delete

This example uses E2B to make the provider input concrete. The generated client also includes typed creation inputs for the other providers in the 12-adapter OpenAPI contract.

```typescript
import { Wildflower } from "@wildflowercomputer/sdk";

const client = new Wildflower({
  wildflowerApiKey: process.env.WILDFLOWER_API_KEY,
});

const sandbox = await client.sandboxes.create({
  provider: "e2b",
  image: "base",
  timeout: 300,
});

const handle = client.sandboxes.attach(sandbox.id);
await handle.waitUntilReady();
const result = await handle.runCommand({
  command: "echo hello",
});
await handle.writeText("/tmp/hello.txt", "hello");
console.log(result.stdout, result.stderr, result.exitCode);
await handle.delete();
```

## Authentication model

The Wildflower Computer API key authenticates the application. The selected provider credential is resolved from a connected project profile or sent as an inline override. Inline secrets are carried in headers and never serialized into the JSON request body.

A fresh process can use the same connected project profile. Inline mode requires the credential again; provider-specific connection context remains typed separately.

## Error model

API failures expose stable error codes, HTTP status, an optional provider, and the response `X-Request-Id`. A command with a non-zero exit code is a successful execution result, not an API failure.

## Generated package provenance

| Package version | `0.8.0` |
| --- | --- |
| API version | `v1` |
| OpenAPI version | `0.8.0` |
| Generator version | `0.7.0` |
| OpenAPI SHA-256 | `7e4f085adbee5ae5e63941b3286eebbbc90d2185735f5ac2b0a1093432e81c4f` |
| Source revision | `788b7325a454b8b753a7d614247d5694bad5c967` |

## Availability

Distribution status: **source-only**. The generated package exists in the API source repository and its local release-candidate pipeline. This page does not claim registry publication while the generated status remains source-only.

## Continue

- [Shared lifecycle quickstart](https://wildflower.computer/docs/getting-started/)
- [Authentication and normalized error concepts](https://wildflower.computer/docs/concepts/)
- [Provider compatibility matrix](https://wildflower.computer/compatibility/)
- [OpenAPI and JSON schema downloads](https://wildflower.computer/openapi/)

> **@wildflowercomputer/sdk** — Generated package Node.js 20 or newer · Promise-based