@boatdev/sdk 1.10.0 → 1.12.0

package/dist/apis/BoatApi.d.ts

@@ -46,7 +46,18 @@ import { type DesktopRequest } from '../models/DesktopRequest';
 import { type DesktopResponse } from '../models/DesktopResponse';
 import { type EnvironmentItemChangeResponse } from '../models/EnvironmentItemChangeResponse';
 import { type EventsResponse } from '../models/EventsResponse';
+import { type FileDeleteResponse } from '../models/FileDeleteResponse';
+import { type FileFindResponse } from '../models/FileFindResponse';
+import { type FileFolderRequest } from '../models/FileFolderRequest';
+import { type FileInfoResponse } from '../models/FileInfoResponse';
+import { type FileListResponse } from '../models/FileListResponse';
+import { type FileMoveRequest } from '../models/FileMoveRequest';
+import { type FileMoveResponse } from '../models/FileMoveResponse';
+import { type FilePermissionsRequest } from '../models/FilePermissionsRequest';
 import { type FileReadResponse } from '../models/FileReadResponse';
+import { type FileReplaceRequest } from '../models/FileReplaceRequest';
+import { type FileReplaceResponse } from '../models/FileReplaceResponse';
+import { type FileSearchResponse } from '../models/FileSearchResponse';
 import { type FileUrlRequest } from '../models/FileUrlRequest';
 import { type FileUrlResponse } from '../models/FileUrlResponse';
 import { type FileWriteRequest } from '../models/FileWriteRequest';
@@ -82,6 +93,11 @@ import { type SandboxEnvironmentResponse } from '../models/SandboxEnvironmentRes
 import { type SandboxInfoResponse } from '../models/SandboxInfoResponse';
 import { type SandboxListResponse } from '../models/SandboxListResponse';
 import { type SandboxUsageResponse } from '../models/SandboxUsageResponse';
+import { type SavedSnapshotDeletedResponse } from '../models/SavedSnapshotDeletedResponse';
+import { type SavedSnapshotInfoResponse } from '../models/SavedSnapshotInfoResponse';
+import { type SavedSnapshotListResponse } from '../models/SavedSnapshotListResponse';
+import { type SavedSnapshotSaveRequest } from '../models/SavedSnapshotSaveRequest';
+import { type SavedSnapshotSavingResponse } from '../models/SavedSnapshotSavingResponse';
 import { type SecretsResponse } from '../models/SecretsResponse';
 import { type SecretsUpdateRequest } from '../models/SecretsUpdateRequest';
 import { type SetCredentialKeyRequest } from '../models/SetCredentialKeyRequest';
@@ -187,6 +203,10 @@ export interface CreateEnvironmentRequest {
     createSandboxEnvironmentRequest: CreateSandboxEnvironmentRequest;
     org?: string;
 }
+export interface CreateFolderRequest {
+    sandboxId: string;
+    fileFolderRequest: FileFolderRequest;
+}
 export interface CreateScopedApiKeyOperationRequest {
     createScopedApiKeyRequest: CreateScopedApiKeyRequest;
 }
@@ -235,6 +255,11 @@ export interface DeleteEnvironmentVarRequest {
     key: string;
     org?: string;
 }
+export interface DeleteFileRequest {
+    sandboxId: string;
+    path: string;
+    recursive?: boolean;
+}
 export interface DeleteNamedSnapshotRequest {
     name: string;
 }
@@ -246,6 +271,9 @@ export interface DeleteSandboxSnapshotsRequest {
     sandboxId: string;
     xAsciiConfirmDelete: string;
 }
