@boatdev/sdk 1.5.0 → 1.6.0

package/.openapi-generator/FILES

@@ -62,6 +62,7 @@ docs/LimitsResponse.md
 docs/MeResponse.md
 docs/MeResponseAllOfUser.md
 docs/NamedSnapshot.md
+docs/NamedSnapshotAllowance.md
 docs/NamedSnapshotDeletedResponse.md
 docs/NamedSnapshotInfoResponse.md
 docs/NamedSnapshotListResponse.md
@@ -202,6 +203,7 @@ src/models/LimitsResponse.ts
 src/models/MeResponse.ts
 src/models/MeResponseAllOfUser.ts
 src/models/NamedSnapshot.ts
+src/models/NamedSnapshotAllowance.ts
 src/models/NamedSnapshotDeletedResponse.ts
 src/models/NamedSnapshotInfoResponse.ts
 src/models/NamedSnapshotListResponse.ts

package/dist/boat-helpers.d.ts

@@ -53,6 +53,12 @@ export declare function stopAndRemove(api: BoatApi, sandboxId: string, options?:
 }): Promise<import("./models").DeletionOperationResponse | import("./models").SandboxActionResponse>;
 export declare function readText(api: BoatApi, sandboxId: string, path: string): Promise<string>;
 export declare function writeText(api: BoatApi, sandboxId: string, path: string, content: string): Promise<import("./models").FileWriteResponse>;
+/**
+ * Run a command and return its result.
+ *
+ * Safe to call right after `resume()`: a refusal that never ran the command
+ * (`retryable: true`, the sandbox is still restoring) is resent for up to 60 s.
+ */
 export declare function execCommand(api: BoatApi, sandboxId: string, command: string, cwd?: string, timeoutSeconds?: number): Promise<import("./models").Command200Response>;
 /** One line of a streamed command, as sent (an `exit` frame also carries e.g. `signal`, `oomKilled`). */
 export type CommandFrame = CommandStreamFrame & Record<string, unknown>;

package/dist/boat-helpers.js

