Runtime for ComputeSDK

ComputeSDK publishes its providers to npm from its own repository. The Runtime provider is one of them, as @computesdk/runtime since 28 September 2026:

Terminalnpm install computesdk @computesdk/runtime

It needs Node.js 22.12 or later. The key comes from RUNTIME_API_KEY, or from npx withruntime login on this machine, as in the rest of the SDK.

JavaScriptimport { runtime } from "@computesdk/runtime";const compute = runtime({ apiKey: process.env.RUNTIME_API_KEY });const sandbox = await compute.sandbox.create({ envs: { NODE_ENV: "production" } });try {  const result = await sandbox.runCommand("node --version");  console.log(result.stdout);  await sandbox.runCommand("python3 -m http.server 3000", { background: true });  console.log(await sandbox.getUrl({ port: 3000 }));} finally {  await sandbox.destroy();}

sandbox.getInstance() returns the withruntime sandbox. Use it for anything ComputeSDK's interface does not cover: processes, terminals, network rules, the desktop and the rest.

Every option is optional.

compute.sandbox.create() takes ComputeSDK's own options and maps them: templateId is a Runtime image, snapshotId a Runtime snapshot, metadata becomes labels, timeout a time limit, vcpus, memoryMiB and diskMiB the size, and envs is set on every command the provider runs in that sandbox.

• Commands run under bash -c, for 60 seconds unless timeout says otherwise (up to 24 hours). One that runs past its timeout returns exit code 124 with its output so far. background: true starts a Runtime process and returns immediately.
• Streaming. onStdout and onStderr receive output through Runtime's API as the command writes it, so ComputeSDK needs no port inside the sandbox.
• Files use Runtime's file calls, not shell commands.
• getUrl shares the port as a private preview and returns a link that carries its token. The link works unchanged in a browser, fetch, curl or a WebSocket client, until the token expires.
• destroy stops the sandbox. getById returns null for a stopped one, and a paused one wakes when used.
• Snapshots keep files, memory and running processes; create, list and delete work, and snapshotId starts a sandbox from one.
• envs from create are held by the provider object that created the sandbox. A sandbox reached through getById or list does not have them; pass env to runCommand there.

On 25 September 2026, the provider was built in a clone of ComputeSDK's repository (commit d52afb5) against withruntime 0.5.1 from npm. There, its CommonJS and ESM builds, type declarations, typecheck and lint passed. 28 unit tests passed with the Runtime SDK mocked. ComputeSDK's shared provider suite passed against ComputeSDK's own mock sandbox. Both builds loaded withruntime and called a local stand-in for Runtime's API.

On 11 October 2026 the published @computesdk/runtime 0.1.4 ran against Runtime's API: create, a command, streamed output, a file written and read, a timeout's exit code 124, a background command, list, getById and destroy.