@boatdev/sdk 1.4.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
@@ -104,6 +105,7 @@ docs/SecretsUpdateRequest.md
 docs/SelectedRepository.md
 docs/SetEnvironmentSecretFileRequest.md
 docs/SetEnvironmentVarRequest.md
+docs/Share200Response.md
 docs/SnapshotChunk.md
 docs/SnapshotDownloadResponse.md
 docs/SnapshotDownloadResponseAllOfInventory.md
@@ -201,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
@@ -243,6 +246,7 @@ src/models/SecretsUpdateRequest.ts
 src/models/SelectedRepository.ts
 src/models/SetEnvironmentSecretFileRequest.ts
 src/models/SetEnvironmentVarRequest.ts
+src/models/Share200Response.ts
 src/models/SnapshotChunk.ts
 src/models/SnapshotDownloadResponse.ts
 src/models/SnapshotDownloadResponseAllOfInventory.ts

package/dist/apis/BoatApi.d.ts

@@ -64,6 +64,7 @@ import { type SecretsResponse } from '../models/SecretsResponse';
 import { type SecretsUpdateRequest } from '../models/SecretsUpdateRequest';
 import { type SetEnvironmentSecretFileRequest } from '../models/SetEnvironmentSecretFileRequest';
 import { type SetEnvironmentVarRequest } from '../models/SetEnvironmentVarRequest';
+import { type Share200Response } from '../models/Share200Response';
 import { type SnapshotDownloadResponse } from '../models/SnapshotDownloadResponse';
 import { type SnapshotLatestResponse } from '../models/SnapshotLatestResponse';
 import { type SnapshotListResponse } from '../models/SnapshotListResponse';
