tensorlake 0.5.140 → 0.5.142

package/dist/index.d.cts

@@ -79,7 +79,8 @@ interface NativeSandboxClient {
     getArchivedSandbox(sandboxId: string): Promise<TracedJson>;
     getSandboxLogs(requestJson: string): Promise<TracedJson>;
     listSandboxLogProcesses(sandboxId: string): Promise<TracedJson>;
-    updateSandbox(sandboxId: string, requestJson: string): Promise<TracedJson>;
+    updateSandbox(sandboxId: string, requestJson: string, wait?: boolean, timeoutSec?: number, pollIntervalSec?: number): Promise<TracedJson>;
+    waitForResourceResize(sandboxId: string, generation: number, timeoutSec?: number, pollIntervalSec?: number): Promise<TracedJson>;
     deleteSandbox(sandboxId: string): Promise<string>;
     suspendSandbox(sandboxId: string): Promise<string>;
     resumeSandbox(sandboxId: string): Promise<string>;
@@ -303,9 +304,9 @@ interface CreateSandboxOptions {
     image?: string;
     /** CPU count. Defaults to 1 for fresh creates; snapshot restores inherit it when omitted. */
     cpus?: number;
-    /** Memory in MB. Defaults to 1024 for fresh creates; snapshot restores inherit it when omitted. */
+    /** Memory in MiB. Defaults to 1024 for fresh creates; snapshot restores inherit it when omitted. */
     memoryMb?: number;
-    /** Root disk size in megabytes. When omitted, the server uses its default disk size. */
+    /** Root disk size in MiB. When omitted, the server uses its default disk size. */
     diskMb?: number;
     /** Number of GPUs to allocate. Defaults to A10 unless gpuModel is set. GPU sandboxes require a CAS image. */
     gpus?: number;
@@ -340,7 +341,42 @@ interface CreateSandboxOptions {
      */
     maxPendingSecs?: number;
 }
-interface UpdateSandboxOptions {
+/**
+ * Bounded generation wait. Timeout never cancels a resize. Times are seconds.
+ * A zero timeout checks once without polling again.
+ */
+interface ResourceResizeWaitOptions {
+    timeout?: number;
+    pollInterval?: number;
+}
+declare enum ResizeStatus {
+    PENDING = "pending",
+    SUCCEEDED = "succeeded",
+    FAILED = "failed"
+}
+declare enum ResizeErrorReason {
+    FAILED = "failed",
+    TIMEOUT = "timeout",
+    SUPERSEDED = "superseded",
+    INTERRUPTED = "interrupted",
+    INCOMPATIBLE_RESPONSE = "incompatible_response"
+}
+interface SandboxResourceResizeInfo {
+    generation: number;
+    requested: ContainerResourcesInfo;
+    status: ResizeStatus | (string & {});
+    errorMessage?: string | null;
+}
+/** Wait options apply only to resource updates and are ignored for other properties. */
+interface UpdateSandboxOptions extends ResourceResizeWaitOptions {
+    /** Whole live vCPU target; omitted retains the current allocation. */
+    cpus?: number;
+    /** Memory target in MiB, with the same units as create; never rounded by the SDK. */
+    memoryMb?: number;
+    /** Root disk target in MiB; can only grow. */
+    diskMb?: number;
+    /** Wait for resize completion (default true). False returns admission. */
+    wait?: boolean;
     /** New name for the sandbox. Naming an ephemeral sandbox enables suspend/resume. */
     name?: string;
     /** Whether exposed user ports should be reachable without TensorLake auth. */
@@ -428,6 +464,8 @@ interface CopySandboxResponse {
     sandboxes: CopiedSandboxResponse[];
 }
 interface SandboxInfo {
+    runtime?: string;
+    resourceResize?: SandboxResourceResizeInfo | null;
     sandboxId: string;
     namespace: string;
     status: SandboxStatus;
@@ -555,7 +593,7 @@ interface CreatePoolOptions {
     image: string;
     cpus?: number;
     memoryMb?: number;
-    /** Root disk size in megabytes. Omit to use the registered image's size. */
+    /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
     timeoutSecs?: number;
     entrypoint?: string[];
@@ -575,7 +613,7 @@ interface UpdatePoolOptions {
     image: string;
     cpus?: number;
     memoryMb?: number;
-    /** Root disk size in megabytes. Omit to use the registered image's size. */
+    /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
     timeoutSecs?: number;
     entrypoint?: string[];
@@ -759,9 +797,12 @@ interface SandboxClientOptions {
     namespace?: string;
     maxRetries?: number;
     retryBackoffMs?: number;
-    /** Total HTTP request timeout in seconds. Default: 300. */
+    /**
+     * HTTP request timeout in seconds. For a streamed response it bounds the
+     * wait for the stream to start and each wait for more data. Default: 300.
+     */
     requestTimeout?: number;
-    /** @deprecated Use requestTimeout. Total HTTP request timeout in milliseconds. */
+    /** @deprecated Use requestTimeout. HTTP request timeout in milliseconds. */
     timeoutMs?: number;
 }
 interface SandboxOptions {
@@ -781,9 +822,14 @@ interface SandboxOptions {
     resolveProxyInfo?: (identifier: string) => Promise<SandboxInfo & {
         readonly traceId: string;
     }>;
-    /** Optional total HTTP request timeout in seconds for sandbox proxy operations. Omit for no total proxy timeout. */
+    /**
+     * Optional HTTP request timeout in seconds for sandbox proxy operations. For
+     * streamed responses, such as `run()` and output follows, it bounds the wait
+     * for the stream to start and each wait for more data. Omit for no proxy
+     * timeout.
+     */
     requestTimeout?: number;
-    /** @deprecated Use requestTimeout. Optional total HTTP request timeout in milliseconds for sandbox proxy operations. */
+    /** @deprecated Use requestTimeout. Optional HTTP request timeout in milliseconds for sandbox proxy operations. */
     timeoutMs?: number;
     /**
      * @internal Shared Rust-backed lifecycle client. When provided, the proxy
@@ -1132,14 +1178,20 @@ declare class Sandbox {
      */
     status(): Promise<SandboxStatus>;
     /**
-     * Update this sandbox's properties (name, exposed ports, proxy auth, and
-     * egress network policy).
+     * Update this sandbox's properties or resize its resources.
+     *
+     * Resource targets use create's cpus, memoryMb, and diskMb names. Resize
+     * waits by default; wait=false returns admission. Timeout does not cancel it.
+     * Wait, timeout, and pollInterval are ignored on non-resource updates.
+     * A no-op returns current resources with absent or earlier resize metadata.
      *
      * Naming an ephemeral sandbox makes it non-ephemeral and enables
      * suspend/resume. For `network`, omit to keep the current policy, pass an
      * object to replace it, or pass `null` to clear it to unrestricted egress.
      */
     update(options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
+    /** Wait for this exact resize generation without submitting another update. */
+    waitForResourceResize(generation: number, options?: ResourceResizeWaitOptions): Promise<Traced<SandboxInfo>>;
     /**
      * Suspend this sandbox.
      *
@@ -1451,8 +1503,16 @@ declare class SandboxClient {
     getLogs(sandboxId: string, options?: GetSandboxLogsOptions): Promise<Traced<SandboxLogsResponse>>;
     /** List sandbox processes available as persisted-log filters. */
     listLogProcesses(sandboxId: string): Promise<Traced<SandboxProcessLogFiltersResponse>>;
-    /** Update sandbox properties such as name, exposed ports, and proxy auth settings. */
+    /**
+     * Update properties or resize a Running Cloud Hypervisor sandbox.
+     * Resource names match create. Resize waits by default; wait=false returns
+     * admission. Timeout leaves the resize running and reports its generation.
+     * Wait, timeout, and pollInterval are ignored on non-resource updates.
+     * A no-op returns current resources with absent or earlier resize metadata.
+     */
     update(sandboxId: string, options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
+    /** Wait for this exact generation. Timeout leaves the resize running. */
+    waitForResourceResize(sandboxId: string, generation: number, options?: ResourceResizeWaitOptions): Promise<Traced<SandboxInfo>>;
     /** Get the current proxy port settings for a sandbox. */
     getPortAccess(sandboxId: string): Promise<SandboxPortAccess>;
     /** Add one or more user ports to the sandbox proxy allowlist. */
@@ -2274,6 +2334,21 @@ declare class SandboxError extends SandboxException {
         sandboxId?: string;
     });
 }
+/** A failed, timed-out, interrupted, or superseded resize, with confirmed allocation. */
+declare class SandboxResizeError extends SandboxError {
+    readonly reason: ResizeErrorReason;
+    readonly generation: number;
+    readonly info?: SandboxInfo;
+    constructor(payload: {
+        sandboxId: string;
+        generation: number;
+        reason: ResizeErrorReason;
+        message: string;
+        info?: SandboxInfo | null;
+    });
+    /** Last confirmed allocation, if an observation was available. */
+    get confirmedResources(): ContainerResourcesInfo | undefined;
+}
 /**
  * The wait budget ran out while the sandbox was still queued.
  *
@@ -2349,4 +2424,4 @@ declare class RequestExecutionError extends Error {
     constructor(message: string, functionName?: string);
 }
 
-export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint };
+export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint };

package/dist/index.d.ts

@@ -79,7 +79,8 @@ interface NativeSandboxClient {
     getArchivedSandbox(sandboxId: string): Promise<TracedJson>;
     getSandboxLogs(requestJson: string): Promise<TracedJson>;
     listSandboxLogProcesses(sandboxId: string): Promise<TracedJson>;
-    updateSandbox(sandboxId: string, requestJson: string): Promise<TracedJson>;
+    updateSandbox(sandboxId: string, requestJson: string, wait?: boolean, timeoutSec?: number, pollIntervalSec?: number): Promise<TracedJson>;
+    waitForResourceResize(sandboxId: string, generation: number, timeoutSec?: number, pollIntervalSec?: number): Promise<TracedJson>;
     deleteSandbox(sandboxId: string): Promise<string>;
     suspendSandbox(sandboxId: string): Promise<string>;
     resumeSandbox(sandboxId: string): Promise<string>;
@@ -303,9 +304,9 @@ interface CreateSandboxOptions {
     image?: string;
     /** CPU count. Defaults to 1 for fresh creates; snapshot restores inherit it when omitted. */
     cpus?: number;
-    /** Memory in MB. Defaults to 1024 for fresh creates; snapshot restores inherit it when omitted. */
+    /** Memory in MiB. Defaults to 1024 for fresh creates; snapshot restores inherit it when omitted. */
     memoryMb?: number;
-    /** Root disk size in megabytes. When omitted, the server uses its default disk size. */
+    /** Root disk size in MiB. When omitted, the server uses its default disk size. */
     diskMb?: number;
     /** Number of GPUs to allocate. Defaults to A10 unless gpuModel is set. GPU sandboxes require a CAS image. */
     gpus?: number;
@@ -340,7 +341,42 @@ interface CreateSandboxOptions {
      */
     maxPendingSecs?: number;
 }
-interface UpdateSandboxOptions {
+/**
+ * Bounded generation wait. Timeout never cancels a resize. Times are seconds.
+ * A zero timeout checks once without polling again.
+ */
+interface ResourceResizeWaitOptions {
+    timeout?: number;
+    pollInterval?: number;
+}
+declare enum ResizeStatus {
+    PENDING = "pending",
+    SUCCEEDED = "succeeded",
+    FAILED = "failed"
+}
+declare enum ResizeErrorReason {
+    FAILED = "failed",
+    TIMEOUT = "timeout",
+    SUPERSEDED = "superseded",
+    INTERRUPTED = "interrupted",
+    INCOMPATIBLE_RESPONSE = "incompatible_response"
+}
+interface SandboxResourceResizeInfo {
+    generation: number;
+    requested: ContainerResourcesInfo;
+    status: ResizeStatus | (string & {});
+    errorMessage?: string | null;
+}
+/** Wait options apply only to resource updates and are ignored for other properties. */
+interface UpdateSandboxOptions extends ResourceResizeWaitOptions {
+    /** Whole live vCPU target; omitted retains the current allocation. */
+    cpus?: number;
+    /** Memory target in MiB, with the same units as create; never rounded by the SDK. */
+    memoryMb?: number;
+    /** Root disk target in MiB; can only grow. */
+    diskMb?: number;
+    /** Wait for resize completion (default true). False returns admission. */
+    wait?: boolean;
     /** New name for the sandbox. Naming an ephemeral sandbox enables suspend/resume. */
     name?: string;
     /** Whether exposed user ports should be reachable without TensorLake auth. */
@@ -428,6 +464,8 @@ interface CopySandboxResponse {
     sandboxes: CopiedSandboxResponse[];
 }
 interface SandboxInfo {
+    runtime?: string;
+    resourceResize?: SandboxResourceResizeInfo | null;
     sandboxId: string;
     namespace: string;
     status: SandboxStatus;
@@ -555,7 +593,7 @@ interface CreatePoolOptions {
     image: string;
     cpus?: number;
     memoryMb?: number;
-    /** Root disk size in megabytes. Omit to use the registered image's size. */
+    /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
     timeoutSecs?: number;
     entrypoint?: string[];
@@ -575,7 +613,7 @@ interface UpdatePoolOptions {
     image: string;
     cpus?: number;
     memoryMb?: number;
-    /** Root disk size in megabytes. Omit to use the registered image's size. */
+    /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
     timeoutSecs?: number;
     entrypoint?: string[];
@@ -759,9 +797,12 @@ interface SandboxClientOptions {
     namespace?: string;
     maxRetries?: number;
     retryBackoffMs?: number;
-    /** Total HTTP request timeout in seconds. Default: 300. */
+    /**
+     * HTTP request timeout in seconds. For a streamed response it bounds the
+     * wait for the stream to start and each wait for more data. Default: 300.
+     */
     requestTimeout?: number;
-    /** @deprecated Use requestTimeout. Total HTTP request timeout in milliseconds. */
+    /** @deprecated Use requestTimeout. HTTP request timeout in milliseconds. */
     timeoutMs?: number;
 }
 interface SandboxOptions {
@@ -781,9 +822,14 @@ interface SandboxOptions {
     resolveProxyInfo?: (identifier: string) => Promise<SandboxInfo & {
         readonly traceId: string;
     }>;
-    /** Optional total HTTP request timeout in seconds for sandbox proxy operations. Omit for no total proxy timeout. */
+    /**
+     * Optional HTTP request timeout in seconds for sandbox proxy operations. For
+     * streamed responses, such as `run()` and output follows, it bounds the wait
+     * for the stream to start and each wait for more data. Omit for no proxy
+     * timeout.
+     */
     requestTimeout?: number;
-    /** @deprecated Use requestTimeout. Optional total HTTP request timeout in milliseconds for sandbox proxy operations. */
+    /** @deprecated Use requestTimeout. Optional HTTP request timeout in milliseconds for sandbox proxy operations. */
     timeoutMs?: number;
     /**
      * @internal Shared Rust-backed lifecycle client. When provided, the proxy
@@ -1132,14 +1178,20 @@ declare class Sandbox {
      */
     status(): Promise<SandboxStatus>;
     /**
-     * Update this sandbox's properties (name, exposed ports, proxy auth, and
-     * egress network policy).
+     * Update this sandbox's properties or resize its resources.
+     *
+     * Resource targets use create's cpus, memoryMb, and diskMb names. Resize
+     * waits by default; wait=false returns admission. Timeout does not cancel it.
+     * Wait, timeout, and pollInterval are ignored on non-resource updates.
+     * A no-op returns current resources with absent or earlier resize metadata.
      *
      * Naming an ephemeral sandbox makes it non-ephemeral and enables
      * suspend/resume. For `network`, omit to keep the current policy, pass an
      * object to replace it, or pass `null` to clear it to unrestricted egress.
      */
     update(options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
+    /** Wait for this exact resize generation without submitting another update. */
+    waitForResourceResize(generation: number, options?: ResourceResizeWaitOptions): Promise<Traced<SandboxInfo>>;
     /**
      * Suspend this sandbox.
      *
@@ -1451,8 +1503,16 @@ declare class SandboxClient {
     getLogs(sandboxId: string, options?: GetSandboxLogsOptions): Promise<Traced<SandboxLogsResponse>>;
     /** List sandbox processes available as persisted-log filters. */
     listLogProcesses(sandboxId: string): Promise<Traced<SandboxProcessLogFiltersResponse>>;
-    /** Update sandbox properties such as name, exposed ports, and proxy auth settings. */
+    /**
+     * Update properties or resize a Running Cloud Hypervisor sandbox.
+     * Resource names match create. Resize waits by default; wait=false returns
+     * admission. Timeout leaves the resize running and reports its generation.
+     * Wait, timeout, and pollInterval are ignored on non-resource updates.
+     * A no-op returns current resources with absent or earlier resize metadata.
+     */
     update(sandboxId: string, options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
+    /** Wait for this exact generation. Timeout leaves the resize running. */
+    waitForResourceResize(sandboxId: string, generation: number, options?: ResourceResizeWaitOptions): Promise<Traced<SandboxInfo>>;
     /** Get the current proxy port settings for a sandbox. */
     getPortAccess(sandboxId: string): Promise<SandboxPortAccess>;
     /** Add one or more user ports to the sandbox proxy allowlist. */
@@ -2274,6 +2334,21 @@ declare class SandboxError extends SandboxException {
         sandboxId?: string;
     });
 }
+/** A failed, timed-out, interrupted, or superseded resize, with confirmed allocation. */
+declare class SandboxResizeError extends SandboxError {
+    readonly reason: ResizeErrorReason;
+    readonly generation: number;
+    readonly info?: SandboxInfo;
+    constructor(payload: {
+        sandboxId: string;
+        generation: number;
+        reason: ResizeErrorReason;
+        message: string;
+        info?: SandboxInfo | null;
+    });
+    /** Last confirmed allocation, if an observation was available. */
+    get confirmedResources(): ContainerResourcesInfo | undefined;
+}
 /**
  * The wait budget ran out while the sandbox was still queued.
  *
@@ -2349,4 +2424,4 @@ declare class RequestExecutionError extends Error {
     constructor(message: string, functionName?: string);
 }
 
-export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint };
+export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint };