langsmith 0.5.20 → 0.5.22

package/dist/experimental/sandbox/types.d.ts

@@ -11,59 +11,6 @@ export interface ExecutionResult {
     stderr: string;
     exit_code: number;
 }
-/**
- * Resource specification for a sandbox.
- */
-export interface ResourceSpec {
-    cpu?: string;
-    memory?: string;
-    storage?: string;
-}
-/**
- * Specification for mounting a volume in a sandbox template.
- */
-export interface VolumeMountSpec {
-    volume_name: string;
-    mount_path: string;
-}
-/**
- * Represents a persistent volume.
- */
-export interface Volume {
-    id?: string;
-    name: string;
-    size: string;
-    storage_class: string;
-    created_at?: string;
-    updated_at?: string;
-}
-/**
- * Represents a SandboxTemplate.
- *
- * Templates define the image, resource limits, and volume mounts for sandboxes.
- */
-export interface SandboxTemplate {
-    id?: string;
-    name: string;
-    image: string;
-    resources: ResourceSpec;
-    volume_mounts?: VolumeMountSpec[];
-    created_at?: string;
-    updated_at?: string;
-}
-/**
- * Represents a Sandbox Pool for pre-provisioned sandboxes.
- *
- * Pools pre-provision sandboxes from a template for faster startup.
- */
-export interface Pool {
-    id?: string;
-    name: string;
-    template_name: string;
-    replicas: number;
-    created_at?: string;
-    updated_at?: string;
-}
 /**
  * Lightweight provisioning status for any async-created resource.
  */
