tensorlake 0.5.5 → 0.5.7

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CreatePtySessionOptions, S as SandboxOptions, a as CreateAndConnectOptions, b as SandboxClientOptions, c as ConnectOptions, d as SnapshotInfo, e as SandboxStatus, U as UpdateSandboxOptions, f as SandboxInfo, 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 SandboxPortAccess, q as SnapshotOptions, r as CreateSnapshotResponse, s as SnapshotAndWaitOptions, t as CreatePoolOptions, u as CreateSandboxPoolResponse, v as SandboxPoolInfo, w as UpdatePoolOptions } from './sandbox-image-BmhjX2bC.cjs';
-export { x as CheckpointType, y as ContainerResourcesInfo, z as ContainerState, A as CreateSandboxImageOptions, B as DirectoryEntry, E as DockerfileBuildPlan, F as DockerfileInstruction, I as Image, G as ImageBuildOperation, J as ImageBuildOperationType, J as ImageBuildOperationTypeValue, K as ImageOptions, N as NetworkConfig, M as OutputMode, Q as PoolContainerInfo, T as ProcessStatus, V as SandboxImageSource, W as SnapshotStatus, X as SnapshotType, Y as StdinMode, Z as createSandboxImage, _ as dockerfileContent } from './sandbox-image-BmhjX2bC.cjs';
+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 SandboxPortAccess, q as SnapshotOptions, r as CreateSnapshotResponse, s as SnapshotAndWaitOptions, t as CreatePoolOptions, u as CreateSandboxPoolResponse, v as SandboxPoolInfo, w as UpdatePoolOptions } from './sandbox-image-BMDaNpZ2.cjs';
+export { x as CheckpointType, y as ContainerResourcesInfo, z as ContainerState, A as CreateSandboxImageOptions, B as DirectoryEntry, E as DockerfileBuildPlan, F as DockerfileInstruction, I as Image, G as ImageBuildOperation, J as ImageBuildOperationType, J as ImageBuildOperationTypeValue, K as ImageOptions, N as NetworkConfig, M as OutputMode, Q as PoolContainerInfo, T as ProcessStatus, V as SandboxImageSource, W as SnapshotStatus, X as SnapshotType, Y as StdinMode, Z as createSandboxImage, _ as dockerfileContent } from './sandbox-image-BMDaNpZ2.cjs';
 
 /**
  * The return value of every SDK operation. Carries the W3C `trace_id` so callers
@@ -191,8 +191,8 @@ declare class Sandbox {
     /**
      * Attach to an existing sandbox and return a connected handle.
      *
-     * Verifies the sandbox exists via a server GET call, then returns a handle
-     * in whatever state the sandbox is in. Does **not** auto-resume a suspended
+     * Returns immediately without contacting the server. Call `sandbox.info()`
+     * to fetch the current state on demand. Does **not** auto-resume a suspended
      * sandbox — call `sandbox.resume()` explicitly.
      */
     static connect(options: ConnectOptions & Partial<SandboxClientOptions>): Promise<Sandbox>;
