SDK / typescript

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.

sandbox.ts
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 version0.8.0
API versionv1
OpenAPI version0.8.0
Generator version0.7.0
OpenAPI SHA-2567e4f085adbee5ae5e63941b3286eebbbc90d2185735f5ac2b0a1093432e81c4f
Source revision788b7325a454b8b753a7d614247d5694bad5c967

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