@@ -172,12 +172,36 @@ async function readText(api, sandboxId, path) {
 async function writeText(api, sandboxId, path, content) {
     return api.writeFile({ sandboxId, fileWriteRequest: { path, content, encoding: 'utf8' } });
 }
-async function execCommand(api, sandboxId, command, cwd, timeoutSeconds = 30) {
-    return api.command({ sandboxId, commandRequest: { command, cwd, timeoutSeconds } });
-}
 // A refusal that provably never ran the command (the sandbox is still restoring
-// its disk, `retryable: true` before `started`) is retried for this long.
+// its disk, `retryable: true`) is retried for this long.
 const STREAM_RETRY_MS = 60000;
+async function isRetryable(e) {
+    const response = e === null || e === void 0 ? void 0 : e.response;
+    if (!response)
+        return false;
+    const body = await response.clone().json().catch(() => undefined);
+    return (body === null || body === void 0 ? void 0 : body.retryable) === true;
+}
+/**
+ * Run a command and return its result.
+ *
+ * Safe to call right after `resume()`: a refusal that never ran the command
+ * (`retryable: true`, the sandbox is still restoring) is resent for up to 60 s.
+ */
+async function execCommand(api, sandboxId, command, cwd, timeoutSeconds = 30) {
+    const deadline = Date.now() + STREAM_RETRY_MS;
+    for (;;) {
+        try {
+            return await api.command({ sandboxId, commandRequest: { command, cwd, timeoutSeconds } });
+        }
+        catch (e) {
+            // The 1 s pause before the resend must also fit before the deadline.
+            if (Date.now() + 1000 >= deadline || !(await isRetryable(e)))
+                throw e;
+        }
+        await delay(1000);
+    }
+}
 async function* ndjsonFrames(response) {
     if (!response.body)
         throw new Error('The command stream has no body');

package/dist/esm/boat-helpers.d.ts

@@ -53,6 +53,12 @@ export declare function stopAndRemove(api: BoatApi, sandboxId: string, options?:
 }): Promise<import("./models").DeletionOperationResponse | import("./models").SandboxActionResponse>;
 export declare function readText(api: BoatApi, sandboxId: string, path: string): Promise<string>;
 export declare function writeText(api: BoatApi, sandboxId: string, path: string, content: string): Promise<import("./models").FileWriteResponse>;
+/**
+ * Run a command and return its result.
+ *
+ * Safe to call right after `resume()`: a refusal that never ran the command
+ * (`retryable: true`, the sandbox is still restoring) is resent for up to 60 s.
+ */
 export declare function execCommand(api: BoatApi, sandboxId: string, command: string, cwd?: string, timeoutSeconds?: number): Promise<import("./models").Command200Response>;
 /** One line of a streamed command, as sent (an `exit` frame also carries e.g. `signal`, `oomKilled`). */
 export type CommandFrame = CommandStreamFrame & Record<string, unknown>;

package/dist/esm/boat-helpers.js

@@ -158,12 +158,36 @@ export async function readText(api, sandboxId, path) {
 export async function writeText(api, sandboxId, path, content) {
     return api.writeFile({ sandboxId, fileWriteRequest: { path, content, encoding: 'utf8' } });
 }
-export async function execCommand(api, sandboxId, command, cwd, timeoutSeconds = 30) {
-    return api.command({ sandboxId, commandRequest: { command, cwd, timeoutSeconds } });
-}
 // A refusal that provably never ran the command (the sandbox is still restoring
-// its disk, `retryable: true` before `started`) is retried for this long.
+// its disk, `retryable: true`) is retried for this long.
 const STREAM_RETRY_MS = 60000;
+async function isRetryable(e) {
+    const response = e === null || e === void 0 ? void 0 : e.response;
+    if (!response)
+        return false;
+    const body = await response.clone().json().catch(() => undefined);
+    return (body === null || body === void 0 ? void 0 : body.retryable) === true;
+}
+/**
+ * Run a command and return its result.
+ *
+ * Safe to call right after `resume()`: a refusal that never ran the command
+ * (`retryable: true`, the sandbox is still restoring) is resent for up to 60 s.
+ */
+export async function execCommand(api, sandboxId, command, cwd, timeoutSeconds = 30) {
+    const deadline = Date.now() + STREAM_RETRY_MS;
+    for (;;) {
+        try {
+            return await api.command({ sandboxId, commandRequest: { command, cwd, timeoutSeconds } });
+        }
+        catch (e) {
+            // The 1 s pause before the resend must also fit before the deadline.
+            if (Date.now() + 1000 >= deadline || !(await isRetryable(e)))
+                throw e;
+        }
+        await delay(1000);
+    }
+}
 async function* ndjsonFrames(response) {
     if (!response.body)
         throw new Error('The command stream has no body');

package/dist/esm/models/NamedSnapshotAllowance.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * What the request's wallet (your active organization, `?org=`, or personal) pays for named snapshots. 10 are free per wallet; each one above costs $1.70 a month, charged daily from usage. An organization's count includes every member's names billed to it.
+ * @export
+ * @interface NamedSnapshotAllowance
+ */
+export interface NamedSnapshotAllowance {
+    /**
+     * Organization the numbers are for. null = personal.
+     * @type {string}
+     * @memberof NamedSnapshotAllowance
+     */
+    org?: string | null;
+    /**
+     * That organization's name.
+     * @type {string}
+     * @memberof NamedSnapshotAllowance
+     */
+    orgName?: string | null;
+    /**
+     * Named snapshots kept for free.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    free?: number;
+    /**
+     * Named snapshots this wallet keeps.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    used?: number;
+    /**
+     * Named snapshots above the free ones.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extra?: number;
+    /**
+     * What the extra ones cost per month.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extraMonthlyDollars?: number;
+    /**
+     * Boat time the extra ones take per day, in dollars (the daily charge).
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extraDailyDollars?: number;
+    /**
+     * Monthly price of one extra named snapshot.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    pricePerExtraMonthlyDollars?: number;
+}
+/**
+ * Check if a given object implements the NamedSnapshotAllowance interface.
+ */
+export declare function instanceOfNamedSnapshotAllowance(value: object): value is NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceFromJSON(json: any): NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceFromJSONTyped(json: any, ignoreDiscriminator: boolean): NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceToJSON(json: any): NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceToJSONTyped(value?: NamedSnapshotAllowance | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/NamedSnapshotAllowance.js

@@ -0,0 +1,55 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Check if a given object implements the NamedSnapshotAllowance interface.
+ */
+export function instanceOfNamedSnapshotAllowance(value) {
+    return true;
+}
+export function NamedSnapshotAllowanceFromJSON(json) {
+    return NamedSnapshotAllowanceFromJSONTyped(json, false);
+}
+export function NamedSnapshotAllowanceFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'org': json['org'] == null ? undefined : json['org'],
+        'orgName': json['orgName'] == null ? undefined : json['orgName'],
+        'free': json['free'] == null ? undefined : json['free'],
+        'used': json['used'] == null ? undefined : json['used'],
+        'extra': json['extra'] == null ? undefined : json['extra'],
+        'extraMonthlyDollars': json['extraMonthlyDollars'] == null ? undefined : json['extraMonthlyDollars'],
+        'extraDailyDollars': json['extraDailyDollars'] == null ? undefined : json['extraDailyDollars'],
+        'pricePerExtraMonthlyDollars': json['pricePerExtraMonthlyDollars'] == null ? undefined : json['pricePerExtraMonthlyDollars'],
+    };
+}
+export function NamedSnapshotAllowanceToJSON(json) {
+    return NamedSnapshotAllowanceToJSONTyped(json, false);
+}
+export function NamedSnapshotAllowanceToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'org': value['org'],
+        'orgName': value['orgName'],
+        'free': value['free'],
+        'used': value['used'],
+        'extra': value['extra'],
+        'extraMonthlyDollars': value['extraMonthlyDollars'],
+        'extraDailyDollars': value['extraDailyDollars'],
+        'pricePerExtraMonthlyDollars': value['pricePerExtraMonthlyDollars'],
+    };
+}

package/dist/esm/models/NamedSnapshotListResponse.d.ts

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { NamedSnapshotAllowance } from './NamedSnapshotAllowance';
 import type { NamedSnapshot } from './NamedSnapshot';
 /**
  *
@@ -34,6 +35,12 @@ export interface NamedSnapshotListResponse {
      * @memberof NamedSnapshotListResponse
      */
     snapshots: Array<NamedSnapshot>;
+    /**
+     *
+     * @type {NamedSnapshotAllowance}
+     * @memberof NamedSnapshotListResponse
+     */
+    allowance?: NamedSnapshotAllowance;
 }
 /**
  * @export

package/dist/esm/models/NamedSnapshotListResponse.js

@@ -11,6 +11,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { NamedSnapshotAllowanceFromJSON, NamedSnapshotAllowanceToJSON, } from './NamedSnapshotAllowance';
 import { NamedSnapshotFromJSON, NamedSnapshotToJSON, } from './NamedSnapshot';
 /**
  * @export
@@ -41,6 +42,7 @@ export function NamedSnapshotListResponseFromJSONTyped(json, ignoreDiscriminator
         'ok': json['ok'],
         'type': json['type'],
         'snapshots': (json['snapshots'].map(NamedSnapshotFromJSON)),
+        'allowance': json['allowance'] == null ? undefined : NamedSnapshotAllowanceFromJSON(json['allowance']),
     };
 }
 export function NamedSnapshotListResponseToJSON(json) {
@@ -54,5 +56,6 @@ export function NamedSnapshotListResponseToJSONTyped(value, ignoreDiscriminator
         'ok': value['ok'],
         'type': value['type'],
         'snapshots': (value['snapshots'].map(NamedSnapshotToJSON)),
+        'allowance': NamedSnapshotAllowanceToJSON(value['allowance']),
     };
 }

package/dist/esm/models/index.d.ts

@@ -57,6 +57,7 @@ export * from './LimitsResponse';
 export * from './MeResponse';
 export * from './MeResponseAllOfUser';
 export * from './NamedSnapshot';
+export * from './NamedSnapshotAllowance';
 export * from './NamedSnapshotDeletedResponse';
 export * from './NamedSnapshotInfoResponse';
 export * from './NamedSnapshotListResponse';

package/dist/esm/models/index.js

@@ -59,6 +59,7 @@ export * from './LimitsResponse';
 export * from './MeResponse';
 export * from './MeResponseAllOfUser';
 export * from './NamedSnapshot';
+export * from './NamedSnapshotAllowance';
 export * from './NamedSnapshotDeletedResponse';
 export * from './NamedSnapshotInfoResponse';
 export * from './NamedSnapshotListResponse';

package/dist/models/NamedSnapshotAllowance.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * What the request's wallet (your active organization, `?org=`, or personal) pays for named snapshots. 10 are free per wallet; each one above costs $1.70 a month, charged daily from usage. An organization's count includes every member's names billed to it.
+ * @export
+ * @interface NamedSnapshotAllowance
+ */
+export interface NamedSnapshotAllowance {
+    /**
+     * Organization the numbers are for. null = personal.
+     * @type {string}
+     * @memberof NamedSnapshotAllowance
+     */
+    org?: string | null;
+    /**
+     * That organization's name.
+     * @type {string}
+     * @memberof NamedSnapshotAllowance
+     */
+    orgName?: string | null;
+    /**
+     * Named snapshots kept for free.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    free?: number;
+    /**
+     * Named snapshots this wallet keeps.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    used?: number;
+    /**
+     * Named snapshots above the free ones.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extra?: number;
+    /**
+     * What the extra ones cost per month.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extraMonthlyDollars?: number;
+    /**
+     * Boat time the extra ones take per day, in dollars (the daily charge).
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extraDailyDollars?: number;
+    /**
+     * Monthly price of one extra named snapshot.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    pricePerExtraMonthlyDollars?: number;
+}
+/**
+ * Check if a given object implements the NamedSnapshotAllowance interface.
+ */
+export declare function instanceOfNamedSnapshotAllowance(value: object): value is NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceFromJSON(json: any): NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceFromJSONTyped(json: any, ignoreDiscriminator: boolean): NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceToJSON(json: any): NamedSnapshotAllowance;
+export declare function NamedSnapshotAllowanceToJSONTyped(value?: NamedSnapshotAllowance | null, ignoreDiscriminator?: boolean): any;

package/dist/models/NamedSnapshotAllowance.js

@@ -0,0 +1,62 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfNamedSnapshotAllowance = instanceOfNamedSnapshotAllowance;
+exports.NamedSnapshotAllowanceFromJSON = NamedSnapshotAllowanceFromJSON;
+exports.NamedSnapshotAllowanceFromJSONTyped = NamedSnapshotAllowanceFromJSONTyped;
+exports.NamedSnapshotAllowanceToJSON = NamedSnapshotAllowanceToJSON;
+exports.NamedSnapshotAllowanceToJSONTyped = NamedSnapshotAllowanceToJSONTyped;
+/**
+ * Check if a given object implements the NamedSnapshotAllowance interface.
+ */
+function instanceOfNamedSnapshotAllowance(value) {
+    return true;
+}
+function NamedSnapshotAllowanceFromJSON(json) {
+    return NamedSnapshotAllowanceFromJSONTyped(json, false);
+}
+function NamedSnapshotAllowanceFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'org': json['org'] == null ? undefined : json['org'],
+        'orgName': json['orgName'] == null ? undefined : json['orgName'],
+        'free': json['free'] == null ? undefined : json['free'],
+        'used': json['used'] == null ? undefined : json['used'],
+        'extra': json['extra'] == null ? undefined : json['extra'],
+        'extraMonthlyDollars': json['extraMonthlyDollars'] == null ? undefined : json['extraMonthlyDollars'],
+        'extraDailyDollars': json['extraDailyDollars'] == null ? undefined : json['extraDailyDollars'],
+        'pricePerExtraMonthlyDollars': json['pricePerExtraMonthlyDollars'] == null ? undefined : json['pricePerExtraMonthlyDollars'],
+    };
+}
+function NamedSnapshotAllowanceToJSON(json) {
+    return NamedSnapshotAllowanceToJSONTyped(json, false);
+}
+function NamedSnapshotAllowanceToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'org': value['org'],
+        'orgName': value['orgName'],
+        'free': value['free'],
+        'used': value['used'],
+        'extra': value['extra'],
+        'extraMonthlyDollars': value['extraMonthlyDollars'],
+        'extraDailyDollars': value['extraDailyDollars'],
+        'pricePerExtraMonthlyDollars': value['pricePerExtraMonthlyDollars'],
+    };
+}