@@ -257,6 +258,8 @@ export interface RotateWebhookSigningSecretRequest {
     webhookId: string;
 }
 export interface SandboxesRequest {
+    org?: string;
+    xBoatOrg?: string;
     limit?: number;
     cursor?: string | null;
     sort?: SandboxesSortEnum;
@@ -280,6 +283,9 @@ export interface SetEnvironmentVarOperationRequest {
     key: string;
     setEnvironmentVarRequest: SetEnvironmentVarRequest;
 }
+export interface ShareRequest {
+    sandboxId: string;
+}
 export interface SshKeyOperationRequest {
     sandboxId: string;
     sshKeyRequest: SshKeyRequest;
@@ -1023,10 +1029,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     sandboxesRequestOpts(requestParameters: SandboxesRequest): Promise<runtime.RequestOpts>;
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     sandboxesRaw(requestParameters: SandboxesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SandboxListResponse>>;
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     sandboxes(requestParameters?: SandboxesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SandboxListResponse>;
@@ -1114,6 +1122,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Set one environment variable
      */
     setEnvironmentVar(requestParameters: SetEnvironmentVarOperationRequest | runtime.FlatBody<SetEnvironmentVarOperationRequest, 'setEnvironmentVarRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EnvironmentItemChangeResponse>;
+    /**
+     * Creates request options for share without sending the request
+     */
+    shareRequestOpts(requestParameters: ShareRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    shareRaw(requestParameters: ShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Share200Response>>;
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    share(requestParameters: ShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Share200Response>;
     /**
      * Creates request options for sshKey without sending the request
      */

package/dist/apis/BoatApi.js

@@ -102,6 +102,7 @@ const SecretsResponse_1 = require("../models/SecretsResponse");
 const SecretsUpdateRequest_1 = require("../models/SecretsUpdateRequest");
 const SetEnvironmentSecretFileRequest_1 = require("../models/SetEnvironmentSecretFileRequest");
 const SetEnvironmentVarRequest_1 = require("../models/SetEnvironmentVarRequest");
+const Share200Response_1 = require("../models/Share200Response");
 const SnapshotDownloadResponse_1 = require("../models/SnapshotDownloadResponse");
 const SnapshotLatestResponse_1 = require("../models/SnapshotLatestResponse");
 const SnapshotListResponse_1 = require("../models/SnapshotListResponse");
@@ -2360,6 +2361,9 @@ class BoatApi extends runtime.BaseAPI {
      */
     async sandboxesRequestOpts(requestParameters) {
         const queryParameters = {};
+        if (requestParameters['org'] != null) {
+            queryParameters['org'] = requestParameters['org'];
+        }
         if (requestParameters['limit'] != null) {
             queryParameters['limit'] = requestParameters['limit'];
         }
@@ -2373,6 +2377,9 @@ class BoatApi extends runtime.BaseAPI {
             queryParameters['state'] = requestParameters['state'];
         }
         const headerParameters = {};
+        if (requestParameters['xBoatOrg'] != null) {
+            headerParameters['X-Boat-Org'] = String(requestParameters['xBoatOrg']);
+        }
         if (this.configuration && this.configuration.accessToken) {
             const token = this.configuration.accessToken;
             const tokenString = await token("BoatBearerAuth", []);
@@ -2389,6 +2396,7 @@ class BoatApi extends runtime.BaseAPI {
         };
     }
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     async sandboxesRaw(requestParameters, initOverrides) {
@@ -2397,6 +2405,7 @@ class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, SandboxListResponse_1.SandboxListResponseFromJSON)(jsonValue));
     }
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     async sandboxes(requestParameters = {}, initOverrides) {
@@ -2673,6 +2682,48 @@ class BoatApi extends runtime.BaseAPI {
         const response = await this.setEnvironmentVarRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for share without sending the request
+     */
+    async shareRequestOpts(requestParameters) {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError('sandboxId', 'Required parameter "sandboxId" was null or undefined when calling share().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/sandboxes/{sandboxId}/share`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    async shareRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.shareRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, Share200Response_1.Share200ResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    async share(requestParameters, initOverrides) {
+        const response = await this.shareRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for sshKey without sending the request
      */

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/apis/BoatApi.d.ts

@@ -64,6 +64,7 @@ import { type SecretsResponse } from '../models/SecretsResponse';
 import { type SecretsUpdateRequest } from '../models/SecretsUpdateRequest';
 import { type SetEnvironmentSecretFileRequest } from '../models/SetEnvironmentSecretFileRequest';
 import { type SetEnvironmentVarRequest } from '../models/SetEnvironmentVarRequest';
+import { type Share200Response } from '../models/Share200Response';
 import { type SnapshotDownloadResponse } from '../models/SnapshotDownloadResponse';
 import { type SnapshotLatestResponse } from '../models/SnapshotLatestResponse';
 import { type SnapshotListResponse } from '../models/SnapshotListResponse';
@@ -257,6 +258,8 @@ export interface RotateWebhookSigningSecretRequest {
     webhookId: string;
 }
 export interface SandboxesRequest {
+    org?: string;
+    xBoatOrg?: string;
     limit?: number;
     cursor?: string | null;
     sort?: SandboxesSortEnum;
@@ -280,6 +283,9 @@ export interface SetEnvironmentVarOperationRequest {
     key: string;
     setEnvironmentVarRequest: SetEnvironmentVarRequest;
 }
+export interface ShareRequest {
+    sandboxId: string;
+}
 export interface SshKeyOperationRequest {
     sandboxId: string;
     sshKeyRequest: SshKeyRequest;
@@ -1023,10 +1029,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     sandboxesRequestOpts(requestParameters: SandboxesRequest): Promise<runtime.RequestOpts>;
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     sandboxesRaw(requestParameters: SandboxesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SandboxListResponse>>;
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     sandboxes(requestParameters?: SandboxesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SandboxListResponse>;
@@ -1114,6 +1122,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Set one environment variable
      */
     setEnvironmentVar(requestParameters: SetEnvironmentVarOperationRequest | runtime.FlatBody<SetEnvironmentVarOperationRequest, 'setEnvironmentVarRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EnvironmentItemChangeResponse>;
+    /**
+     * Creates request options for share without sending the request
+     */
+    shareRequestOpts(requestParameters: ShareRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    shareRaw(requestParameters: ShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Share200Response>>;
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    share(requestParameters: ShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Share200Response>;
     /**
      * Creates request options for sshKey without sending the request
      */

package/dist/esm/apis/BoatApi.js

@@ -66,6 +66,7 @@ import { SecretsResponseFromJSON, } from '../models/SecretsResponse';
 import { SecretsUpdateRequestToJSON, } from '../models/SecretsUpdateRequest';
 import { SetEnvironmentSecretFileRequestToJSON, } from '../models/SetEnvironmentSecretFileRequest';
 import { SetEnvironmentVarRequestToJSON, } from '../models/SetEnvironmentVarRequest';
+import { Share200ResponseFromJSON, } from '../models/Share200Response';
 import { SnapshotDownloadResponseFromJSON, } from '../models/SnapshotDownloadResponse';
 import { SnapshotLatestResponseFromJSON, } from '../models/SnapshotLatestResponse';
 import { SnapshotListResponseFromJSON, } from '../models/SnapshotListResponse';
@@ -2324,6 +2325,9 @@ export class BoatApi extends runtime.BaseAPI {
      */
     async sandboxesRequestOpts(requestParameters) {
         const queryParameters = {};
+        if (requestParameters['org'] != null) {
+            queryParameters['org'] = requestParameters['org'];
+        }
         if (requestParameters['limit'] != null) {
             queryParameters['limit'] = requestParameters['limit'];
         }
@@ -2337,6 +2341,9 @@ export class BoatApi extends runtime.BaseAPI {
             queryParameters['state'] = requestParameters['state'];
         }
         const headerParameters = {};
+        if (requestParameters['xBoatOrg'] != null) {
+            headerParameters['X-Boat-Org'] = String(requestParameters['xBoatOrg']);
+        }
         if (this.configuration && this.configuration.accessToken) {
             const token = this.configuration.accessToken;
             const tokenString = await token("BoatBearerAuth", []);
@@ -2353,6 +2360,7 @@ export class BoatApi extends runtime.BaseAPI {
         };
     }
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     async sandboxesRaw(requestParameters, initOverrides) {
@@ -2361,6 +2369,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => SandboxListResponseFromJSON(jsonValue));
     }
     /**
+     * Your sandboxes. In an organization\'s scope (the active wallet, `org`, or `X-Boat-Org`) the list also holds every sandbox that organization pays for, whoever created it; `createdBy` and `access` say whose it is and what you may do with it.
      * List sandboxes
      */
     async sandboxes(requestParameters = {}, initOverrides) {
@@ -2637,6 +2646,48 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.setEnvironmentVarRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for share without sending the request
+     */
+    async shareRequestOpts(requestParameters) {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError('sandboxId', 'Required parameter "sandboxId" was null or undefined when calling share().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/sandboxes/{sandboxId}/share`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    async shareRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.shareRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => Share200ResponseFromJSON(jsonValue));
+    }
+    /**
+     * Let every member of the organization that pays for this sandbox use it.  Your personal logins (GitHub token, Claude and Codex logins, environment secrets, the sandbox\'s own CLI key) are never pushed to it again and are wiped off its disk at its next start, so a teammate never acts as you. Files you wrote stay. One-way: the sandbox stays like a `noEnv` sandbox from then on. A running sandbox stays `view` for the organization until you stop and resume it (`restartRequired`).  Only the person who created the sandbox can share it, and only a sandbox billed to an organization. Sharing an already shared sandbox is a no-op.
+     * Share sandbox with the organization
+     */
+    async share(requestParameters, initOverrides) {
+        const response = await this.shareRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for sshKey without sending the request
      */

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/PromptRequest.d.ts

@@ -40,6 +40,12 @@ export interface PromptRequest {
      * @memberof PromptRequest
      */
     reasoningEffort?: string | null;
+    /**
+     * Optional. `true` runs this prompt in fast mode. The model stays the same and gives output faster. The provider bills fast mode at its higher fast rate. Omit to use the choice saved on the Agents dashboard for that model. `false` forces standard speed. Only models with `fastMode` set to `true` in `GET /provider-models` accept `true`. Other models return 400 `fast_mode_not_supported`.
+     * @type {boolean}
+     * @memberof PromptRequest
+     */
+    fast?: boolean | null;
     /**
      * Start a NEW conversation on the sandbox (runs in parallel with any existing ones) instead of continuing the most-recently-active one. Mutually exclusive with `conversationId`.
      * @type {boolean}