feat: add createIfNotExist query param support in SDK

[devin-ai-integration]

Summary

Adds createIfNotExist query parameter support to the TypeScript SDK's sandbox creation flow. When createIfNotExist=true is passed, the controlplane returns an existing alive sandbox (200) instead of creating a new one, reducing unnecessary 409 conflicts. Existing 409 handling is preserved unchanged for parallel-creation race conditions.

Changes:

• SandboxInstance.create() now accepts an optional createIfNotExist boolean. When true, it passes ?createIfNotExist=true as a query parameter to createSandbox, allowing the server to return an existing alive sandbox instead of a 409 error.
• SandboxInstance.createIfNotExists() passes createIfNotExist: true to create() by default. All existing 409 handling logic is unchanged.
• CodeInterpreter.create() now accepts and forwards the createIfNotExist option to super.create(). Previously, CodeInterpreter.create only destructured { safe }, silently discarding createIfNotExist.
• Makefile adds a branch variable (defaults to main) so make sdk-controlplane / make sdk-sandbox can regenerate clients from feature branches.
• Regenerated client from main: Picks up latest OpenAPI spec including new image sharing endpoints, sandbox state field, network config changes, and other unrelated additions.

Updates since last revision

• Removed the 2-second setTimeout delay from the 409 handler — existing 409 handling was already correct and needs no modification
• Regenerated client from main branch (controlplane PR #3304 is now merged) instead of the feature branch
• Simplified overall approach: just pass the query parameter, keep all existing behavior
• Fixed DriveStateWritable → DriveState reference in regenerated types.gen.ts (codegen produced a reference to a non-existent writable variant)

Review & Testing Checklist for Human

• DriveStateWritable fix: The regenerated types.gen.ts referenced DriveStateWritable which doesn't exist — manually fixed to DriveState. This suggests the Makefile's sed-based type renaming has a gap. Verify the fix is correct and consider patching the Makefile's sed rules to handle this case automatically.
• Unrelated generated changes: Client regeneration from latest main pulled in many new types and endpoints (image sharing, sandbox state, network domain filtering, workspace group mappings, etc.). Verify these are expected from the current main spec and acceptable to include in this PR.
• End-to-end verification: Test createIfNotExists() with a named sandbox: (1) first call creates, (2) second call returns existing sandbox via 200, (3) parallel creation race still correctly handles 409 and returns existing sandbox.

Notes

• Dependency: controlplane #3304 is already merged and deployed.
• Companion PR: blaxel-ai/sdk-python#120 (same changes for the Python SDK)
• Part of ENG-2188.

Link to Devin session: https://app.devin.ai/sessions/c6b33927f20443edaa3e9e14b9f74f63
Requested by: @drappier-charles

---

---

Note

Adds createIfNotExist query parameter support to SandboxInstance.create() and CodeInterpreter.create(), allowing the server to return an existing alive sandbox instead of a 409. Fixes CodeInterpreter.create() which previously silently dropped the flag. Includes regenerated client types from main adding image sharing endpoints, GithubRunnerConfig, JobVolume, sandbox state field, and other new types.

^{Written by Mendral for commit 1a97a34.}

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR that start with 'DevinAI' or '@devin'.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[mendral-app]

Needs attention — 1 issue in 1 file

The previous comment on the TERMINATED-sandbox branch was not addressed — the latest commit (1a97a34) changed create(sandbox) to create(sandbox, { createIfNotExist: true }), which is the opposite of the fix needed. A TERMINATED sandbox must be recreated without the flag so the server performs a fresh create rather than returning the terminated resource.

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.

<assessment>
The previous comment on the TERMINATED-sandbox branch was **not addressed** — the latest commit (`1a97a34`) changed `create(sandbox)` to `create(sandbox, { createIfNotExist: true })`, which is the opposite of the fix needed. A TERMINATED sandbox must be recreated without the flag so the server performs a fresh create rather than returning the terminated resource.
</assessment>

<file name="@blaxel/core/src/sandbox/sandbox.ts">
<issue location="@blaxel/core/src/sandbox/sandbox.ts:295">
TERMINATED branch still passes `createIfNotExist: true`, causing the server to return the terminated sandbox instead of creating a fresh one. The flag must be omitted here.
</issue>
</file>

_{Tag @mendral-app with feedback or questions. View session}

[mendral-app]

bug (P1): TERMINATED branch still passes createIfNotExist: true, causing the server to return the terminated sandbox instead of creating a fresh one. The flag must be omitted here.

Suggested change

Suggested change

	return await this.create(sandbox, { createIfNotExist: true });
	return await this.create(sandbox);

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At @blaxel/core/src/sandbox/sandbox.ts, line 295:

<issue>
TERMINATED branch still passes `createIfNotExist: true`, causing the server to return the terminated sandbox instead of creating a fresh one. The flag must be omitted here.
</issue>