@boatdev/sdk 1.10.0 → 1.12.0

package/src/apis/BoatApi.ts

@@ -208,11 +208,66 @@ import {
     EventsResponseFromJSON,
     EventsResponseToJSON,
 } from '../models/EventsResponse';
+import {
+    type FileDeleteResponse,
+    FileDeleteResponseFromJSON,
+    FileDeleteResponseToJSON,
+} from '../models/FileDeleteResponse';
+import {
+    type FileFindResponse,
+    FileFindResponseFromJSON,
+    FileFindResponseToJSON,
+} from '../models/FileFindResponse';
+import {
+    type FileFolderRequest,
+    FileFolderRequestFromJSON,
+    FileFolderRequestToJSON,
+} from '../models/FileFolderRequest';
+import {
+    type FileInfoResponse,
+    FileInfoResponseFromJSON,
+    FileInfoResponseToJSON,
+} from '../models/FileInfoResponse';
+import {
+    type FileListResponse,
+    FileListResponseFromJSON,
+    FileListResponseToJSON,
+} from '../models/FileListResponse';
+import {
+    type FileMoveRequest,
+    FileMoveRequestFromJSON,
+    FileMoveRequestToJSON,
+} from '../models/FileMoveRequest';
+import {
+    type FileMoveResponse,
+    FileMoveResponseFromJSON,
+    FileMoveResponseToJSON,
+} from '../models/FileMoveResponse';
+import {
+    type FilePermissionsRequest,
+    FilePermissionsRequestFromJSON,
+    FilePermissionsRequestToJSON,
+} from '../models/FilePermissionsRequest';
 import {
     type FileReadResponse,
     FileReadResponseFromJSON,
     FileReadResponseToJSON,
 } from '../models/FileReadResponse';
