tensorlake 0.5.17 → 0.5.19

package/dist/index.d.cts

@@ -1,5 +1,4 @@
-import { C as CreatePtySessionOptions, S as SandboxOptions, a as CreateAndConnectOptions, b as SandboxClientOptions, c as ConnectOptions, d as SnapshotInfo, e as SandboxInfo, f as SandboxStatus, U as UpdateSandboxOptions, g as SuspendResumeOptions, h as CheckpointOptions, R as RunOptions, i as CommandResult, j as StartProcessOptions, P as ProcessInfo, k as SendSignalResponse, O as OutputResponse, l as OutputEvent, L as ListDirectoryResponse, m as PtySessionInfo, H as HealthResponse, D as DaemonInfo, n as CreateSandboxOptions, o as CreateSandboxResponse, p as ListArchivedSandboxesOptions, q as ListArchivedSandboxesResponse, A as ArchivedSandboxInfo, r as SandboxPortAccess, s as SnapshotOptions, t as CreateSnapshotResponse, u as SnapshotAndWaitOptions, v as CreatePoolOptions, w as CreateSandboxPoolResponse, x as SandboxPoolInfo, y as UpdatePoolOptions } from './sandbox-image-BBcx3bSx.cjs';
-export { z as CheckpointType, B as ContainerResourcesInfo, E as ContainerState, F as CreateSandboxImageOptions, G as DirectoryEntry, I as DockerfileBuildPlan, J as DockerfileInstruction, K as Image, M as ImageBuildOperation, N as ImageBuildOperationType, N as ImageBuildOperationTypeValue, Q as ImageOptions, T as NetworkConfig, V as OutputMode, W as PoolContainerInfo, X as ProcessStatus, Y as ProcessUser, Z as ProcessUserSpec, _ as SandboxImageSource, $ as SnapshotStatus, a0 as SnapshotType, a1 as SnapshotWaitCondition, a2 as StdinMode, a3 as createSandboxImage, a4 as dockerfileContent } from './sandbox-image-BBcx3bSx.cjs';
+export { C as CreateSandboxImageOptions, I as Image, a as ImageBuildOperation, b as ImageBuildOperationType, b as ImageBuildOperationTypeValue, c as ImageOptions, S as SandboxImageSource, d as createSandboxImage, e as dockerfileContent } from './sandbox-image-CmX-BLMV.cjs';
 
 /**
  * The return value of every SDK operation. Carries the W3C `trace_id` so callers
@@ -19,6 +18,350 @@ type Traced<T> = T & {
     readonly traceId: string;
 };
 
+declare enum SandboxStatus {
+    PENDING = "pending",
+    RUNNING = "running",
+    SNAPSHOTTING = "snapshotting",
+    SUSPENDING = "suspending",
+    SUSPENDED = "suspended",
+    TERMINATED = "terminated"
+}
+declare enum SnapshotStatus {
+    IN_PROGRESS = "in_progress",
+    LOCAL_READY = "local_ready",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/**
+ * Snapshot type for sandbox snapshot creation.
+ *
+ * - `"memory"`: Capture VM memory + filesystem state. Sandboxes restored
+ *   from this snapshot warm-restore VM memory.
+ * - `"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.
+ */
+type SnapshotType = "memory" | "filesystem";
+/**
+ * Checkpoint type for {@link Sandbox.checkpoint}.
+ *
+ * - `"memory"`: Capture VM memory + filesystem state. Sandboxes restored
+ *   from this checkpoint warm-restore VM memory and running processes.
+ * - `"filesystem"`: Capture filesystem state only. Sandboxes restored from
+ *   this checkpoint cold-boot from the snapshot tarball.
+ */
+type CheckpointType = "memory" | "filesystem";
+type SnapshotWaitCondition = "local_ready" | "completed";
+declare enum ProcessStatus {
+    RUNNING = "running",
+    EXITED = "exited",
+    SIGNALED = "signaled"
+}
+declare enum StdinMode {
+    CLOSED = "closed",
+    PIPE = "pipe"
+}
+declare enum OutputMode {
+    CAPTURE = "capture",
+    DISCARD = "discard"
+}
+declare enum ContainerState {
+    IDLE = "Idle",
+    RUNNING = "Running"
+}
+interface ContainerResourcesInfo {
+    cpus: number;
+    memoryMb: number;
+    ephemeralDiskMb: number;
+}
+interface NetworkConfig {
+    allowInternetAccess: boolean;
+    allowOut: string[];
+    denyOut: string[];
+}
+interface CreateSandboxOptions {
+    /** Optional sandbox image name, such as `tensorlake/ubuntu-minimal` or a registered Sandbox Image. When omitted, Tensorlake uses the default managed environment. */
+    image?: string;
+    cpus?: number;
+    memoryMb?: number;
+    /** Root disk size in megabytes. When omitted, the server uses its default disk size. */
+    diskMb?: number;
+    secretNames?: string[];
+    timeoutSecs?: number;
+    entrypoint?: string[];
+    allowInternetAccess?: boolean;
+    allowOut?: string[];
+    denyOut?: string[];
+    snapshotId?: string;
+    /** Optional name for the sandbox. Named sandboxes support suspend/resume. When absent the sandbox is ephemeral. */
+    name?: string;
+}
+interface UpdateSandboxOptions {
+    /** New name for the sandbox. Naming an ephemeral sandbox enables suspend/resume. */
+    name?: string;
+    /** Whether exposed user ports should be reachable without TensorLake auth. */
+    allowUnauthenticatedAccess?: boolean;
+    /** User ports that should be routable through the sandbox proxy. Port 9501 is reserved. */
+    exposedPorts?: number[];
+}
+interface CreateSandboxResponse {
+    sandboxId: string;
+    status: SandboxStatus;
+    routingHint?: string;
+    name?: string | null;
+    terminationReason?: string;
+    errorDetails?: unknown;
+}
+interface SandboxInfo {
+    sandboxId: string;
+    namespace: string;
+    status: SandboxStatus;
+    /** Resolved sandbox image name. */
+    image?: string;
+    resources: ContainerResourcesInfo;
+    secretNames: string[];
+    timeoutSecs?: number;
+    entrypoint?: string[];
+    network?: NetworkConfig;
+    poolId?: string;
+    outcome?: string;
+    terminationReason?: string;
+    errorDetails?: unknown;
+    createdAt?: Date;
+    terminatedAt?: Date;
+    name?: string;
+    allowUnauthenticatedAccess?: boolean;
+    exposedPorts?: number[];
+    sandboxUrl?: string;
+    routingHint?: string;
+}
+interface SandboxPortAccess {
+    allowUnauthenticatedAccess: boolean;
+    exposedPorts: number[];
+    sandboxUrl?: string;
+}
+/** Sandbox information plus the archival timestamp. */
+interface ArchivedSandboxInfo extends SandboxInfo {
+    archivedAt: Date;
+}
+/** Pagination params for `listArchivedSandboxes`. */
+interface ListArchivedSandboxesOptions {
+    limit?: number;
+    /** Base64-encoded pagination cursor returned by a prior call. */
+    cursor?: string;
+    /** Pagination direction. */
+    direction?: "forward" | "backward";
+}
+interface ListArchivedSandboxesResponse {
+    sandboxes: ArchivedSandboxInfo[];
+    prevCursor?: string;
+    nextCursor?: string;
+}
+interface CreateSnapshotResponse {
+    snapshotId: string;
+    status: SnapshotStatus;
+}
+interface SnapshotInfo {
+    snapshotId: string;
+    namespace: string;
+    sandboxId: string;
+    baseImage: string;
+    status: SnapshotStatus;
+    snapshotType?: SnapshotType;
+    error?: string;
+    snapshotUri?: string;
+    snapshotFormatVersion?: string;
+    sizeBytes?: number;
+    rootfsDiskBytes?: number;
+    createdAt?: Date;
+}
+interface SnapshotOptions {
+    /**
+     * Optional snapshot type. When omitted the server picks its default. Use
+     * `"filesystem"` for snapshots intended for sandbox image builds so that
+     * restored sandboxes cold-boot.
+     */
+    snapshotType?: SnapshotType;
+}
+interface SnapshotAndWaitOptions extends SnapshotOptions {
+    timeout?: number;
+    pollInterval?: number;
+    /** Defaults to `"local_ready"`, which is enough to resume from a snapshot. */
+    waitUntil?: SnapshotWaitCondition;
+}
+interface CreatePoolOptions {
+    /** Sandbox image name, such as `tensorlake/ubuntu-minimal` or a registered Sandbox Image. */
+    image: string;
+    cpus?: number;
+    memoryMb?: number;
+    ephemeralDiskMb?: number;
+    secretNames?: string[];
+    timeoutSecs?: number;
+    entrypoint?: string[];
+    maxContainers?: number;
+    warmContainers?: number;
+}
+interface UpdatePoolOptions {
+    /** Sandbox image name, such as `tensorlake/ubuntu-minimal` or a registered Sandbox Image. */
+    image: string;
+    cpus?: number;
+    memoryMb?: number;
+    ephemeralDiskMb?: number;
+    secretNames?: string[];
+    timeoutSecs?: number;
+    entrypoint?: string[];
+    maxContainers?: number;
+    warmContainers?: number;
+}
+interface CreateSandboxPoolResponse {
+    poolId: string;
+    namespace: string;
+}
+interface PoolContainerInfo {
+    id: string;
+    state: string;
+    sandboxId?: string;
+    executorId: string;
+}
+interface SandboxPoolInfo {
+    poolId: string;
+    namespace: string;
+    /** Sandbox image name backing the pool. */
+    image: string;
+    resources: ContainerResourcesInfo;
+    secretNames: string[];
+    timeoutSecs: number;
+    entrypoint?: string[];
+    maxContainers?: number;
+    warmContainers?: number;
+    containers?: PoolContainerInfo[];
+    createdAt?: Date;
+    updatedAt?: Date;
+}
+interface ProcessUserSpec {
+    name?: string;
+    uid?: number;
+    gid?: number;
+}
+type ProcessUser = string | ProcessUserSpec;
+interface StartProcessOptions {
+    args?: string[];
+    env?: Record<string, string>;
+    workingDir?: string;
+    stdinMode?: StdinMode;
+    stdoutMode?: OutputMode;
+    stderrMode?: OutputMode;
+    user?: ProcessUser;
+}
+interface ProcessInfo {
+    pid: number;
+    status: ProcessStatus;
+    exitCode?: number;
+    signal?: number;
+    stdinWritable: boolean;
+    command: string;
+    args: string[];
+    startedAt: Date;
+    endedAt?: Date;
+}
+interface SendSignalResponse {
+    success: boolean;
+}
+interface OutputResponse {
+    pid: number;
+    lines: string[];
+    lineCount: number;
+}
+interface OutputEvent {
+    line: string;
+    timestamp: Date;
+    stream?: string;
+}
+interface RunOptions {
+    args?: string[];
+    env?: Record<string, string>;
+    workingDir?: string;
+    timeout?: number;
+    user?: ProcessUser;
+}
+interface CommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+interface DirectoryEntry {
+    name: string;
+    isDir: boolean;
+    size?: number;
+    modifiedAt?: Date;
+}
+interface ListDirectoryResponse {
+    path: string;
+    entries: DirectoryEntry[];
+}
+interface CreatePtySessionOptions {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    workingDir?: string;
+    rows?: number;
+    cols?: number;
+}
+interface PtySessionInfo {
+    sessionId: string;
+    token: string;
+}
+interface HealthResponse {
+    healthy: boolean;
+}
+interface DaemonInfo {
+    version: string;
+    uptimeSecs: number;
+    runningProcesses: number;
+    totalProcesses: number;
+}
+interface SandboxClientOptions {
+    apiUrl?: string;
+    apiKey?: string;
+    organizationId?: string;
+    projectId?: string;
+    namespace?: string;
+    maxRetries?: number;
+    retryBackoffMs?: number;
+}
+interface SandboxOptions {
+    sandboxId: string;
+    proxyUrl?: string;
+    apiKey?: string;
+    organizationId?: string;
+    projectId?: string;
+    routingHint?: string;
+}
+interface CreateAndConnectOptions extends CreateSandboxOptions {
+    poolId?: string;
+    proxyUrl?: string;
+    startupTimeout?: number;
+}
+interface SuspendResumeOptions {
+    /** If false, fire-and-return without waiting for completion. Default: true. */
+    wait?: boolean;
+    /** Max seconds to wait when wait=true. Default: 300. */
+    timeout?: number;
+    /** Seconds between status polls when wait=true. Default: 1. */
+    pollInterval?: number;
+}
+interface CheckpointOptions extends SuspendResumeOptions {
+    checkpointType?: CheckpointType;
+    /** Defaults to `"local_ready"`, which is enough to resume from a checkpoint. */
+    waitUntil?: SnapshotWaitCondition;
+}
+interface ConnectOptions {
+    sandboxId: string;
+    proxyUrl?: string;
+    routingHint?: string;
+}
+
 type MouseButton = "left" | "middle" | "right";
 interface ConnectDesktopOptions {
     /** Remote VNC port. Defaults to `5901`. */
@@ -719,4 +1062,4 @@ declare class RequestExecutionError extends Error {
     constructor(message: string, functionName?: string);
 }
 
-export { APIClient, type ApiKeyIntrospection, type ApplicationBuildContext, type ApplicationBuildImageResult, type ApplicationBuildResponse, type ApplicationManifest, type ApplicationSummary, ArchivedSandboxInfo, type BinaryPayload, type BuildInfo, type BuildLogEntry, CheckpointOptions, CloudClient, type CloudClientOptions, CommandResult, type ConnectDesktopOptions, ConnectOptions, CreateAndConnectOptions, type CreateApplicationBuildImageRequest, type CreateApplicationBuildRequest, CreatePoolOptions, type CreatePtyOptions, CreatePtySessionOptions, CreateSandboxOptions, CreateSandboxPoolResponse, CreateSandboxResponse, CreateSnapshotResponse, type CreateTunnelOptions, DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, HealthResponse, ListArchivedSandboxesOptions, ListArchivedSandboxesResponse, ListDirectoryResponse, type MouseButton, type NewSecret, OutputEvent, OutputResponse, PoolInUseError, PoolNotFoundError, ProcessInfo, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, PtySessionInfo, RemoteAPIError, type RequestErrorInfo, RequestExecutionError, RequestFailedError, type RequestInput, type RequestMetadata, RequestNotFinishedError, type RequestOutput, RunOptions, Sandbox, SandboxClient, SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, SandboxInfo, SandboxNotFoundError, SandboxOptions, SandboxPoolInfo, SandboxPortAccess, SandboxStatus, type Secret, type SecretsList, type SecretsPagination, SendSignalResponse, SnapshotAndWaitOptions, SnapshotInfo, SnapshotOptions, type StartImageBuildRequest, StartProcessOptions, SuspendResumeOptions, TcpTunnel, type TunnelAddress, UpdatePoolOptions, type UpsertSecretResponse };
+export { APIClient, type ApiKeyIntrospection, type ApplicationBuildContext, type ApplicationBuildImageResult, type ApplicationBuildResponse, type ApplicationManifest, type ApplicationSummary, type ArchivedSandboxInfo, type BinaryPayload, type BuildInfo, type BuildLogEntry, type CheckpointOptions, type CheckpointType, CloudClient, type CloudClientOptions, type CommandResult, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CreateAndConnectOptions, type CreateApplicationBuildImageRequest, type 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 HealthResponse, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type MouseButton, type NetworkConfig, type NewSecret, type OutputEvent, OutputMode, type OutputResponse, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, RemoteAPIError, type RequestErrorInfo, RequestExecutionError, RequestFailedError, type RequestInput, type RequestMetadata, RequestNotFinishedError, type RequestOutput, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, SandboxNotFoundError, type SandboxOptions, type SandboxPoolInfo, type SandboxPortAccess, SandboxStatus, type Secret, type SecretsList, type SecretsPagination, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpsertSecretResponse };