@boatdev/sdk 1.11.0 → 1.12.0

package/dist/esm/apis/BoatApi.d.ts

@@ -46,7 +46,18 @@ import { type DesktopRequest } from '../models/DesktopRequest';
 import { type DesktopResponse } from '../models/DesktopResponse';
 import { type EnvironmentItemChangeResponse } from '../models/EnvironmentItemChangeResponse';
 import { type EventsResponse } from '../models/EventsResponse';
+import { type FileDeleteResponse } from '../models/FileDeleteResponse';
+import { type FileFindResponse } from '../models/FileFindResponse';
+import { type FileFolderRequest } from '../models/FileFolderRequest';
+import { type FileInfoResponse } from '../models/FileInfoResponse';
+import { type FileListResponse } from '../models/FileListResponse';
+import { type FileMoveRequest } from '../models/FileMoveRequest';
+import { type FileMoveResponse } from '../models/FileMoveResponse';
+import { type FilePermissionsRequest } from '../models/FilePermissionsRequest';
 import { type FileReadResponse } from '../models/FileReadResponse';
+import { type FileReplaceRequest } from '../models/FileReplaceRequest';
+import { type FileReplaceResponse } from '../models/FileReplaceResponse';
+import { type FileSearchResponse } from '../models/FileSearchResponse';
 import { type FileUrlRequest } from '../models/FileUrlRequest';
 import { type FileUrlResponse } from '../models/FileUrlResponse';
 import { type FileWriteRequest } from '../models/FileWriteRequest';
@@ -192,6 +203,10 @@ export interface CreateEnvironmentRequest {
     createSandboxEnvironmentRequest: CreateSandboxEnvironmentRequest;
     org?: string;
 }
+export interface CreateFolderRequest {
+    sandboxId: string;
+    fileFolderRequest: FileFolderRequest;
+}
 export interface CreateScopedApiKeyOperationRequest {
     createScopedApiKeyRequest: CreateScopedApiKeyRequest;
 }
@@ -240,6 +255,11 @@ export interface DeleteEnvironmentVarRequest {
     key: string;
     org?: string;
 }
+export interface DeleteFileRequest {
+    sandboxId: string;
+    path: string;
+    recursive?: boolean;
+}
 export interface DeleteNamedSnapshotRequest {
     name: string;
 }
@@ -278,6 +298,12 @@ export interface EventsRequest {
     type?: string;
     conversation?: string;
 }