+import {
+    type FileReplaceRequest,
+    FileReplaceRequestFromJSON,
+    FileReplaceRequestToJSON,
+} from '../models/FileReplaceRequest';
+import {
+    type FileReplaceResponse,
+    FileReplaceResponseFromJSON,
+    FileReplaceResponseToJSON,
+} from '../models/FileReplaceResponse';
+import {
+    type FileSearchResponse,
+    FileSearchResponseFromJSON,
+    FileSearchResponseToJSON,
+} from '../models/FileSearchResponse';
 import {
     type FileUrlRequest,
     FileUrlRequestFromJSON,
@@ -393,6 +448,31 @@ import {
     SandboxUsageResponseFromJSON,
     SandboxUsageResponseToJSON,
 } from '../models/SandboxUsageResponse';
+import {
+    type SavedSnapshotDeletedResponse,
+    SavedSnapshotDeletedResponseFromJSON,
+    SavedSnapshotDeletedResponseToJSON,
+} from '../models/SavedSnapshotDeletedResponse';
+import {
+    type SavedSnapshotInfoResponse,
+    SavedSnapshotInfoResponseFromJSON,
+    SavedSnapshotInfoResponseToJSON,
+} from '../models/SavedSnapshotInfoResponse';
+import {
+    type SavedSnapshotListResponse,
+    SavedSnapshotListResponseFromJSON,
+    SavedSnapshotListResponseToJSON,
+} from '../models/SavedSnapshotListResponse';
+import {
+    type SavedSnapshotSaveRequest,
+    SavedSnapshotSaveRequestFromJSON,
+    SavedSnapshotSaveRequestToJSON,
+} from '../models/SavedSnapshotSaveRequest';
+import {
+    type SavedSnapshotSavingResponse,
+    SavedSnapshotSavingResponseFromJSON,
+    SavedSnapshotSavingResponseToJSON,
+} from '../models/SavedSnapshotSavingResponse';
 import {
     type SecretsResponse,
     SecretsResponseFromJSON,
@@ -657,6 +737,11 @@ export interface CreateEnvironmentRequest {
     org?: string;
 }
 
+export interface CreateFolderRequest {
+    sandboxId: string;
+    fileFolderRequest: FileFolderRequest;
+}
+
 export interface CreateScopedApiKeyOperationRequest {
     createScopedApiKeyRequest: CreateScopedApiKeyRequest;
 }
@@ -717,6 +802,12 @@ export interface DeleteEnvironmentVarRequest {
     org?: string;
 }
 
+export interface DeleteFileRequest {
+    sandboxId: string;
+    path: string;
+    recursive?: boolean;
+}
+
 export interface DeleteNamedSnapshotRequest {
     name: string;
 }
@@ -731,6 +822,10 @@ export interface DeleteSandboxSnapshotsRequest {
     xAsciiConfirmDelete: string;
 }
 
+export interface DeleteSavedSnapshotRequest {
+    name: string;
+}
+
 export interface DeleteSnapshotRequest {
     snapshotId: string;
     xAsciiConfirmDelete: string;
@@ -760,6 +855,13 @@ export interface EventsRequest {
     conversation?: string;
 }
 
+export interface FindInFilesRequest {
+    sandboxId: string;
+    pattern: string;
+    path?: string;
+    regex?: boolean;
+}
+
 export interface ForkOperationRequest {
     sandboxId: string;
     idempotencyKey?: string;
@@ -791,6 +893,11 @@ export interface GetDeletionOperationRequest {
     operationId: string;
 }
 
+export interface GetFileInfoRequest {
+    sandboxId: string;
+    path: string;
+}
+
 export interface GetLatestSandboxSnapshotRequest {
     sandboxId: string;
 }
@@ -804,6 +911,10 @@ export interface GetSandboxAiUsageRequest {
     days?: number;
 }
 
+export interface GetSavedSnapshotRequest {
+    name: string;
+}
+
 export interface GetSnapshotDownloadRequest {
     snapshotId: string;
 }
@@ -847,6 +958,11 @@ export interface ListCredentialAccountsRequest {
     credential: CredentialId;
 }
 
+export interface ListFilesRequest {
+    sandboxId: string;
+    path?: string;
+}
+
 export interface ListSandboxSnapshotsRequest {
     sandboxId: string;
     limit?: number;
@@ -864,6 +980,11 @@ export interface ListSnapshotsRequest {
     sort?: ListSnapshotsSortEnum;
 }
 
+export interface MoveFileRequest {
+    sandboxId: string;
+    fileMoveRequest: FileMoveRequest;
+}
+
 export interface ProcessesRequest {
     sandboxId: string;
 }
@@ -888,6 +1009,11 @@ export interface RecoverRequest {
     sandboxId: string;
 }
 
+export interface ReplaceInFilesRequest {
+    sandboxId: string;
+    fileReplaceRequest: FileReplaceRequest;
+}
+
 export interface ReposRequest {
     sync?: boolean;
     limit?: number;
@@ -933,6 +1059,16 @@ export interface SaveNamedSnapshotRequest {
     namedSnapshotSaveRequest: NamedSnapshotSaveRequest;
 }
 
+export interface SaveSavedSnapshotRequest {
+    savedSnapshotSaveRequest: SavedSnapshotSaveRequest;
+}
+
+export interface SearchFilesRequest {
+    sandboxId: string;
+    pattern: string;
+    path?: string;
+}
+
 export interface SelectRepoRequest {
     repoSelectionRequest: RepoSelectionRequest;
 }
@@ -966,6 +1102,11 @@ export interface SetEnvironmentVarOperationRequest {
     org?: string;
 }
 
+export interface SetFilePermissionsRequest {
+    sandboxId: string;
+    filePermissionsRequest: FilePermissionsRequest;
+}
+
 export interface SetSandboxAiAccessOperationRequest {
     sandboxId: string;
     setSandboxAiAccessRequest: SetSandboxAiAccessRequest;
@@ -2050,6 +2191,72 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for createFolder without sending the request
+     */
+    async createFolderRequestOpts(input: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>): Promise<runtime.RequestOpts> {
+        const requestParameters = runtime.unflattenBody<CreateFolderRequest>(input, 'fileFolderRequest', ['sandboxId'], []);
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling createFolder().'
+            );
+        }
+
+        if (requestParameters['fileFolderRequest'] == null) {
+            throw new runtime.RequiredError(
+                'fileFolderRequest',
+                'Required parameter "fileFolderRequest" was null or undefined when calling createFolder().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        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}/files/folder`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: FileFolderRequestToJSON(requestParameters['fileFolderRequest']),
+        };
+    }
+
+    /**
+     * Missing parent directories are created. An existing directory is not an error. Needs `file.write`.
+     * Create a directory in a sandbox
+     */
+    async createFolderRaw(requestParameters: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>> {
+        const requestOptions = await this.createFolderRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileInfoResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Missing parent directories are created. An existing directory is not an error. Needs `file.write`.
+     * Create a directory in a sandbox
+     */
+    async createFolder(requestParameters: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse> {
+        const response = await this.createFolderRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for createScopedApiKey without sending the request
      */
@@ -2089,7 +2296,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async createScopedApiKeyRaw(requestParameters: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeySecretResponse>> {
@@ -2100,7 +2307,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async createScopedApiKey(requestParameters: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeySecretResponse> {
@@ -2132,7 +2339,7 @@ export class BoatApi extends runtime.BaseAPI {
             }
         }
 
-        let urlPath = `/named-snapshots/{name}/shares`;
+        let urlPath = `/saved-snapshots/{name}/shares`;
         urlPath = urlPath.replace('{name}', encodeURIComponent(String(requestParameters['name'])));
 
         return {
@@ -2144,8 +2351,8 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * Make a secret code that lets any Boat account create a sandbox from this named snapshot (`boat snapshot share <name>` in the CLI). The response shows the code once; Boat stores only a hash. Re-saving the name changes what the code deploys. Removing the name removes its codes. Everything on the disk is shared, so do not keep secrets in files on it. Needs `snapshot.write`.
-     * Share a named snapshot
+     * Make a secret code that lets any Boat account create a sandbox from this saved snapshot (`boat snapshot share <name>` in the CLI). The response shows the code once; Boat stores only a hash. Re-saving the name changes what the code deploys. Removing the name removes its codes. Everything on the disk is shared, so do not keep secrets in files on it. Needs `snapshot.write`.
+     * Share a saved snapshot
      */
     async createSnapshotShareRaw(requestParameters: CreateSnapshotShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotShareCreatedResponse>> {
         const requestOptions = await this.createSnapshotShareRequestOpts(requestParameters);
@@ -2155,8 +2362,8 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * Make a secret code that lets any Boat account create a sandbox from this named snapshot (`boat snapshot share <name>` in the CLI). The response shows the code once; Boat stores only a hash. Re-saving the name changes what the code deploys. Removing the name removes its codes. Everything on the disk is shared, so do not keep secrets in files on it. Needs `snapshot.write`.
-     * Share a named snapshot
+     * Make a secret code that lets any Boat account create a sandbox from this saved snapshot (`boat snapshot share <name>` in the CLI). The response shows the code once; Boat stores only a hash. Re-saving the name changes what the code deploys. Removing the name removes its codes. Everything on the disk is shared, so do not keep secrets in files on it. Needs `snapshot.write`.
+     * Share a saved snapshot
      */
     async createSnapshotShare(requestParameters: CreateSnapshotShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotShareCreatedResponse> {
         const response = await this.createSnapshotShareRaw(requestParameters, initOverrides);
@@ -2802,8 +3009,79 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for deleteFile without sending the request
+     */
+    async deleteFileRequestOpts(requestParameters: DeleteFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling deleteFile().'
+            );
+        }
+
+        if (requestParameters['path'] == null) {
+            throw new runtime.RequiredError(
+                'path',
+                'Required parameter "path" was null or undefined when calling deleteFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+
+        if (requestParameters['recursive'] != null) {
+            queryParameters['recursive'] = requestParameters['recursive'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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}/files`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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
+     */
+    async deleteFileRaw(requestParameters: DeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileDeleteResponse>> {
+        const requestOptions = await this.deleteFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileDeleteResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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
+     */
+    async deleteFile(requestParameters: DeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileDeleteResponse> {
+        const response = await this.deleteFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for deleteNamedSnapshot without sending the request
+     * @deprecated
      */
     async deleteNamedSnapshotRequestOpts(requestParameters: DeleteNamedSnapshotRequest): Promise<runtime.RequestOpts> {
         if (requestParameters['name'] == null) {
@@ -2840,6 +3118,7 @@ export class BoatApi extends runtime.BaseAPI {
     /**
      * Remove a named snapshot and release its storage (`boat snapshot rm <name>` in the CLI). Sandboxes already deployed from it are unaffected.
      * Remove a named snapshot
+     * @deprecated
      */
     async deleteNamedSnapshotRaw(requestParameters: DeleteNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotDeletedResponse>> {
         const requestOptions = await this.deleteNamedSnapshotRequestOpts(requestParameters);
@@ -2851,6 +3130,7 @@ export class BoatApi extends runtime.BaseAPI {
     /**
      * Remove a named snapshot and release its storage (`boat snapshot rm <name>` in the CLI). Sandboxes already deployed from it are unaffected.
      * Remove a named snapshot
+     * @deprecated
      */
     async deleteNamedSnapshot(requestParameters: DeleteNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotDeletedResponse> {
         const response = await this.deleteNamedSnapshotRaw(requestParameters, initOverrides);
@@ -2904,7 +3184,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * Accept irreversible background deletion of the sandbox machine, snapshots, and content-bearing records. This is not archive: the sandbox cannot be resumed. Named snapshots and other shared artifacts remain independent. Poll the returned operation until `completed`.
+     * Accept irreversible background deletion of the sandbox machine, snapshots, and content-bearing records. This is not archive: the sandbox cannot be resumed. Saved snapshots and other shared artifacts remain independent. Poll the returned operation until `completed`.
      * Permanently delete sandbox data
      */
     async deleteSandboxRaw(requestParameters: DeleteSandboxRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeletionOperationResponse>> {
@@ -2915,7 +3195,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * Accept irreversible background deletion of the sandbox machine, snapshots, and content-bearing records. This is not archive: the sandbox cannot be resumed. Named snapshots and other shared artifacts remain independent. Poll the returned operation until `completed`.
+     * Accept irreversible background deletion of the sandbox machine, snapshots, and content-bearing records. This is not archive: the sandbox cannot be resumed. Saved snapshots and other shared artifacts remain independent. Poll the returned operation until `completed`.
      * Permanently delete sandbox data
      */
     async deleteSandbox(requestParameters: DeleteSandboxRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletionOperationResponse> {
@@ -2970,7 +3250,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * Accept irreversible deletion of every unpinned snapshot of this sandbox. The sandbox itself and its named snapshots stay. Snapshots disappear from lists, restores and forks immediately; their stored data is purged in the background. Set `X-Ascii-Confirm-Delete` to the sandbox id.
+     * Accept irreversible deletion of every unpinned snapshot of this sandbox. The sandbox itself and its saved snapshots stay. Snapshots disappear from lists, restores and forks immediately; their stored data is purged in the background. Set `X-Ascii-Confirm-Delete` to the sandbox id.
      * Permanently delete all snapshots of a sandbox
      */
     async deleteSandboxSnapshotsRaw(requestParameters: DeleteSandboxSnapshotsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeletionOperationListResponse>> {
@@ -2981,7 +3261,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * Accept irreversible deletion of every unpinned snapshot of this sandbox. The sandbox itself and its named snapshots stay. Snapshots disappear from lists, restores and forks immediately; their stored data is purged in the background. Set `X-Ascii-Confirm-Delete` to the sandbox id.
+     * Accept irreversible deletion of every unpinned snapshot of this sandbox. The sandbox itself and its saved snapshots stay. Snapshots disappear from lists, restores and forks immediately; their stored data is purged in the background. Set `X-Ascii-Confirm-Delete` to the sandbox id.
      * Permanently delete all snapshots of a sandbox
      */
     async deleteSandboxSnapshots(requestParameters: DeleteSandboxSnapshotsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletionOperationListResponse> {
@@ -2989,6 +3269,61 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for deleteSavedSnapshot without sending the request
+     */
+    async deleteSavedSnapshotRequestOpts(requestParameters: DeleteSavedSnapshotRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['name'] == null) {
+            throw new runtime.RequiredError(
+                'name',
+                'Required parameter "name" was null or undefined when calling deleteSavedSnapshot().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/saved-snapshots/{name}`;
+        urlPath = urlPath.replace('{name}', encodeURIComponent(String(requestParameters['name'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Remove a saved snapshot and release its storage (`boat snapshot rm <name>` in the CLI). Sandboxes already deployed from it are unaffected.
+     * Remove a saved snapshot
+     */
+    async deleteSavedSnapshotRaw(requestParameters: DeleteSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotDeletedResponse>> {
+        const requestOptions = await this.deleteSavedSnapshotRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SavedSnapshotDeletedResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Remove a saved snapshot and release its storage (`boat snapshot rm <name>` in the CLI). Sandboxes already deployed from it are unaffected.
+     * Remove a saved snapshot
+     */
+    async deleteSavedSnapshot(requestParameters: DeleteSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotDeletedResponse> {
+        const response = await this.deleteSavedSnapshotRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for deleteSnapshot without sending the request
      */
@@ -3350,6 +3685,80 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for findInFiles without sending the request
+     */
+    async findInFilesRequestOpts(requestParameters: FindInFilesRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling findInFiles().'
+            );
+        }
+
+        if (requestParameters['pattern'] == null) {
+            throw new runtime.RequiredError(
+                'pattern',
+                'Required parameter "pattern" was null or undefined when calling findInFiles().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+
+        if (requestParameters['pattern'] != null) {
+            queryParameters['pattern'] = requestParameters['pattern'];
+        }
+
+        if (requestParameters['regex'] != null) {
+            queryParameters['regex'] = requestParameters['regex'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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}/files/find`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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
+     */
+    async findInFilesRaw(requestParameters: FindInFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileFindResponse>> {
+        const requestOptions = await this.findInFilesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileFindResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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
+     */
+    async findInFiles(requestParameters: FindInFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileFindResponse> {
+        const response = await this.findInFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for fork without sending the request
      */
@@ -3750,7 +4159,73 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * Creates request options for getLatestSandboxSnapshot without sending the request
+     * Creates request options for getFileInfo without sending the request
+     */
+    async getFileInfoRequestOpts(requestParameters: GetFileInfoRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling getFileInfo().'
+            );
+        }
+
+        if (requestParameters['path'] == null) {
+            throw new runtime.RequiredError(
+                'path',
+                'Required parameter "path" was null or undefined when calling getFileInfo().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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}/files/info`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Size, permission bits, type and modification time. Needs `file.read`.
+     * Get file or directory details in a sandbox
+     */
+    async getFileInfoRaw(requestParameters: GetFileInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>> {
+        const requestOptions = await this.getFileInfoRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileInfoResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Size, permission bits, type and modification time. Needs `file.read`.
+     * Get file or directory details in a sandbox
+     */
+    async getFileInfo(requestParameters: GetFileInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse> {
+        const response = await this.getFileInfoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getLatestSandboxSnapshot without sending the request
      */
     async getLatestSandboxSnapshotRequestOpts(requestParameters: GetLatestSandboxSnapshotRequest): Promise<runtime.RequestOpts> {
         if (requestParameters['sandboxId'] == null) {
@@ -3806,6 +4281,7 @@ export class BoatApi extends runtime.BaseAPI {
 
     /**
      * Creates request options for getNamedSnapshot without sending the request
+     * @deprecated
      */
     async getNamedSnapshotRequestOpts(requestParameters: GetNamedSnapshotRequest): Promise<runtime.RequestOpts> {
         if (requestParameters['name'] == null) {
@@ -3841,6 +4317,7 @@ export class BoatApi extends runtime.BaseAPI {
 
     /**
      * Get a named snapshot
+     * @deprecated
      */
     async getNamedSnapshotRaw(requestParameters: GetNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotInfoResponse>> {
         const requestOptions = await this.getNamedSnapshotRequestOpts(requestParameters);
@@ -3851,6 +4328,7 @@ export class BoatApi extends runtime.BaseAPI {
 
     /**
      * Get a named snapshot
+     * @deprecated
      */
     async getNamedSnapshot(requestParameters: GetNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotInfoResponse> {
         const response = await this.getNamedSnapshotRaw(requestParameters, initOverrides);
@@ -3916,6 +4394,59 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for getSavedSnapshot without sending the request
+     */
+    async getSavedSnapshotRequestOpts(requestParameters: GetSavedSnapshotRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['name'] == null) {
+            throw new runtime.RequiredError(
+                'name',
+                'Required parameter "name" was null or undefined when calling getSavedSnapshot().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/saved-snapshots/{name}`;
+        urlPath = urlPath.replace('{name}', encodeURIComponent(String(requestParameters['name'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Get a saved snapshot
+     */
+    async getSavedSnapshotRaw(requestParameters: GetSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotInfoResponse>> {
+        const requestOptions = await this.getSavedSnapshotRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SavedSnapshotInfoResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Get a saved snapshot
+     */
+    async getSavedSnapshot(requestParameters: GetSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotInfoResponse> {
+        const response = await this.getSavedSnapshotRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getSnapshotDownload without sending the request
      */
@@ -4415,7 +4946,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async limitsRaw(requestParameters: LimitsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<LimitsResponse>> {
@@ -4426,7 +4957,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async limits(requestParameters: LimitsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<LimitsResponse> {
@@ -4544,8 +5075,68 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for listFiles without sending the request
+     */
+    async listFilesRequestOpts(requestParameters: ListFilesRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling listFiles().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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}/files/list`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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
+     */
+    async listFilesRaw(requestParameters: ListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileListResponse>> {
+        const requestOptions = await this.listFilesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileListResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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
+     */
+    async listFiles(requestParameters: ListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileListResponse> {
+        const response = await this.listFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listNamedSnapshots without sending the request
+     * @deprecated
      */
     async listNamedSnapshotsRequestOpts(): Promise<runtime.RequestOpts> {
         const queryParameters: any = {};
@@ -4574,6 +5165,7 @@ export class BoatApi extends runtime.BaseAPI {
     /**
      * List your named snapshots, newest first.
      * List named snapshots
+     * @deprecated
      */
     async listNamedSnapshotsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotListResponse>> {
         const requestOptions = await this.listNamedSnapshotsRequestOpts();
@@ -4585,6 +5177,7 @@ export class BoatApi extends runtime.BaseAPI {
     /**
      * List your named snapshots, newest first.
      * List named snapshots
+     * @deprecated
      */
     async listNamedSnapshots(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotListResponse> {
         const response = await this.listNamedSnapshotsRaw(initOverrides);
@@ -4705,6 +5298,53 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for listSavedSnapshots without sending the request
+     */
+    async listSavedSnapshotsRequestOpts(): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/saved-snapshots`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List your saved snapshots, newest first.
+     * List saved snapshots
+     */
+    async listSavedSnapshotsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotListResponse>> {
+        const requestOptions = await this.listSavedSnapshotsRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SavedSnapshotListResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List your saved snapshots, newest first.
+     * List saved snapshots
+     */
+    async listSavedSnapshots(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotListResponse> {
+        const response = await this.listSavedSnapshotsRaw(initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for listSnapshotShares without sending the request
      */
@@ -4729,7 +5369,7 @@ export class BoatApi extends runtime.BaseAPI {
             }
         }
 
-        let urlPath = `/named-snapshots/{name}/shares`;
+        let urlPath = `/saved-snapshots/{name}/shares`;
         urlPath = urlPath.replace('{name}', encodeURIComponent(String(requestParameters['name'])));
 
         return {
@@ -4741,8 +5381,8 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * List the share codes of a named snapshot, active and revoked (`boat snapshot shares <name>` in the CLI). The full codes are not returned. Needs `snapshot.read`.
-     * List share codes of a named snapshot
+     * List the share codes of a saved snapshot, active and revoked (`boat snapshot shares <name>` in the CLI). The full codes are not returned. Needs `snapshot.read`.
+     * List share codes of a saved snapshot
      */
     async listSnapshotSharesRaw(requestParameters: ListSnapshotSharesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotShareListResponse>> {
         const requestOptions = await this.listSnapshotSharesRequestOpts(requestParameters);
@@ -4752,8 +5392,8 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * List the share codes of a named snapshot, active and revoked (`boat snapshot shares <name>` in the CLI). The full codes are not returned. Needs `snapshot.read`.
-     * List share codes of a named snapshot
+     * List the share codes of a saved snapshot, active and revoked (`boat snapshot shares <name>` in the CLI). The full codes are not returned. Needs `snapshot.read`.
+     * List share codes of a saved snapshot
      */
     async listSnapshotShares(requestParameters: ListSnapshotSharesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotShareListResponse> {
         const response = await this.listSnapshotSharesRaw(requestParameters, initOverrides);
@@ -4913,6 +5553,72 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for moveFile without sending the request
+     */
+    async moveFileRequestOpts(input: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>): Promise<runtime.RequestOpts> {
+        const requestParameters = runtime.unflattenBody<MoveFileRequest>(input, 'fileMoveRequest', ['sandboxId'], []);
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling moveFile().'
+            );
+        }
+
+        if (requestParameters['fileMoveRequest'] == null) {
+            throw new runtime.RequiredError(
+                'fileMoveRequest',
+                'Required parameter "fileMoveRequest" was null or undefined when calling moveFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        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}/files/move`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: FileMoveRequestToJSON(requestParameters['fileMoveRequest']),
+        };
+    }
+
+    /**
+     * 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
+     */
+    async moveFileRaw(requestParameters: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileMoveResponse>> {
+        const requestOptions = await this.moveFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileMoveResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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
+     */
+    async moveFile(requestParameters: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileMoveResponse> {
+        const response = await this.moveFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for processes without sending the request
      */
@@ -5148,7 +5854,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async readFileRaw(requestParameters: ReadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileReadResponse>> {
@@ -5159,7 +5865,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async readFile(requestParameters: ReadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileReadResponse> {
@@ -5222,6 +5928,72 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for replaceInFiles without sending the request
+     */
+    async replaceInFilesRequestOpts(input: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>): Promise<runtime.RequestOpts> {
+        const requestParameters = runtime.unflattenBody<ReplaceInFilesRequest>(input, 'fileReplaceRequest', ['sandboxId'], []);
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling replaceInFiles().'
+            );
+        }
+
+        if (requestParameters['fileReplaceRequest'] == null) {
+            throw new runtime.RequiredError(
+                'fileReplaceRequest',
+                'Required parameter "fileReplaceRequest" was null or undefined when calling replaceInFiles().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        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}/files/replace`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: FileReplaceRequestToJSON(requestParameters['fileReplaceRequest']),
+        };
+    }
+
+    /**
+     * Replaces every occurrence of `pattern` with `newValue` in each file. Needs `file.write`.
+     * Replace text in sandbox files
+     */
+    async replaceInFilesRaw(requestParameters: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileReplaceResponse>> {
+        const requestOptions = await this.replaceInFilesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileReplaceResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Replaces every occurrence of `pattern` with `newValue` in each file. Needs `file.write`.
+     * Replace text in sandbox files
+     */
+    async replaceInFiles(requestParameters: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileReplaceResponse> {
+        const response = await this.replaceInFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for repos without sending the request
      */
@@ -5386,7 +6158,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async revokeApiKeyRaw(requestParameters: RevokeApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeyRevokeResponse>> {
@@ -5397,7 +6169,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async revokeApiKey(requestParameters: RevokeApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeyRevokeResponse> {
@@ -5436,7 +6208,7 @@ export class BoatApi extends runtime.BaseAPI {
             }
         }
 
-        let urlPath = `/named-snapshots/{name}/shares/{shareId}`;
+        let urlPath = `/saved-snapshots/{name}/shares/{shareId}`;
         urlPath = urlPath.replace('{name}', encodeURIComponent(String(requestParameters['name'])));
         urlPath = urlPath.replace('{shareId}', encodeURIComponent(String(requestParameters['shareId'])));
 
@@ -5504,7 +6276,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async rotateApiKeyRaw(requestParameters: RotateApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeySecretResponse>> {
@@ -5515,7 +6287,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async rotateApiKey(requestParameters: RotateApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeySecretResponse> {
@@ -5655,6 +6427,7 @@ export class BoatApi extends runtime.BaseAPI {
 
     /**
      * Creates request options for saveNamedSnapshot without sending the request
+     * @deprecated
      */
     async saveNamedSnapshotRequestOpts(input: SaveNamedSnapshotRequest | runtime.FlatBody<SaveNamedSnapshotRequest, 'namedSnapshotSaveRequest'>): Promise<runtime.RequestOpts> {
         const requestParameters = runtime.unflattenBody<SaveNamedSnapshotRequest>(input, 'namedSnapshotSaveRequest', [], []);
@@ -5694,6 +6467,7 @@ export class BoatApi extends runtime.BaseAPI {
     /**
      * Freeze a sandbox\'s current state under a name (`boat snapshot <id> <name>` in the CLI). Answers `202` immediately with the snapshot in `saving`; a running sandbox takes a fresh capture first, which can run minutes. Poll `GET /named-snapshots/{name}` until the status settles at `ready` or `failed`. Reusing one of your existing names replaces that snapshot\'s artifact once the new save is ready.
      * Save a named snapshot
+     * @deprecated
      */
     async saveNamedSnapshotRaw(requestParameters: SaveNamedSnapshotRequest | runtime.FlatBody<SaveNamedSnapshotRequest, 'namedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotSavingResponse>> {
         const requestOptions = await this.saveNamedSnapshotRequestOpts(requestParameters);
@@ -5705,12 +6479,141 @@ export class BoatApi extends runtime.BaseAPI {
     /**
      * Freeze a sandbox\'s current state under a name (`boat snapshot <id> <name>` in the CLI). Answers `202` immediately with the snapshot in `saving`; a running sandbox takes a fresh capture first, which can run minutes. Poll `GET /named-snapshots/{name}` until the status settles at `ready` or `failed`. Reusing one of your existing names replaces that snapshot\'s artifact once the new save is ready.
      * Save a named snapshot
+     * @deprecated
      */
     async saveNamedSnapshot(requestParameters: SaveNamedSnapshotRequest | runtime.FlatBody<SaveNamedSnapshotRequest, 'namedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotSavingResponse> {
         const response = await this.saveNamedSnapshotRaw(requestParameters, initOverrides);
         return await response.value();
     }
 
+    /**
+     * Creates request options for saveSavedSnapshot without sending the request
+     */
+    async saveSavedSnapshotRequestOpts(input: SaveSavedSnapshotRequest | runtime.FlatBody<SaveSavedSnapshotRequest, 'savedSnapshotSaveRequest'>): Promise<runtime.RequestOpts> {
+        const requestParameters = runtime.unflattenBody<SaveSavedSnapshotRequest>(input, 'savedSnapshotSaveRequest', [], []);
+        if (requestParameters['savedSnapshotSaveRequest'] == null) {
+            throw new runtime.RequiredError(
+                'savedSnapshotSaveRequest',
+                'Required parameter "savedSnapshotSaveRequest" was null or undefined when calling saveSavedSnapshot().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/saved-snapshots`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: SavedSnapshotSaveRequestToJSON(requestParameters['savedSnapshotSaveRequest']),
+        };
+    }
+
+    /**
+     * Freeze a sandbox\'s current state under a name (`boat snapshot <id> <name>` in the CLI). Answers `202` immediately with the snapshot in `saving`; a running sandbox takes a fresh capture first, which can run minutes. Poll `GET /saved-snapshots/{name}` until the status settles at `ready` or `failed`. Reusing one of your existing names replaces that snapshot\'s artifact once the new save is ready.
+     * Save a saved snapshot
+     */
+    async saveSavedSnapshotRaw(requestParameters: SaveSavedSnapshotRequest | runtime.FlatBody<SaveSavedSnapshotRequest, 'savedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotSavingResponse>> {
+        const requestOptions = await this.saveSavedSnapshotRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SavedSnapshotSavingResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Freeze a sandbox\'s current state under a name (`boat snapshot <id> <name>` in the CLI). Answers `202` immediately with the snapshot in `saving`; a running sandbox takes a fresh capture first, which can run minutes. Poll `GET /saved-snapshots/{name}` until the status settles at `ready` or `failed`. Reusing one of your existing names replaces that snapshot\'s artifact once the new save is ready.
+     * Save a saved snapshot
+     */
+    async saveSavedSnapshot(requestParameters: SaveSavedSnapshotRequest | runtime.FlatBody<SaveSavedSnapshotRequest, 'savedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotSavingResponse> {
+        const response = await this.saveSavedSnapshotRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for searchFiles without sending the request
+     */
+    async searchFilesRequestOpts(requestParameters: SearchFilesRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling searchFiles().'
+            );
+        }
+
+        if (requestParameters['pattern'] == null) {
+            throw new runtime.RequiredError(
+                'pattern',
+                'Required parameter "pattern" was null or undefined when calling searchFiles().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+
+        if (requestParameters['pattern'] != null) {
+            queryParameters['pattern'] = requestParameters['pattern'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        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}/files/search`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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
+     */
+    async searchFilesRaw(requestParameters: SearchFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileSearchResponse>> {
+        const requestOptions = await this.searchFilesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileSearchResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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
+     */
+    async searchFiles(requestParameters: SearchFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileSearchResponse> {
+        const response = await this.searchFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for secrets without sending the request
      */
@@ -6170,6 +7073,72 @@ export class BoatApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for setFilePermissions without sending the request
+     */
+    async setFilePermissionsRequestOpts(input: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>): Promise<runtime.RequestOpts> {
+        const requestParameters = runtime.unflattenBody<SetFilePermissionsRequest>(input, 'filePermissionsRequest', ['sandboxId'], []);
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError(
+                'sandboxId',
+                'Required parameter "sandboxId" was null or undefined when calling setFilePermissions().'
+            );
+        }
+
+        if (requestParameters['filePermissionsRequest'] == null) {
+            throw new runtime.RequiredError(
+                'filePermissionsRequest',
+                'Required parameter "filePermissionsRequest" was null or undefined when calling setFilePermissions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        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}/files/permissions`;
+        urlPath = urlPath.replace('{sandboxId}', encodeURIComponent(String(requestParameters['sandboxId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: FilePermissionsRequestToJSON(requestParameters['filePermissionsRequest']),
+        };
+    }
+
+    /**
+     * 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
+     */
+    async setFilePermissionsRaw(requestParameters: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>> {
+        const requestOptions = await this.setFilePermissionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileInfoResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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
+     */
+    async setFilePermissions(requestParameters: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse> {
+        const response = await this.setFilePermissionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for setSandboxAiAccess without sending the request
      */
@@ -6844,7 +7813,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async updateAiProxyRaw(requestParameters: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiProxySettings>> {
@@ -6855,7 +7824,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async updateAiProxy(requestParameters: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiProxySettings> {
@@ -7418,7 +8387,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async writeFileRaw(requestParameters: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileWriteResponse>> {
@@ -7429,7 +8398,7 @@ export class BoatApi extends runtime.BaseAPI {
     }
 
     /**
-     * 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
      */
     async writeFile(requestParameters: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileWriteResponse> {