@boatdev/sdk 1.11.0 → 1.12.0

package/dist/esm/apis/BoatApi.js

@@ -47,7 +47,18 @@ import { DesktopRequestToJSON, } from '../models/DesktopRequest';
 import { DesktopResponseFromJSON, } from '../models/DesktopResponse';
 import { EnvironmentItemChangeResponseFromJSON, } from '../models/EnvironmentItemChangeResponse';
 import { EventsResponseFromJSON, } from '../models/EventsResponse';
+import { FileDeleteResponseFromJSON, } from '../models/FileDeleteResponse';
+import { FileFindResponseFromJSON, } from '../models/FileFindResponse';
+import { FileFolderRequestToJSON, } from '../models/FileFolderRequest';
+import { FileInfoResponseFromJSON, } from '../models/FileInfoResponse';
+import { FileListResponseFromJSON, } from '../models/FileListResponse';
+import { FileMoveRequestToJSON, } from '../models/FileMoveRequest';
+import { FileMoveResponseFromJSON, } from '../models/FileMoveResponse';
+import { FilePermissionsRequestToJSON, } from '../models/FilePermissionsRequest';
 import { FileReadResponseFromJSON, } from '../models/FileReadResponse';
+import { FileReplaceRequestToJSON, } from '../models/FileReplaceRequest';
+import { FileReplaceResponseFromJSON, } from '../models/FileReplaceResponse';
+import { FileSearchResponseFromJSON, } from '../models/FileSearchResponse';
 import { FileUrlRequestToJSON, } from '../models/FileUrlRequest';
 import { FileUrlResponseFromJSON, } from '../models/FileUrlResponse';
 import { FileWriteRequestToJSON, } from '../models/FileWriteRequest';
@@ -857,6 +868,54 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.createEnvironmentRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for createFolder without sending the request
+     */
+    async createFolderRequestOpts(input) {
+        const requestParameters = runtime.unflattenBody(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 = {};
+        const headerParameters = {};
+        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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.createFolderRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for createScopedApiKey without sending the request
      */
@@ -885,7 +944,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, initOverrides) {
@@ -894,7 +953,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => ApiKeySecretResponseFromJSON(jsonValue));
     }
     /**
-     * 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, initOverrides) {
@@ -1413,6 +1472,57 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.deleteEnvironmentVarRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for deleteFile without sending the request
+     */
+    async deleteFileRequestOpts(requestParameters) {
+        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 = {};
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+        if (requestParameters['recursive'] != null) {
+            queryParameters['recursive'] = requestParameters['recursive'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/sandboxes/{sandboxId}/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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.deleteFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for deleteNamedSnapshot without sending the request
      * @deprecated
@@ -1873,6 +1983,60 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.eventsRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for findInFiles without sending the request
+     */
+    async findInFilesRequestOpts(requestParameters) {
+        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 = {};
+        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 = {};
+        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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.findInFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for fork without sending the request
      */
@@ -2181,6 +2345,54 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.getDeletionOperationRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for getFileInfo without sending the request
+     */
+    async getFileInfoRequestOpts(requestParameters) {
+        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 = {};
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/sandboxes/{sandboxId}/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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.getFileInfoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for getLatestSandboxSnapshot without sending the request
      */
@@ -2730,7 +2942,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, initOverrides) {
@@ -2739,7 +2951,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => LimitsResponseFromJSON(jsonValue));
     }
     /**
-     * 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 = {}, initOverrides) {
@@ -2830,6 +3042,51 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.listCredentialProfilesRaw(initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for listFiles without sending the request
+     */
+    async listFilesRequestOpts(requestParameters) {
+        if (requestParameters['sandboxId'] == null) {
+            throw new runtime.RequiredError('sandboxId', 'Required parameter "sandboxId" was null or undefined when calling listFiles().');
+        }
+        const queryParameters = {};
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/sandboxes/{sandboxId}/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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.listFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for listNamedSnapshots without sending the request
      * @deprecated
@@ -3163,6 +3420,54 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.meRaw(initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for moveFile without sending the request
+     */
+    async moveFileRequestOpts(input) {
+        const requestParameters = runtime.unflattenBody(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 = {};
+        const headerParameters = {};
+        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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.moveFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for processes without sending the request
      */
@@ -3334,7 +3639,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, initOverrides) {
@@ -3343,7 +3648,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => FileReadResponseFromJSON(jsonValue));
     }
     /**
-     * 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, initOverrides) {
@@ -3392,6 +3697,54 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.recoverRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for replaceInFiles without sending the request
+     */
+    async replaceInFilesRequestOpts(input) {
+        const requestParameters = runtime.unflattenBody(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 = {};
+        const headerParameters = {};
+        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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.replaceInFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for repos without sending the request
      */
@@ -3517,7 +3870,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, initOverrides) {
@@ -3526,7 +3879,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => ApiKeyRevokeResponseFromJSON(jsonValue));
     }
     /**
-     * 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, initOverrides) {
@@ -3605,7 +3958,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, initOverrides) {
@@ -3614,7 +3967,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => ApiKeySecretResponseFromJSON(jsonValue));
     }
     /**
-     * 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, initOverrides) {
@@ -3813,6 +4166,57 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.saveSavedSnapshotRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for searchFiles without sending the request
+     */
+    async searchFilesRequestOpts(requestParameters) {
+        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 = {};
+        if (requestParameters['path'] != null) {
+            queryParameters['path'] = requestParameters['path'];
+        }
+        if (requestParameters['pattern'] != null) {
+            queryParameters['pattern'] = requestParameters['pattern'];
+        }
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BoatBearerAuth", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/sandboxes/{sandboxId}/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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.searchFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for secrets without sending the request
      */
@@ -4149,6 +4553,54 @@ export class BoatApi extends runtime.BaseAPI {
         const response = await this.setEnvironmentVarRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for setFilePermissions without sending the request
+     */
+    async setFilePermissionsRequestOpts(input) {
+        const requestParameters = runtime.unflattenBody(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 = {};
+        const headerParameters = {};
+        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, initOverrides) {
+        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, initOverrides) {
+        const response = await this.setFilePermissionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for setSandboxAiAccess without sending the request
      */
@@ -4645,7 +5097,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, initOverrides) {
@@ -4654,7 +5106,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => AiProxySettingsFromJSON(jsonValue));
     }
     /**
-     * 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, initOverrides) {
@@ -5070,7 +5522,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, initOverrides) {
@@ -5079,7 +5531,7 @@ export class BoatApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => FileWriteResponseFromJSON(jsonValue));
     }
     /**
-     * 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, initOverrides) {