@@ -200,7 +200,13 @@ declare class Sandbox {
     static getSnapshot(snapshotId: string, options?: Partial<SandboxClientOptions>): Promise<SnapshotInfo>;
     /** Delete a snapshot by ID. No sandbox handle needed. */
     static deleteSnapshot(snapshotId: string, options?: Partial<SandboxClientOptions>): Promise<void>;
+    /** List all sandboxes. No sandbox handle needed. */
+    static list(options?: Partial<SandboxClientOptions>): Promise<SandboxInfo[]>;
+    /** List all snapshots in the project. No sandbox handle needed. */
+    static listSnapshots(options?: Partial<SandboxClientOptions>): Promise<SnapshotInfo[]>;
     private requireLifecycleClient;
+    /** Fetch the current sandbox information from the server on demand. */
+    info(): Promise<Traced<SandboxInfo>>;
     /**
      * Fetch the current sandbox status from the server.
      *
@@ -214,7 +220,7 @@ declare class Sandbox {
      * Naming an ephemeral sandbox makes it non-ephemeral and enables
      * suspend/resume.
      */
-    update(options: UpdateSandboxOptions): Promise<SandboxInfo>;
+    update(options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
     /**
      * Suspend this sandbox.
      *
@@ -237,7 +243,7 @@ declare class Sandbox {
      * the completed `SnapshotInfo`. Pass `{ wait: false }` to fire-and-return
      * (returns `undefined`).
      */
-    checkpoint(options?: CheckpointOptions): Promise<SnapshotInfo | undefined>;
+    checkpoint(options?: CheckpointOptions): Promise<Traced<SnapshotInfo> | undefined>;
     /**
      * List snapshots taken from this sandbox.
      */
@@ -252,7 +258,7 @@ declare class Sandbox {
      * Uses a single streaming `POST /api/v1/processes/run` request that starts
      * the process, streams output, and delivers the exit code over one connection.
      */
-    run(command: string, options?: RunOptions): Promise<CommandResult>;
+    run(command: string, options?: RunOptions): Promise<Traced<CommandResult>>;
     /**
      * Start a process in the sandbox without waiting for it to exit.
      *
@@ -261,25 +267,25 @@ declare class Sandbox {
      * until the process exits. Use `run()` instead to block until completion
      * and get combined output in one call.
      */
-    startProcess(command: string, options?: StartProcessOptions): Promise<ProcessInfo>;
+    startProcess(command: string, options?: StartProcessOptions): Promise<Traced<ProcessInfo>>;
     /** List all processes (running and exited) tracked by the sandbox daemon. */
     listProcesses(): Promise<Traced<ProcessInfo[]>>;
     /** Get current status and metadata for a process by PID. */
-    getProcess(pid: number): Promise<ProcessInfo>;
+    getProcess(pid: number): Promise<Traced<ProcessInfo>>;
     /** Send SIGKILL to a process. */
     killProcess(pid: number): Promise<void>;
     /** Send an arbitrary signal to a process (e.g. `15` for SIGTERM, `9` for SIGKILL). */
-    sendSignal(pid: number, signal: number): Promise<SendSignalResponse>;
+    sendSignal(pid: number, signal: number): Promise<Traced<SendSignalResponse>>;
     /** Write bytes to a process's stdin. The process must have been started with `stdinMode: StdinMode.PIPE`. */
     writeStdin(pid: number, data: Uint8Array): Promise<void>;
     /** Close a process's stdin pipe, signalling EOF to the process. */
     closeStdin(pid: number): Promise<void>;
     /** Return all captured stdout lines produced so far by a process. */
-    getStdout(pid: number): Promise<OutputResponse>;
+    getStdout(pid: number): Promise<Traced<OutputResponse>>;
     /** Return all captured stderr lines produced so far by a process. */
-    getStderr(pid: number): Promise<OutputResponse>;
+    getStderr(pid: number): Promise<Traced<OutputResponse>>;
     /** Return all captured stdout+stderr lines produced so far by a process. */
-    getOutput(pid: number): Promise<OutputResponse>;
+    getOutput(pid: number): Promise<Traced<OutputResponse>>;
     /** Stream stdout events from a process until it exits. Yields one `OutputEvent` per line. */
     followStdout(pid: number, options?: {
         signal?: AbortSignal;
@@ -293,15 +299,15 @@ declare class Sandbox {
         signal?: AbortSignal;
     }): AsyncIterable<OutputEvent>;
     /** Read a file from the sandbox and return its raw bytes. */
-    readFile(path: string): Promise<Uint8Array>;
+    readFile(path: string): Promise<Traced<Uint8Array>>;
     /** Write raw bytes to a file in the sandbox, creating it if it does not exist. */
     writeFile(path: string, content: Uint8Array): Promise<void>;
     /** Delete a file from the sandbox. */
     deleteFile(path: string): Promise<void>;
     /** List the contents of a directory in the sandbox. */
-    listDirectory(path: string): Promise<ListDirectoryResponse>;
+    listDirectory(path: string): Promise<Traced<ListDirectoryResponse>>;
     /** Create an interactive PTY session. Returns a `sessionId` and `token` for WebSocket connection via `connectPty()`. */
-    createPtySession(options: CreatePtySessionOptions): Promise<PtySessionInfo>;
+    createPtySession(options: CreatePtySessionOptions): Promise<Traced<PtySessionInfo>>;
     /** Create a PTY session and connect to it immediately. Cleans up the session if the WebSocket connection fails. */
     createPty(options: CreatePtyOptions): Promise<Pty>;
     /** Attach to an existing PTY session by ID and token and return a connected `Pty` handle. */
@@ -310,11 +316,17 @@ declare class Sandbox {
     createTunnel(remotePort: number, options?: CreateTunnelOptions): Promise<TcpTunnel>;
     /** Connect to a sandbox VNC session for programmatic desktop control. */
     connectDesktop(options?: ConnectDesktopOptions): Promise<Desktop>;
+    /**
+     * Poll the in-sandbox daemon until `127.0.0.1:port` accepts a TCP connection.
+     * Uses `bash`'s `/dev/tcp` builtin via `processes/run` — no extra deps in
+     * the sandbox image. `bash` is present on every image we ship.
+     */
+    private waitForPortReady;
     ptyWsUrl(sessionId: string, token: string): string;
     /** Check the sandbox daemon health. */
-    health(): Promise<HealthResponse>;
+    health(): Promise<Traced<HealthResponse>>;
     /** Get sandbox daemon info (version, uptime, process counts). */
-    info(): Promise<DaemonInfo>;
+    daemonInfo(): Promise<Traced<DaemonInfo>>;
 }
 
 /**
@@ -350,11 +362,11 @@ declare class SandboxClient {
     /** Create a new sandbox. Returns immediately; the sandbox may still be starting. Use `createAndConnect()` for a blocking, ready-to-use handle. */
     create(options?: CreateSandboxOptions): Promise<Traced<CreateSandboxResponse>>;
     /** Get current state and metadata for a sandbox by ID. */
-    get(sandboxId: string): Promise<SandboxInfo>;
+    get(sandboxId: string): Promise<Traced<SandboxInfo>>;
     /** List all sandboxes in the namespace. */
     list(): Promise<Traced<SandboxInfo[]>>;
     /** Update sandbox properties such as name, exposed ports, and proxy auth settings. */
-    update(sandboxId: string, options: UpdateSandboxOptions): Promise<SandboxInfo>;
+    update(sandboxId: string, options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
     /** Get the current proxy port settings for a sandbox. */
     getPortAccess(sandboxId: string): Promise<SandboxPortAccess>;
     /** Add one or more user ports to the sandbox proxy allowlist. */
@@ -408,7 +420,7 @@ declare class SandboxClient {
      */
     snapshot(sandboxId: string, options?: SnapshotOptions): Promise<CreateSnapshotResponse>;
     /** Get current status and metadata for a snapshot by ID. */
-    getSnapshot(snapshotId: string): Promise<SnapshotInfo>;
+    getSnapshot(snapshotId: string): Promise<Traced<SnapshotInfo>>;
     /** List all snapshots in the namespace. */
     listSnapshots(): Promise<Traced<SnapshotInfo[]>>;
     /** Delete a snapshot by ID. */
@@ -426,7 +438,7 @@ declare class SandboxClient {
      * @param options.snapshotType - Snapshot type passed through to `snapshot()`.
      * @throws {SandboxError} If the snapshot fails or `timeout` elapses.
      */
-    snapshotAndWait(sandboxId: string, options?: SnapshotAndWaitOptions): Promise<SnapshotInfo>;
+    snapshotAndWait(sandboxId: string, options?: SnapshotAndWaitOptions): Promise<Traced<SnapshotInfo>>;
     /** Create a new sandbox pool with warm pre-booted containers. */
     createPool(options: CreatePoolOptions): Promise<CreateSandboxPoolResponse>;
     /** Get current state and metadata for a sandbox pool by ID. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CreatePtySessionOptions, S as SandboxOptions, a as CreateAndConnectOptions, b as SandboxClientOptions, c as ConnectOptions, d as SnapshotInfo, e as SandboxStatus, U as UpdateSandboxOptions, f as SandboxInfo, 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 SandboxPortAccess, q as SnapshotOptions, r as CreateSnapshotResponse, s as SnapshotAndWaitOptions, t as CreatePoolOptions, u as CreateSandboxPoolResponse, v as SandboxPoolInfo, w as UpdatePoolOptions } from './sandbox-image-BmhjX2bC.js';
-export { x as CheckpointType, y as ContainerResourcesInfo, z as ContainerState, A as CreateSandboxImageOptions, B as DirectoryEntry, E as DockerfileBuildPlan, F as DockerfileInstruction, I as Image, G as ImageBuildOperation, J as ImageBuildOperationType, J as ImageBuildOperationTypeValue, K as ImageOptions, N as NetworkConfig, M as OutputMode, Q as PoolContainerInfo, T as ProcessStatus, V as SandboxImageSource, W as SnapshotStatus, X as SnapshotType, Y as StdinMode, Z as createSandboxImage, _ as dockerfileContent } from './sandbox-image-BmhjX2bC.js';
+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 SandboxPortAccess, q as SnapshotOptions, r as CreateSnapshotResponse, s as SnapshotAndWaitOptions, t as CreatePoolOptions, u as CreateSandboxPoolResponse, v as SandboxPoolInfo, w as UpdatePoolOptions } from './sandbox-image-BMDaNpZ2.js';
+export { x as CheckpointType, y as ContainerResourcesInfo, z as ContainerState, A as CreateSandboxImageOptions, B as DirectoryEntry, E as DockerfileBuildPlan, F as DockerfileInstruction, I as Image, G as ImageBuildOperation, J as ImageBuildOperationType, J as ImageBuildOperationTypeValue, K as ImageOptions, N as NetworkConfig, M as OutputMode, Q as PoolContainerInfo, T as ProcessStatus, V as SandboxImageSource, W as SnapshotStatus, X as SnapshotType, Y as StdinMode, Z as createSandboxImage, _ as dockerfileContent } from './sandbox-image-BMDaNpZ2.js';
 
 /**
  * The return value of every SDK operation. Carries the W3C `trace_id` so callers
@@ -191,8 +191,8 @@ declare class Sandbox {
     /**
      * Attach to an existing sandbox and return a connected handle.
      *
-     * Verifies the sandbox exists via a server GET call, then returns a handle
-     * in whatever state the sandbox is in. Does **not** auto-resume a suspended
+     * Returns immediately without contacting the server. Call `sandbox.info()`
+     * to fetch the current state on demand. Does **not** auto-resume a suspended
      * sandbox — call `sandbox.resume()` explicitly.
      */
     static connect(options: ConnectOptions & Partial<SandboxClientOptions>): Promise<Sandbox>;
@@ -200,7 +200,13 @@ declare class Sandbox {
     static getSnapshot(snapshotId: string, options?: Partial<SandboxClientOptions>): Promise<SnapshotInfo>;
     /** Delete a snapshot by ID. No sandbox handle needed. */
     static deleteSnapshot(snapshotId: string, options?: Partial<SandboxClientOptions>): Promise<void>;
+    /** List all sandboxes. No sandbox handle needed. */
+    static list(options?: Partial<SandboxClientOptions>): Promise<SandboxInfo[]>;
+    /** List all snapshots in the project. No sandbox handle needed. */
+    static listSnapshots(options?: Partial<SandboxClientOptions>): Promise<SnapshotInfo[]>;
     private requireLifecycleClient;
+    /** Fetch the current sandbox information from the server on demand. */
+    info(): Promise<Traced<SandboxInfo>>;
     /**
      * Fetch the current sandbox status from the server.
      *
@@ -214,7 +220,7 @@ declare class Sandbox {
      * Naming an ephemeral sandbox makes it non-ephemeral and enables
      * suspend/resume.
      */
-    update(options: UpdateSandboxOptions): Promise<SandboxInfo>;
+    update(options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
     /**
      * Suspend this sandbox.
      *
@@ -237,7 +243,7 @@ declare class Sandbox {
      * the completed `SnapshotInfo`. Pass `{ wait: false }` to fire-and-return
      * (returns `undefined`).
      */
-    checkpoint(options?: CheckpointOptions): Promise<SnapshotInfo | undefined>;
+    checkpoint(options?: CheckpointOptions): Promise<Traced<SnapshotInfo> | undefined>;
     /**
      * List snapshots taken from this sandbox.
      */
@@ -252,7 +258,7 @@ declare class Sandbox {
      * Uses a single streaming `POST /api/v1/processes/run` request that starts
      * the process, streams output, and delivers the exit code over one connection.
      */
-    run(command: string, options?: RunOptions): Promise<CommandResult>;
+    run(command: string, options?: RunOptions): Promise<Traced<CommandResult>>;
     /**
      * Start a process in the sandbox without waiting for it to exit.
      *
@@ -261,25 +267,25 @@ declare class Sandbox {
      * until the process exits. Use `run()` instead to block until completion
      * and get combined output in one call.
      */
-    startProcess(command: string, options?: StartProcessOptions): Promise<ProcessInfo>;
+    startProcess(command: string, options?: StartProcessOptions): Promise<Traced<ProcessInfo>>;
     /** List all processes (running and exited) tracked by the sandbox daemon. */
     listProcesses(): Promise<Traced<ProcessInfo[]>>;
     /** Get current status and metadata for a process by PID. */
-    getProcess(pid: number): Promise<ProcessInfo>;
+    getProcess(pid: number): Promise<Traced<ProcessInfo>>;
     /** Send SIGKILL to a process. */
     killProcess(pid: number): Promise<void>;
     /** Send an arbitrary signal to a process (e.g. `15` for SIGTERM, `9` for SIGKILL). */
-    sendSignal(pid: number, signal: number): Promise<SendSignalResponse>;
+    sendSignal(pid: number, signal: number): Promise<Traced<SendSignalResponse>>;
     /** Write bytes to a process's stdin. The process must have been started with `stdinMode: StdinMode.PIPE`. */
     writeStdin(pid: number, data: Uint8Array): Promise<void>;
     /** Close a process's stdin pipe, signalling EOF to the process. */
     closeStdin(pid: number): Promise<void>;
     /** Return all captured stdout lines produced so far by a process. */
-    getStdout(pid: number): Promise<OutputResponse>;
+    getStdout(pid: number): Promise<Traced<OutputResponse>>;
     /** Return all captured stderr lines produced so far by a process. */
-    getStderr(pid: number): Promise<OutputResponse>;
+    getStderr(pid: number): Promise<Traced<OutputResponse>>;
     /** Return all captured stdout+stderr lines produced so far by a process. */
-    getOutput(pid: number): Promise<OutputResponse>;
+    getOutput(pid: number): Promise<Traced<OutputResponse>>;
     /** Stream stdout events from a process until it exits. Yields one `OutputEvent` per line. */
     followStdout(pid: number, options?: {
         signal?: AbortSignal;
@@ -293,15 +299,15 @@ declare class Sandbox {
         signal?: AbortSignal;
     }): AsyncIterable<OutputEvent>;
     /** Read a file from the sandbox and return its raw bytes. */
-    readFile(path: string): Promise<Uint8Array>;
+    readFile(path: string): Promise<Traced<Uint8Array>>;
     /** Write raw bytes to a file in the sandbox, creating it if it does not exist. */
     writeFile(path: string, content: Uint8Array): Promise<void>;
     /** Delete a file from the sandbox. */
     deleteFile(path: string): Promise<void>;
     /** List the contents of a directory in the sandbox. */
-    listDirectory(path: string): Promise<ListDirectoryResponse>;
+    listDirectory(path: string): Promise<Traced<ListDirectoryResponse>>;
     /** Create an interactive PTY session. Returns a `sessionId` and `token` for WebSocket connection via `connectPty()`. */
-    createPtySession(options: CreatePtySessionOptions): Promise<PtySessionInfo>;
+    createPtySession(options: CreatePtySessionOptions): Promise<Traced<PtySessionInfo>>;
     /** Create a PTY session and connect to it immediately. Cleans up the session if the WebSocket connection fails. */
     createPty(options: CreatePtyOptions): Promise<Pty>;
     /** Attach to an existing PTY session by ID and token and return a connected `Pty` handle. */
@@ -310,11 +316,17 @@ declare class Sandbox {
     createTunnel(remotePort: number, options?: CreateTunnelOptions): Promise<TcpTunnel>;
     /** Connect to a sandbox VNC session for programmatic desktop control. */
     connectDesktop(options?: ConnectDesktopOptions): Promise<Desktop>;
+    /**
+     * Poll the in-sandbox daemon until `127.0.0.1:port` accepts a TCP connection.
+     * Uses `bash`'s `/dev/tcp` builtin via `processes/run` — no extra deps in
+     * the sandbox image. `bash` is present on every image we ship.
+     */
+    private waitForPortReady;
     ptyWsUrl(sessionId: string, token: string): string;
     /** Check the sandbox daemon health. */
-    health(): Promise<HealthResponse>;
+    health(): Promise<Traced<HealthResponse>>;
     /** Get sandbox daemon info (version, uptime, process counts). */
-    info(): Promise<DaemonInfo>;
+    daemonInfo(): Promise<Traced<DaemonInfo>>;
 }
 
 /**
@@ -350,11 +362,11 @@ declare class SandboxClient {
     /** Create a new sandbox. Returns immediately; the sandbox may still be starting. Use `createAndConnect()` for a blocking, ready-to-use handle. */
     create(options?: CreateSandboxOptions): Promise<Traced<CreateSandboxResponse>>;
     /** Get current state and metadata for a sandbox by ID. */
-    get(sandboxId: string): Promise<SandboxInfo>;
+    get(sandboxId: string): Promise<Traced<SandboxInfo>>;
     /** List all sandboxes in the namespace. */
     list(): Promise<Traced<SandboxInfo[]>>;
     /** Update sandbox properties such as name, exposed ports, and proxy auth settings. */
-    update(sandboxId: string, options: UpdateSandboxOptions): Promise<SandboxInfo>;
+    update(sandboxId: string, options: UpdateSandboxOptions): Promise<Traced<SandboxInfo>>;
     /** Get the current proxy port settings for a sandbox. */
     getPortAccess(sandboxId: string): Promise<SandboxPortAccess>;
     /** Add one or more user ports to the sandbox proxy allowlist. */
@@ -408,7 +420,7 @@ declare class SandboxClient {
      */
     snapshot(sandboxId: string, options?: SnapshotOptions): Promise<CreateSnapshotResponse>;
     /** Get current status and metadata for a snapshot by ID. */
-    getSnapshot(snapshotId: string): Promise<SnapshotInfo>;
+    getSnapshot(snapshotId: string): Promise<Traced<SnapshotInfo>>;
     /** List all snapshots in the namespace. */
     listSnapshots(): Promise<Traced<SnapshotInfo[]>>;
     /** Delete a snapshot by ID. */
@@ -426,7 +438,7 @@ declare class SandboxClient {
      * @param options.snapshotType - Snapshot type passed through to `snapshot()`.
      * @throws {SandboxError} If the snapshot fails or `timeout` elapses.
      */
-    snapshotAndWait(sandboxId: string, options?: SnapshotAndWaitOptions): Promise<SnapshotInfo>;
+    snapshotAndWait(sandboxId: string, options?: SnapshotAndWaitOptions): Promise<Traced<SnapshotInfo>>;
     /** Create a new sandbox pool with warm pre-booted containers. */
     createPool(options: CreatePoolOptions): Promise<CreateSandboxPoolResponse>;
     /** Get current state and metadata for a sandbox pool by ID. */