eve 0.84.0 → 0.85.0

package/dist/src/compiled/@vercel/sandbox/api-client/api-client.d.ts

@@ -8,6 +8,7 @@ import { z } from "#compiled/zod/index.js";
 import { Readable } from "stream";
 
 //#region src/api-client/api-client.d.ts
+
 interface WithFetchOptions {
   fetch?: typeof globalThis.fetch;
 }
@@ -172,6 +173,7 @@ declare class APIClient extends BaseClient {
     runtime?: RUNTIMES | (string & {});
     image?: string;
     networkPolicy?: NetworkPolicy;
+    networkId?: string;
     env?: Record<string, string>;
     tags?: Record<string, string>;
     snapshotExpiration?: number;
@@ -194,6 +196,7 @@ declare class APIClient extends BaseClient {
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       region?: string | undefined;
       failoverRegions?: string[] | undefined;
+      networkId?: string | undefined;
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
@@ -437,7 +440,9 @@ declare class APIClient extends BaseClient {
     persistent?: boolean;
     image?: string;
     networkPolicy?: NetworkPolicy;
+    networkId?: string;
     env?: Record<string, string>;
+    mounts?: SandboxMetaData["mounts"];
     tags?: Record<string, string>;
     snapshotExpiration?: number;
     keepLastSnapshots?: {
@@ -458,6 +463,7 @@ declare class APIClient extends BaseClient {
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       region?: string | undefined;
       failoverRegions?: string[] | undefined;
+      networkId?: string | undefined;
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
@@ -697,6 +703,7 @@ declare class APIClient extends BaseClient {
     env: Record<string, string>;
     sudo: boolean;
     wait: true;
+    attachStdin?: boolean;
     logs?: boolean;
     onLog?: (log: LogOutputLine) => void;
     timeout?: number;
@@ -713,6 +720,7 @@ declare class APIClient extends BaseClient {
     env: Record<string, string>;
     sudo: boolean;
     wait?: false;
+    attachStdin?: boolean;
     timeout?: number;
     signal?: AbortSignal;
   }): Promise<Parsed<z.infer<typeof CommandResponse>>>;
@@ -1036,6 +1044,8 @@ declare class APIClient extends BaseClient {
       maxSizeBytes: number;
       createdAt: number;
       updatedAt: number;
+      parentDriveId?: string | undefined;
+      rootDriveId?: string | undefined;
       currentSessionId?: string | undefined;
       currentSandboxName?: string | undefined;
     }[];
@@ -1044,6 +1054,25 @@ declare class APIClient extends BaseClient {
       next: string | null;
     };
   }>>;
+  getDrive(params: {
+    projectId: string;
+    name: string;
+    signal?: AbortSignal;
+  }): Promise<Parsed<{
+    drive: {
+      id: string;
+      name: string;
+      projectId: string;
+      region: string;
+      maxSizeBytes: number;
+      createdAt: number;
+      updatedAt: number;
+      parentDriveId?: string | undefined;
+      rootDriveId?: string | undefined;
+      currentSessionId?: string | undefined;
+      currentSandboxName?: string | undefined;
+    };
+  }>>;
   getOrCreateDrive(params: {
     projectId: string;
     name: string;
@@ -1059,6 +1088,28 @@ declare class APIClient extends BaseClient {
       maxSizeBytes: number;
       createdAt: number;
       updatedAt: number;
+      parentDriveId?: string | undefined;
+      rootDriveId?: string | undefined;
+      currentSessionId?: string | undefined;
+      currentSandboxName?: string | undefined;
+    };
+  }>>;
+  forkDrive(params: {
+    projectId: string;
+    name: string;
+    forkName: string;
+    signal?: AbortSignal;
+  }): Promise<Parsed<{
+    drive: {
+      id: string;
+      name: string;
+      projectId: string;
+      region: string;
+      maxSizeBytes: number;
+      createdAt: number;
+      updatedAt: number;
+      parentDriveId?: string | undefined;
+      rootDriveId?: string | undefined;
       currentSessionId?: string | undefined;
       currentSandboxName?: string | undefined;
     };
@@ -1097,6 +1148,22 @@ declare class APIClient extends BaseClient {
       durationMs?: number | undefined;
     };
   }>>;
+  /**
+   * Writes to a command's stdin. With `offset`, the request is safe to resend
+   * (the server skips bytes it already has), so it is retried across
+   * connection failures. Without it, only rate limited requests are retried,
+   * since any other failure may have written the bytes already.
+   */
+  writeCommandStdin(params: {
+    sessionId: string;
+    commandId: string;
+    data?: Uint8Array;
+    offset?: number;
+    close?: boolean;
+    abortSignal?: AbortSignal;
+  }): Promise<{
+    bytesWritten?: number;
+  }>;
   getLogs(params: {
     sessionId: string;
     cmdId: string;
@@ -1104,6 +1171,7 @@ declare class APIClient extends BaseClient {
   }): AsyncGenerator<LogOutputLine, void, void> & Disposable & {
     close(): void;
   };
+  private getLogsStream;
   stopSession(params: {
     sessionId: string;
     signal?: AbortSignal;
@@ -1146,6 +1214,7 @@ declare class APIClient extends BaseClient {
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       region?: string | undefined;
       failoverRegions?: string[] | undefined;
+      networkId?: string | undefined;
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
@@ -1401,6 +1470,7 @@ declare class APIClient extends BaseClient {
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       region?: string | undefined;
       failoverRegions?: string[] | undefined;
+      networkId?: string | undefined;
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
@@ -1530,6 +1600,8 @@ declare class APIClient extends BaseClient {
       maxSizeBytes: number;
       createdAt: number;
       updatedAt: number;
+      parentDriveId?: string | undefined;
+      rootDriveId?: string | undefined;
       currentSessionId?: string | undefined;
       currentSandboxName?: string | undefined;
     };
@@ -1544,6 +1616,7 @@ declare class APIClient extends BaseClient {
     };
     timeout?: number;
     networkPolicy?: NetworkPolicy;
+    networkId?: string | null;
     tags?: Record<string, string>;
     ports?: number[];
     snapshotExpiration?: number;
@@ -1567,6 +1640,7 @@ declare class APIClient extends BaseClient {
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       region?: string | undefined;
       failoverRegions?: string[] | undefined;
+      networkId?: string | undefined;
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
@@ -1699,6 +1773,7 @@ declare class APIClient extends BaseClient {
       status: "pending" | "running" | "stopping" | "stopped" | "failed" | "aborted" | "snapshotting";
       region?: string | undefined;
       failoverRegions?: string[] | undefined;
+      networkId?: string | undefined;
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;

package/dist/src/compiled/@vercel/sandbox/api-client/validators.d.ts

@@ -524,6 +524,8 @@ declare const SnapshotResponse: z.ZodObject<{
 }, z.core.$strip>;
 declare const Drive: z.ZodObject<{
   id: z.ZodString;
+  parentDriveId: z.ZodOptional<z.ZodString>;
+  rootDriveId: z.ZodOptional<z.ZodString>;
   name: z.ZodString;
   projectId: z.ZodString;
   region: z.ZodString;
@@ -539,6 +541,7 @@ declare const Sandbox: z.ZodObject<{
   persistent: z.ZodBoolean;
   region: z.ZodOptional<z.ZodString>;
   failoverRegions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  networkId: z.ZodOptional<z.ZodString>;
   vcpus: z.ZodOptional<z.ZodNumber>;
   memory: z.ZodOptional<z.ZodNumber>;
   runtime: z.ZodOptional<z.ZodString>;
@@ -793,6 +796,7 @@ declare const StopSessionResponse: z.ZodObject<{
     persistent: z.ZodBoolean;
     region: z.ZodOptional<z.ZodString>;
     failoverRegions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    networkId: z.ZodOptional<z.ZodString>;
     vcpus: z.ZodOptional<z.ZodNumber>;
     memory: z.ZodOptional<z.ZodNumber>;
     runtime: z.ZodOptional<z.ZodString>;

package/dist/src/compiled/@vercel/sandbox/command.d.ts

@@ -2,6 +2,7 @@ import { CommandData, LogOutputLine } from "./api-client/validators.js";
 import { APIClient } from "./api-client/api-client.js";
 import "./api-client/index.js";
 import { Signal } from "./utils/resolveSignal.js";
+import { StdinPipe } from "./utils/pipe-stdin.js";
 import { WORKFLOW_DESERIALIZE, WORKFLOW_SERIALIZE } from "./_workflow-serde.js";
 
 //#region src/command.d.ts
@@ -73,6 +74,28 @@ declare class Command {
    * @internal
    */
   protected _resolvedOutput: CommandOutput | null;
+  /**
+   * Tail of pending stdin writes, so concurrent calls reach the process in
+   * call order.
+   */
+  private stdinQueue;
+  /**
+   * Set when a write failed after possibly delivering some bytes. Later
+   * writes are rejected so they can't be appended to a partial message.
+   */
+  private stdinError;
+  /**
+   * Bytes the API has confirmed written to stdin, sent with each request so
+   * the API can skip bytes it already has when a request is resent. Unknown
+   * until the first stdin call, because a deserialized `Command` can't know
+   * what an earlier instance wrote.
+   */
+  private stdinOffset;
+  /**
+   * Set when the command was started with a `Readable` for stdin.
+   * @internal
+   */
+  stdinPipe: StdinPipe | null;
   /**
    * ID of the command execution.
    */
@@ -223,6 +246,43 @@ declare class Command {
   kill(signal?: Signal, opts?: {
     abortSignal?: AbortSignal;
   }): Promise<void>;
+  /**
+   * Write data to the stdin of a running command. The command must have been
+   * started with `stdin: true` and `detached: true`.
+   *
+   * Writes are delivered in the order they are called, and resolve once the
+   * process has accepted the data. Don't write to the same command from more
+   * than one place. If a write fails, part of it may have been written and
+   * further writes are rejected.
+   *
+   * ```
+   * const cmd = await sandbox.runCommand({ cmd: "cat", stdin: true, detached: true });
+   * await cmd.writeStdin("hello\n");
+   * await cmd.closeStdin();
+   * ```
+   *
+   * @param data - The data to write. Strings are encoded as UTF-8.
+   * @param opts - Optional parameters.
+   * @param opts.abortSignal - An AbortSignal to cancel the write. Aborting a
+   * write that has started may leave part of the data written.
+   * @returns Promise<void>.
+   */
+  writeStdin(data: string | Uint8Array, opts?: {
+    abortSignal?: AbortSignal;
+  }): Promise<void>;
+  /**
+   * Close the stdin of a running command, so it reads EOF once it has
+   * consumed any pending data.
+   *
+   * @param opts - Optional parameters.
+   * @param opts.abortSignal - An AbortSignal to cancel the operation.
+   * @returns Promise<void>.
+   */
+  closeStdin(opts?: {
+    abortSignal?: AbortSignal;
+  }): Promise<void>;
+  private resolveStdinOffset;
+  private enqueueStdin;
 }
 /**
  * A command that has finished executing.
@@ -286,6 +346,24 @@ declare class CommandFinished extends Command {
    * @returns This CommandFinished instance.
    */
   wait(): Promise<CommandFinished>;
+  /**
+   * Not available: the command has already exited.
+   *
+   * @deprecated Always throws on a finished command.
+   * @throws Always.
+   */
+  writeStdin(_data: string | Uint8Array, _opts?: {
+    abortSignal?: AbortSignal;
+  }): Promise<never>;
+  /**
+   * Not available: the command has already exited.
+   *
+   * @deprecated Always throws on a finished command.
+   * @throws Always.
+   */
+  closeStdin(_opts?: {
+    abortSignal?: AbortSignal;
+  }): Promise<never>;
 }
 //#endregion
 export { Command, CommandFinished, CommandOutput, SerializedCommand, SerializedCommandFinished };

package/dist/src/compiled/@vercel/sandbox/drive.d.ts

@@ -12,6 +12,17 @@ interface SerializedDrive {
   projectId?: string;
 }
 /** @inline */
+interface GetDriveParams {
+  /**
+   * The name of the drive.
+   */
+  name: string;
+  /**
+   * An AbortSignal to cancel the operation.
+   */
+  signal?: AbortSignal;
+}
+/** @inline */
 interface GetOrCreateDriveParams {
   /**
    * The name of the drive to get or create. Must be unique within the project.
@@ -35,7 +46,7 @@ interface GetOrCreateDriveParams {
  * A Drive is a persistent, bottomless storage that can be attached and detached to Sandboxes.
  * Drives can be mounted as read-write or as read-only snapshots, at a configurable path with `Sandbox.create()`.
  *
- * Use {@link Drive.getOrCreate} to construct.
+ * Use {@link Drive.get} or {@link Drive.getOrCreate} to construct.
  * @hideconstructor
  */
 declare class Drive {
@@ -51,6 +62,14 @@ declare class Drive {
    * Unique ID of this drive.
    */
   get driveId(): string;
+  /**
+   * The ID of the source drive, if this drive is a fork.
+   */
+  get parentDriveId(): string | undefined;
+  /**
+   * The ID of the original drive at the root of this fork.
+   */
+  get rootDriveId(): string | undefined;
   /**
    * The name of the drive.
    */
@@ -137,13 +156,34 @@ declare class Drive {
       next: string | null;
     };
   }, "drives">>;
+  /**
+   * Retrieve an existing drive by its name. Use {@link Drive.getOrCreate}
+   * to create new drives.
+   *
+   * @param params - Get parameters and optional credentials.
+   * @returns A promise resolving to the {@link Drive} if it exists.
+   */
+  static get(params: (GetDriveParams | (GetDriveParams & Credentials)) & WithFetchOptions): Promise<Drive>;
   /**
    * Retrieve an existing drive, or create a new one if it doesn't exists.
+   * Use {@link Drive.get} to get a drive without trying to create it if
+   * it doesn't exit.
    *
    * @param params - Get/create parameters and optional credentials.
    * @returns A promise resolving to the {@link Drive}.
    */
   static getOrCreate(params: (GetOrCreateDriveParams | (GetOrCreateDriveParams & Credentials)) & WithFetchOptions): Promise<Drive>;
+  /**
+   * Create a fork of this drive, with a new name. Forks inherit their parent
+   * drive's data, max size and region.
+   *
+   * @param params - Name of the forked drive and optional abort signal.
+   * @returns A promise resolving to the forked {@link Drive}.
+   */
+  fork(params: {
+    name: string;
+    signal?: AbortSignal;
+  }): Promise<Drive>;
   /**
    * Delete this drive. The drive must not be attached to any sandbox.
    * This operation is irreversible and will delete all data stored in the drive.