sandbox0 0.2.4 → 0.2.5

package/README.md

@@ -49,6 +49,21 @@ async function main() {
 main().catch(console.error);
 ```
 
+## CMD Streaming
+
+```typescript
+const stream = await sandbox.cmdStream("sh -c 'echo hello && echo warn >&2'", {
+  command: ["sh", "-c", "echo hello && echo warn >&2"],
+});
+
+for await (const output of stream.outputs()) {
+  process.stdout.write(output.data);
+}
+
+const done = await stream.wait();
+console.log(`exit=${done.exitCode} state=${done.state}`);
+```
+
 ## Documentation
 
 - [Sandbox0 docs](https://sandbox0.ai/docs)

package/dist/apispec/src/apis/ContextsApi.d.ts

@@ -129,12 +129,12 @@ export declare class ContextsApi extends runtime.BaseAPI {
      */
     apiV1SandboxesIdContextsCtxIdStatsGet(requestParameters: ApiV1SandboxesIdContextsCtxIdStatsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessContextStatsResponse>;
     /**
-     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" }
+     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" } - { \"type\": \"done\", \"request_id\": \"req-1\" } - { \"type\": \"done\", \"exit_code\": 0, \"state\": \"stopped\" }
      * Context WebSocket (I/O)
      */
     apiV1SandboxesIdContextsCtxIdWsGetRaw(requestParameters: ApiV1SandboxesIdContextsCtxIdWsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" }
+     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" } - { \"type\": \"done\", \"request_id\": \"req-1\" } - { \"type\": \"done\", \"exit_code\": 0, \"state\": \"stopped\" }
      * Context WebSocket (I/O)
      */
     apiV1SandboxesIdContextsCtxIdWsGet(requestParameters: ApiV1SandboxesIdContextsCtxIdWsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;

package/dist/apispec/src/apis/ContextsApi.js

@@ -336,7 +336,7 @@ export class ContextsApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" }
+     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" } - { \"type\": \"done\", \"request_id\": \"req-1\" } - { \"type\": \"done\", \"exit_code\": 0, \"state\": \"stopped\" }
      * Context WebSocket (I/O)
      */
     async apiV1SandboxesIdContextsCtxIdWsGetRaw(requestParameters, initOverrides) {
@@ -367,7 +367,7 @@ export class ContextsApi extends runtime.BaseAPI {
         return new runtime.VoidApiResponse(response);
     }
     /**
-     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" }
+     * Upgrades to WebSocket for streaming I/O. Client messages (JSON): - { \"type\": \"input\", \"data\": \"ls\\n\", \"request_id\": \"req-1\" } - { \"type\": \"resize\", \"rows\": 24, \"cols\": 80 } - { \"type\": \"signal\", \"signal\": \"INT\" } Server messages (JSON): - { \"type\": \"output\", \"source\": \"stdout\", \"data\": \"hello\\n\" } - { \"type\": \"done\", \"request_id\": \"req-1\" } - { \"type\": \"done\", \"exit_code\": 0, \"state\": \"stopped\" }
      * Context WebSocket (I/O)
      */
     async apiV1SandboxesIdContextsCtxIdWsGet(requestParameters, initOverrides) {

package/dist/apispec/src/models/AddTeamMemberRequest.d.ts

@@ -34,6 +34,7 @@ export interface AddTeamMemberRequest {
 export declare const AddTeamMemberRequestRoleEnum: {
     readonly Admin: "admin";
     readonly Developer: "developer";
+    readonly Builder: "builder";
     readonly Viewer: "viewer";
 };
 export type AddTeamMemberRequestRoleEnum = typeof AddTeamMemberRequestRoleEnum[keyof typeof AddTeamMemberRequestRoleEnum];

package/dist/apispec/src/models/AddTeamMemberRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AddTeamMemberRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/AddTeamMemberRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,EAAE,4BAA4B,CAAC;CACtC;AAGD;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAG1H;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,oBAAoB,CAI3F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE5E;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,oBAAoB,CAS/G;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE1E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAU9H"}
+{"version":3,"file":"AddTeamMemberRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/AddTeamMemberRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,EAAE,4BAA4B,CAAC;CACtC;AAGD;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;CAK/B,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAG1H;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,oBAAoB,CAI3F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE5E;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,oBAAoB,CAS/G;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE1E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAU9H"}

package/dist/apispec/src/models/AddTeamMemberRequest.js

@@ -17,6 +17,7 @@
 export const AddTeamMemberRequestRoleEnum = {
     Admin: 'admin',
     Developer: 'developer',
+    Builder: 'builder',
     Viewer: 'viewer'
 };
 /**

package/dist/apispec/src/models/ContextWebSocketDone.d.ts

@@ -22,11 +22,23 @@ export interface ContextWebSocketDone {
      */
     type: ContextWebSocketDoneTypeEnum;
     /**
-     *
+     * Present for request-scoped REPL completion events.
+     * @type {string}
+     * @memberof ContextWebSocketDone
+     */
+    requestId?: string;
+    /**
+     * Present when the underlying process has exited.
+     * @type {number}
+     * @memberof ContextWebSocketDone
+     */
+    exitCode?: number;
+    /**
+     * Final process state when the underlying process has exited.
      * @type {string}
      * @memberof ContextWebSocketDone
      */
-    requestId: string;
+    state?: string;
 }
 /**
  * @export

package/dist/apispec/src/models/ContextWebSocketDone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextWebSocketDone.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/ContextWebSocketDone.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,IAAI,EAAE,4BAA4B,CAAC;IACnC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB;AAGD;;GAEG;AACH,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAG1H;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,oBAAoB,CAI3F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE5E;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,oBAAoB,CAS/G;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE1E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAU9H"}
+{"version":3,"file":"ContextWebSocketDone.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/ContextWebSocketDone.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,IAAI,EAAE,4BAA4B,CAAC;IACnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD;;GAEG;AACH,eAAO,MAAM,4BAA4B;;CAE/B,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAG1H;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,oBAAoB,CAG3F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE5E;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,oBAAoB,CAW/G;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,oBAAoB,CAE1E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CAY9H"}

package/dist/apispec/src/models/ContextWebSocketDone.js

@@ -23,8 +23,6 @@ export const ContextWebSocketDoneTypeEnum = {
 export function instanceOfContextWebSocketDone(value) {
     if (!('type' in value) || value['type'] === undefined)
         return false;
-    if (!('requestId' in value) || value['requestId'] === undefined)
-        return false;
     return true;
 }
 export function ContextWebSocketDoneFromJSON(json) {
@@ -36,7 +34,9 @@ export function ContextWebSocketDoneFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'type': json['type'],
-        'requestId': json['request_id'],
+        'requestId': json['request_id'] == null ? undefined : json['request_id'],
+        'exitCode': json['exit_code'] == null ? undefined : json['exit_code'],
+        'state': json['state'] == null ? undefined : json['state'],
     };
 }
 export function ContextWebSocketDoneToJSON(json) {
@@ -49,5 +49,7 @@ export function ContextWebSocketDoneToJSONTyped(value, ignoreDiscriminator = fal
     return {
         'type': value['type'],
         'request_id': value['requestId'],
+        'exit_code': value['exitCode'],
+        'state': value['state'],
     };
 }

package/dist/apispec/src/models/ContextWebSocketOutput.d.ts

@@ -47,7 +47,7 @@ export type ContextWebSocketOutputTypeEnum = typeof ContextWebSocketOutputTypeEn
 export declare const ContextWebSocketOutputSourceEnum: {
     readonly Stdout: "stdout";
     readonly Stderr: "stderr";
-    readonly Prompt: "prompt";
+    readonly Pty: "pty";
 };
 export type ContextWebSocketOutputSourceEnum = typeof ContextWebSocketOutputSourceEnum[keyof typeof ContextWebSocketOutputSourceEnum];
 /**

package/dist/apispec/src/models/ContextWebSocketOutput.js

@@ -23,7 +23,7 @@ export const ContextWebSocketOutputTypeEnum = {
 export const ContextWebSocketOutputSourceEnum = {
     Stdout: 'stdout',
     Stderr: 'stderr',
-    Prompt: 'prompt'
+    Pty: 'pty'
 };
 /**
  * Check if a given object implements the ContextWebSocketOutput interface.

package/dist/apispec/src/models/UpdateTeamMemberRequest.d.ts

@@ -28,6 +28,7 @@ export interface UpdateTeamMemberRequest {
 export declare const UpdateTeamMemberRequestRoleEnum: {
     readonly Admin: "admin";
     readonly Developer: "developer";
+    readonly Builder: "builder";
     readonly Viewer: "viewer";
 };
 export type UpdateTeamMemberRequestRoleEnum = typeof UpdateTeamMemberRequestRoleEnum[keyof typeof UpdateTeamMemberRequestRoleEnum];

package/dist/apispec/src/models/UpdateTeamMemberRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpdateTeamMemberRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/UpdateTeamMemberRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,IAAI,EAAE,+BAA+B,CAAC;CACzC;AAGD;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;CAIlC,CAAC;AACX,MAAM,MAAM,+BAA+B,GAAG,OAAO,+BAA+B,CAAC,MAAM,OAAO,+BAA+B,CAAC,CAAC;AAGnI;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAGjG;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,GAAG,GAAG,uBAAuB,CAElF;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,uBAAuB,CAQrH;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,GAAG,GAAG,uBAAuB,CAEhF;AAED,wBAAgB,kCAAkC,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CASpI"}
+{"version":3,"file":"UpdateTeamMemberRequest.d.ts","sourceRoot":"","sources":["../../../../src/apispec/src/models/UpdateTeamMemberRequest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAGH;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,IAAI,EAAE,+BAA+B,CAAC;CACzC;AAGD;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;CAKlC,CAAC;AACX,MAAM,MAAM,+BAA+B,GAAG,OAAO,+BAA+B,CAAC,MAAM,OAAO,+BAA+B,CAAC,CAAC;AAGnI;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB,CAGjG;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,GAAG,GAAG,uBAAuB,CAElF;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,EAAE,OAAO,GAAG,uBAAuB,CAQrH;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,GAAG,GAAG,uBAAuB,CAEhF;AAED,wBAAgB,kCAAkC,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,IAAI,EAAE,mBAAmB,GAAE,OAAe,GAAG,GAAG,CASpI"}

package/dist/apispec/src/models/UpdateTeamMemberRequest.js

@@ -17,6 +17,7 @@
 export const UpdateTeamMemberRequestRoleEnum = {
     Admin: 'admin',
     Developer: 'developer',
+    Builder: 'builder',
     Viewer: 'viewer'
 };
 /**

package/dist/models.d.ts

@@ -23,6 +23,13 @@ export interface StreamOutput {
     source: string;
     data: string;
 }
+export interface StreamDone {
+    sandboxId: string;
+    contextId: string;
+    requestId?: string;
+    exitCode?: number;
+    state?: string;
+}
 export interface ExposedPort {
     port: number;
     resume: boolean;

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/sandbox.d.ts

@@ -1,6 +1,6 @@
 import type { MountStatus } from "./apispec/src/models/index.js";
 import type { Client } from "./client.js";
-import type { CmdResult, FileWatchResponse, RunResult, StreamInput, StreamOutput } from "./models.js";
+import type { CmdResult, FileWatchResponse, RunResult, StreamDone, StreamInput, StreamOutput } from "./models.js";
 import { WebSocketClient } from "./ws_client.js";
 export interface RunOptions {
     /**
@@ -63,9 +63,13 @@ type SandboxParams = {
 export declare class ContextStream {
     readonly readable: ReadableStream<StreamOutput>;
     readonly writable: WritableStream<StreamInput>;
+    readonly done: Promise<StreamDone>;
     private readonly socket;
     private readonly _contextId;
     private readonly _sandboxId;
+    private readonly resolveDone;
+    private readonly rejectDone;
+    private doneSettled;
     constructor(socket: WebSocketClient, sandboxId: string, contextId: string);
     get id(): string;
     /**
@@ -84,10 +88,16 @@ export declare class ContextStream {
      * Async generator for consuming outputs.
      */
     outputs(): AsyncGenerator<StreamOutput>;
+    /**
+     * Wait for the underlying process to finish.
+     */
+    wait(): Promise<StreamDone>;
     /**
      * Close the stream connection.
      */
     close(): void;
+    private settleDone;
+    private rejectPendingDone;
 }
 /**
  * FileWatchStream provides a stream interface for file system watch events.
@@ -142,6 +152,7 @@ export declare class Sandbox {
     constructor(params: SandboxParams);
     run(alias: string, input: string, options?: RunOptions): Promise<RunResult>;
     cmd(command: string, options?: CmdOptions): Promise<CmdResult>;
+    cmdStream(command: string, options?: CmdOptions): Promise<ContextStream>;
     connectWsContext(contextId: string): Promise<ContextStream>;
     private ensureReplContext;
 }

package/dist/sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"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"}

package/dist/sandbox.js

@@ -36,13 +36,25 @@ import { WebSocketClient } from "./ws_client.js";
 export class ContextStream {
     readable;
     writable;
+    done;
     socket;
     _contextId;
     _sandboxId;
+    resolveDone;
+    rejectDone;
+    doneSettled = false;
     constructor(socket, sandboxId, contextId) {
         this.socket = socket;
         this._sandboxId = sandboxId;
         this._contextId = contextId;
+        let resolveDone;
+        let rejectDone;
+        this.done = new Promise((resolve, reject) => {
+            resolveDone = resolve;
+            rejectDone = reject;
+        });
+        this.resolveDone = resolveDone;
+        this.rejectDone = rejectDone;
         // Create ReadableStream for outputs with backpressure
         this.readable = new ReadableStream({
             start: (controller) => {
@@ -50,6 +62,19 @@ export class ContextStream {
                     const payload = parseWsMessage(data);
                     if (!payload)
                         return;
+                    if (isTerminalDonePayload(payload)) {
+                        this.settleDone(buildStreamDone(this._sandboxId, this._contextId, payload));
+                        try {
+                            controller.close();
+                        }
+                        catch {
+                            // Controller may already be closed due to error.
+                        }
+                        socket.close();
+                        return;
+                    }
+                    if (payload.type && payload.type !== "output")
+                        return;
                     controller.enqueue({
                         sandboxId: this._sandboxId,
                         contextId: this._contextId,
@@ -58,9 +83,14 @@ export class ContextStream {
                     });
                 });
                 socket.onError((err) => {
+                    this.rejectPendingDone(err instanceof Error ? err : new Error("websocket error"));
                     controller.error(err instanceof Error ? err : new Error("websocket error"));
                 });
                 socket.onClose(() => {
+                    this.settleDone({
+                        sandboxId: this._sandboxId,
+                        contextId: this._contextId,
+                    });
                     try {
                         controller.close();
                     }
@@ -125,12 +155,30 @@ export class ContextStream {
             reader.releaseLock();
         }
     }
+    /**
+     * Wait for the underlying process to finish.
+     */
+    async wait() {
+        return this.done;
+    }
     /**
      * Close the stream connection.
      */
     close() {
         this.socket.close();
     }
+    settleDone(done) {
+        if (this.doneSettled)
+            return;
+        this.doneSettled = true;
+        this.resolveDone(done);
+    }
+    rejectPendingDone(reason) {
+        if (this.doneSettled)
+            return;
+        this.doneSettled = true;
+        this.rejectDone(reason);
+    }
 }
 /**
  * FileWatchStream provides a stream interface for file system watch events.
@@ -288,6 +336,35 @@ export class Sandbox {
             outputRaw: contextResp.outputRaw ?? "",
         };
     }
+    async cmdStream(command, options) {
+        if (options?.wait === true) {
+            throw new APIError({
+                statusCode: 0,
+                code: "invalid_argument",
+                message: "cmd stream requires wait=false",
+            });
+        }
+        const cmdArgs = options?.command ?? parseCommand(command);
+        if (!command.trim() || cmdArgs.length === 0) {
+            throw new APIError({
+                statusCode: 0,
+                code: "invalid_argument",
+                message: "command cannot be empty",
+            });
+        }
+        const request = {
+            type: models.ProcessType.Cmd,
+            cmd: { command: cmdArgs },
+            waitUntilDone: false,
+            cwd: options?.cwd,
+            envVars: options?.envVars,
+            ptySize: buildPty(options?.ptyRows, options?.ptyCols),
+            idleTimeoutSec: options?.idleTimeoutSec,
+            ttlSec: options?.ttlSec,
+        };
+        const contextResp = await this.createContext(request);
+        return this.connectWsContext(contextResp.id);
+    }
     async connectWsContext(contextId) {
         const wsUrl = this.client.websocketUrl(`/api/v1/sandboxes/${this.id}/contexts/${contextId}/ws`);
         const headers = await this.client.wsHeaders();
@@ -389,6 +466,24 @@ function parseWsMessage(data) {
         return null;
     }
 }
+function isTerminalDonePayload(payload) {
+    if (payload?.type !== "done") {
+        return false;
+    }
+    return !payload.request_id && !payload.requestId
+        || payload.exit_code !== undefined
+        || payload.exitCode !== undefined
+        || typeof payload.state === "string" && payload.state.length > 0;
+}
+function buildStreamDone(sandboxId, contextId, payload) {
+    return {
+        sandboxId,
+        contextId,
+        requestId: payload.request_id ?? payload.requestId,
+        exitCode: payload.exit_code ?? payload.exitCode,
+        state: typeof payload.state === "string" ? payload.state : undefined,
+    };
+}
 let requestCounter = 0;
 function generateRequestId() {
     requestCounter += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandbox0",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Sandbox0 JavaScript/TypeScript SDK",
   "license": "Apache-2.0",
   "author": "Sandbox0 Team",