@tensorlakeai/tensorlake 0.5.145 → 0.5.148

package/dist/index.d.cts

@@ -189,7 +189,7 @@ declare enum SnapshotStatus {
  * - `"filesystem"`: Capture filesystem state only. Sandboxes restored from
  *   this snapshot cold-boot from the snapshot tarball instead of warm-
  *   restoring VM state. Use this for sandbox image builds so that the
- *   restored sandbox bypasses Firecracker's overlay-path constraints.
+ *   restored sandbox bypasses the overlay-path constraints of non-CAS sandboxes.
  */
 type SnapshotType = "memory" | "filesystem";
 /**
@@ -224,6 +224,8 @@ interface ContainerResourcesInfo {
     cpus: number;
     memoryMb: number;
     diskMb: number;
+    /** Reported GPU allocation. Include it in a pool update to retain the allocation. */
+    gpuConfigs?: GPUResources[];
 }
 /** GPU models supported by the sandbox scheduler. */
 type GpuModel = "A100-40GB" | "A100-80GB" | "H100" | "T4" | "A6000" | "RTX-PRO-6000" | "L40" | "A10";
@@ -310,7 +312,7 @@ interface CreateSandboxOptions {
     diskMb?: number;
     /** Number of GPUs to allocate. Defaults to A10 unless gpuModel is set. GPU sandboxes require a CAS image. */
     gpus?: number;
-    /** GPU model to allocate. The string arm preserves compatibility with existing callers; values are validated at runtime. */
+    /** GPU model to allocate. Defaults to one GPU when gpus is omitted. The string arm preserves compatibility with existing callers; values are validated at runtime. */
     gpuModel?: GpuModel | (string & {});
     /** Typed GPU model and count request. Cannot be combined with gpus or gpuModel. */
     gpu?: GpuRequest;
@@ -595,6 +597,12 @@ interface CreatePoolOptions {
     memoryMb?: number;
     /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
+    /** GPUs per container. Defaults to A10 unless gpuModel is set. GPU CAS pools require a CAS image. */
+    gpus?: number;
+    /** GPU model to allocate for each container. Defaults to one GPU when gpus is omitted. Validated at runtime. */
+    gpuModel?: GpuModel | (string & {});
+    /** Typed GPU allocation. Cannot be combined with gpus or gpuModel. */
+    gpu?: GpuRequest;
     timeoutSecs?: number;
     entrypoint?: string[];
     maxContainers?: number;
@@ -615,6 +623,12 @@ interface UpdatePoolOptions {
     memoryMb?: number;
     /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
+    /** GPUs per container. Include on each update to keep a GPU CAS pool; omission configures a CPU-only CAS pool. Defaults to A10 unless gpuModel is set. */
+    gpus?: number;
+    /** GPU model to allocate for each container. Defaults to one GPU when gpus is omitted. Validated at runtime. */
+    gpuModel?: GpuModel | (string & {});
+    /** Typed GPU allocation. Cannot be combined with gpus or gpuModel. */
+    gpu?: GpuRequest;
     timeoutSecs?: number;
     entrypoint?: string[];
     maxContainers?: number;
@@ -753,10 +767,29 @@ interface RunOptions {
     timeout?: number;
     user?: ProcessUser;
 }
+/** Why a command run with `Sandbox.run()` ended. */
+declare enum CommandExitReason {
+    /** The process exited on its own; `exitCode` is its exit status. */
+    EXITED = "exited",
+    /** The process was killed by a signal; `exitCode` is `-signal`. */
+    SIGNALED = "signaled",
+    /** The kernel OOM killer terminated the process (`exitCode` is `-9`). */
+    OOM_KILLED = "oom_killed",
+    /** The run's `timeout` expired and the sandbox killed the process (`exitCode` is `-9`). */
+    TIMED_OUT = "timed_out"
+}
 interface CommandResult {
     exitCode: number;
     stdout: string;
     stderr: string;
+    /**
+     * Why the command ended. `Sandbox.run()` always sets it; sandboxes that
+     * predate timeout reporting never report `TIMED_OUT`, so a timed-out run on
+     * them shows as `SIGNALED`.
+     */
+    reason?: CommandExitReason;
+    /** True when the run's `timeout` expired and the process was killed. */
+    timedOut?: boolean;
 }
 interface DirectoryEntry {
     name: string;
@@ -1182,6 +1215,9 @@ declare class Sandbox {
      *
      * Resource targets use create's cpus, memoryMb, and diskMb names. Resize
      * waits by default; wait=false returns admission. Timeout does not cancel it.
+     * CPU-only CAS sandboxes support CPU, memory, and root-disk resize; GPU CAS sandboxes
+     * support only root-disk growth and reject CPU and memory changes.
+     * Non-CAS sandboxes do not support live resize.
      * Wait, timeout, and pollInterval are ignored on non-resource updates.
      * A no-op returns current resources with absent or earlier resize metadata.
      *
@@ -1504,7 +1540,9 @@ declare class SandboxClient {
     /** List sandbox processes available as persisted-log filters. */
     listLogProcesses(sandboxId: string): Promise<Traced<SandboxProcessLogFiltersResponse>>;
     /**
-     * Update properties or resize a Running Cloud Hypervisor sandbox.
+     * Update properties or resize a running sandbox. CPU-only CAS sandboxes support
+     * CPU, memory, and root-disk resize; GPU CAS sandboxes support only root-disk
+     * growth. Non-CAS sandboxes do not support live resize.
      * 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.
@@ -1605,9 +1643,9 @@ declare class SandboxClient {
      * network policy, set it to replace the policy, or pass `null` to remove the
      * policy entirely. On a change the service recycles the pool's unclaimed
      * warm containers onto the new policy, while containers already claimed by
-     * sandboxes keep the policy they booted with. CPU, memory, disk, image, and
-     * entrypoint changes likewise recycle unclaimed warm containers
-     * asynchronously. If suitable capacity is unavailable, stale warm
+     * sandboxes keep the policy they booted with. CPU, memory, disk, GPU
+     * allocation, image, and entrypoint changes likewise recycle unclaimed warm
+     * containers asynchronously. If suitable capacity is unavailable, stale warm
      * containers are not used as a fallback.
      */
     updatePool(poolId: string, options: UpdatePoolOptions): Promise<SandboxPoolInfo>;
@@ -2428,4 +2466,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, 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 };
+export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, 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

@@ -189,7 +189,7 @@ declare enum SnapshotStatus {
  * - `"filesystem"`: Capture filesystem state only. Sandboxes restored from
  *   this snapshot cold-boot from the snapshot tarball instead of warm-
  *   restoring VM state. Use this for sandbox image builds so that the
- *   restored sandbox bypasses Firecracker's overlay-path constraints.
+ *   restored sandbox bypasses the overlay-path constraints of non-CAS sandboxes.
  */
 type SnapshotType = "memory" | "filesystem";
 /**
@@ -224,6 +224,8 @@ interface ContainerResourcesInfo {
     cpus: number;
     memoryMb: number;
     diskMb: number;
+    /** Reported GPU allocation. Include it in a pool update to retain the allocation. */
+    gpuConfigs?: GPUResources[];
 }
 /** GPU models supported by the sandbox scheduler. */
 type GpuModel = "A100-40GB" | "A100-80GB" | "H100" | "T4" | "A6000" | "RTX-PRO-6000" | "L40" | "A10";
@@ -310,7 +312,7 @@ interface CreateSandboxOptions {
     diskMb?: number;
     /** Number of GPUs to allocate. Defaults to A10 unless gpuModel is set. GPU sandboxes require a CAS image. */
     gpus?: number;
-    /** GPU model to allocate. The string arm preserves compatibility with existing callers; values are validated at runtime. */
+    /** GPU model to allocate. Defaults to one GPU when gpus is omitted. The string arm preserves compatibility with existing callers; values are validated at runtime. */
     gpuModel?: GpuModel | (string & {});
     /** Typed GPU model and count request. Cannot be combined with gpus or gpuModel. */
     gpu?: GpuRequest;
@@ -595,6 +597,12 @@ interface CreatePoolOptions {
     memoryMb?: number;
     /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
+    /** GPUs per container. Defaults to A10 unless gpuModel is set. GPU CAS pools require a CAS image. */
+    gpus?: number;
+    /** GPU model to allocate for each container. Defaults to one GPU when gpus is omitted. Validated at runtime. */
+    gpuModel?: GpuModel | (string & {});
+    /** Typed GPU allocation. Cannot be combined with gpus or gpuModel. */
+    gpu?: GpuRequest;
     timeoutSecs?: number;
     entrypoint?: string[];
     maxContainers?: number;
@@ -615,6 +623,12 @@ interface UpdatePoolOptions {
     memoryMb?: number;
     /** Root disk size in MiB. Omit to use the registered image's size. */
     diskMb?: number;
+    /** GPUs per container. Include on each update to keep a GPU CAS pool; omission configures a CPU-only CAS pool. Defaults to A10 unless gpuModel is set. */
+    gpus?: number;
+    /** GPU model to allocate for each container. Defaults to one GPU when gpus is omitted. Validated at runtime. */
+    gpuModel?: GpuModel | (string & {});
+    /** Typed GPU allocation. Cannot be combined with gpus or gpuModel. */
+    gpu?: GpuRequest;
     timeoutSecs?: number;
     entrypoint?: string[];
     maxContainers?: number;
@@ -753,10 +767,29 @@ interface RunOptions {
     timeout?: number;
     user?: ProcessUser;
 }
+/** Why a command run with `Sandbox.run()` ended. */
+declare enum CommandExitReason {
+    /** The process exited on its own; `exitCode` is its exit status. */
+    EXITED = "exited",
+    /** The process was killed by a signal; `exitCode` is `-signal`. */
+    SIGNALED = "signaled",
+    /** The kernel OOM killer terminated the process (`exitCode` is `-9`). */
+    OOM_KILLED = "oom_killed",
+    /** The run's `timeout` expired and the sandbox killed the process (`exitCode` is `-9`). */
+    TIMED_OUT = "timed_out"
+}
 interface CommandResult {
     exitCode: number;
     stdout: string;
     stderr: string;
+    /**
+     * Why the command ended. `Sandbox.run()` always sets it; sandboxes that
+     * predate timeout reporting never report `TIMED_OUT`, so a timed-out run on
+     * them shows as `SIGNALED`.
+     */
+    reason?: CommandExitReason;
+    /** True when the run's `timeout` expired and the process was killed. */
+    timedOut?: boolean;
 }
 interface DirectoryEntry {
     name: string;
@@ -1182,6 +1215,9 @@ declare class Sandbox {
      *
      * Resource targets use create's cpus, memoryMb, and diskMb names. Resize
      * waits by default; wait=false returns admission. Timeout does not cancel it.
+     * CPU-only CAS sandboxes support CPU, memory, and root-disk resize; GPU CAS sandboxes
+     * support only root-disk growth and reject CPU and memory changes.
+     * Non-CAS sandboxes do not support live resize.
      * Wait, timeout, and pollInterval are ignored on non-resource updates.
      * A no-op returns current resources with absent or earlier resize metadata.
      *
@@ -1504,7 +1540,9 @@ declare class SandboxClient {
     /** List sandbox processes available as persisted-log filters. */
     listLogProcesses(sandboxId: string): Promise<Traced<SandboxProcessLogFiltersResponse>>;
     /**
-     * Update properties or resize a Running Cloud Hypervisor sandbox.
+     * Update properties or resize a running sandbox. CPU-only CAS sandboxes support
+     * CPU, memory, and root-disk resize; GPU CAS sandboxes support only root-disk
+     * growth. Non-CAS sandboxes do not support live resize.
      * 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.
@@ -1605,9 +1643,9 @@ declare class SandboxClient {
      * network policy, set it to replace the policy, or pass `null` to remove the
      * policy entirely. On a change the service recycles the pool's unclaimed
      * warm containers onto the new policy, while containers already claimed by
-     * sandboxes keep the policy they booted with. CPU, memory, disk, image, and
-     * entrypoint changes likewise recycle unclaimed warm containers
-     * asynchronously. If suitable capacity is unavailable, stale warm
+     * sandboxes keep the policy they booted with. CPU, memory, disk, GPU
+     * allocation, image, and entrypoint changes likewise recycle unclaimed warm
+     * containers asynchronously. If suitable capacity is unavailable, stale warm
      * containers are not used as a fallback.
      */
     updatePool(poolId: string, options: UpdatePoolOptions): Promise<SandboxPoolInfo>;
@@ -2428,4 +2466,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, 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 };
+export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, 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.js

@@ -46,7 +46,7 @@ var init_defaults = __esm({
   "src/defaults.ts"() {
     "use strict";
     init_esm_shims();
-    SDK_VERSION = "0.5.145";
+    SDK_VERSION = "0.5.148";
     API_URL = process.env.TENSORLAKE_API_URL ?? "https://api.tensorlake.ai";
     API_KEY = process.env.TENSORLAKE_API_KEY ?? void 0;
     NAMESPACE = process.env.INDEXIFY_NAMESPACE ?? "default";
@@ -490,7 +490,7 @@ var init_native_worker_client = __esm({
       }
     };
     runtimeKey = /* @__PURE__ */ Symbol.for(
-      `tensorlake.native.worker.${false ? "source" : "0.5.145"}.v1`
+      `tensorlake.native.worker.${false ? "source" : "0.5.148"}.v1`
     );
     runtimes = globalThis;
   }
@@ -556,7 +556,7 @@ function fromSnakeKeys(obj, idField) {
   }
   return obj;
 }
-var SandboxStatus, SandboxPendingReason, TERMINATION_REASON_NO_CAPACITY, TERMINATION_REASON_CANCELLED, SnapshotStatus, ProcessStatus, StdinMode, OutputMode, ContainerState, ResizeStatus, ResizeErrorReason, CAMEL_TO_SNAKE_RE;
+var SandboxStatus, SandboxPendingReason, TERMINATION_REASON_NO_CAPACITY, TERMINATION_REASON_CANCELLED, SnapshotStatus, ProcessStatus, StdinMode, OutputMode, ContainerState, ResizeStatus, ResizeErrorReason, CommandExitReason, CAMEL_TO_SNAKE_RE;
 var init_models = __esm({
   "src/models.ts"() {
     "use strict";
@@ -628,6 +628,13 @@ var init_models = __esm({
       ResizeErrorReason2["INCOMPATIBLE_RESPONSE"] = "incompatible_response";
       return ResizeErrorReason2;
     })(ResizeErrorReason || {});
+    CommandExitReason = /* @__PURE__ */ ((CommandExitReason2) => {
+      CommandExitReason2["EXITED"] = "exited";
+      CommandExitReason2["SIGNALED"] = "signaled";
+      CommandExitReason2["OOM_KILLED"] = "oom_killed";
+      CommandExitReason2["TIMED_OUT"] = "timed_out";
+      return CommandExitReason2;
+    })(CommandExitReason || {});
     CAMEL_TO_SNAKE_RE = /[A-Z]/g;
   }
 });
@@ -753,6 +760,7 @@ function assembleCommandResult(events) {
   const stdoutLines = [];
   const stderrLines = [];
   let exitCode = -1;
+  let reason;
   for (const eventJson of events) {
     const raw = JSON.parse(eventJson);
     if (typeof raw.line === "string") {
@@ -766,12 +774,23 @@ function assembleCommandResult(events) {
         exitCode = raw.exit_code;
       } else if (typeof raw.signal === "number") {
         exitCode = -raw.signal;
+      } else {
+        continue;
       }
+      reason = exitReason(raw);
     }
   }
-  return { exitCode, stdout: stdoutLines.join("\n"), stderr: stderrLines.join("\n") };
+  return { exitCode, stdout: stdoutLines.join("\n"), stderr: stderrLines.join("\n"), reason };
 }
-var cachedBinding;
+function exitReason(raw) {
+  if (typeof raw.reason === "string" && KNOWN_EXIT_REASONS.has(raw.reason)) {
+    return raw.reason;
+  }
+  if (raw.oom_killed === true) return "oom_killed" /* OOM_KILLED */;
+  if (typeof raw.exit_code === "number") return "exited" /* EXITED */;
+  return "signaled" /* SIGNALED */;
+}
+var cachedBinding, KNOWN_EXIT_REASONS;
 var init_native_sandbox = __esm({
   "src/native-sandbox.ts"() {
     "use strict";
@@ -780,6 +799,7 @@ var init_native_sandbox = __esm({
     init_errors();
     init_native_worker_client();
     init_native_worker_protocol();
+    KNOWN_EXIT_REASONS = new Set(Object.values(CommandExitReason));
   }
 });
 
@@ -4006,6 +4026,9 @@ var init_sandbox = __esm({
        *
        * Resource targets use create's cpus, memoryMb, and diskMb names. Resize
        * waits by default; wait=false returns admission. Timeout does not cancel it.
+       * CPU-only CAS sandboxes support CPU, memory, and root-disk resize; GPU CAS sandboxes
+       * support only root-disk growth and reject CPU and memory changes.
+       * Non-CAS sandboxes do not support live resize.
        * Wait, timeout, and pollInterval are ignored on non-resource updates.
        * A no-op returns current resources with absent or earlier resize metadata.
        *
@@ -4233,15 +4256,17 @@ var init_sandbox = __esm({
           () => proxy.runProcess(JSON.stringify(body)),
           { sandboxId: this.sandboxId }
         );
-        const { exitCode, stdout, stderr } = assembleCommandResult(events);
+        const { exitCode, stdout, stderr, reason } = assembleCommandResult(events);
         logSdkTiming("sandbox.run", "complete", opStart, {
           sandbox_id: this.sandboxId,
           server_trace_id: traceId,
           command: sdkTimingPayloadsEnabled() ? command : void 0,
           command_length: command.length,
-          exit_code: exitCode
+          exit_code: exitCode,
+          exit_reason: reason
         });
-        return Object.assign({ exitCode, stdout, stderr }, { traceId });
+        const timedOut = reason === "timed_out" /* TIMED_OUT */;
+        return Object.assign({ exitCode, stdout, stderr, reason, timedOut }, { traceId });
       }
       // --- Process management ---
       /**
@@ -4636,7 +4661,10 @@ function gpuRequest(gpu, gpus, gpuModel) {
     gpus = gpu.count;
     gpuModel = gpu.model;
   }
-  if (gpus == null) return void 0;
+  if (gpus == null) {
+    if (gpuModel == null) return void 0;
+    gpus = 1;
+  }
   if (!Number.isInteger(gpus) || gpus < 1) {
     throw new SandboxError("gpus must be a positive integer");
   }
@@ -5106,7 +5134,9 @@ var init_client = __esm({
         });
       }
       /**
-       * Update properties or resize a Running Cloud Hypervisor sandbox.
+       * Update properties or resize a running sandbox. CPU-only CAS sandboxes support
+       * CPU, memory, and root-disk resize; GPU CAS sandboxes support only root-disk
+       * growth. Non-CAS sandboxes do not support live resize.
        * 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.
@@ -5434,12 +5464,14 @@ var init_client = __esm({
       // --- Pools ---
       /** Create a new sandbox pool with warm pre-booted containers. */
       async createPool(options) {
+        const gpus = gpuRequest(options.gpu, options.gpus, options.gpuModel);
         const body = {
           image: options.image,
           resources: {
             cpus: options.cpus ?? 1,
             memory_mb: options.memoryMb ?? 1024,
-            ...options.diskMb != null ? { disk_mb: options.diskMb } : {}
+            ...options.diskMb != null ? { disk_mb: options.diskMb } : {},
+            ...gpus != null ? { gpus } : {}
           },
           timeout_secs: options.timeoutSecs ?? 0
         };
@@ -5476,18 +5508,20 @@ var init_client = __esm({
        * network policy, set it to replace the policy, or pass `null` to remove the
        * policy entirely. On a change the service recycles the pool's unclaimed
        * warm containers onto the new policy, while containers already claimed by
-       * sandboxes keep the policy they booted with. CPU, memory, disk, image, and
-       * entrypoint changes likewise recycle unclaimed warm containers
-       * asynchronously. If suitable capacity is unavailable, stale warm
+       * sandboxes keep the policy they booted with. CPU, memory, disk, GPU
+       * allocation, image, and entrypoint changes likewise recycle unclaimed warm
+       * containers asynchronously. If suitable capacity is unavailable, stale warm
        * containers are not used as a fallback.
        */
       async updatePool(poolId, options) {
+        const gpus = gpuRequest(options.gpu, options.gpus, options.gpuModel);
         const body = {
           image: options.image,
           resources: {
             cpus: options.cpus ?? 1,
             memory_mb: options.memoryMb ?? 1024,
-            ...options.diskMb != null ? { disk_mb: options.diskMb } : {}
+            ...options.diskMb != null ? { disk_mb: options.diskMb } : {},
+            ...gpus != null ? { gpus } : {}
           },
           timeout_secs: options.timeoutSecs ?? 0
         };
@@ -10039,6 +10073,7 @@ export {
   APIClient,
   CliNotFoundError,
   CloudClient,
+  CommandExitReason,
   ContainerState,
   Desktop,
   File,