@@ -101,7 +48,6 @@ export interface Snapshot {
 export interface SandboxData {
     id?: string;
     name: string;
-    template_name?: string;
     dataplane_url?: string;
     status?: string;
     status_message?: string;
@@ -265,15 +211,43 @@ export interface RunOptions {
      */
     pty?: boolean;
 }
+/**
+ * Network access-control rules for a sandbox's proxy sidecar.
+ *
+ * Supported pattern types: exact domains, globs (e.g. `*.example.com`),
+ * IPs, CIDR ranges (e.g. `10.0.0.0/8`), and regex (`~pattern`).
+ *
+ * Only one of `allow_list` and `deny_list` may be populated.
+ */
+export interface SandboxAccessControl {
+    /** Hosts the sandbox is allowed to reach. */
+    allow_list?: string[];
+    /** Hosts the sandbox is blocked from reaching. */
+    deny_list?: string[];
+}
+/**
+ * Full proxy configuration forwarded to the sandbox server as-is (snake_case
+ * so it's wire-compatible with the backend). Mirrors the server's
+ * `ProxyConfig` type.
+ */
+export interface SandboxProxyConfig {
+    /** Header-injection rules keyed by host pattern. */
+    rules?: unknown[];
+    /** Hosts that bypass the proxy entirely. */
+    no_proxy?: string[];
+    /** Allow/deny list enforced at the proxy sidecar. */
+    access_control?: SandboxAccessControl;
+}
 /**
  * Options for creating a sandbox.
  */
 export interface CreateSandboxOptions {
     /**
-     * Snapshot ID to boot from.
-     * Mutually exclusive with the `templateName` positional arg.
+     * Snapshot name to boot from. Mutually exclusive with the positional
+     * `snapshotId` argument on `createSandbox`; exactly one must be provided.
+     * Resolved server-side to a snapshot owned by the caller's tenant.
      */
-    snapshotId?: string;
+    snapshotName?: string;
     /**
      * Optional sandbox name (auto-generated if not provided).
      */
@@ -305,6 +279,13 @@ export interface CreateSandboxOptions {
     memBytes?: number;
     /** Root filesystem capacity in bytes. */
     fsCapacityBytes?: number;
+    /**
+     * Per-sandbox proxy configuration. Use
+     * `{ access_control: { allow_list: ["github.com", "*.example.com"] } }`
+     * to restrict outbound HTTPS to a set of host patterns. Forwarded to the
+     * server as-is on the wire.
+     */
+    proxyConfig?: SandboxProxyConfig;
 }
 /**
  * Options for creating a snapshot from a Docker image.
@@ -327,13 +308,39 @@ export interface CreateSnapshotOptions {
  * Options for capturing a snapshot from a running sandbox.
  */
 export interface CaptureSnapshotOptions {
-    /** Checkpoint timestamp to use. If omitted, creates a fresh checkpoint. */
-    checkpoint?: string;
     /** Timeout in seconds when waiting for ready. Default: 60. */
     timeout?: number;
     /** AbortSignal for cancellation. */
     signal?: AbortSignal;
 }
+/**
+ * Options for listing snapshots. All fields are optional and independent.
+ *
+ * The backend always paginates: when `limit` is omitted the server applies
+ * a default page size (currently 50), so a single call will not necessarily
+ * return every snapshot visible to the caller's tenant.
+ */
+export interface ListSnapshotsOptions {
+    /**
+     * Case-insensitive substring filter applied server-side to snapshot
+     * names.
+     */
+    nameContains?: string;
+    /**
+     * Maximum number of snapshots to return for a single request. Must be
+     * between 1 and 500 (inclusive); the server rejects values outside that
+     * range. Defaults to 50 server-side when omitted.
+     */
+    limit?: number;
+    /**
+     * Number of snapshots to skip before returning results. Must be `>= 0`.
+     * Useful for paginating through large result sets in combination with
+     * `limit`.
+     */
+    offset?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
 /**
  * Options for waiting for a snapshot to become ready.
  */
@@ -387,93 +394,3 @@ export interface WaitForSandboxOptions {
     /** AbortSignal for cancellation. */
     signal?: AbortSignal;
 }
-/**
- * Options for creating a volume.
- */
-export interface CreateVolumeOptions {
-    /**
-     * Storage size (e.g., "1Gi", "10Gi").
-     */
-    size: string;
-    /**
-     * Timeout in seconds when waiting for volume to be ready. Default: 60.
-     */
-    timeout?: number;
-}
-/**
- * Options for creating a template.
- */
-export interface CreateTemplateOptions {
-    /**
-     * Container image (e.g., "python:3.12-slim", "node:20-slim").
-     */
-    image: string;
-    /**
-     * CPU limit (e.g., "500m", "1", "2"). Default: "500m".
-     */
-    cpu?: string;
-    /**
-     * Memory limit (e.g., "256Mi", "1Gi"). Default: "512Mi".
-     */
-    memory?: string;
-    /**
-     * Ephemeral storage limit (e.g., "1Gi"). Optional.
-     */
-    storage?: string;
-    /**
-     * List of volumes to mount in the sandbox. Optional.
-     */
-    volumeMounts?: VolumeMountSpec[];
-}
-/**
- * Options for updating a template.
- */
-export interface UpdateTemplateOptions {
-    /**
-     * New display name (optional).
-     */
-    newName?: string;
-}
-/**
- * Options for creating a pool.
- */
-export interface CreatePoolOptions {
-    /**
-     * Name of the template to use for sandboxes in this pool.
-     */
-    templateName: string;
-    /**
-     * Number of pre-warmed sandboxes to maintain (0-100).
-     */
-    replicas: number;
-    /**
-     * Timeout in seconds when waiting for pool to be ready. Default: 30.
-     */
-    timeout?: number;
-}
-/**
- * Options for updating a volume.
- */
-export interface UpdateVolumeOptions {
-    /**
-     * New display name (optional).
-     */
-    newName?: string;
-    /**
-     * New storage size (must be >= current size). Optional.
-     */
-    size?: string;
-}
-/**
- * Options for updating a pool.
- */
-export interface UpdatePoolOptions {
-    /**
-     * New display name (optional).
-     */
-    newName?: string;
-    /**
-     * New number of replicas (0-100). Set to 0 to pause.
-     */
-    replicas?: number;
-}

package/dist/index.cjs

@@ -18,4 +18,4 @@ 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.5.20";
+exports.__version__ = "0.5.22";

package/dist/index.d.ts

@@ -5,4 +5,4 @@ export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 export { uuid7, uuid7FromTime } from "./uuid.js";
 export { Cache, PromptCache, type CacheConfig, type CacheMetrics, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
-export declare const __version__ = "0.5.20";
+export declare const __version__ = "0.5.22";

package/dist/index.js

@@ -5,4 +5,4 @@ export { getDefaultProjectName } from "./utils/project.js";
 export { uuid7, uuid7FromTime } from "./uuid.js";
 export { Cache, PromptCache, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 // Update using pnpm bump-version
-export const __version__ = "0.5.20";
+export const __version__ = "0.5.22";