alibaba / alibaba/ROCK

[Feature] Extend TypeScript SDK sandbox lifecycle and disk configuration

Open
#1,240 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Python
Stars
485
Forks
81
Avg merge
16h 12m
Merged PRs (30d)
8

Description

**Feature Category**
- [x] SDK & API

**Problem Statement**
The TypeScript SDK cannot request archival for stopped sandboxes, configure requested disk capacity when creating a sandbox, or expose archive lifecycle state in typed status responses.

**Proposed Solution**
Add an archive operation to the sandbox client, pass an optional disk setting to the sandbox start request, and model sandbox states and transition history in the TypeScript SDK.

**Detailed Feature Description**
- Add `Sandbox.archive()` for `POST /sandboxes/{sandboxId}/archive`.
- Add optional `disk` configuration and include it in `start_async` requests.
- Add typed sandbox states, transition-history records, and status-response fields.
- Bump the TypeScript SDK package and lockfile version to `1.10.0`.
- Add unit coverage for the new SDK behavior.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by locating the TypeScript sandbox client, its start_async request type, sandbox status types, package manifest, and lockfile, then run the existing SDK unit tests. Done means archive() sends the specified POST request, disk is included when configured, lifecycle states and transition history are represented in status responses, tests cover the new behavior, and the package version is 1.10.0.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
api, developer-experience
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.