langsmith 0.5.14 → 0.5.15

package/dist/experimental/sandbox/client.cjs

@@ -524,6 +524,7 @@ class SandboxClient {
      * @returns Created Sandbox.
      * @throws ResourceTimeoutError if timeout waiting for sandbox to be ready.
      * @throws SandboxCreationError if sandbox creation fails.
+     * @throws LangSmithValidationError if TTL values are invalid.
      *
      * @example
      * ```typescript
@@ -537,7 +538,9 @@ class SandboxClient {
      * ```
      */
     async createSandbox(templateName, options = {}) {
-        const { name, timeout = 30, waitForReady = true } = options;
+        const { name, timeout = 30, waitForReady = true, ttlSeconds, idleTtlSeconds, } = options;
+        (0, helpers_js_1.validateTtl)(ttlSeconds, "ttlSeconds");
+        (0, helpers_js_1.validateTtl)(idleTtlSeconds, "idleTtlSeconds");
         const url = `${this._baseUrl}/boxes`;
         const payload = {
             template_name: templateName,
@@ -549,6 +552,12 @@ class SandboxClient {
         if (name) {
             payload.name = name;
         }
+        if (ttlSeconds !== undefined) {
+            payload.ttl_seconds = ttlSeconds;
+        }
+        if (idleTtlSeconds !== undefined) {
+            payload.idle_ttl_seconds = idleTtlSeconds;
+        }
         const httpTimeout = waitForReady ? (timeout + 30) * 1000 : 30 * 1000;
         const response = await this._fetch(url, {
             method: "POST",
@@ -600,18 +609,29 @@ class SandboxClient {
         const data = await response.json();
         return (data.sandboxes ?? []).map((s) => new sandbox_js_1.Sandbox(s, this));
     }
-    /**
-     * Update a sandbox's display name.
-     *
-     * @param name - Current sandbox name.
-     * @param newName - New display name.
-     * @returns Updated Sandbox.
-     * @throws LangSmithResourceNotFoundError if sandbox not found.
-     * @throws LangSmithResourceNameConflictError if newName is already in use.
-     */
-    async updateSandbox(name, newName) {
+    async updateSandbox(name, newNameOrOptions) {
+        const options = typeof newNameOrOptions === "string"
+            ? { newName: newNameOrOptions }
+            : newNameOrOptions;
+        const { newName, ttlSeconds, idleTtlSeconds } = options;
+        (0, helpers_js_1.validateTtl)(ttlSeconds, "ttlSeconds");
+        (0, helpers_js_1.validateTtl)(idleTtlSeconds, "idleTtlSeconds");
+        if (newName === undefined &&
+            ttlSeconds === undefined &&
+            idleTtlSeconds === undefined) {
+            return this.getSandbox(name);
+        }
         const url = `${this._baseUrl}/boxes/${encodeURIComponent(name)}`;
-        const payload = { name: newName };
+        const payload = {};
+        if (newName !== undefined) {
+            payload.name = newName;
+        }
+        if (ttlSeconds !== undefined) {
+            payload.ttl_seconds = ttlSeconds;
+        }
+        if (idleTtlSeconds !== undefined) {
+            payload.idle_ttl_seconds = idleTtlSeconds;
+        }
         const response = await this._fetch(url, {
             method: "PATCH",
             headers: { "Content-Type": "application/json" },
@@ -622,7 +642,9 @@ class SandboxClient {
                 throw new errors_js_1.LangSmithResourceNotFoundError(`Sandbox '${name}' not found`, "sandbox");
             }
             if (response.status === 409) {
-                throw new errors_js_1.LangSmithResourceNameConflictError(`Sandbox name '${newName}' already in use`, "sandbox");
+                throw new errors_js_1.LangSmithResourceNameConflictError(newName !== undefined
+                    ? `Sandbox name '${newName}' already in use`
+                    : "Sandbox update conflict (name may already be in use)", "sandbox");
             }
             await (0, helpers_js_1.handleClientHttpError)(response);
         }

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

@@ -1,7 +1,7 @@
 /**
  * Main SandboxClient class for interacting with the sandbox server API.
  */
-import type { CreatePoolOptions, CreateSandboxOptions, CreateTemplateOptions, CreateVolumeOptions, Pool, ResourceStatus, SandboxClientConfig, SandboxTemplate, UpdatePoolOptions, UpdateTemplateOptions, UpdateVolumeOptions, Volume, WaitForSandboxOptions } from "./types.js";
+import type { CreatePoolOptions, CreateSandboxOptions, CreateTemplateOptions, CreateVolumeOptions, Pool, ResourceStatus, SandboxClientConfig, SandboxTemplate, UpdatePoolOptions, UpdateSandboxOptions, UpdateTemplateOptions, UpdateVolumeOptions, Volume, WaitForSandboxOptions } from "./types.js";
 import { Sandbox } from "./sandbox.js";
 /**
  * Client for interacting with the Sandbox Server API.
@@ -191,6 +191,7 @@ export declare class SandboxClient {
      * @returns Created Sandbox.
      * @throws ResourceTimeoutError if timeout waiting for sandbox to be ready.
      * @throws SandboxCreationError if sandbox creation fails.
+     * @throws LangSmithValidationError if TTL values are invalid.
      *
      * @example
      * ```typescript
@@ -225,11 +226,19 @@ export declare class SandboxClient {
      *
      * @param name - Current sandbox name.
      * @param newName - New display name.
-     * @returns Updated Sandbox.
+     */
+    updateSandbox(name: string, newName: string): Promise<Sandbox>;
+    /**
+     * Update a sandbox's name and/or TTL settings.
+     *
+     * @param name - Current sandbox name.
+     * @param options - Fields to update. Omit a field to leave it unchanged.
+     * @returns Updated Sandbox. If no fields are provided, returns the current sandbox.
      * @throws LangSmithResourceNotFoundError if sandbox not found.
      * @throws LangSmithResourceNameConflictError if newName is already in use.
+     * @throws LangSmithValidationError if TTL values are invalid.
      */
-    updateSandbox(name: string, newName: string): Promise<Sandbox>;
+    updateSandbox(name: string, options: UpdateSandboxOptions): Promise<Sandbox>;
     /**
      * Delete a Sandbox.
      *

package/dist/experimental/sandbox/client.js

@@ -6,7 +6,7 @@ import { _getFetchImplementation } from "../../singletons/fetch.js";
 import { AsyncCaller } from "../../utils/async_caller.js";
 import { Sandbox } from "./sandbox.js";
 import { LangSmithResourceCreationError, LangSmithResourceNameConflictError, LangSmithResourceNotFoundError, LangSmithResourceTimeoutError, LangSmithSandboxAPIError, } from "./errors.js";
-import { handleClientHttpError, handleConflictError, handlePoolError, handleResourceInUseError, handleSandboxCreationError, handleVolumeCreationError, } from "./helpers.js";
+import { handleClientHttpError, handleConflictError, handlePoolError, handleResourceInUseError, handleSandboxCreationError, handleVolumeCreationError, validateTtl, } from "./helpers.js";
 /**
  * Get the default sandbox API endpoint from environment.
  *
@@ -521,6 +521,7 @@ export class SandboxClient {
      * @returns Created Sandbox.
      * @throws ResourceTimeoutError if timeout waiting for sandbox to be ready.
      * @throws SandboxCreationError if sandbox creation fails.
+     * @throws LangSmithValidationError if TTL values are invalid.
      *
      * @example
      * ```typescript
@@ -534,7 +535,9 @@ export class SandboxClient {
      * ```
      */
     async createSandbox(templateName, options = {}) {
-        const { name, timeout = 30, waitForReady = true } = options;
+        const { name, timeout = 30, waitForReady = true, ttlSeconds, idleTtlSeconds, } = options;
+        validateTtl(ttlSeconds, "ttlSeconds");
+        validateTtl(idleTtlSeconds, "idleTtlSeconds");
         const url = `${this._baseUrl}/boxes`;
         const payload = {
             template_name: templateName,
@@ -546,6 +549,12 @@ export class SandboxClient {
         if (name) {
             payload.name = name;
         }
+        if (ttlSeconds !== undefined) {
+            payload.ttl_seconds = ttlSeconds;
+        }
+        if (idleTtlSeconds !== undefined) {
+            payload.idle_ttl_seconds = idleTtlSeconds;
+        }
         const httpTimeout = waitForReady ? (timeout + 30) * 1000 : 30 * 1000;
         const response = await this._fetch(url, {
             method: "POST",
@@ -597,18 +606,29 @@ export class SandboxClient {
         const data = await response.json();
         return (data.sandboxes ?? []).map((s) => new Sandbox(s, this));
     }
-    /**
-     * Update a sandbox's display name.
-     *
-     * @param name - Current sandbox name.
-     * @param newName - New display name.
-     * @returns Updated Sandbox.
-     * @throws LangSmithResourceNotFoundError if sandbox not found.
-     * @throws LangSmithResourceNameConflictError if newName is already in use.
-     */
-    async updateSandbox(name, newName) {
+    async updateSandbox(name, newNameOrOptions) {
+        const options = typeof newNameOrOptions === "string"
+            ? { newName: newNameOrOptions }
+            : newNameOrOptions;
+        const { newName, ttlSeconds, idleTtlSeconds } = options;
+        validateTtl(ttlSeconds, "ttlSeconds");
+        validateTtl(idleTtlSeconds, "idleTtlSeconds");
+        if (newName === undefined &&
+            ttlSeconds === undefined &&
+            idleTtlSeconds === undefined) {
+            return this.getSandbox(name);
+        }
         const url = `${this._baseUrl}/boxes/${encodeURIComponent(name)}`;
-        const payload = { name: newName };
+        const payload = {};
+        if (newName !== undefined) {
+            payload.name = newName;
+        }
+        if (ttlSeconds !== undefined) {
+            payload.ttl_seconds = ttlSeconds;
+        }
+        if (idleTtlSeconds !== undefined) {
+            payload.idle_ttl_seconds = idleTtlSeconds;
+        }
         const response = await this._fetch(url, {
             method: "PATCH",
             headers: { "Content-Type": "application/json" },
@@ -619,7 +639,9 @@ export class SandboxClient {
                 throw new LangSmithResourceNotFoundError(`Sandbox '${name}' not found`, "sandbox");
             }
             if (response.status === 409) {
-                throw new LangSmithResourceNameConflictError(`Sandbox name '${newName}' already in use`, "sandbox");
+                throw new LangSmithResourceNameConflictError(newName !== undefined
+                    ? `Sandbox name '${newName}' already in use`
+                    : "Sandbox update conflict (name may already be in use)", "sandbox");
             }
             await handleClientHttpError(response);
         }

package/dist/experimental/sandbox/helpers.cjs

@@ -6,6 +6,7 @@
  * exceptions. They contain no I/O operations.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTtl = validateTtl;
 exports.parseErrorResponse = parseErrorResponse;
 exports.parseValidationError = parseValidationError;
 exports.extractQuotaType = extractQuotaType;
@@ -17,6 +18,27 @@ exports.handleSandboxHttpError = handleSandboxHttpError;
 exports.handleConflictError = handleConflictError;
 exports.handleResourceInUseError = handleResourceInUseError;
 const errors_js_1 = require("./errors.cjs");
+// =============================================================================
+// Input validation
+// =============================================================================
+/**
+ * Validate TTL values for sandbox create/update (minute resolution).
+ *
+ * @param value - TTL in seconds (`undefined` means unset; `0` disables).
+ * @param name - Parameter name for error messages.
+ * @throws LangSmithValidationError if negative or not a multiple of 60 (when non-zero).
+ */
+function validateTtl(value, name) {
+    if (value === undefined) {
+        return;
+    }
+    if (value < 0) {
+        throw new errors_js_1.LangSmithValidationError(`${name} must be >= 0, got ${value}`, name);
+    }
+    if (value !== 0 && value % 60 !== 0) {
+        throw new errors_js_1.LangSmithValidationError(`${name} must be a multiple of 60 seconds, got ${value}`, name);
+    }
+}
 /**
  * Parse standardized error response.
  *

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

@@ -4,6 +4,14 @@
  * These functions are used to parse error responses and raise appropriate
  * exceptions. They contain no I/O operations.
  */
+/**
+ * Validate TTL values for sandbox create/update (minute resolution).
+ *
+ * @param value - TTL in seconds (`undefined` means unset; `0` disables).
+ * @param name - Parameter name for error messages.
+ * @throws LangSmithValidationError if negative or not a multiple of 60 (when non-zero).
+ */
+export declare function validateTtl(value: number | undefined, name: string): void;
 interface ParsedError {
     errorType?: string;
     message: string;

package/dist/experimental/sandbox/helpers.js

@@ -5,6 +5,27 @@
  * exceptions. They contain no I/O operations.
  */
 import { LangSmithQuotaExceededError, LangSmithResourceAlreadyExistsError, LangSmithResourceInUseError, LangSmithResourceNameConflictError, LangSmithResourceNotFoundError, LangSmithResourceTimeoutError, LangSmithSandboxAPIError, LangSmithSandboxAuthenticationError, LangSmithSandboxError, LangSmithSandboxConnectionError, LangSmithSandboxCreationError, LangSmithSandboxNotReadyError, LangSmithSandboxOperationError, LangSmithValidationError, } from "./errors.js";
+// =============================================================================
+// Input validation
+// =============================================================================
+/**
+ * Validate TTL values for sandbox create/update (minute resolution).
+ *
+ * @param value - TTL in seconds (`undefined` means unset; `0` disables).
+ * @param name - Parameter name for error messages.
+ * @throws LangSmithValidationError if negative or not a multiple of 60 (when non-zero).
+ */
+export function validateTtl(value, name) {
+    if (value === undefined) {
+        return;
+    }
+    if (value < 0) {
+        throw new LangSmithValidationError(`${name} must be >= 0, got ${value}`, name);
+    }
+    if (value !== 0 && value % 60 !== 0) {
+        throw new LangSmithValidationError(`${name} must be a multiple of 60 seconds, got ${value}`, name);
+    }
+}
 /**
  * Parse standardized error response.
  *

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

@@ -25,5 +25,5 @@
 export { SandboxClient } from "./client.js";
 export { Sandbox } from "./sandbox.js";
 export { CommandHandle } from "./command_handle.js";
-export type { ExecutionResult, OutputChunk, WsMessage, WsRunOptions, ResourceSpec, ResourceStatus, VolumeMountSpec, Volume, SandboxTemplate, Pool, SandboxData, SandboxClientConfig, RunOptions, CreateSandboxOptions, WaitForSandboxOptions, CreateVolumeOptions, CreateTemplateOptions, UpdateTemplateOptions, CreatePoolOptions, UpdateVolumeOptions, UpdatePoolOptions, } from "./types.js";
+export type { ExecutionResult, OutputChunk, WsMessage, WsRunOptions, ResourceSpec, ResourceStatus, VolumeMountSpec, Volume, SandboxTemplate, Pool, SandboxData, SandboxClientConfig, RunOptions, CreateSandboxOptions, UpdateSandboxOptions, WaitForSandboxOptions, CreateVolumeOptions, CreateTemplateOptions, UpdateTemplateOptions, CreatePoolOptions, UpdateVolumeOptions, UpdatePoolOptions, } from "./types.js";
 export { LangSmithSandboxError, LangSmithSandboxAPIError, LangSmithSandboxAuthenticationError, LangSmithSandboxConnectionError, LangSmithSandboxServerReloadError, LangSmithResourceNotFoundError, LangSmithResourceTimeoutError, LangSmithResourceInUseError, LangSmithResourceAlreadyExistsError, LangSmithResourceNameConflictError, LangSmithValidationError, LangSmithQuotaExceededError, LangSmithResourceCreationError, LangSmithSandboxCreationError, LangSmithSandboxNotReadyError, LangSmithSandboxOperationError, LangSmithCommandTimeoutError, LangSmithDataplaneNotConfiguredError, } from "./errors.js";

package/dist/experimental/sandbox/sandbox.cjs

@@ -85,6 +85,27 @@ class Sandbox {
             writable: true,
             value: void 0
         });
+        /** Maximum lifetime TTL in seconds (`0` means disabled). */
+        Object.defineProperty(this, "ttl_seconds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Idle timeout TTL in seconds (`0` means disabled). */
+        Object.defineProperty(this, "idle_ttl_seconds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Computed expiration timestamp when a TTL is active. */
+        Object.defineProperty(this, "expires_at", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "_client", {
             enumerable: true,
             configurable: true,
@@ -99,6 +120,9 @@ class Sandbox {
         this.id = data.id;
         this.created_at = data.created_at;
         this.updated_at = data.updated_at;
+        this.ttl_seconds = data.ttl_seconds;
+        this.idle_ttl_seconds = data.idle_ttl_seconds;
+        this.expires_at = data.expires_at;
         this._client = client;
     }
     /**

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

@@ -38,6 +38,12 @@ export declare class Sandbox {
     readonly created_at?: string;
     /** Timestamp when the sandbox was last updated. */
     readonly updated_at?: string;
+    /** Maximum lifetime TTL in seconds (`0` means disabled). */
+    readonly ttl_seconds?: number;
+    /** Idle timeout TTL in seconds (`0` means disabled). */
+    readonly idle_ttl_seconds?: number;
+    /** Computed expiration timestamp when a TTL is active. */
+    readonly expires_at?: string;
     private _client;
     /**
      * Validate and return the dataplane URL.

package/dist/experimental/sandbox/sandbox.js

@@ -82,6 +82,27 @@ export class Sandbox {
             writable: true,
             value: void 0
         });
+        /** Maximum lifetime TTL in seconds (`0` means disabled). */
+        Object.defineProperty(this, "ttl_seconds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Idle timeout TTL in seconds (`0` means disabled). */
+        Object.defineProperty(this, "idle_ttl_seconds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** Computed expiration timestamp when a TTL is active. */
+        Object.defineProperty(this, "expires_at", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "_client", {
             enumerable: true,
             configurable: true,
@@ -96,6 +117,9 @@ export class Sandbox {
         this.id = data.id;
         this.created_at = data.created_at;
         this.updated_at = data.updated_at;
+        this.ttl_seconds = data.ttl_seconds;
+        this.idle_ttl_seconds = data.idle_ttl_seconds;
+        this.expires_at = data.expires_at;
         this._client = client;
     }
     /**

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

@@ -85,6 +85,12 @@ export interface SandboxData {
     status_message?: string;
     created_at?: string;
     updated_at?: string;
+    /** Maximum lifetime TTL in seconds (`0` means disabled, omitted/`undefined` means not set). */
+    ttl_seconds?: number;
+    /** Idle timeout TTL in seconds (`0` means disabled, omitted/`undefined` means not set). */
+    idle_ttl_seconds?: number;
+    /** Computed expiration timestamp when a TTL is active, else omitted/`undefined`. */
+    expires_at?: string;
 }
 /**
  * Configuration options for the SandboxClient.
@@ -248,6 +254,32 @@ export interface CreateSandboxOptions {
      * Default: true.
      */
     waitForReady?: boolean;
+    /**
+     * Maximum lifetime in seconds from creation. The sandbox is deleted after
+     * this duration. Must be a multiple of 60, or `0`/`undefined` to disable or omit.
+     */
+    ttlSeconds?: number;
+    /**
+     * Idle timeout in seconds. The sandbox is deleted after this much inactivity.
+     * Must be a multiple of 60, or `0`/`undefined` to disable or omit.
+     */
+    idleTtlSeconds?: number;
+}
+/**
+ * Options for updating a sandbox (name and/or TTL).
+ */
+export interface UpdateSandboxOptions {
+    /** New display name. */
+    newName?: string;
+    /**
+     * Maximum lifetime in seconds from creation. Must be a multiple of 60.
+     * Pass `0` to disable absolute TTL.
+     */
+    ttlSeconds?: number;
+    /**
+     * Idle timeout in seconds. Must be a multiple of 60. Pass `0` to disable.
+     */
+    idleTtlSeconds?: number;
 }
 /**
  * Options for waiting for a sandbox to become ready.

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 yarn bump-version
-exports.__version__ = "0.5.14";
+exports.__version__ = "0.5.15";

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.14";
+export declare const __version__ = "0.5.15";

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 yarn bump-version
-export const __version__ = "0.5.14";
+export const __version__ = "0.5.15";

package/dist/wrappers/gemini.cjs

@@ -166,7 +166,7 @@ const chatAggregator = (input) => {
     return result;
 };
 function processGeminiInputs(inputs) {
-    const { contents, model, ...rest } = inputs;
+    const { contents, ...rest } = inputs;
     if (!contents)
         return inputs;
     if (typeof contents === "string") {

package/dist/wrappers/gemini.js

@@ -163,7 +163,7 @@ const chatAggregator = (input) => {
     return result;
 };
 function processGeminiInputs(inputs) {
-    const { contents, model, ...rest } = inputs;
+    const { contents, ...rest } = inputs;
     if (!contents)
         return inputs;
     if (typeof contents === "string") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.5.14",
+  "version": "0.5.15",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [
@@ -157,7 +157,7 @@
     "@ai-sdk/openai": "^3.0.0",
     "@ai-sdk/provider": "^3.0.0",
     "@anthropic-ai/claude-agent-sdk": "^0.2.83",
-    "@anthropic-ai/sdk": "^0.78.0",
+    "@anthropic-ai/sdk": "^0.80.0",
     "@babel/preset-env": "^7.22.4",
     "@faker-js/faker": "^8.4.1",
     "@google/genai": "^1.29.0",
@@ -167,8 +167,8 @@
     "@langchain/langgraph": "^0.3.6",
     "@langchain/openai": "^0.5.16",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/auto-instrumentations-node": "^0.70.1",
-    "@opentelemetry/sdk-node": "^0.212.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.71.0",
+    "@opentelemetry/sdk-node": "^0.214.0",
     "@opentelemetry/sdk-trace-base": "^2.0.0",
     "@opentelemetry/sdk-trace-node": "^2.0.0",
     "@tsconfig/recommended": "^1.0.2",