eve 0.26.2 → 0.27.1

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

@@ -193,6 +193,7 @@ declare class APIClient extends BaseClient {
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
+      image?: string | undefined;
       timeout?: number | undefined;
       networkPolicy?: {
         [x: string]: unknown;
@@ -284,6 +285,7 @@ declare class APIClient extends BaseClient {
       totalIngressBytes?: number | undefined;
       totalActiveCpuDurationMs?: number | undefined;
       totalDurationMs?: number | undefined;
+      expiresAt?: number | undefined;
       currentSnapshotId?: string | undefined;
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
@@ -771,6 +773,7 @@ declare class APIClient extends BaseClient {
       sessionId: string;
       exitCode: number | null;
       startedAt: number;
+      durationMs?: number | undefined;
     };
   }>>;
   getLogs(params: {
@@ -824,6 +827,7 @@ declare class APIClient extends BaseClient {
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
+      image?: string | undefined;
       timeout?: number | undefined;
       networkPolicy?: {
         [x: string]: unknown;
@@ -915,6 +919,7 @@ declare class APIClient extends BaseClient {
       totalIngressBytes?: number | undefined;
       totalActiveCpuDurationMs?: number | undefined;
       totalDurationMs?: number | undefined;
+      expiresAt?: number | undefined;
       currentSnapshotId?: string | undefined;
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
@@ -1067,6 +1072,7 @@ declare class APIClient extends BaseClient {
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
+      image?: string | undefined;
       timeout?: number | undefined;
       networkPolicy?: {
         [x: string]: unknown;
@@ -1158,6 +1164,7 @@ declare class APIClient extends BaseClient {
       totalIngressBytes?: number | undefined;
       totalActiveCpuDurationMs?: number | undefined;
       totalDurationMs?: number | undefined;
+      expiresAt?: number | undefined;
       currentSnapshotId?: string | undefined;
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
@@ -1207,6 +1214,7 @@ declare class APIClient extends BaseClient {
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
+      image?: string | undefined;
       timeout?: number | undefined;
       networkPolicy?: {
         [x: string]: unknown;
@@ -1298,6 +1306,7 @@ declare class APIClient extends BaseClient {
       totalIngressBytes?: number | undefined;
       totalActiveCpuDurationMs?: number | undefined;
       totalDurationMs?: number | undefined;
+      expiresAt?: number | undefined;
       currentSnapshotId?: string | undefined;
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;
@@ -1331,6 +1340,7 @@ declare class APIClient extends BaseClient {
       vcpus?: number | undefined;
       memory?: number | undefined;
       runtime?: string | undefined;
+      image?: string | undefined;
       timeout?: number | undefined;
       networkPolicy?: {
         [x: string]: unknown;
@@ -1422,6 +1432,7 @@ declare class APIClient extends BaseClient {
       totalIngressBytes?: number | undefined;
       totalActiveCpuDurationMs?: number | undefined;
       totalDurationMs?: number | undefined;
+      expiresAt?: number | undefined;
       currentSnapshotId?: string | undefined;
       statusUpdatedAt?: number | undefined;
       cwd?: string | undefined;

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

@@ -151,6 +151,7 @@ declare const Command: z.ZodObject<{
   cwd: z.ZodString;
   sessionId: z.ZodString;
   exitCode: z.ZodNullable<z.ZodNumber>;
+  durationMs: z.ZodOptional<z.ZodNumber>;
   startedAt: z.ZodNumber;
 }, z.core.$strip>;
 declare const SessionResponse: z.ZodObject<{
@@ -284,6 +285,7 @@ declare const CommandResponse: z.ZodObject<{
     cwd: z.ZodString;
     sessionId: z.ZodString;
     exitCode: z.ZodNullable<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
     startedAt: z.ZodNumber;
   }, z.core.$strip>;
 }, z.core.$strip>;
@@ -295,6 +297,7 @@ declare const CommandFinishedResponse: z.ZodObject<{
     args: z.ZodArray<z.ZodString>;
     cwd: z.ZodString;
     sessionId: z.ZodString;
+    durationMs: z.ZodOptional<z.ZodNumber>;
     startedAt: z.ZodNumber;
     exitCode: z.ZodNumber;
   }, z.core.$strip>;
@@ -521,6 +524,7 @@ declare const Sandbox: z.ZodObject<{
   vcpus: z.ZodOptional<z.ZodNumber>;
   memory: z.ZodOptional<z.ZodNumber>;
   runtime: z.ZodOptional<z.ZodString>;
+  image: z.ZodOptional<z.ZodString>;
   timeout: z.ZodOptional<z.ZodNumber>;
   networkPolicy: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
     mode: z.ZodLiteral<"allow-all">;
@@ -611,6 +615,7 @@ declare const Sandbox: z.ZodObject<{
   totalDurationMs: z.ZodOptional<z.ZodNumber>;
   createdAt: z.ZodNumber;
   updatedAt: z.ZodNumber;
+  expiresAt: z.ZodOptional<z.ZodNumber>;
   currentSessionId: z.ZodString;
   currentSnapshotId: z.ZodOptional<z.ZodString>;
   status: z.ZodEnum<{
@@ -758,6 +763,7 @@ declare const StopSessionResponse: z.ZodObject<{
     vcpus: z.ZodOptional<z.ZodNumber>;
     memory: z.ZodOptional<z.ZodNumber>;
     runtime: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
     timeout: z.ZodOptional<z.ZodNumber>;
     networkPolicy: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
       mode: z.ZodLiteral<"allow-all">;
@@ -848,6 +854,7 @@ declare const StopSessionResponse: z.ZodObject<{
     totalDurationMs: z.ZodOptional<z.ZodNumber>;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
     currentSessionId: z.ZodString;
     currentSnapshotId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{

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

@@ -26,6 +26,7 @@ interface SerializedCommand {
  */
 interface SerializedCommandFinished extends SerializedCommand {
   exitCode: number;
+  durationMs?: number;
 }
 /**
  * A command executed in a Sandbox.
@@ -60,6 +61,7 @@ declare class Command {
    */
   protected cmd: CommandData;
   exitCode: number | null;
+  durationMs?: number;
   protected outputCache: Promise<{
     stdout: string;
     stderr: string;
@@ -237,12 +239,17 @@ declare class CommandFinished extends Command {
    * CommandFinished instances.
    */
   exitCode: number;
+  /**
+   * The duration of the command execution in milliseconds.
+   */
+  durationMs?: number;
   /**
    * @param params - Object containing client, sandbox ID, command data, and exit code.
    * @param params.client - Optional API client. If not provided, will be lazily created using global credentials.
    * @param params.sessionId - The ID of the session where the command ran.
    * @param params.cmd - The command data.
    * @param params.exitCode - The exit code of the completed command.
+   * @param params.durationMs - Optional duration of the command execution in milliseconds.
    * @param params.output - Optional cached output to restore (used during deserialization).
    */
   constructor(params: {
@@ -250,6 +257,7 @@ declare class CommandFinished extends Command {
     sessionId: string;
     cmd: CommandData;
     exitCode: number;
+    durationMs?: number;
     output?: CommandOutput;
   });
   /**

package/dist/src/compiled/@vercel/sandbox/execution-context.d.ts

@@ -0,0 +1,116 @@
+import { Command, CommandFinished } from "./command.js";
+import { RunCommandParams } from "./session.js";
+
+//#region src/execution-context.d.ts
+
+/**
+ * The common surface for running commands and performing file operations in
+ * a sandbox, regardless of scope.
+ *
+ * Implemented by {@link Sandbox}, {@link Session}, and {@link SandboxUser},
+ * so code can be written against "somewhere to run commands" without caring
+ * whether it targets the whole sandbox or a specific user's context.
+ *
+ * Implementations may scope the operations: for example, {@link SandboxUser}
+ * runs commands as its user and resolves relative paths against the user's
+ * home directory.
+ */
+interface ExecutionContext {
+  /**
+   * Start executing a command in this context.
+   *
+   * @param command - The command to execute.
+   * @param args - Arguments to pass to the command.
+   * @param opts - Optional parameters.
+   * @returns A {@link CommandFinished} result once execution is done.
+   */
+  runCommand(command: string, args?: string[], opts?: {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+  }): Promise<CommandFinished>;
+  /**
+   * Start executing a command in this context in detached mode.
+   *
+   * @param params - The command parameters.
+   * @returns A {@link Command} instance for the running command.
+   */
+  runCommand(params: RunCommandParams & {
+    detached: true;
+  }): Promise<Command>;
+  /**
+   * Start executing a command in this context.
+   *
+   * @param params - The command parameters.
+   * @returns A {@link CommandFinished} result once execution is done.
+   */
+  runCommand(params: RunCommandParams): Promise<CommandFinished>;
+  /**
+   * Create a directory in the filesystem of this context.
+   *
+   * @param path - Path of the directory to create
+   * @param opts - Optional parameters.
+   */
+  mkDir(path: string, opts?: {
+    signal?: AbortSignal;
+  }): Promise<void>;
+  /**
+   * Read a file from this context as a stream.
+   *
+   * @param file - File to read, with path and optional cwd
+   * @param opts - Optional parameters.
+   * @returns A ReadableStream of the file contents, or null if not found
+   */
+  readFile(file: {
+    path: string;
+    cwd?: string;
+  }, opts?: {
+    signal?: AbortSignal;
+  }): Promise<NodeJS.ReadableStream | null>;
+  /**
+   * Read a file from this context as a Buffer.
+   *
+   * @param file - File to read, with path and optional cwd
+   * @param opts - Optional parameters.
+   * @returns The file contents as a Buffer, or null if not found
+   */
+  readFileToBuffer(file: {
+    path: string;
+    cwd?: string;
+  }, opts?: {
+    signal?: AbortSignal;
+  }): Promise<Buffer | null>;
+  /**
+   * Download a file from this context to the local filesystem.
+   *
+   * @param src - Source file in the sandbox
+   * @param dst - Destination on the local machine
+   * @param opts - Optional parameters.
+   * @returns The absolute path to the written file, or null if not found
+   */
+  downloadFile(src: {
+    path: string;
+    cwd?: string;
+  }, dst: {
+    path: string;
+    cwd?: string;
+  }, opts?: {
+    mkdirRecursive?: boolean;
+    signal?: AbortSignal;
+  }): Promise<string | null>;
+  /**
+   * Write files to the filesystem of this context.
+   *
+   * @param files - Array of files with path, content, and optional mode
+   * @param opts - Optional parameters.
+   */
+  writeFiles(files: {
+    path: string;
+    content: string | Uint8Array;
+    mode?: number;
+  }[], opts?: {
+    signal?: AbortSignal;
+  }): Promise<void>;
+}
+//#endregion
+export { ExecutionContext };
+//# sourceMappingURL=execution-context.d.ts.map

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

@@ -3,8 +3,10 @@ import { SnapshotTreeNodeData } from "./api-client/validators.js";
 import { NetworkPolicy, NetworkPolicyKeyValueMatcher, NetworkPolicyMatch, NetworkPolicyMatcher, NetworkPolicyRule, NetworkTransformer } from "./network-policy.js";
 import { Command, CommandFinished, CommandOutput, SerializedCommand, SerializedCommandFinished } from "./command.js";
 import { SerializedSnapshot, Snapshot } from "./snapshot.js";
+import { ExecutionContext } from "./execution-context.js";
 import { Session } from "./session.js";
 import { FileSystem } from "./filesystem.js";
+import { SandboxUser, SandboxUserAlreadyExistsError } from "./sandbox-user.js";
 import { Sandbox, SerializedSandbox } from "./sandbox.js";
 import { InvalidRequestProxyHandler, ProxyHandler, ProxyMeta, defineSandboxProxy } from "./proxy.js";
-export { APIError, Command, CommandFinished, type CommandOutput, FileSystem, type InvalidRequestProxyHandler, type NetworkPolicy, type NetworkPolicyKeyValueMatcher, type NetworkPolicyMatch, type NetworkPolicyMatcher, type NetworkPolicyRule, type NetworkTransformer, type ProxyHandler, type ProxyMeta, Sandbox, type SerializedCommand, type SerializedCommandFinished, type SerializedSandbox, type SerializedSnapshot, Session, Snapshot, type SnapshotTreeNodeData, StreamError, defineSandboxProxy };
+export { APIError, Command, CommandFinished, type CommandOutput, type ExecutionContext, FileSystem, type InvalidRequestProxyHandler, type NetworkPolicy, type NetworkPolicyKeyValueMatcher, type NetworkPolicyMatch, type NetworkPolicyMatcher, type NetworkPolicyRule, type NetworkTransformer, type ProxyHandler, type ProxyMeta, Sandbox, SandboxUser, SandboxUserAlreadyExistsError, type SerializedCommand, type SerializedCommandFinished, type SerializedSandbox, type SerializedSnapshot, Session, Snapshot, type SnapshotTreeNodeData, StreamError, defineSandboxProxy };