package/dist/models/NamedSnapshotListResponse.d.ts

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { NamedSnapshotAllowance } from './NamedSnapshotAllowance';
 import type { NamedSnapshot } from './NamedSnapshot';
 /**
  *
@@ -34,6 +35,12 @@ export interface NamedSnapshotListResponse {
      * @memberof NamedSnapshotListResponse
      */
     snapshots: Array<NamedSnapshot>;
+    /**
+     *
+     * @type {NamedSnapshotAllowance}
+     * @memberof NamedSnapshotListResponse
+     */
+    allowance?: NamedSnapshotAllowance;
 }
 /**
  * @export

package/dist/models/NamedSnapshotListResponse.js

@@ -19,6 +19,7 @@ exports.NamedSnapshotListResponseFromJSON = NamedSnapshotListResponseFromJSON;
 exports.NamedSnapshotListResponseFromJSONTyped = NamedSnapshotListResponseFromJSONTyped;
 exports.NamedSnapshotListResponseToJSON = NamedSnapshotListResponseToJSON;
 exports.NamedSnapshotListResponseToJSONTyped = NamedSnapshotListResponseToJSONTyped;
+const NamedSnapshotAllowance_1 = require("./NamedSnapshotAllowance");
 const NamedSnapshot_1 = require("./NamedSnapshot");
 /**
  * @export
@@ -49,6 +50,7 @@ function NamedSnapshotListResponseFromJSONTyped(json, ignoreDiscriminator) {
         'ok': json['ok'],
         'type': json['type'],
         'snapshots': (json['snapshots'].map(NamedSnapshot_1.NamedSnapshotFromJSON)),
+        'allowance': json['allowance'] == null ? undefined : (0, NamedSnapshotAllowance_1.NamedSnapshotAllowanceFromJSON)(json['allowance']),
     };
 }
 function NamedSnapshotListResponseToJSON(json) {
@@ -62,5 +64,6 @@ function NamedSnapshotListResponseToJSONTyped(value, ignoreDiscriminator = false
         'ok': value['ok'],
         'type': value['type'],
         'snapshots': (value['snapshots'].map(NamedSnapshot_1.NamedSnapshotToJSON)),
+        'allowance': (0, NamedSnapshotAllowance_1.NamedSnapshotAllowanceToJSON)(value['allowance']),
     };
 }

package/dist/models/index.d.ts

@@ -57,6 +57,7 @@ export * from './LimitsResponse';
 export * from './MeResponse';
 export * from './MeResponseAllOfUser';
 export * from './NamedSnapshot';
+export * from './NamedSnapshotAllowance';
 export * from './NamedSnapshotDeletedResponse';
 export * from './NamedSnapshotInfoResponse';
 export * from './NamedSnapshotListResponse';

package/dist/models/index.js

@@ -75,6 +75,7 @@ __exportStar(require("./LimitsResponse"), exports);
 __exportStar(require("./MeResponse"), exports);
 __exportStar(require("./MeResponseAllOfUser"), exports);
 __exportStar(require("./NamedSnapshot"), exports);
+__exportStar(require("./NamedSnapshotAllowance"), exports);
 __exportStar(require("./NamedSnapshotDeletedResponse"), exports);
 __exportStar(require("./NamedSnapshotInfoResponse"), exports);
 __exportStar(require("./NamedSnapshotListResponse"), exports);

package/docs/BoatApi.md

@@ -3983,7 +3983,8 @@ example().catch(console.error);
 | **400** | Invalid request body or parameters. |  -  |
 | **401** | Missing or invalid bearer token. |  -  |
 | **404** | Resource not found. |  -  |
-| **409** | `named_snapshot_limit` when you already keep the maximum of 10 named snapshots; remove one first. `save_in_progress` when a save under this name is already running; wait for it to settle rather than retrying immediately. |  -  |
+| **402** | `credit_required`: the wallet already keeps 10 or more named snapshots and has no credit left. Each named snapshot above the free 10 costs $1.70 a month, charged daily. Add credit or remove one. |  -  |
+| **409** | `save_in_progress` when a save under this name is already running; wait for it to settle rather than retrying immediately. |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 

package/docs/NamedSnapshotAllowance.md

@@ -0,0 +1,47 @@
+
+# NamedSnapshotAllowance
+
+What the request\'s wallet (your active organization, `?org=`, or personal) pays for named snapshots. 10 are free per wallet; each one above costs $1.70 a month, charged daily from usage. An organization\'s count includes every member\'s names billed to it.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`org` | string
+`orgName` | string
+`free` | number
+`used` | number
+`extra` | number
+`extraMonthlyDollars` | number
+`extraDailyDollars` | number
+`pricePerExtraMonthlyDollars` | number
+
+## Example
+
+```typescript
+import type { NamedSnapshotAllowance } from '@boatdev/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "org": null,
+  "orgName": null,
+  "free": null,
+  "used": null,
+  "extra": null,
+  "extraMonthlyDollars": null,
+  "extraDailyDollars": null,
+  "pricePerExtraMonthlyDollars": null,
+} satisfies NamedSnapshotAllowance
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as NamedSnapshotAllowance
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)

package/docs/NamedSnapshotListResponse.md

@@ -9,6 +9,7 @@ Name | Type
 `ok` | boolean
 `type` | string
 `snapshots` | [Array<NamedSnapshot>](NamedSnapshot.md)
+`allowance` | [NamedSnapshotAllowance](NamedSnapshotAllowance.md)
 
 ## Example
 
@@ -20,6 +21,7 @@ const example = {
   "ok": null,
   "type": null,
   "snapshots": null,
+  "allowance": null,
 } satisfies NamedSnapshotListResponse
 
 console.log(example)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boatdev/sdk",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "OpenAPI client for @boatdev/sdk",
   "author": "OpenAPI-Generator",
   "license": "MIT",

package/src/boat-helpers.ts

@@ -182,8 +182,34 @@ export async function writeText(api: BoatApi, sandboxId: string, path: string, c
   return api.writeFile({ sandboxId, fileWriteRequest: { path, content, encoding: 'utf8' } });
 }
 
+// A refusal that provably never ran the command (the sandbox is still restoring
+// its disk, `retryable: true`) is retried for this long.
+const STREAM_RETRY_MS = 60_000;
+
+async function isRetryable(e: unknown): Promise<boolean> {
+  const response = (e as { response?: Response })?.response;
+  if (!response) return false;
+  const body = await response.clone().json().catch(() => undefined);
+  return body?.retryable === true;
+}
+
+/**
+ * Run a command and return its result.
+ *
+ * Safe to call right after `resume()`: a refusal that never ran the command
+ * (`retryable: true`, the sandbox is still restoring) is resent for up to 60 s.
+ */
 export async function execCommand(api: BoatApi, sandboxId: string, command: string, cwd?: string, timeoutSeconds = 30) {
-  return api.command({ sandboxId, commandRequest: { command, cwd, timeoutSeconds } });
+  const deadline = Date.now() + STREAM_RETRY_MS;
+  for (;;) {
+    try {
+      return await api.command({ sandboxId, commandRequest: { command, cwd, timeoutSeconds } });
+    } catch (e) {
+      // The 1 s pause before the resend must also fit before the deadline.
+      if (Date.now() + 1_000 >= deadline || !(await isRetryable(e))) throw e;
+    }
+    await delay(1_000);
+  }
 }
 
 /** One line of a streamed command, as sent (an `exit` frame also carries e.g. `signal`, `oomKilled`). */
