tensorlake 0.5.17 → 0.5.19

package/dist/sandbox-image-BBcx3bSx.d.ts

@@ -1,477 +0,0 @@
-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;
-}
-
-declare const ImageBuildOperationType: {
-    readonly ADD: "ADD";
-    readonly COPY: "COPY";
-    readonly ENV: "ENV";
-    readonly RUN: "RUN";
-    readonly WORKDIR: "WORKDIR";
-};
-type ImageBuildOperationType = (typeof ImageBuildOperationType)[keyof typeof ImageBuildOperationType];
-interface ImageBuildOperation {
-    type: ImageBuildOperationType;
-    args: string[];
-    options: Record<string, string>;
-}
-interface ImageOptions {
-    name?: string;
-    tag?: string;
-    baseImage?: string | null;
-}
-declare class Image {
-    readonly _id: string;
-    readonly _name: string;
-    readonly _tag: string;
-    readonly _baseImage: string | null;
-    readonly _buildOperations: ImageBuildOperation[];
-    constructor();
-    constructor(name: string, tag?: string, baseImage?: string | null);
-    constructor(options: ImageOptions);
-    get name(): string;
-    get tag(): string;
-    get baseImage(): string | null;
-    get buildOperations(): ImageBuildOperation[];
-    add(src: string, dest: string, options?: Record<string, string> | undefined): this;
-    copy(src: string, dest: string, options?: Record<string, string> | undefined): this;
-    env(key: string, value: string): this;
-    run(commands: string | string[], options?: Record<string, string> | undefined): this;
-    workdir(directory: string): this;
-    /**
-     * Build this image as a sandbox template and register it.
-     *
-     * Materializes the image in a build sandbox, snapshots the filesystem,
-     * and registers the snapshot as a named sandbox template.
-     */
-    build(options?: CreateSandboxImageOptions): Promise<Record<string, unknown>>;
-    private _addOperation;
-}
-declare function dockerfileContent(image: Image): string;
-
-interface DockerfileInstruction {
-    keyword: string;
-    value: string;
-    lineNumber: number;
-}
-interface DockerfileBuildPlan {
-    dockerfilePath: string;
-    contextDir: string;
-    registeredName: string;
-    dockerfileText: string;
-    baseImage?: string;
-    instructions: DockerfileInstruction[];
-}
-interface CreateSandboxImageOptions {
-    registeredName?: string;
-    cpus?: number;
-    memoryMb?: number;
-    diskMb?: number;
-    builderDiskMb?: number;
-    isPublic?: boolean;
-    contextDir?: string;
-    /**
-     * Print build progress to stderr. Ignored when an explicit `emit` is passed
-     * via `deps`. Defaults to false — `createSandboxImage` is silent by default
-     * when invoked programmatically (e.g. `Image.build()`).
-     */
-    verbose?: boolean;
-}
-type SandboxImageSource = string | Image;
-interface BuildContext {
-    apiUrl: string;
-    apiKey?: string;
-    personalAccessToken?: string;
-    namespace: string;
-    organizationId?: string;
-    projectId?: string;
-    debug: boolean;
-}
-interface BuildSandbox {
-    sandboxId: string;
-    run(command: string, options?: {
-        args?: string[];
-        env?: Record<string, string>;
-        workingDir?: string;
-        timeout?: number;
-        user?: ProcessUser;
-    }): Promise<CommandResult>;
-    startProcess(command: string, options?: {
-        args?: string[];
-        env?: Record<string, string>;
-        workingDir?: string;
-        user?: ProcessUser;
-    }): Promise<ProcessInfo>;
-    getStdout(pid: number): Promise<OutputResponse>;
-    getStderr(pid: number): Promise<OutputResponse>;
-    getProcess(pid: number): Promise<ProcessInfo>;
-    writeFile(path: string, content: Uint8Array): Promise<void>;
-    readFile(path: string): Promise<Uint8Array>;
-    terminate(): Promise<void>;
-}
-interface BuildClient {
-    createAndConnect(options: {
-        image?: string;
-        cpus?: number;
-        memoryMb?: number;
-        diskMb?: number;
-    }): Promise<BuildSandbox>;
-    close(): void;
-}
-interface CreateSandboxImageDeps {
-    emit?: (event: Record<string, unknown>) => void;
-    createClient?: (context: BuildContext) => BuildClient;
-    sleep?: (ms: number) => Promise<void>;
-}
-declare function defaultRegisteredName(dockerfilePath: string): string;
-declare function logicalDockerfileLines(dockerfileText: string): Array<{
-    lineNumber: number;
-    line: string;
-}>;
-declare function loadDockerfilePlan(dockerfilePath: string, registeredName?: string): Promise<DockerfileBuildPlan>;
-declare function loadImagePlan(image: Image, options?: Pick<CreateSandboxImageOptions, "registeredName" | "contextDir">): DockerfileBuildPlan;
-declare function registerImage(context: BuildContext, name: string, dockerfile: string, snapshotId: string, snapshotSandboxId: string, snapshotUri: string, snapshotSizeBytes: number, rootfsDiskBytes: number, isPublic: boolean, snapshotFormatVersion?: string): Promise<Record<string, unknown>>;
-declare function createSandboxImage(source: SandboxImageSource, options?: CreateSandboxImageOptions, deps?: CreateSandboxImageDeps): Promise<Record<string, unknown>>;
-declare function runCreateSandboxImageCli(argv?: string[]): Promise<void>;
-
-export { SnapshotStatus as $, type ArchivedSandboxInfo as A, type ContainerResourcesInfo as B, type CreatePtySessionOptions as C, type DaemonInfo as D, ContainerState as E, type CreateSandboxImageOptions as F, type DirectoryEntry as G, type HealthResponse as H, type DockerfileBuildPlan as I, type DockerfileInstruction as J, Image as K, type ListDirectoryResponse as L, type ImageBuildOperation as M, ImageBuildOperationType as N, type OutputResponse as O, type ProcessInfo as P, type ImageOptions as Q, type RunOptions as R, type SandboxOptions as S, type NetworkConfig as T, type UpdateSandboxOptions as U, OutputMode as V, type PoolContainerInfo as W, ProcessStatus as X, type ProcessUser as Y, type ProcessUserSpec as Z, type SandboxImageSource as _, type CreateAndConnectOptions as a, type SnapshotType as a0, type SnapshotWaitCondition as a1, StdinMode as a2, createSandboxImage as a3, dockerfileContent as a4, type BuildContext as a5, defaultRegisteredName as a6, loadDockerfilePlan as a7, loadImagePlan as a8, logicalDockerfileLines as a9, registerImage as aa, runCreateSandboxImageCli as ab, type SandboxClientOptions as b, type ConnectOptions as c, type SnapshotInfo as d, type SandboxInfo as e, SandboxStatus as f, type SuspendResumeOptions as g, type CheckpointOptions as h, type CommandResult as i, type StartProcessOptions as j, type SendSignalResponse as k, type OutputEvent as l, type PtySessionInfo as m, type CreateSandboxOptions as n, type CreateSandboxResponse as o, type ListArchivedSandboxesOptions as p, type ListArchivedSandboxesResponse as q, type SandboxPortAccess as r, type SnapshotOptions as s, type CreateSnapshotResponse as t, type SnapshotAndWaitOptions as u, type CreatePoolOptions as v, type CreateSandboxPoolResponse as w, type SandboxPoolInfo as x, type UpdatePoolOptions as y, type CheckpointType as z };