+export interface DeleteSavedSnapshotRequest {
+    name: string;
+}
 export interface DeleteSnapshotRequest {
     snapshotId: string;
     xAsciiConfirmDelete: string;
@@ -270,6 +298,12 @@ export interface EventsRequest {
     type?: string;
     conversation?: string;
 }
+export interface FindInFilesRequest {
+    sandboxId: string;
+    pattern: string;
+    path?: string;
+    regex?: boolean;
+}
 export interface ForkOperationRequest {
     sandboxId: string;
     idempotencyKey?: string;
@@ -295,6 +329,10 @@ export interface GetCommandRequest {
 export interface GetDeletionOperationRequest {
     operationId: string;
 }
+export interface GetFileInfoRequest {
+    sandboxId: string;
+    path: string;
+}
 export interface GetLatestSandboxSnapshotRequest {
     sandboxId: string;
 }
@@ -305,6 +343,9 @@ export interface GetSandboxAiUsageRequest {
     sandboxId: string;
     days?: number;
 }
+export interface GetSavedSnapshotRequest {
+    name: string;
+}
 export interface GetSnapshotDownloadRequest {
     snapshotId: string;
 }
@@ -339,6 +380,10 @@ export interface ListCredentialAccountsRequest {
     profile: string;
     credential: CredentialId;
 }
+export interface ListFilesRequest {
+    sandboxId: string;
+    path?: string;
+}
 export interface ListSandboxSnapshotsRequest {
     sandboxId: string;
     limit?: number;
@@ -353,6 +398,10 @@ export interface ListSnapshotsRequest {
     cursor?: string | null;
     sort?: ListSnapshotsSortEnum;
 }
+export interface MoveFileRequest {
+    sandboxId: string;
+    fileMoveRequest: FileMoveRequest;
+}
 export interface ProcessesRequest {
     sandboxId: string;
 }
@@ -372,6 +421,10 @@ export interface ReadFileRequest {
 export interface RecoverRequest {
     sandboxId: string;
 }
+export interface ReplaceInFilesRequest {
+    sandboxId: string;
+    fileReplaceRequest: FileReplaceRequest;
+}
 export interface ReposRequest {
     sync?: boolean;
     limit?: number;
@@ -409,6 +462,14 @@ export interface SandboxesRequest {
 export interface SaveNamedSnapshotRequest {
     namedSnapshotSaveRequest: NamedSnapshotSaveRequest;
 }
+export interface SaveSavedSnapshotRequest {
+    savedSnapshotSaveRequest: SavedSnapshotSaveRequest;
+}
+export interface SearchFilesRequest {
+    sandboxId: string;
+    pattern: string;
+    path?: string;
+}
 export interface SelectRepoRequest {
     repoSelectionRequest: RepoSelectionRequest;
 }
@@ -436,6 +497,10 @@ export interface SetEnvironmentVarOperationRequest {
     setEnvironmentVarRequest: SetEnvironmentVarRequest;
     org?: string;
 }
+export interface SetFilePermissionsRequest {
+    sandboxId: string;
+    filePermissionsRequest: FilePermissionsRequest;
+}
 export interface SetSandboxAiAccessOperationRequest {
     sandboxId: string;
     setSandboxAiAccessRequest: SetSandboxAiAccessRequest;
@@ -731,17 +796,31 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Create a sandbox environment
      */
     createEnvironment(requestParameters: CreateEnvironmentRequest | runtime.FlatBody<CreateEnvironmentRequest, 'createSandboxEnvironmentRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SandboxEnvironmentListResponse>;
+    /**
+     * Creates request options for createFolder without sending the request
+     */
+    createFolderRequestOpts(input: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Missing parent directories are created. An existing directory is not an error. Needs `file.write`.
+     * Create a directory in a sandbox
+     */
+    createFolderRaw(requestParameters: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>>;
+    /**
+     * Missing parent directories are created. An existing directory is not an error. Needs `file.write`.
+     * Create a directory in a sandbox
+     */
+    createFolder(requestParameters: CreateFolderRequest | runtime.FlatBody<CreateFolderRequest, 'fileFolderRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse>;
     /**
      * Creates request options for createScopedApiKey without sending the request
      */
     createScopedApiKeyRequestOpts(input: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>): Promise<runtime.RequestOpts>;
     /**
-     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. This dedicated path returns a typed 503 until scoped credential creation is activated.
+     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. An unknown field is a 400, so a misspelled scope never creates a full-access key. environmentIds takes your own environments and the org environments you can use. This dedicated path returns a typed 503 until scoped credential creation is activated.
      * Create a scoped API key
      */
     createScopedApiKeyRaw(requestParameters: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeySecretResponse>>;
     /**
-     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. This dedicated path returns a typed 503 until scoped credential creation is activated.
+     * Creates a scoped, expiring API key. Requires a dashboard/CLI session or an admin-scoped token. The secret is returned once. An unknown field is a 400, so a misspelled scope never creates a full-access key. environmentIds takes your own environments and the org environments you can use. This dedicated path returns a typed 503 until scoped credential creation is activated.
      * Create a scoped API key
      */
     createScopedApiKey(requestParameters: CreateScopedApiKeyOperationRequest | runtime.FlatBody<CreateScopedApiKeyOperationRequest, 'createScopedApiKeyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeySecretResponse>;
@@ -750,13 +829,13 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     createSnapshotShareRequestOpts(requestParameters: CreateSnapshotShareRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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
      */
     createSnapshotShareRaw(requestParameters: CreateSnapshotShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotShareCreatedResponse>>;
     /**
-     * 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
      */
     createSnapshotShare(requestParameters: CreateSnapshotShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotShareCreatedResponse>;
     /**
@@ -899,18 +978,35 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Remove one environment variable
      */
     deleteEnvironmentVar(requestParameters: DeleteEnvironmentVarRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EnvironmentItemChangeResponse>;
+    /**
+     * Creates request options for deleteFile without sending the request
+     */
+    deleteFileRequestOpts(requestParameters: DeleteFileRequest): Promise<runtime.RequestOpts>;
+    /**
+     * A directory needs `recursive=true`. A symlink is deleted itself, never its target. /home/user and /tmp themselves cannot be deleted. Needs `file.write`.
+     * Delete a file or directory in a sandbox
+     */
+    deleteFileRaw(requestParameters: DeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileDeleteResponse>>;
+    /**
+     * A directory needs `recursive=true`. A symlink is deleted itself, never its target. /home/user and /tmp themselves cannot be deleted. Needs `file.write`.
+     * Delete a file or directory in a sandbox
+     */
+    deleteFile(requestParameters: DeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileDeleteResponse>;
     /**
      * Creates request options for deleteNamedSnapshot without sending the request
+     * @deprecated
      */
     deleteNamedSnapshotRequestOpts(requestParameters: DeleteNamedSnapshotRequest): Promise<runtime.RequestOpts>;
     /**
      * 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
      */
     deleteNamedSnapshotRaw(requestParameters: DeleteNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotDeletedResponse>>;
     /**
      * 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
      */
     deleteNamedSnapshot(requestParameters: DeleteNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotDeletedResponse>;
     /**
@@ -918,12 +1014,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     deleteSandboxRequestOpts(requestParameters: DeleteSandboxRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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
      */
     deleteSandboxRaw(requestParameters: DeleteSandboxRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeletionOperationResponse>>;
     /**
-     * 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
      */
     deleteSandbox(requestParameters: DeleteSandboxRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletionOperationResponse>;
@@ -932,15 +1028,29 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     deleteSandboxSnapshotsRequestOpts(requestParameters: DeleteSandboxSnapshotsRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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
      */
     deleteSandboxSnapshotsRaw(requestParameters: DeleteSandboxSnapshotsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeletionOperationListResponse>>;
     /**
-     * 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
      */
     deleteSandboxSnapshots(requestParameters: DeleteSandboxSnapshotsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletionOperationListResponse>;
+    /**
+     * Creates request options for deleteSavedSnapshot without sending the request
+     */
+    deleteSavedSnapshotRequestOpts(requestParameters: DeleteSavedSnapshotRequest): Promise<runtime.RequestOpts>;
+    /**
+     * 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
+     */
+    deleteSavedSnapshotRaw(requestParameters: DeleteSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotDeletedResponse>>;
+    /**
+     * 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
+     */
+    deleteSavedSnapshot(requestParameters: DeleteSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotDeletedResponse>;
     /**
      * Creates request options for deleteSnapshot without sending the request
      */
@@ -1025,6 +1135,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * List boat events
      */
     events(requestParameters: EventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventsResponse>;
+    /**
+     * Creates request options for findInFiles without sending the request
+     */
+    findInFilesRequestOpts(requestParameters: FindInFilesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Every line under `path` that contains `pattern`. `pattern` is plain text; with `regex=true` it is an extended regular expression. Binary files are skipped and symlinks are not followed. Needs `file.read`.
+     * Find text in sandbox files
+     */
+    findInFilesRaw(requestParameters: FindInFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileFindResponse>>;
+    /**
+     * Every line under `path` that contains `pattern`. `pattern` is plain text; with `regex=true` it is an extended regular expression. Binary files are skipped and symlinks are not followed. Needs `file.read`.
+     * Find text in sandbox files
+     */
+    findInFiles(requestParameters: FindInFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileFindResponse>;
     /**
      * Creates request options for fork without sending the request
      */
@@ -1121,6 +1245,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Get deletion operation
      */
     getDeletionOperation(requestParameters: GetDeletionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletionOperationResponse>;
+    /**
+     * Creates request options for getFileInfo without sending the request
+     */
+    getFileInfoRequestOpts(requestParameters: GetFileInfoRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Size, permission bits, type and modification time. Needs `file.read`.
+     * Get file or directory details in a sandbox
+     */
+    getFileInfoRaw(requestParameters: GetFileInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>>;
+    /**
+     * Size, permission bits, type and modification time. Needs `file.read`.
+     * Get file or directory details in a sandbox
+     */
+    getFileInfo(requestParameters: GetFileInfoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse>;
     /**
      * Creates request options for getLatestSandboxSnapshot without sending the request
      */
@@ -1137,14 +1275,17 @@ export declare class BoatApi extends runtime.BaseAPI {
     getLatestSandboxSnapshot(requestParameters: GetLatestSandboxSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SnapshotLatestResponse>;
     /**
      * Creates request options for getNamedSnapshot without sending the request
+     * @deprecated
      */
     getNamedSnapshotRequestOpts(requestParameters: GetNamedSnapshotRequest): Promise<runtime.RequestOpts>;
     /**
      * Get a named snapshot
+     * @deprecated
      */
     getNamedSnapshotRaw(requestParameters: GetNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotInfoResponse>>;
     /**
      * Get a named snapshot
+     * @deprecated
      */
     getNamedSnapshot(requestParameters: GetNamedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotInfoResponse>;
     /**
@@ -1161,6 +1302,18 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Get sandbox AI usage
      */
     getSandboxAiUsage(requestParameters: GetSandboxAiUsageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SandboxAiUsageResponse>;
+    /**
+     * Creates request options for getSavedSnapshot without sending the request
+     */
+    getSavedSnapshotRequestOpts(requestParameters: GetSavedSnapshotRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get a saved snapshot
+     */
+    getSavedSnapshotRaw(requestParameters: GetSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotInfoResponse>>;
+    /**
+     * Get a saved snapshot
+     */
+    getSavedSnapshot(requestParameters: GetSavedSnapshotRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotInfoResponse>;
     /**
      * Creates request options for getSnapshotDownload without sending the request
      */
@@ -1278,12 +1431,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     limitsRequestOpts(requestParameters: LimitsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Check remaining machine starts, compute time, credits, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
+     * Check remaining machine starts, included VM time, the wallet, overage prices, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
      * Get Boat limits
      */
     limitsRaw(requestParameters: LimitsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<LimitsResponse>>;
     /**
-     * Check remaining machine starts, compute time, credits, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
+     * Check remaining machine starts, included VM time, the wallet, overage prices, access readiness, and concurrent-sandbox capacity for the wallet a create would bill: the `org` / `X-Boat-Org` you pass (id or name), else the account\'s active wallet, else personal. The response carries `teamId` when an organization wallet was read.
      * Get Boat limits
      */
     limits(requestParameters?: LimitsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<LimitsResponse>;
@@ -1315,18 +1468,35 @@ export declare class BoatApi extends runtime.BaseAPI {
      * List credential profiles
      */
     listCredentialProfiles(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CredentialProfileListResponse>;
+    /**
+     * Creates request options for listFiles without sending the request
+     */
+    listFilesRequestOpts(requestParameters: ListFilesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * One level, sorted by name. A symlink is listed as a symlink, not followed. Defaults to /home/user. Needs `file.read`.
+     * List a directory in a sandbox
+     */
+    listFilesRaw(requestParameters: ListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileListResponse>>;
+    /**
+     * One level, sorted by name. A symlink is listed as a symlink, not followed. Defaults to /home/user. Needs `file.read`.
+     * List a directory in a sandbox
+     */
+    listFiles(requestParameters: ListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileListResponse>;
     /**
      * Creates request options for listNamedSnapshots without sending the request
+     * @deprecated
      */
     listNamedSnapshotsRequestOpts(): Promise<runtime.RequestOpts>;
     /**
      * List your named snapshots, newest first.
      * List named snapshots
+     * @deprecated
      */
     listNamedSnapshotsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotListResponse>>;
     /**
      * List your named snapshots, newest first.
      * List named snapshots
+     * @deprecated
      */
     listNamedSnapshots(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotListResponse>;
     /**
@@ -1357,18 +1527,32 @@ export declare class BoatApi extends runtime.BaseAPI {
      * List boat snapshots
      */
     listSandboxSnapshots(requestParameters: ListSandboxSnapshotsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SnapshotListResponse>;
+    /**
+     * Creates request options for listSavedSnapshots without sending the request
+     */
+    listSavedSnapshotsRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * List your saved snapshots, newest first.
+     * List saved snapshots
+     */
+    listSavedSnapshotsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotListResponse>>;
+    /**
+     * List your saved snapshots, newest first.
+     * List saved snapshots
+     */
+    listSavedSnapshots(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotListResponse>;
     /**
      * Creates request options for listSnapshotShares without sending the request
      */
     listSnapshotSharesRequestOpts(requestParameters: ListSnapshotSharesRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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
      */
     listSnapshotSharesRaw(requestParameters: ListSnapshotSharesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotShareListResponse>>;
     /**
-     * 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
      */
     listSnapshotShares(requestParameters: ListSnapshotSharesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotShareListResponse>;
     /**
@@ -1413,6 +1597,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Get current Boat user
      */
     me(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MeResponse>;
+    /**
+     * Creates request options for moveFile without sending the request
+     */
+    moveFileRequestOpts(input: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Works across /home/user and /tmp. A symlink is moved itself, never its target. Needs `file.write`.
+     * Move or rename a file or directory in a sandbox
+     */
+    moveFileRaw(requestParameters: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileMoveResponse>>;
+    /**
+     * Works across /home/user and /tmp. A symlink is moved itself, never its target. Needs `file.write`.
+     * Move or rename a file or directory in a sandbox
+     */
+    moveFile(requestParameters: MoveFileRequest | runtime.FlatBody<MoveFileRequest, 'fileMoveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileMoveResponse>;
     /**
      * Creates request options for processes without sending the request
      */
@@ -1460,12 +1658,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     readFileRequestOpts(requestParameters: ReadFileRequest): Promise<runtime.RequestOpts>;
     /**
-     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`.
+     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command), so it reads the sandbox\'s own disk and never the machine\'s stock one.
      * Read a file from a sandbox
      */
     readFileRaw(requestParameters: ReadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileReadResponse>>;
     /**
-     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`.
+     * Files up to 5 MiB. For a larger file, use `POST /sandboxes/{sandboxId}/files/download-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command), so it reads the sandbox\'s own disk and never the machine\'s stock one.
      * Read a file from a sandbox
      */
     readFile(requestParameters: ReadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileReadResponse>;
@@ -1483,6 +1681,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Recover a sandbox that stopped responding
      */
     recover(requestParameters: RecoverRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Recover200Response>;
+    /**
+     * Creates request options for replaceInFiles without sending the request
+     */
+    replaceInFilesRequestOpts(input: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Replaces every occurrence of `pattern` with `newValue` in each file. Needs `file.write`.
+     * Replace text in sandbox files
+     */
+    replaceInFilesRaw(requestParameters: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileReplaceResponse>>;
+    /**
+     * Replaces every occurrence of `pattern` with `newValue` in each file. Needs `file.write`.
+     * Replace text in sandbox files
+     */
+    replaceInFiles(requestParameters: ReplaceInFilesRequest | runtime.FlatBody<ReplaceInFilesRequest, 'fileReplaceRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileReplaceResponse>;
     /**
      * Creates request options for repos without sending the request
      */
@@ -1514,12 +1726,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     revokeApiKeyRequestOpts(requestParameters: RevokeApiKeyRequest): Promise<runtime.RequestOpts>;
     /**
-     * Revokes the key immediately. Requires a dashboard or CLI session.
+     * Revokes the key immediately. Requires a dashboard or CLI session, or an admin-scoped key. A key revokes itself or a key it could create (same or fewer actions, sandboxes and environments, no later expiry).
      * Revoke an API key
      */
     revokeApiKeyRaw(requestParameters: RevokeApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeyRevokeResponse>>;
     /**
-     * Revokes the key immediately. Requires a dashboard or CLI session.
+     * Revokes the key immediately. Requires a dashboard or CLI session, or an admin-scoped key. A key revokes itself or a key it could create (same or fewer actions, sandboxes and environments, no later expiry).
      * Revoke an API key
      */
     revokeApiKey(requestParameters: RevokeApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeyRevokeResponse>;
@@ -1542,12 +1754,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     rotateApiKeyRequestOpts(requestParameters: RotateApiKeyRequest): Promise<runtime.RequestOpts>;
     /**
-     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session.
+     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session, or an admin-scoped key. A key rotates itself or a key it could create.
      * Rotate an API key
      */
     rotateApiKeyRaw(requestParameters: RotateApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ApiKeySecretResponse>>;
     /**
-     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session.
+     * Replaces the raw secret without changing expiry or scope. Requires a dashboard or CLI session, or an admin-scoped key. A key rotates itself or a key it could create.
      * Rotate an API key
      */
     rotateApiKey(requestParameters: RotateApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ApiKeySecretResponse>;
@@ -1581,18 +1793,49 @@ export declare class BoatApi extends runtime.BaseAPI {
     sandboxes(requestParameters?: SandboxesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SandboxListResponse>;
     /**
      * Creates request options for saveNamedSnapshot without sending the request
+     * @deprecated
      */
     saveNamedSnapshotRequestOpts(input: SaveNamedSnapshotRequest | runtime.FlatBody<SaveNamedSnapshotRequest, 'namedSnapshotSaveRequest'>): Promise<runtime.RequestOpts>;
     /**
      * 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
      */
     saveNamedSnapshotRaw(requestParameters: SaveNamedSnapshotRequest | runtime.FlatBody<SaveNamedSnapshotRequest, 'namedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<NamedSnapshotSavingResponse>>;
     /**
      * 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
      */
     saveNamedSnapshot(requestParameters: SaveNamedSnapshotRequest | runtime.FlatBody<SaveNamedSnapshotRequest, 'namedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<NamedSnapshotSavingResponse>;
+    /**
+     * Creates request options for saveSavedSnapshot without sending the request
+     */
+    saveSavedSnapshotRequestOpts(input: SaveSavedSnapshotRequest | runtime.FlatBody<SaveSavedSnapshotRequest, 'savedSnapshotSaveRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * 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
+     */
+    saveSavedSnapshotRaw(requestParameters: SaveSavedSnapshotRequest | runtime.FlatBody<SaveSavedSnapshotRequest, 'savedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SavedSnapshotSavingResponse>>;
+    /**
+     * 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
+     */
+    saveSavedSnapshot(requestParameters: SaveSavedSnapshotRequest | runtime.FlatBody<SaveSavedSnapshotRequest, 'savedSnapshotSaveRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SavedSnapshotSavingResponse>;
+    /**
+     * Creates request options for searchFiles without sending the request
+     */
+    searchFilesRequestOpts(requestParameters: SearchFilesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Every file and directory under `path` whose name matches the glob `pattern` (for example `*.py`). Symlinks are not followed. Needs `file.read`.
+     * Search files by name in a sandbox
+     */
+    searchFilesRaw(requestParameters: SearchFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileSearchResponse>>;
+    /**
+     * Every file and directory under `path` whose name matches the glob `pattern` (for example `*.py`). Symlinks are not followed. Needs `file.read`.
+     * Search files by name in a sandbox
+     */
+    searchFiles(requestParameters: SearchFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileSearchResponse>;
     /**
      * Creates request options for secrets without sending the request
      */
@@ -1691,6 +1934,20 @@ export declare class BoatApi extends runtime.BaseAPI {
      * Set one environment variable
      */
     setEnvironmentVar(requestParameters: SetEnvironmentVarOperationRequest | runtime.FlatBody<SetEnvironmentVarOperationRequest, 'setEnvironmentVarRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EnvironmentItemChangeResponse>;
+    /**
+     * Creates request options for setFilePermissions without sending the request
+     */
+    setFilePermissionsRequestOpts(input: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>): Promise<runtime.RequestOpts>;
+    /**
+     * Sets the permission bits. Files belong to the sandbox user; the owner and group do not change. Needs `file.write`.
+     * Set file permissions in a sandbox
+     */
+    setFilePermissionsRaw(requestParameters: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileInfoResponse>>;
+    /**
+     * Sets the permission bits. Files belong to the sandbox user; the owner and group do not change. Needs `file.write`.
+     * Set file permissions in a sandbox
+     */
+    setFilePermissions(requestParameters: SetFilePermissionsRequest | runtime.FlatBody<SetFilePermissionsRequest, 'filePermissionsRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileInfoResponse>;
     /**
      * Creates request options for setSandboxAiAccess without sending the request
      */
@@ -1834,12 +2091,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     updateAiProxyRequestOpts(input: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>): Promise<runtime.RequestOpts>;
     /**
-     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the account pays $1 of Boat time for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
+     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the wallet of the account pays $1 for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
      * Turn the AI credentials proxy on or off
      */
     updateAiProxyRaw(requestParameters: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiProxySettings>>;
     /**
-     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the account pays $1 of Boat time for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
+     * With the proxy on, sandboxes get placeholder keys and base URLs that point at Boat. Boat swaps in the real key on each request. Real keys never enter the sandbox.  Running sandboxes switch at their next start. While on, the wallet of the account pays $1 for each UTC day, plus $1 per 1,000 proxied requests, charged to the wallet each sandbox bills. For an organization, only its owner can change the switch. Needs an API key with `account.admin`.
      * Turn the AI credentials proxy on or off
      */
     updateAiProxy(requestParameters: UpdateAiProxyOperationRequest | runtime.FlatBody<UpdateAiProxyOperationRequest, 'updateAiProxyRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiProxySettings>;
@@ -1958,12 +2215,12 @@ export declare class BoatApi extends runtime.BaseAPI {
      */
     writeFileRequestOpts(input: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>): Promise<runtime.RequestOpts>;
     /**
-     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`.
+     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command): a sandbox\'s files are in place only once it is ready, so a write any earlier would not stay. A `200` always means the file is on the sandbox\'s disk.
      * Write a file in a sandbox
      */
     writeFileRaw(requestParameters: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileWriteResponse>>;
     /**
-     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`.
+     * Files up to 5 MiB after decoding. For a larger file, use `POST /sandboxes/{sandboxId}/files/upload-url`. On a sandbox that is still starting, the call waits until it is ready (up to 60 s, like a command): a sandbox\'s files are in place only once it is ready, so a write any earlier would not stay. A `200` always means the file is on the sandbox\'s disk.
      * Write a file in a sandbox
      */
     writeFile(requestParameters: WriteFileRequest | runtime.FlatBody<WriteFileRequest, 'fileWriteRequest'>, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileWriteResponse>;