@@ -195,10 +221,6 @@ export type StreamCommandOptions = {
   signal?: AbortSignal;
 };
 
-// A refusal that provably never ran the command (the sandbox is still restoring
-// its disk, `retryable: true` before `started`) is retried for this long.
-const STREAM_RETRY_MS = 60_000;
-
 async function* ndjsonFrames(response: Response): AsyncGenerator<CommandFrame> {
   if (!response.body) throw new Error('The command stream has no body');
   const reader = response.body.getReader();

package/src/models/NamedSnapshotAllowance.ts

@@ -0,0 +1,121 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Boat Public API v1
+ * Public JSON API for creating, operating, prompting, observing, and exposing sandboxes from backend services, CI jobs, hosted workers, and Boat automation products.  The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * What the request's wallet (your active organization, `?org=`, or personal) pays for named snapshots. 10 are free per wallet; each one above costs $1.70 a month, charged daily from usage. An organization's count includes every member's names billed to it.
+ * @export
+ * @interface NamedSnapshotAllowance
+ */
+export interface NamedSnapshotAllowance {
+    /**
+     * Organization the numbers are for. null = personal.
+     * @type {string}
+     * @memberof NamedSnapshotAllowance
+     */
+    org?: string | null;
+    /**
+     * That organization's name.
+     * @type {string}
+     * @memberof NamedSnapshotAllowance
+     */
+    orgName?: string | null;
+    /**
+     * Named snapshots kept for free.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    free?: number;
+    /**
+     * Named snapshots this wallet keeps.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    used?: number;
+    /**
+     * Named snapshots above the free ones.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extra?: number;
+    /**
+     * What the extra ones cost per month.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extraMonthlyDollars?: number;
+    /**
+     * Boat time the extra ones take per day, in dollars (the daily charge).
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    extraDailyDollars?: number;
+    /**
+     * Monthly price of one extra named snapshot.
+     * @type {number}
+     * @memberof NamedSnapshotAllowance
+     */
+    pricePerExtraMonthlyDollars?: number;
+}
+
+/**
+ * Check if a given object implements the NamedSnapshotAllowance interface.
+ */
+export function instanceOfNamedSnapshotAllowance(value: object): value is NamedSnapshotAllowance {
+    return true;
+}
+
+export function NamedSnapshotAllowanceFromJSON(json: any): NamedSnapshotAllowance {
+    return NamedSnapshotAllowanceFromJSONTyped(json, false);
+}
+
+export function NamedSnapshotAllowanceFromJSONTyped(json: any, ignoreDiscriminator: boolean): NamedSnapshotAllowance {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'org': json['org'] == null ? undefined : json['org'],
+        'orgName': json['orgName'] == null ? undefined : json['orgName'],
+        'free': json['free'] == null ? undefined : json['free'],
+        'used': json['used'] == null ? undefined : json['used'],
+        'extra': json['extra'] == null ? undefined : json['extra'],
+        'extraMonthlyDollars': json['extraMonthlyDollars'] == null ? undefined : json['extraMonthlyDollars'],
+        'extraDailyDollars': json['extraDailyDollars'] == null ? undefined : json['extraDailyDollars'],
+        'pricePerExtraMonthlyDollars': json['pricePerExtraMonthlyDollars'] == null ? undefined : json['pricePerExtraMonthlyDollars'],
+    };
+}
+
+export function NamedSnapshotAllowanceToJSON(json: any): NamedSnapshotAllowance {
+    return NamedSnapshotAllowanceToJSONTyped(json, false);
+}
+
+export function NamedSnapshotAllowanceToJSONTyped(value?: NamedSnapshotAllowance | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'org': value['org'],
+        'orgName': value['orgName'],
+        'free': value['free'],
+        'used': value['used'],
+        'extra': value['extra'],
+        'extraMonthlyDollars': value['extraMonthlyDollars'],
+        'extraDailyDollars': value['extraDailyDollars'],
+        'pricePerExtraMonthlyDollars': value['pricePerExtraMonthlyDollars'],
+    };
+}
+