+export interface FindInFilesRequest {
+    sandboxId: string;
+    pattern: string;
+    path?: string;
+    regex?: boolean;
+}
 export interface ForkOperationRequest {
     sandboxId: string;
     idempotencyKey?: string;
@@ -303,6 +329,10 @@ export interface GetCommandRequest {
 export interface GetDeletionOperationRequest {
     operationId: string;
 }
+export interface GetFileInfoRequest {
+    sandboxId: string;
+    path: string;
+}
 export interface GetLatestSandboxSnapshotRequest {
     sandboxId: string;
 }
@@ -350,6 +380,10 @@ export interface ListCredentialAccountsRequest {
     profile: string;
     credential: CredentialId;
 }
+export interface ListFilesRequest {
+    sandboxId: string;
+    path?: string;
+}
 export interface ListSandboxSnapshotsRequest {
     sandboxId: string;
     limit?: number;
@@ -364,6 +398,10 @@ export interface ListSnapshotsRequest {
     cursor?: string | null;
     sort?: ListSnapshotsSortEnum;
 }
+export interface MoveFileRequest {
+    sandboxId: string;
+    fileMoveRequest: FileMoveRequest;
+}
 export interface ProcessesRequest {
     sandboxId: string;
 }
@@ -383,6 +421,10 @@ export interface ReadFileRequest {
 export interface RecoverRequest {
     sandboxId: string;
 }
+export interface ReplaceInFilesRequest {
+    sandboxId: string;
+    fileReplaceRequest: FileReplaceRequest;
+}
 export interface ReposRequest {
     sync?: boolean;
     limit?: number;
@@ -423,6 +465,11 @@ export interface SaveNamedSnapshotRequest {
 export interface SaveSavedSnapshotRequest {
     savedSnapshotSaveRequest: SavedSnapshotSaveRequest;
 }
+export interface SearchFilesRequest {
+    sandboxId: string;
+    pattern: string;
+    path?: string;
+}
 export interface SelectRepoRequest {
     repoSelectionRequest: RepoSelectionRequest;
 }
@@ -450,6 +497,10 @@ export interface SetEnvironmentVarOperationRequest {
     setEnvironmentVarRequest: SetEnvironmentVarRequest;
     org?: string;
 }
+export interface SetFilePermissionsRequest {
+    sandboxId: string;
+    filePermissionsRequest: FilePermissionsRequest;
+}
 export interface SetSandboxAiAccessOperationRequest {
     sandboxId: string;
     setSandboxAiAccessRequest: SetSandboxAiAccessRequest;
@@ -745,17 +796,31 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Create a sandbox environment
      */
     createEnvironment(requestParameters: CreateEnvironmentRequest | runtime.FlatBody<CreateEnvironmentRequest, 'createSandboxEnvironmentRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SandboxEnvironmentListResponse>;
+    /**
+     * Creates request options for createFolder without sending the request
+     */
+    createFolderRequestOpts(input: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Missing parent directories are created. An existing directory is not an error. Needs `file.write`.
+     * Create a directory in a sandbox
+     */
+    createFolderRaw(requestParameters: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>>;
+    /**
+     * Missing parent directories are created. An existing directory is not an error. Needs `file.write`.
+     * Create a directory in a sandbox
+     */
+    createFolder(requestParameters: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse>;
     /**
      * Creates request options for createScopedApiKey without sending the request
      */
     createScopedApiKeyRequestOpts(input: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>): Promise<runtime.RequestOpts>;
     /**
-     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. This dedicated path returns a typed 503 until scoped credential creation is activated.
+     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. An unknown field is a 400, so a misspelled scope never creates a full-access key. environmentIds takes your own environments and the org environments you can use. This dedicated path returns a typed 503 until scoped credential creation is activated.
      * Create a scoped API key
      */
     createScopedApiKeyRaw(requestParameters: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeySecretResponse>>;
     /**
-     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. This dedicated path returns a typed 503 until scoped credential creation is activated.
+     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. An unknown field is a 400, so a misspelled scope never creates a full-access key. environmentIds takes your own environments and the org environments you can use. This dedicated path returns a typed 503 until scoped credential creation is activated.
      * Create a scoped API key
      */
     createScopedApiKey(requestParameters: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeySecretResponse>;
@@ -913,6 +978,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Remove one environment variable
      */
     deleteEnvironmentVar(requestParameters: DeleteEnvironmentVarRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EnvironmentItemChangeResponse>;
+    /**
+     * Creates request options for deleteFile without sending the request
+     */
+    deleteFileRequestOpts(requestParameters: DeleteFileRequest): Promise<runtime.RequestOpts>;
+    /**
+     * A directory needs `recursive=true`. A symlink is deleted itself, never its target. /home/user and /tmp themselves cannot be deleted. Needs `file.write`.
+     * Delete a file or directory in a sandbox
+     */
+    deleteFileRaw(requestParameters: DeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileDeleteResponse>>;
+    /**
+     * A directory needs `recursive=true`. A symlink is deleted itself, never its target. /home/user and /tmp themselves cannot be deleted. Needs `file.write`.
+     * Delete a file or directory in a sandbox
+     */
+    deleteFile(requestParameters: DeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileDeleteResponse>;
     /**
      * Creates request options for deleteNamedSnapshot without sending the request
      * @deprecated
@@ -1056,6 +1135,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * List boat events
      */
     events(requestParameters: EventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventsResponse>;
+    /**
+     * Creates request options for findInFiles without sending the request
+     */
+    findInFilesRequestOpts(requestParameters: FindInFilesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Every line under `path` that contains `pattern`. `pattern` is plain text; with `regex=true` it is an extended regular expression. Binary files are skipped and symlinks are not followed. Needs `file.read`.
+     * Find text in sandbox files
+     */
+    findInFilesRaw(requestParameters: FindInFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileFindResponse>>;
+    /**
+     * Every line under `path` that contains `pattern`. `pattern` is plain text; with `regex=true` it is an extended regular expression. Binary files are skipped and symlinks are not followed. Needs `file.read`.
+     * Find text in sandbox files
+     */
+    findInFiles(requestParameters: FindInFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileFindResponse>;
     /**
      * Creates request options for fork without sending the request
      */
@@ -1152,6 +1245,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Get deletion operation
      */
     getDeletionOperation(requestParameters: GetDeletionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletionOperationResponse>;
+    /**
+     * Creates request options for getFileInfo without sending the request
+     */
+    getFileInfoRequestOpts(requestParameters: GetFileInfoRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Size, permission bits, type and modification time. Needs `file.read`.
+     * Get file or directory details in a sandbox
+     */
+    getFileInfoRaw(requestParameters: GetFileInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>>;
+    /**
+     * Size, permission bits, type and modification time. Needs `file.read`.
+     * Get file or directory details in a sandbox
+     */
+    getFileInfo(requestParameters: GetFileInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse>;
     /**
      * Creates request options for getLatestSandboxSnapshot without sending the request
      */
@@ -1324,12 +1431,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     limitsRequestOpts(requestParameters: LimitsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Check remaining machine starts, compute time, credits, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
+     * Check remaining machine starts, included VM time, the wallet, overage prices, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
      * Get Boat limits
      */
     limitsRaw(requestParameters: LimitsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<LimitsResponse>>;
     /**
-     * Check remaining machine starts, compute time, credits, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
+     * Check remaining machine starts, included VM time, the wallet, overage prices, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
      * Get Boat limits
      */
     limits(requestParameters?: LimitsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<LimitsResponse>;
@@ -1361,6 +1468,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * List credential profiles
      */
     listCredentialProfiles(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CredentialProfileListResponse>;
+    /**
+     * Creates request options for listFiles without sending the request
+     */
+    listFilesRequestOpts(requestParameters: ListFilesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * One level, sorted by name. A symlink is listed as a symlink, not followed. Defaults to /home/user. Needs `file.read`.
+     * List a directory in a sandbox
+     */
+    listFilesRaw(requestParameters: ListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileListResponse>>;
+    /**
+     * One level, sorted by name. A symlink is listed as a symlink, not followed. Defaults to /home/user. Needs `file.read`.
+     * List a directory in a sandbox
+     */
+    listFiles(requestParameters: ListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileListResponse>;
     /**
      * Creates request options for listNamedSnapshots without sending the request
      * @deprecated
@@ -1476,6 +1597,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Get current Boat user
      */
     me(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MeResponse>;
+    /**
+     * Creates request options for moveFile without sending the request
+     */
+    moveFileRequestOpts(input: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Works across /home/user and /tmp. A symlink is moved itself, never its target. Needs `file.write`.
+     * Move or rename a file or directory in a sandbox
+     */
+    moveFileRaw(requestParameters: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileMoveResponse>>;
+    /**
+     * Works across /home/user and /tmp. A symlink is moved itself, never its target. Needs `file.write`.
+     * Move or rename a file or directory in a sandbox
+     */
+    moveFile(requestParameters: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileMoveResponse>;
     /**
      * Creates request options for processes without sending the request
      */
@@ -1523,12 +1658,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     readFileRequestOpts(requestParameters: ReadFileRequest): Promise<runtime.RequestOpts>;
     /**
-     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`.
+     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command), so it reads the sandbox\'s own disk and never the machine\'s stock one.
      * Read a file from a sandbox
      */
     readFileRaw(requestParameters: ReadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileReadResponse>>;
     /**
-     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`.
+     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command), so it reads the sandbox\'s own disk and never the machine\'s stock one.
      * Read a file from a sandbox
      */
     readFile(requestParameters: ReadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileReadResponse>;
@@ -1546,6 +1681,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Recover a sandbox that stopped responding
      */
     recover(requestParameters: RecoverRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Recover200Response>;
+    /**
+     * Creates request options for replaceInFiles without sending the request
+     */
+    replaceInFilesRequestOpts(input: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Replaces every occurrence of `pattern` with `newValue` in each file. Needs `file.write`.
+     * Replace text in sandbox files
+     */
+    replaceInFilesRaw(requestParameters: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileReplaceResponse>>;
+    /**
+     * Replaces every occurrence of `pattern` with `newValue` in each file. Needs `file.write`.
+     * Replace text in sandbox files
+     */
+    replaceInFiles(requestParameters: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileReplaceResponse>;
     /**
      * Creates request options for repos without sending the request
      */
@@ -1577,12 +1726,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     revokeApiKeyRequestOpts(requestParameters: RevokeApiKeyRequest): Promise<runtime.RequestOpts>;
     /**
-     * Revokes the key immediately. Requires a dashboard or CLI session.
+     * Revokes the key immediately. Requires a dashboard or CLI session, or an admin-scoped key. A key revokes itself or a key it could create (same or fewer actions, sandboxes and environments, no later expiry).
      * Revoke an API key
      */
     revokeApiKeyRaw(requestParameters: RevokeApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeyRevokeResponse>>;
     /**
-     * Revokes the key immediately. Requires a dashboard or CLI session.
+     * Revokes the key immediately. Requires a dashboard or CLI session, or an admin-scoped key. A key revokes itself or a key it could create (same or fewer actions, sandboxes and environments, no later expiry).
      * Revoke an API key
      */
     revokeApiKey(requestParameters: RevokeApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeyRevokeResponse>;
@@ -1605,12 +1754,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     rotateApiKeyRequestOpts(requestParameters: RotateApiKeyRequest): Promise<runtime.RequestOpts>;
     /**
-     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session.
+     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session, or an admin-scoped key. A key rotates itself or a key it could create.
      * Rotate an API key
      */
     rotateApiKeyRaw(requestParameters: RotateApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeySecretResponse>>;
     /**
-     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session.
+     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session, or an admin-scoped key. A key rotates itself or a key it could create.
      * Rotate an API key
      */
     rotateApiKey(requestParameters: RotateApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeySecretResponse>;
@@ -1673,6 +1822,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Save a saved snapshot
      */
     saveSavedSnapshot(requestParameters: SaveSavedSnapshotRequest | runtime.FlatBody<SaveSavedSnapshotRequest, 'savedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotSavingResponse>;
+    /**
+     * Creates request options for searchFiles without sending the request
+     */
+    searchFilesRequestOpts(requestParameters: SearchFilesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Every file and directory under `path` whose name matches the glob `pattern` (for example `*.py`). Symlinks are not followed. Needs `file.read`.
+     * Search files by name in a sandbox
+     */
+    searchFilesRaw(requestParameters: SearchFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileSearchResponse>>;
+    /**
+     * Every file and directory under `path` whose name matches the glob `pattern` (for example `*.py`). Symlinks are not followed. Needs `file.read`.
+     * Search files by name in a sandbox
+     */
+    searchFiles(requestParameters: SearchFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileSearchResponse>;
     /**
      * Creates request options for secrets without sending the request
      */
@@ -1771,6 +1934,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 setFilePermissions without sending the request
+     */
+    setFilePermissionsRequestOpts(input: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Sets the permission bits. Files belong to the sandbox user; the owner and group do not change. Needs `file.write`.
+     * Set file permissions in a sandbox
+     */
+    setFilePermissionsRaw(requestParameters: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>>;
+    /**
+     * Sets the permission bits. Files belong to the sandbox user; the owner and group do not change. Needs `file.write`.
+     * Set file permissions in a sandbox
+     */
+    setFilePermissions(requestParameters: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse>;
     /**
      * Creates request options for setSandboxAiAccess without sending the request
      */
@@ -1914,12 +2091,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     updateAiProxyRequestOpts(input: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>): Promise<runtime.RequestOpts>;
     /**
-     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the account pays $1 of Boat time for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
+     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the wallet of the account pays $1 for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
      * Turn the AI credentials proxy on or off
      */
     updateAiProxyRaw(requestParameters: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiProxySettings>>;
     /**
-     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the account pays $1 of Boat time for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
+     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the wallet of the account pays $1 for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
      * Turn the AI credentials proxy on or off
      */
     updateAiProxy(requestParameters: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiProxySettings>;
@@ -2038,12 +2215,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     writeFileRequestOpts(input: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>): Promise<runtime.RequestOpts>;
     /**
-     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`.
+     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command): a sandbox\'s files are in place only once it is ready, so a write any earlier would not stay. A `200` always means the file is on the sandbox\'s disk.
      * Write a file in a sandbox
      */
     writeFileRaw(requestParameters: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileWriteResponse>>;
     /**
-     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`.
+     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command): a sandbox\'s files are in place only once it is ready, so a write any earlier would not stay. A `200` always means the file is on the sandbox\'s disk.
      * Write a file in a sandbox
      */
     writeFile(requestParameters: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileWriteResponse>;