langsmith 0.7.12 → 0.7.13

package/dist/_openapi_client/resources/sandboxes/snapshots.d.ts

@@ -0,0 +1,62 @@
+import { APIResource } from '../../core/resource.js';
+import * as SandboxesAPI from './sandboxes.js';
+import { APIPromise } from '../../core/api-promise.js';
+import { RequestOptions } from '../../internal/request-options.js';
+export declare class Snapshots extends APIResource {
+    /**
+     * Create a snapshot from a Docker image (async build).
+     */
+    create(body: SnapshotCreateParams, options?: RequestOptions): APIPromise<SandboxesAPI.SnapshotResponse>;
+    /**
+     * Get a sandbox snapshot by ID.
+     */
+    retrieve(snapshotID: string, options?: RequestOptions): APIPromise<SandboxesAPI.SnapshotResponse>;
+    /**
+     * List sandbox snapshots for the authenticated tenant, with optional filtering,
+     * sorting, and pagination.
+     */
+    list(query?: SnapshotListParams | null | undefined, options?: RequestOptions): APIPromise<SandboxesAPI.SnapshotListResponse>;
+    /**
+     * Delete a snapshot by ID. The underlying storage is reclaimed asynchronously.
+     */
+    delete(snapshotID: string, options?: RequestOptions): APIPromise<void>;
+}
+export interface SnapshotCreateParams {
+    docker_image: string;
+    fs_capacity_bytes: number;
+    name: string;
+    registry_id?: string;
+}
+export interface SnapshotListParams {
+    /**
+     * Filter by creator identity. Only 'me' is supported.
+     */
+    created_by?: string;
+    /**
+     * Maximum number of results
+     */
+    limit?: number;
+    /**
+     * Filter by name substring
+     */
+    name_contains?: string;
+    /**
+     * Pagination offset
+     */
+    offset?: number;
+    /**
+     * Sort column (name, status, created_at)
+     */
+    sort_by?: string;
+    /**
+     * Sort direction (asc, desc)
+     */
+    sort_direction?: string;
+    /**
+     * Filter by status (building, ready, failed, deleting)
+     */
+    status?: string;
+}
+export declare namespace Snapshots {
+    export { type SnapshotCreateParams as SnapshotCreateParams, type SnapshotListParams as SnapshotListParams };
+}

package/dist/_openapi_client/resources/sandboxes/snapshots.js

