tensorlake 0.5.6 → 0.5.9

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. */
@@ -318,9 +324,9 @@ declare class Sandbox {
     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>>;
 }
 
 /**
@@ -356,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. */
@@ -414,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. */
@@ -432,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. */
@@ -318,9 +324,9 @@ declare class Sandbox {
     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>>;
 }
 
 /**
@@ -356,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. */
@@ -414,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. */
@@ -432,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.js

@@ -13,7 +13,7 @@ var SDK_VERSION, API_URL, API_KEY, NAMESPACE, SANDBOX_PROXY_URL, DEFAULT_HTTP_TI
 var init_defaults = __esm({
   "src/defaults.ts"() {
     "use strict";
-    SDK_VERSION = "0.4.49";
+    SDK_VERSION = "0.5.9";
     API_URL = process.env.TENSORLAKE_API_URL ?? "https://api.tensorlake.ai";
     API_KEY = process.env.TENSORLAKE_API_KEY ?? void 0;
     NAMESPACE = process.env.INDEXIFY_NAMESPACE ?? "default";
@@ -218,6 +218,9 @@ var init_http = __esm({
         if (options.hostHeader) {
           this.headers["Host"] = options.hostHeader;
         }
+        if (options.sandboxIdHeader) {
+          this.headers["X-Tensorlake-Sandbox-Id"] = options.sandboxIdHeader;
+        }
         if (options.routingHint) {
           this.headers["X-Tensorlake-Route-Hint"] = options.routingHint;
         }
@@ -2929,21 +2932,36 @@ function resolveProxyTarget(proxyUrl, sandboxId) {
     if (host === "localhost" || host === "127.0.0.1") {
       return {
         baseUrl: trimTrailingSlashes(proxyUrl),
-        hostHeader: `${sandboxId}.local`
+        hostHeader: `${sandboxId}.local`,
+        sandboxIdHeader: void 0
       };
     }
     const port = parsed.port ? `:${parsed.port}` : "";
     return {
-      baseUrl: `${parsed.protocol}//${sandboxId}.${host}${port}`,
-      hostHeader: void 0
+      baseUrl: `${parsed.protocol}//${host}${port}`,
+      hostHeader: void 0,
+      sandboxIdHeader: sandboxId
     };
   } catch {
     return {
       baseUrl: `${trimTrailingSlashes(proxyUrl)}/${sandboxId}`,
-      hostHeader: void 0
+      hostHeader: void 0,
+      sandboxIdHeader: void 0
     };
   }
 }
+function resolveSandboxLifecycleUrl(apiUrl) {
+  if (isLocalhost(apiUrl)) return apiUrl;
+  try {
+    const parsed = new URL(apiUrl);
+    if (parsed.hostname.startsWith("api.")) {
+      parsed.hostname = "sandbox." + parsed.hostname.slice(4);
+      return parsed.toString().replace(/\/$/, "");
+    }
+  } catch {
+  }
+  return apiUrl;
+}
 function lifecyclePath(path2, isLocal, namespace) {
   if (isLocal) {
     return `/v1/namespaces/${namespace}/${path2}`;
@@ -3170,7 +3188,7 @@ var init_sandbox = __esm({
         this.sandboxId = options.sandboxId;
         this.lifecycleIdentifier = options.sandboxId;
         const proxyUrl = options.proxyUrl ?? SANDBOX_PROXY_URL;
-        const { baseUrl, hostHeader } = resolveProxyTarget(proxyUrl, options.sandboxId);
+        const { baseUrl, hostHeader, sandboxIdHeader } = resolveProxyTarget(proxyUrl, options.sandboxId);
         this.baseUrl = baseUrl;
         this.wsHeaders = {};
         if (options.apiKey) {
@@ -3185,12 +3203,16 @@ var init_sandbox = __esm({
         if (hostHeader) {
           this.wsHeaders.Host = hostHeader;
         }
+        if (sandboxIdHeader) {
+          this.wsHeaders["X-Tensorlake-Sandbox-Id"] = sandboxIdHeader;
+        }
         this.http = new HttpClient({
           baseUrl,
           apiKey: options.apiKey,
           organizationId: options.organizationId,
           projectId: options.projectId,
           hostHeader,
+          sandboxIdHeader,
           routingHint: options.routingHint
         });
       }
@@ -3231,8 +3253,8 @@ var init_sandbox = __esm({
       /**
        * 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 async connect(options) {
@@ -3242,15 +3264,12 @@ var init_sandbox = __esm({
           /* _internal */
           true
         );
-        const info = await client.get(options.sandboxId);
         const sandbox = client.connect(
-          info.sandboxId,
+          options.sandboxId,
           options.proxyUrl,
-          options.routingHint ?? info.routingHint
+          options.routingHint
         );
         sandbox.lifecycleClient = client;
-        sandbox._setLifecycleIdentifier(info.sandboxId);
-        sandbox._setName(info.name ?? null);
         return sandbox;
       }
       // --- Static snapshot management ---
@@ -3274,6 +3293,26 @@ var init_sandbox = __esm({
         );
         await client.deleteSnapshot(snapshotId);
       }
+      /** List all sandboxes. No sandbox handle needed. */
+      static async list(options) {
+        const { SandboxClient: SandboxClient2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+        const client = new SandboxClient2(
+          options,
+          /* _internal */
+          true
+        );
+        return client.list();
+      }
+      /** List all snapshots in the project. No sandbox handle needed. */
+      static async listSnapshots(options) {
+        const { SandboxClient: SandboxClient2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+        const client = new SandboxClient2(
+          options,
+          /* _internal */
+          true
+        );
+        return client.listSnapshots();
+      }
       // --- Instance lifecycle methods ---
       requireLifecycleClient(operation) {
         if (!this.lifecycleClient) {
@@ -3283,6 +3322,14 @@ var init_sandbox = __esm({
         }
         return this.lifecycleClient;
       }
+      /** Fetch the current sandbox information from the server on demand. */
+      async info() {
+        const client = this.requireLifecycleClient("info");
+        const info = await client.get(this.lifecycleIdentifier);
+        this._setLifecycleIdentifier(info.sandboxId);
+        this._setName(info.name ?? null);
+        return info;
+      }
       /**
        * Fetch the current sandbox status from the server.
        *
@@ -3390,6 +3437,7 @@ var init_sandbox = __esm({
           "/api/v1/processes/run",
           { json: body }
         );
+        const traceId = sseStream.traceId;
         const stdoutLines = [];
         const stderrLines = [];
         let exitCode = -1;
@@ -3408,11 +3456,10 @@ var init_sandbox = __esm({
             }
           }
         }
-        return {
-          exitCode,
-          stdout: stdoutLines.join("\n"),
-          stderr: stderrLines.join("\n")
-        };
+        return Object.assign(
+          { exitCode, stdout: stdoutLines.join("\n"), stderr: stderrLines.join("\n") },
+          { traceId }
+        );
       }
       // --- Process management ---
       /**
@@ -3442,7 +3489,7 @@ var init_sandbox = __esm({
           "/api/v1/processes",
           { body: payload }
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       /** List all processes (running and exited) tracked by the sandbox daemon. */
       async listProcesses() {
@@ -3459,7 +3506,7 @@ var init_sandbox = __esm({
           "GET",
           `/api/v1/processes/${pid}`
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       /** Send SIGKILL to a process. */
       async killProcess(pid) {
@@ -3472,7 +3519,7 @@ var init_sandbox = __esm({
           `/api/v1/processes/${pid}/signal`,
           { body: { signal } }
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       // --- Process I/O ---
       /** Write bytes to a process's stdin. The process must have been started with `stdinMode: StdinMode.PIPE`. */
@@ -3492,7 +3539,7 @@ var init_sandbox = __esm({
           "GET",
           `/api/v1/processes/${pid}/stdout`
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       /** Return all captured stderr lines produced so far by a process. */
       async getStderr(pid) {
@@ -3500,7 +3547,7 @@ var init_sandbox = __esm({
           "GET",
           `/api/v1/processes/${pid}/stderr`
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       /** Return all captured stdout+stderr lines produced so far by a process. */
       async getOutput(pid) {
@@ -3508,7 +3555,7 @@ var init_sandbox = __esm({
           "GET",
           `/api/v1/processes/${pid}/output`
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       // --- Streaming (SSE) ---
       /** Stream stdout events from a process until it exits. Yields one `OutputEvent` per line. */
@@ -3582,7 +3629,7 @@ var init_sandbox = __esm({
           "GET",
           `/api/v1/files/list?path=${encodeURIComponent(path2)}`
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       // --- PTY ---
       /** Create an interactive PTY session. Returns a `sessionId` and `token` for WebSocket connection via `connectPty()`. */
@@ -3600,7 +3647,7 @@ var init_sandbox = __esm({
           "/api/v1/pty",
           { body: payload }
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       /** Create a PTY session and connect to it immediately. Cleans up the session if the WebSocket connection fails. */
       async createPty(options) {
@@ -3719,15 +3766,15 @@ var init_sandbox = __esm({
           "GET",
           "/api/v1/health"
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
       /** Get sandbox daemon info (version, uptime, process counts). */
-      async info() {
+      async daemonInfo() {
         const raw = await this.http.requestJson(
           "GET",
           "/api/v1/info"
         );
-        return fromSnakeKeys(raw);
+        return Object.assign(fromSnakeKeys(raw), { traceId: raw.traceId });
       }
     };
   }
@@ -3820,7 +3867,7 @@ var init_client = __esm({
         this.namespace = options?.namespace ?? NAMESPACE;
         this.local = isLocalhost(this.apiUrl);
         this.http = new HttpClient({
-          baseUrl: this.apiUrl,
+          baseUrl: resolveSandboxLifecycleUrl(this.apiUrl),
           apiKey: this.apiKey,
           organizationId: this.organizationId,
           projectId: this.projectId,
@@ -3888,7 +3935,7 @@ var init_client = __esm({
           "GET",
           this.path(`sandboxes/${sandboxId}`)
         );
-        return fromSnakeKeys(raw, "sandboxId");
+        return Object.assign(fromSnakeKeys(raw, "sandboxId"), { traceId: raw.traceId });
       }
       /** List all sandboxes in the namespace. */
       async list() {
@@ -3919,7 +3966,7 @@ var init_client = __esm({
           this.path(`sandboxes/${sandboxId}`),
           { body }
         );
-        return fromSnakeKeys(raw, "sandboxId");
+        return Object.assign(fromSnakeKeys(raw, "sandboxId"), { traceId: raw.traceId });
       }
       /** Get the current proxy port settings for a sandbox. */
       async getPortAccess(sandboxId) {
@@ -4061,7 +4108,7 @@ var init_client = __esm({
           "GET",
           this.path(`snapshots/${snapshotId}`)
         );
-        return fromSnakeKeys(raw, "snapshotId");
+        return Object.assign(fromSnakeKeys(raw, "snapshotId"), { traceId: raw.traceId });
       }
       /** List all snapshots in the namespace. */
       async listSnapshots() {