package/src/models/NamedSnapshotListResponse.ts

@@ -13,6 +13,13 @@
  */
 
 import { mapValues } from '../runtime';
+import type { NamedSnapshotAllowance } from './NamedSnapshotAllowance';
+import {
+    NamedSnapshotAllowanceFromJSON,
+    NamedSnapshotAllowanceFromJSONTyped,
+    NamedSnapshotAllowanceToJSON,
+    NamedSnapshotAllowanceToJSONTyped,
+} from './NamedSnapshotAllowance';
 import type { NamedSnapshot } from './NamedSnapshot';
 import {
     NamedSnapshotFromJSON,
@@ -45,6 +52,12 @@ export interface NamedSnapshotListResponse {
      * @memberof NamedSnapshotListResponse
      */
     snapshots: Array<NamedSnapshot>;
+    /**
+     * 
+     * @type {NamedSnapshotAllowance}
+     * @memberof NamedSnapshotListResponse
+     */
+    allowance?: NamedSnapshotAllowance;
 }
 
 
@@ -80,6 +93,7 @@ export function NamedSnapshotListResponseFromJSONTyped(json: any, ignoreDiscrimi
         'ok': json['ok'],
         'type': json['type'],
         'snapshots': ((json['snapshots'] as Array<any>).map(NamedSnapshotFromJSON)),
+        'allowance': json['allowance'] == null ? undefined : NamedSnapshotAllowanceFromJSON(json['allowance']),
     };
 }
 
@@ -97,6 +111,7 @@ export function NamedSnapshotListResponseToJSONTyped(value?: NamedSnapshotListRe
         'ok': value['ok'],
         'type': value['type'],
         'snapshots': ((value['snapshots'] as Array<any>).map(NamedSnapshotToJSON)),
+        'allowance': NamedSnapshotAllowanceToJSON(value['allowance']),
     };
 }
 

package/src/models/index.ts

@@ -59,6 +59,7 @@ export * from './LimitsResponse';
 export * from './MeResponse';
 export * from './MeResponseAllOfUser';
 export * from './NamedSnapshot';
+export * from './NamedSnapshotAllowance';
 export * from './NamedSnapshotDeletedResponse';
 export * from './NamedSnapshotInfoResponse';
 export * from './NamedSnapshotListResponse';