@@ -0,0 +1,35 @@
+// @ts-nocheck
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from '../../core/resource.js';
+import { buildHeaders } from '../../internal/headers.js';
+import { path } from '../../internal/utils/path.js';
+export class Snapshots extends APIResource {
+    /**
+     * Create a snapshot from a Docker image (async build).
+     */
+    create(body, options) {
+        return this._client.post('/v2/sandboxes/snapshots', { body, ...options });
+    }
+    /**
+     * Get a sandbox snapshot by ID.
+     */
+    retrieve(snapshotID, options) {
+        return this._client.get(path `/v2/sandboxes/snapshots/${snapshotID}`, options);
+    }
+    /**
+     * List sandbox snapshots for the authenticated tenant, with optional filtering,
+     * sorting, and pagination.
+     */
+    list(query = {}, options) {
+        return this._client.get('/v2/sandboxes/snapshots', { query, ...options });
+    }
+    /**
+     * Delete a snapshot by ID. The underlying storage is reclaimed asynchronously.
+     */
+    delete(snapshotID, options) {
+        return this._client.delete(path `/v2/sandboxes/snapshots/${snapshotID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}

package/dist/client.cjs

@@ -971,6 +971,10 @@ class Client {
     get runs() {
         return this.openAPIClient.runs;
     }
+    /** Access the v2 sandboxes resource (registries, snapshots, boxes). */
+    get sandboxes() {
+        return this.openAPIClient.sandboxes;
+    }
     async processInputs(inputs) {
         if (this.hideInputs === false) {
             return inputs;

package/dist/client.d.ts

@@ -5,6 +5,7 @@ import { type TracingMode } from "./utils/env.js";
 import { EvaluationResult, EvaluationResults } from "./evaluation/evaluator.js";
 import { OnlineEvaluators } from "./_openapi_client/resources/online-evaluators.js";
 import { Runs as OpenAPIRuns } from "./_openapi_client/resources/runs.js";
+import { Sandboxes } from "./_openapi_client/resources/sandboxes/sandboxes.js";
 import { PromptCache } from "./utils/prompt_cache/index.js";
 import { ProfileAuth } from "./utils/profiles.js";
 export interface ClientConfig {
@@ -504,6 +505,8 @@ export declare class Client implements LangSmithTracingClientInterface {
     private _getPlatformEndpointPath;
     get onlineEvaluators(): OnlineEvaluators;
     get runs(): OpenAPIRuns;
+    /** Access the v2 sandboxes resource (registries, snapshots, boxes). */
+    get sandboxes(): Sandboxes;
     private processInputs;
     private processOutputs;
     private processMetadata;

package/dist/client.js

@@ -932,6 +932,10 @@ export class Client {
     get runs() {
         return this.openAPIClient.runs;
     }
+    /** Access the v2 sandboxes resource (registries, snapshots, boxes). */
+    get sandboxes() {
+        return this.openAPIClient.sandboxes;
+    }
     async processInputs(inputs) {
         if (this.hideInputs === false) {
             return inputs;

package/dist/index.cjs

@@ -20,6 +20,6 @@ Object.defineProperty(exports, "PromptCache", { enumerable: true, get: function
 Object.defineProperty(exports, "configureGlobalPromptCache", { enumerable: true, get: function () { return index_js_1.configureGlobalPromptCache; } });
 Object.defineProperty(exports, "promptCacheSingleton", { enumerable: true, get: function () { return index_js_1.promptCacheSingleton; } });
 // Update using pnpm bump-version
-exports.__version__ = "0.7.12";
+exports.__version__ = "0.7.13";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 exports.LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/index.d.ts

@@ -6,5 +6,5 @@ export { getDefaultProjectName } from "./utils/project.js";
 export { uuid7, uuid7FromTime } from "./uuid.js";
 export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, type CacheConfig, type CacheMetrics, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
-export declare const __version__ = "0.7.12";
+export declare const __version__ = "0.7.13";
 export declare const LS_MESSAGE_VIEW_EXCLUDE: "ls_message_view_exclude";

package/dist/index.js

@@ -6,6 +6,6 @@ export { uuid7, uuid7FromTime } from "./uuid.js";
 export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 // Update using pnpm bump-version
-export const __version__ = "0.7.12";
+export const __version__ = "0.7.13";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 export const LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/sandbox/client.cjs

@@ -7,11 +7,12 @@ exports.SandboxClient = void 0;
 const env_js_1 = require("../utils/env.cjs");
 const fetch_js_1 = require("../singletons/fetch.cjs");
 const async_caller_js_1 = require("../utils/async_caller.cjs");
+const index_js_1 = require("../_openapi_client/index.cjs");
 const sandbox_js_1 = require("./sandbox.cjs");
 const errors_js_1 = require("./errors.cjs");
 const helpers_js_1 = require("./helpers.cjs");
 const mounts_js_1 = require("./mounts.cjs");
-const index_js_1 = require("../utils/uuid/src/index.cjs");
+const index_js_2 = require("../utils/uuid/src/index.cjs");
 /**
  * Sleep that can be interrupted by an AbortSignal.
  * Resolves after `ms` milliseconds or rejects immediately if the signal fires.
@@ -296,6 +297,12 @@ class SandboxClient {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "_registriesClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this._baseUrl = (config.apiEndpoint ?? getDefaultApiEndpoint()).replace(/\/$/, "");
         this._apiKey = config.apiKey ?? getDefaultApiKey();
         this._defaultHeaders = { ...(config.headers ?? {}) };
@@ -305,6 +312,51 @@ class SandboxClient {
             maxConcurrency: config.maxConcurrency ?? Infinity,
         });
     }
+    _apiRoot() {
+        const suffix = "/v2/sandboxes";
+        return this._baseUrl.endsWith(suffix)
+            ? this._baseUrl.slice(0, -suffix.length)
+            : this._baseUrl;
+    }
+    /**
+     * Manage sandbox image registries: create, list, retrieve, update, delete.
+     *
+     * A registry stores credentials for pulling private images. Create one, then
+     * pass its `id` as `registryId` when building a snapshot.
+     *
+     * @example
+     * ```typescript
+     * const registry = await client.registries.create({
+     *   name: "internal",
+     *   url: "registry.example.com",
+     *   username: "robot",
+     *   password: process.env.REGISTRY_PASSWORD,
+     * });
+     * const snapshot = await client.createSnapshot(
+     *   "internal-python",
+     *   "registry.example.com/internal/python:3.12",
+     *   2_147_483_648,
+     *   { registryId: registry.id },
+     * );
+     * ```
+     */
+    get registries() {
+        if (!this._registriesClient) {
+            const defaultHeaders = {
+                ...this._defaultHeaders,
+            };
+            if (this._apiKey === undefined) {
+                defaultHeaders["X-API-Key"] = null;
+            }
+            this._registriesClient = new index_js_1.Langsmith({
+                apiKey: this._apiKey,
+                baseURL: this._apiRoot(),
+                defaultHeaders,
+                fetch: this._fetchImpl,
+            });
+        }
+        return this._registriesClient.sandboxes.registries;
+    }
     /**
      * Internal fetch method that adds authentication headers.
      *
@@ -619,11 +671,11 @@ class SandboxClient {
      * @param name - Snapshot name.
      * @param dockerImage - Docker image to build from (e.g., "python:3.12-slim").
      * @param fsCapacityBytes - Filesystem capacity in bytes.
-     * @param options - Additional options (registry credentials, timeout).
+     * @param options - Additional options (registry ID, timeout).
      * @returns Snapshot in "ready" status.
      */
     async createSnapshot(name, dockerImage, fsCapacityBytes, options = {}) {
-        const { registryId, registryUrl, registryUsername, registryPassword, timeout = 60, signal, } = options;
+        const { registryId, timeout = 60, signal } = options;
         const url = `${this._baseUrl}/snapshots`;
         const payload = {
             name,
@@ -633,15 +685,6 @@ class SandboxClient {
         if (registryId !== undefined) {
             payload.registry_id = registryId;
         }
-        if (registryUrl !== undefined) {
-            payload.registry_url = registryUrl;
-        }
-        if (registryUsername !== undefined) {
-            payload.registry_username = registryUsername;
-        }
-        if (registryPassword !== undefined) {
-            payload.registry_password = registryPassword;
-        }
         const response = await this._postJson(url, payload, { signal });
         const snapshot = (await response.json());
         return this.waitForSnapshot(snapshot.id, { timeout, signal });
@@ -663,18 +706,18 @@ class SandboxClient {
     async createSnapshotFromDockerfile(name, dockerfile, fsCapacityBytes, options = {}) {
         const { context = ".", buildArgs, target, onBuildLog, vCpus, memBytes, timeout = 60, } = options;
         const { contextPath, dockerfileRel } = await resolveDockerfileContext(dockerfile, context);
-        const builderName = `snapshot-builder-${(0, index_js_1.v4)().replace(/-/g, "").slice(0, 12)}`;
+        const builderName = `snapshot-builder-${(0, index_js_2.v4)().replace(/-/g, "").slice(0, 12)}`;
         // Stage the build on the capacity-backed root filesystem, not /tmp.
         // Inside the sandbox /tmp is a RAM-backed tmpfs that fsCapacityBytes does
         // not size, and BuildKit's native snapshotter writes a full copy of every
         // layer under its root, so a /tmp build exhausts guest RAM and fails with
         // "No space left on device".
-        const buildRoot = `/var/lib/langsmith-build/${(0, index_js_1.v4)()
+        const buildRoot = `/var/lib/langsmith-build/${(0, index_js_2.v4)()
             .replace(/-/g, "")
             .slice(0, 12)}`;
         const remoteContext = `${buildRoot}/context`;
         const remoteTar = `${buildRoot}/context.tar`;
-        const imageRef = `langsmith-snapshot-build:${(0, index_js_1.v4)().replace(/-/g, "")}`;
+        const imageRef = `langsmith-snapshot-build:${(0, index_js_2.v4)().replace(/-/g, "")}`;
         const buildkitRoot = `${buildRoot}/buildkit-root`;
         const buildkitRun = `${buildRoot}/buildkit-run`;
         const builder = await this.createSandbox({

package/dist/sandbox/client.d.ts

@@ -1,6 +1,7 @@
 /**
  * Main SandboxClient class for interacting with the sandbox server API.
  */
+import { Registries } from "../_openapi_client/resources/sandboxes/registries.js";
 import type { CaptureSnapshotOptions, CreateDockerfileSnapshotOptions, CreateSandboxOptions, CreateSnapshotOptions, ListSnapshotsOptions, ResourceStatus, SandboxClientConfig, Snapshot, StartSandboxOptions, UpdateSandboxOptions, WaitForSandboxOptions, WaitForSnapshotOptions } from "./types.js";
 import { Sandbox } from "./sandbox.js";
 /**
@@ -37,7 +38,32 @@ export declare class SandboxClient {
     private _defaultHeaders;
     private _fetchImpl;
     private _caller;
+    private _registriesClient?;
     constructor(config?: SandboxClientConfig);
+    private _apiRoot;
+    /**
+     * Manage sandbox image registries: create, list, retrieve, update, delete.
+     *
+     * A registry stores credentials for pulling private images. Create one, then
+     * pass its `id` as `registryId` when building a snapshot.
+     *
+     * @example
+     * ```typescript
+     * const registry = await client.registries.create({
+     *   name: "internal",
+     *   url: "registry.example.com",
+     *   username: "robot",
+     *   password: process.env.REGISTRY_PASSWORD,
+     * });
+     * const snapshot = await client.createSnapshot(
+     *   "internal-python",
+     *   "registry.example.com/internal/python:3.12",
+     *   2_147_483_648,
+     *   { registryId: registry.id },
+     * );
+     * ```
+     */
+    get registries(): Registries;
     /**
      * Create a new Sandbox.
      *
@@ -169,7 +195,7 @@ export declare class SandboxClient {
      * @param name - Snapshot name.
      * @param dockerImage - Docker image to build from (e.g., "python:3.12-slim").
      * @param fsCapacityBytes - Filesystem capacity in bytes.
-     * @param options - Additional options (registry credentials, timeout).
+     * @param options - Additional options (registry ID, timeout).
      * @returns Snapshot in "ready" status.
      */
     createSnapshot(name: string, dockerImage: string, fsCapacityBytes: number, options?: CreateSnapshotOptions): Promise<Snapshot>;

package/dist/sandbox/client.js

@@ -4,6 +4,7 @@
 import { getLangSmithEnvironmentVariable } from "../utils/env.js";
 import { _getFetchImplementation } from "../singletons/fetch.js";
 import { AsyncCaller } from "../utils/async_caller.js";
+import { Langsmith as OpenAPILangsmith } from "../_openapi_client/index.js";
 import { Sandbox } from "./sandbox.js";
 import { LangSmithResourceCreationError, LangSmithResourceNameConflictError, LangSmithResourceNotFoundError, LangSmithResourceTimeoutError, LangSmithSandboxAPIError, LangSmithValidationError, } from "./errors.js";
 import { handleClientHttpError, handleSandboxCreationError, validateTtl, } from "./helpers.js";
@@ -293,6 +294,12 @@ export class SandboxClient {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "_registriesClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this._baseUrl = (config.apiEndpoint ?? getDefaultApiEndpoint()).replace(/\/$/, "");
         this._apiKey = config.apiKey ?? getDefaultApiKey();
         this._defaultHeaders = { ...(config.headers ?? {}) };
@@ -302,6 +309,51 @@ export class SandboxClient {
             maxConcurrency: config.maxConcurrency ?? Infinity,
         });
     }
+    _apiRoot() {
+        const suffix = "/v2/sandboxes";
+        return this._baseUrl.endsWith(suffix)
+            ? this._baseUrl.slice(0, -suffix.length)
+            : this._baseUrl;
+    }
+    /**
+     * Manage sandbox image registries: create, list, retrieve, update, delete.
+     *
+     * A registry stores credentials for pulling private images. Create one, then
+     * pass its `id` as `registryId` when building a snapshot.
+     *
+     * @example
+     * ```typescript
+     * const registry = await client.registries.create({
+     *   name: "internal",
+     *   url: "registry.example.com",
+     *   username: "robot",
+     *   password: process.env.REGISTRY_PASSWORD,
+     * });
+     * const snapshot = await client.createSnapshot(
+     *   "internal-python",
+     *   "registry.example.com/internal/python:3.12",
+     *   2_147_483_648,
+     *   { registryId: registry.id },
+     * );
+     * ```
+     */
+    get registries() {
+        if (!this._registriesClient) {
+            const defaultHeaders = {
+                ...this._defaultHeaders,
+            };
+            if (this._apiKey === undefined) {
+                defaultHeaders["X-API-Key"] = null;
+            }
+            this._registriesClient = new OpenAPILangsmith({
+                apiKey: this._apiKey,
+                baseURL: this._apiRoot(),
+                defaultHeaders,
+                fetch: this._fetchImpl,
+            });
+        }
+        return this._registriesClient.sandboxes.registries;
+    }
     /**
      * Internal fetch method that adds authentication headers.
      *
@@ -616,11 +668,11 @@ export class SandboxClient {
      * @param name - Snapshot name.
      * @param dockerImage - Docker image to build from (e.g., "python:3.12-slim").
      * @param fsCapacityBytes - Filesystem capacity in bytes.
-     * @param options - Additional options (registry credentials, timeout).
+     * @param options - Additional options (registry ID, timeout).
      * @returns Snapshot in "ready" status.
      */
     async createSnapshot(name, dockerImage, fsCapacityBytes, options = {}) {
-        const { registryId, registryUrl, registryUsername, registryPassword, timeout = 60, signal, } = options;
+        const { registryId, timeout = 60, signal } = options;
         const url = `${this._baseUrl}/snapshots`;
         const payload = {
             name,
@@ -630,15 +682,6 @@ export class SandboxClient {
         if (registryId !== undefined) {
             payload.registry_id = registryId;
         }
-        if (registryUrl !== undefined) {
-            payload.registry_url = registryUrl;
-        }
-        if (registryUsername !== undefined) {
-            payload.registry_username = registryUsername;
-        }
-        if (registryPassword !== undefined) {
-            payload.registry_password = registryPassword;
-        }
         const response = await this._postJson(url, payload, { signal });
         const snapshot = (await response.json());
         return this.waitForSnapshot(snapshot.id, { timeout, signal });

package/dist/sandbox/sandbox.cjs

@@ -162,15 +162,16 @@ class Sandbox {
         this._client = client;
     }
     /**
-     * Validate and return the dataplane URL.
-     * @throws LangSmithSandboxNotReadyError if sandbox status is not "ready".
+     * Return the dataplane URL.
+     *
+     * The client does not gate on lifecycle status: a stopped sandbox is resumed
+     * by the platform when the dataplane request arrives, so only the presence of
+     * a URL is required here. A genuinely not-ready box surfaces the server's
+     * LangSmithSandboxNotReadyError from the request itself.
+     *
      * @throws LangSmithDataplaneNotConfiguredError if dataplane_url is not configured.
      */
     requireDataplaneUrl() {
-        if (this.status && this.status !== "ready") {
-            throw new errors_js_1.LangSmithSandboxNotReadyError(`Sandbox '${this.name}' is not ready (status: ${this.status}). ` +
-                "Use waitForSandbox() to wait for the sandbox to become ready.");
-        }
         if (!this.dataplane_url) {
             throw new errors_js_1.LangSmithDataplaneNotConfiguredError(`Sandbox '${this.name}' does not have a dataplane_url configured. ` +
                 "Runtime operations require a dataplane URL.");

package/dist/sandbox/sandbox.d.ts

@@ -64,8 +64,13 @@ export declare class Sandbox {
     readonly fs_capacity_bytes?: number;
     private _client;
     /**
-     * Validate and return the dataplane URL.
-     * @throws LangSmithSandboxNotReadyError if sandbox status is not "ready".
+     * Return the dataplane URL.
+     *
+     * The client does not gate on lifecycle status: a stopped sandbox is resumed
+     * by the platform when the dataplane request arrives, so only the presence of
+     * a URL is required here. A genuinely not-ready box surfaces the server's
+     * LangSmithSandboxNotReadyError from the request itself.
+     *
      * @throws LangSmithDataplaneNotConfiguredError if dataplane_url is not configured.
      */
     private requireDataplaneUrl;

package/dist/sandbox/sandbox.js

@@ -1,7 +1,7 @@
 /**
  * Sandbox class for interacting with a specific sandbox instance.
  */
-import { LangSmithDataplaneNotConfiguredError, LangSmithSandboxNotReadyError, } from "./errors.js";
+import { LangSmithDataplaneNotConfiguredError } from "./errors.js";
 import { handleSandboxHttpError } from "./helpers.js";
 import { CommandHandle } from "./command_handle.js";
 import { reconnectWsStream, runWsStream } from "./ws_execute.js";
@@ -159,15 +159,16 @@ export class Sandbox {
         this._client = client;
     }
     /**
-     * Validate and return the dataplane URL.
-     * @throws LangSmithSandboxNotReadyError if sandbox status is not "ready".
+     * Return the dataplane URL.
+     *
+     * The client does not gate on lifecycle status: a stopped sandbox is resumed
+     * by the platform when the dataplane request arrives, so only the presence of
+     * a URL is required here. A genuinely not-ready box surfaces the server's
+     * LangSmithSandboxNotReadyError from the request itself.
+     *
      * @throws LangSmithDataplaneNotConfiguredError if dataplane_url is not configured.
      */
     requireDataplaneUrl() {
-        if (this.status && this.status !== "ready") {
-            throw new LangSmithSandboxNotReadyError(`Sandbox '${this.name}' is not ready (status: ${this.status}). ` +
-                "Use waitForSandbox() to wait for the sandbox to become ready.");
-        }
         if (!this.dataplane_url) {
             throw new LangSmithDataplaneNotConfiguredError(`Sandbox '${this.name}' does not have a dataplane_url configured. ` +
                 "Runtime operations require a dataplane URL.");

package/dist/sandbox/types.d.ts

@@ -477,14 +477,8 @@ export interface CreateSandboxOptions {
  * Options for creating a snapshot from a Docker image.
  */
 export interface CreateSnapshotOptions {
-    /** Private registry ID (alternative to URL/credentials). */
+    /** Private registry ID. */
     registryId?: string;
-    /** Registry URL for private images. */
-    registryUrl?: string;
-    /** Registry username. */
-    registryUsername?: string;
-    /** Registry password. */
-    registryPassword?: string;
     /** Timeout in seconds when waiting for ready. Default: 60. */
     timeout?: number;
     /** AbortSignal for cancellation. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.7.12",
+  "version": "0.7.13",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "pnpm@10.33.0",
   "files": [