langsmith 0.6.2 → 0.7.0

package/dist/client.cjs

@@ -4668,6 +4668,11 @@ class Client {
      * the prompt contents, not merely the publishing account. Prompts from your
      * own or your organization's account can still be unsafe if that account or
      * prompt was compromised.
+     *
+     * When pulling a trusted external prompt, prefer pinning to a specific commit
+     * rather than following a mutable latest version. Using `includeModel: true`
+     * increases risk and should be avoided for public prompts or prompts outside
+     * your own organization.
      */
     async pullPromptCommit(promptIdentifier, options) {
         assertPullPublicPromptAllowed(promptIdentifier, options?.dangerouslyPullPublicPrompt);
@@ -4703,6 +4708,11 @@ class Client {
      * the prompt contents, not merely the publishing account. Prompts from your
      * own or your organization's account can still be unsafe if that account or
      * prompt was compromised.
+     *
+     * When pulling a trusted external prompt, prefer pinning to a specific commit
+     * rather than following a mutable latest version. Using `includeModel: true`
+     * increases risk and should be avoided for public prompts or prompts outside
+     * your own organization.
      * @private
      */
     async _pullPrompt(promptIdentifier, options) {
@@ -4888,7 +4898,12 @@ class Client {
         });
         const data = (await response.json());
         const commitHash = data.commit.commit_hash;
-        return `${this.getHostUrl()}/hub/${owner}/${name}:${commitHash.slice(0, 8)}`;
+        let ownerForUrl = owner;
+        if (owner === "-") {
+            const settings = await this._getSettings();
+            ownerForUrl = settings.tenant_handle || owner;
+        }
+        return `${this.getHostUrl()}/hub/${ownerForUrl}/${name}:${commitHash.slice(0, 8)}`;
     }
     async _deleteDirectory(identifier) {
         const [owner, name] = (0, prompts_js_1.parseHubIdentifier)(identifier);

package/dist/client.d.ts

@@ -1346,6 +1346,11 @@ export declare class Client implements LangSmithTracingClientInterface {
      * the prompt contents, not merely the publishing account. Prompts from your
      * own or your organization's account can still be unsafe if that account or
      * prompt was compromised.
+     *
+     * When pulling a trusted external prompt, prefer pinning to a specific commit
+     * rather than following a mutable latest version. Using `includeModel: true`
+     * increases risk and should be avoided for public prompts or prompts outside
+     * your own organization.
      */
     pullPromptCommit(promptIdentifier: string, options?: {
         includeModel?: boolean;
@@ -1372,6 +1377,11 @@ export declare class Client implements LangSmithTracingClientInterface {
      * the prompt contents, not merely the publishing account. Prompts from your
      * own or your organization's account can still be unsafe if that account or
      * prompt was compromised.
+     *
+     * When pulling a trusted external prompt, prefer pinning to a specific commit
+     * rather than following a mutable latest version. Using `includeModel: true`
+     * increases risk and should be avoided for public prompts or prompts outside
+     * your own organization.
      * @private
      */
     _pullPrompt(promptIdentifier: string, options?: {

package/dist/client.js

@@ -4630,6 +4630,11 @@ export class Client {
      * the prompt contents, not merely the publishing account. Prompts from your
      * own or your organization's account can still be unsafe if that account or
      * prompt was compromised.
+     *
+     * When pulling a trusted external prompt, prefer pinning to a specific commit
+     * rather than following a mutable latest version. Using `includeModel: true`
+     * increases risk and should be avoided for public prompts or prompts outside
+     * your own organization.
      */
     async pullPromptCommit(promptIdentifier, options) {
         assertPullPublicPromptAllowed(promptIdentifier, options?.dangerouslyPullPublicPrompt);
@@ -4665,6 +4670,11 @@ export class Client {
      * the prompt contents, not merely the publishing account. Prompts from your
      * own or your organization's account can still be unsafe if that account or
      * prompt was compromised.
+     *
+     * When pulling a trusted external prompt, prefer pinning to a specific commit
+     * rather than following a mutable latest version. Using `includeModel: true`
+     * increases risk and should be avoided for public prompts or prompts outside
+     * your own organization.
      * @private
      */
     async _pullPrompt(promptIdentifier, options) {
@@ -4850,7 +4860,12 @@ export class Client {
         });
         const data = (await response.json());
         const commitHash = data.commit.commit_hash;
-        return `${this.getHostUrl()}/hub/${owner}/${name}:${commitHash.slice(0, 8)}`;
+        let ownerForUrl = owner;
+        if (owner === "-") {
+            const settings = await this._getSettings();
+            ownerForUrl = settings.tenant_handle || owner;
+        }
+        return `${this.getHostUrl()}/hub/${ownerForUrl}/${name}:${commitHash.slice(0, 8)}`;
     }
     async _deleteDirectory(identifier) {
         const [owner, name] = parseHubIdentifier(identifier);

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.6.2";
+exports.__version__ = "0.7.0";

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

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.6.2";
+export const __version__ = "0.7.0";

package/dist/{experimental/sandbox → sandbox}/client.cjs

@@ -4,9 +4,9 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 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 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 sandbox_js_1 = require("./sandbox.cjs");
 const errors_js_1 = require("./errors.cjs");
 const helpers_js_1 = require("./helpers.cjs");
@@ -54,7 +54,7 @@ function getDefaultApiKey() {
  *
  * @example
  * ```typescript
- * import { SandboxClient } from "langsmith/experimental/sandbox";
+ * import { SandboxClient } from "langsmith/sandbox";
  *
  * // Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment
  * const client = new SandboxClient();
@@ -65,13 +65,8 @@ function getDefaultApiKey() {
  *   apiKey: "your-api-key",
  * });
  *
- * // Build a snapshot, then create a sandbox from it
- * const snapshot = await client.createSnapshot(
- *   "python",
- *   "python:3.12-slim",
- *   1_073_741_824 // 1 GiB
- * );
- * const sandbox = await client.createSandbox(snapshot.id);
+ * // Create a sandbox with the default runtime
+ * const sandbox = await client.createSandbox();
  * try {
  *   const result = await sandbox.run("python --version");
  *   console.log(result.stdout);
@@ -79,8 +74,6 @@ function getDefaultApiKey() {
  *   await sandbox.delete();
  * }
  * ```
- *
- * @experimental This feature is experimental, and breaking changes are expected.
  */
 class SandboxClient {
     constructor(config = {}) {
@@ -160,56 +153,17 @@ class SandboxClient {
         }
         return response;
     }
-    // =========================================================================
-    // Sandbox Operations
-    // =========================================================================
-    /**
-     * Create a new Sandbox from a snapshot.
-     *
-     * Remember to call `sandbox.delete()` when done to clean up resources.
-     *
-     * Exactly one of `snapshotId` (positional) or `options.snapshotName` must
-     * be provided. When `snapshotName` is used, the server resolves it to a
-     * snapshot owned by the caller's tenant.
-     *
-     * @param snapshotId - ID of the snapshot to boot from. Create one with
-     *   `createSnapshot()` or `captureSnapshot()`, or pass an existing snapshot ID.
-     *   Pass `undefined` when booting by name via `options.snapshotName`.
-     * @param options - Creation options. Use `options.snapshotName` to boot
-     *   by snapshot name instead of ID.
-     * @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, or if neither
-     *   (or both) of `snapshotId` / `options.snapshotName` are provided.
-     *
-     * @example
-     * ```typescript
-     * const snapshot = await client.createSnapshot(
-     *   "python",
-     *   "python:3.12-slim",
-     *   1_073_741_824
-     * );
-     * const sandbox = await client.createSandbox(snapshot.id);
-     * // Or, resolve by snapshot name:
-     * const sandbox = await client.createSandbox(undefined, {
-     *   snapshotName: "python",
-     * });
-     * try {
-     *   const result = await sandbox.run("echo hello");
-     *   console.log(result.stdout);
-     * } finally {
-     *   await sandbox.delete();
-     * }
-     * ```
-     */
-    async createSandbox(snapshotId, options = {}) {
-        const { snapshotName, name, timeout = 30, waitForReady = true, ttlSeconds, idleTtlSeconds, vCpus, memBytes, fsCapacityBytes, proxyConfig, } = options;
-        if (!!snapshotId === !!snapshotName) {
-            throw new errors_js_1.LangSmithValidationError("Exactly one of snapshotId or options.snapshotName must be set", "snapshotId");
+    async createSandbox(snapshotIdOrOptions, options = {}) {
+        const snapshotId = typeof snapshotIdOrOptions === "string" ? snapshotIdOrOptions : undefined;
+        const resolvedOptions = typeof snapshotIdOrOptions === "object" && snapshotIdOrOptions !== null
+            ? snapshotIdOrOptions
+            : options;
+        const { snapshotName, name, timeout = 30, waitForReady = true, idleTtlSeconds, deleteAfterStopSeconds, vCpus, memBytes, fsCapacityBytes, proxyConfig, } = resolvedOptions;
+        if (snapshotId && snapshotName) {
+            throw new errors_js_1.LangSmithValidationError("At most one of snapshotId or options.snapshotName may be set", "snapshotId");
         }
-        (0, helpers_js_1.validateTtl)(ttlSeconds, "ttlSeconds");
         (0, helpers_js_1.validateTtl)(idleTtlSeconds, "idleTtlSeconds");
+        (0, helpers_js_1.validateTtl)(deleteAfterStopSeconds, "deleteAfterStopSeconds");
         const url = `${this._baseUrl}/boxes`;
         const payload = {
             wait_for_ready: waitForReady,
@@ -226,12 +180,12 @@ class SandboxClient {
         if (name) {
             payload.name = name;
         }
-        if (ttlSeconds !== undefined) {
-            payload.ttl_seconds = ttlSeconds;
-        }
         if (idleTtlSeconds !== undefined) {
             payload.idle_ttl_seconds = idleTtlSeconds;
         }
+        if (deleteAfterStopSeconds !== undefined) {
+            payload.delete_after_stop_seconds = deleteAfterStopSeconds;
+        }
         if (vCpus !== undefined) {
             payload.vcpus = vCpus;
         }
@@ -299,12 +253,12 @@ class SandboxClient {
         const options = typeof newNameOrOptions === "string"
             ? { newName: newNameOrOptions }
             : newNameOrOptions;
-        const { newName, ttlSeconds, idleTtlSeconds } = options;
-        (0, helpers_js_1.validateTtl)(ttlSeconds, "ttlSeconds");
+        const { newName, idleTtlSeconds, deleteAfterStopSeconds } = options;
         (0, helpers_js_1.validateTtl)(idleTtlSeconds, "idleTtlSeconds");
+        (0, helpers_js_1.validateTtl)(deleteAfterStopSeconds, "deleteAfterStopSeconds");
         if (newName === undefined &&
-            ttlSeconds === undefined &&
-            idleTtlSeconds === undefined) {
+            idleTtlSeconds === undefined &&
+            deleteAfterStopSeconds === undefined) {
             return this.getSandbox(name);
         }
         const url = `${this._baseUrl}/boxes/${encodeURIComponent(name)}`;
@@ -312,12 +266,12 @@ class SandboxClient {
         if (newName !== undefined) {
             payload.name = newName;
         }
-        if (ttlSeconds !== undefined) {
-            payload.ttl_seconds = ttlSeconds;
-        }
         if (idleTtlSeconds !== undefined) {
             payload.idle_ttl_seconds = idleTtlSeconds;
         }
+        if (deleteAfterStopSeconds !== undefined) {
+            payload.delete_after_stop_seconds = deleteAfterStopSeconds;
+        }
         const response = await this._fetch(url, {
             method: "PATCH",
             headers: { "Content-Type": "application/json" },

package/dist/{experimental/sandbox → sandbox}/client.d.ts

@@ -10,7 +10,7 @@ import { Sandbox } from "./sandbox.js";
  *
  * @example
  * ```typescript
- * import { SandboxClient } from "langsmith/experimental/sandbox";
+ * import { SandboxClient } from "langsmith/sandbox";
  *
  * // Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment
  * const client = new SandboxClient();
@@ -21,13 +21,8 @@ import { Sandbox } from "./sandbox.js";
  *   apiKey: "your-api-key",
  * });
  *
- * // Build a snapshot, then create a sandbox from it
- * const snapshot = await client.createSnapshot(
- *   "python",
- *   "python:3.12-slim",
- *   1_073_741_824 // 1 GiB
- * );
- * const sandbox = await client.createSandbox(snapshot.id);
+ * // Create a sandbox with the default runtime
+ * const sandbox = await client.createSandbox();
  * try {
  *   const result = await sandbox.run("python --version");
  *   console.log(result.stdout);
@@ -35,8 +30,6 @@ import { Sandbox } from "./sandbox.js";
  *   await sandbox.delete();
  * }
  * ```
- *
- * @experimental This feature is experimental, and breaking changes are expected.
  */
 export declare class SandboxClient {
     private _baseUrl;
@@ -45,35 +38,24 @@ export declare class SandboxClient {
     private _caller;
     constructor(config?: SandboxClientConfig);
     /**
-     * Create a new Sandbox from a snapshot.
+     * Create a new Sandbox.
      *
      * Remember to call `sandbox.delete()` when done to clean up resources.
      *
-     * Exactly one of `snapshotId` (positional) or `options.snapshotName` must
-     * be provided. When `snapshotName` is used, the server resolves it to a
-     * snapshot owned by the caller's tenant.
-     *
-     * @param snapshotId - ID of the snapshot to boot from. Create one with
-     *   `createSnapshot()` or `captureSnapshot()`, or pass an existing snapshot ID.
-     *   Pass `undefined` when booting by name via `options.snapshotName`.
-     * @param options - Creation options. Use `options.snapshotName` to boot
-     *   by snapshot name instead of ID.
+     * @param snapshotId - Optional snapshot ID to boot from.
+     * @param options - Creation options. Use `options.snapshotName` to boot from
+     *   a named snapshot instead of the default runtime.
      * @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, or if neither
-     *   (or both) of `snapshotId` / `options.snapshotName` are provided.
+     * @throws LangSmithValidationError if TTL values are invalid, or if both
+     *   `snapshotId` and `options.snapshotName` are provided.
      *
      * @example
      * ```typescript
-     * const snapshot = await client.createSnapshot(
-     *   "python",
-     *   "python:3.12-slim",
-     *   1_073_741_824
-     * );
-     * const sandbox = await client.createSandbox(snapshot.id);
+     * const sandbox = await client.createSandbox();
      * // Or, resolve by snapshot name:
-     * const sandbox = await client.createSandbox(undefined, {
+     * const sandbox = await client.createSandbox({
      *   snapshotName: "python",
      * });
      * try {
@@ -84,6 +66,7 @@ export declare class SandboxClient {
      * }
      * ```
      */
+    createSandbox(options?: CreateSandboxOptions): Promise<Sandbox>;
     createSandbox(snapshotId?: string, options?: CreateSandboxOptions): Promise<Sandbox>;
     /**
      * Get a Sandbox by name.
@@ -111,14 +94,15 @@ export declare class SandboxClient {
      */
     updateSandbox(name: string, newName: string): Promise<Sandbox>;
     /**
-     * Update a sandbox's name and/or TTL settings.
+     * Update a sandbox's name and/or retention settings (idle stop and
+     * delete-after-stop).
      *
      * @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.
+     * @throws LangSmithValidationError if retention values are invalid.
      */
     updateSandbox(name: string, options: UpdateSandboxOptions): Promise<Sandbox>;
     /**

package/dist/{experimental/sandbox → sandbox}/client.js

@@ -1,9 +1,9 @@
 /**
  * Main SandboxClient class for interacting with the sandbox server API.
  */
-import { getLangSmithEnvironmentVariable } from "../../utils/env.js";
-import { _getFetchImplementation } from "../../singletons/fetch.js";
-import { AsyncCaller } from "../../utils/async_caller.js";
+import { getLangSmithEnvironmentVariable } from "../utils/env.js";
+import { _getFetchImplementation } from "../singletons/fetch.js";
+import { AsyncCaller } from "../utils/async_caller.js";
 import { Sandbox } from "./sandbox.js";
 import { LangSmithResourceCreationError, LangSmithResourceNameConflictError, LangSmithResourceNotFoundError, LangSmithResourceTimeoutError, LangSmithSandboxAPIError, LangSmithValidationError, } from "./errors.js";
 import { handleClientHttpError, handleSandboxCreationError, validateTtl, } from "./helpers.js";
@@ -51,7 +51,7 @@ function getDefaultApiKey() {
  *
  * @example
  * ```typescript
- * import { SandboxClient } from "langsmith/experimental/sandbox";
+ * import { SandboxClient } from "langsmith/sandbox";
  *
  * // Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment
  * const client = new SandboxClient();
@@ -62,13 +62,8 @@ function getDefaultApiKey() {
  *   apiKey: "your-api-key",
  * });
  *
- * // Build a snapshot, then create a sandbox from it
- * const snapshot = await client.createSnapshot(
- *   "python",
- *   "python:3.12-slim",
- *   1_073_741_824 // 1 GiB
- * );
- * const sandbox = await client.createSandbox(snapshot.id);
+ * // Create a sandbox with the default runtime
+ * const sandbox = await client.createSandbox();
  * try {
  *   const result = await sandbox.run("python --version");
  *   console.log(result.stdout);
@@ -76,8 +71,6 @@ function getDefaultApiKey() {
  *   await sandbox.delete();
  * }
  * ```
- *
- * @experimental This feature is experimental, and breaking changes are expected.
  */
 export class SandboxClient {
     constructor(config = {}) {
@@ -157,56 +150,17 @@ export class SandboxClient {
         }
         return response;
     }
-    // =========================================================================
-    // Sandbox Operations
-    // =========================================================================
-    /**
-     * Create a new Sandbox from a snapshot.
-     *
-     * Remember to call `sandbox.delete()` when done to clean up resources.
-     *
-     * Exactly one of `snapshotId` (positional) or `options.snapshotName` must
-     * be provided. When `snapshotName` is used, the server resolves it to a
-     * snapshot owned by the caller's tenant.
-     *
-     * @param snapshotId - ID of the snapshot to boot from. Create one with
-     *   `createSnapshot()` or `captureSnapshot()`, or pass an existing snapshot ID.
-     *   Pass `undefined` when booting by name via `options.snapshotName`.
-     * @param options - Creation options. Use `options.snapshotName` to boot
-     *   by snapshot name instead of ID.
-     * @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, or if neither
-     *   (or both) of `snapshotId` / `options.snapshotName` are provided.
-     *
-     * @example
-     * ```typescript
-     * const snapshot = await client.createSnapshot(
-     *   "python",
-     *   "python:3.12-slim",
-     *   1_073_741_824
-     * );
-     * const sandbox = await client.createSandbox(snapshot.id);
-     * // Or, resolve by snapshot name:
-     * const sandbox = await client.createSandbox(undefined, {
-     *   snapshotName: "python",
-     * });
-     * try {
-     *   const result = await sandbox.run("echo hello");
-     *   console.log(result.stdout);
-     * } finally {
-     *   await sandbox.delete();
-     * }
-     * ```
-     */
-    async createSandbox(snapshotId, options = {}) {
-        const { snapshotName, name, timeout = 30, waitForReady = true, ttlSeconds, idleTtlSeconds, vCpus, memBytes, fsCapacityBytes, proxyConfig, } = options;
-        if (!!snapshotId === !!snapshotName) {
-            throw new LangSmithValidationError("Exactly one of snapshotId or options.snapshotName must be set", "snapshotId");
+    async createSandbox(snapshotIdOrOptions, options = {}) {
+        const snapshotId = typeof snapshotIdOrOptions === "string" ? snapshotIdOrOptions : undefined;
+        const resolvedOptions = typeof snapshotIdOrOptions === "object" && snapshotIdOrOptions !== null
+            ? snapshotIdOrOptions
+            : options;
+        const { snapshotName, name, timeout = 30, waitForReady = true, idleTtlSeconds, deleteAfterStopSeconds, vCpus, memBytes, fsCapacityBytes, proxyConfig, } = resolvedOptions;
+        if (snapshotId && snapshotName) {
+            throw new LangSmithValidationError("At most one of snapshotId or options.snapshotName may be set", "snapshotId");
         }
-        validateTtl(ttlSeconds, "ttlSeconds");
         validateTtl(idleTtlSeconds, "idleTtlSeconds");
+        validateTtl(deleteAfterStopSeconds, "deleteAfterStopSeconds");
         const url = `${this._baseUrl}/boxes`;
         const payload = {
             wait_for_ready: waitForReady,
@@ -223,12 +177,12 @@ export class SandboxClient {
         if (name) {
             payload.name = name;
         }
-        if (ttlSeconds !== undefined) {
-            payload.ttl_seconds = ttlSeconds;
-        }
         if (idleTtlSeconds !== undefined) {
             payload.idle_ttl_seconds = idleTtlSeconds;
         }
+        if (deleteAfterStopSeconds !== undefined) {
+            payload.delete_after_stop_seconds = deleteAfterStopSeconds;
+        }
         if (vCpus !== undefined) {
             payload.vcpus = vCpus;
         }
@@ -296,12 +250,12 @@ export class SandboxClient {
         const options = typeof newNameOrOptions === "string"
             ? { newName: newNameOrOptions }
             : newNameOrOptions;
-        const { newName, ttlSeconds, idleTtlSeconds } = options;
-        validateTtl(ttlSeconds, "ttlSeconds");
+        const { newName, idleTtlSeconds, deleteAfterStopSeconds } = options;
         validateTtl(idleTtlSeconds, "idleTtlSeconds");
+        validateTtl(deleteAfterStopSeconds, "deleteAfterStopSeconds");
         if (newName === undefined &&
-            ttlSeconds === undefined &&
-            idleTtlSeconds === undefined) {
+            idleTtlSeconds === undefined &&
+            deleteAfterStopSeconds === undefined) {
             return this.getSandbox(name);
         }
         const url = `${this._baseUrl}/boxes/${encodeURIComponent(name)}`;
@@ -309,12 +263,12 @@ export class SandboxClient {
         if (newName !== undefined) {
             payload.name = newName;
         }
-        if (ttlSeconds !== undefined) {
-            payload.ttl_seconds = ttlSeconds;
-        }
         if (idleTtlSeconds !== undefined) {
             payload.idle_ttl_seconds = idleTtlSeconds;
         }
+        if (deleteAfterStopSeconds !== undefined) {
+            payload.delete_after_stop_seconds = deleteAfterStopSeconds;
+        }
         const response = await this._fetch(url, {
             method: "PATCH",
             headers: { "Content-Type": "application/json" },

package/dist/{experimental/sandbox → sandbox}/index.cjs

@@ -7,7 +7,7 @@
  *
  * @example
  * ```typescript
- * import { SandboxClient } from "langsmith/experimental/sandbox";
+ * import { SandboxClient } from "langsmith/sandbox";
  *
  * // Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment
  * const client = new SandboxClient();

package/dist/{experimental/sandbox → sandbox}/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @example
  * ```typescript
- * import { SandboxClient } from "langsmith/experimental/sandbox";
+ * import { SandboxClient } from "langsmith/sandbox";
  *
  * // Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment
  * const client = new SandboxClient();

package/dist/{experimental/sandbox → sandbox}/index.js

@@ -6,7 +6,7 @@
  *
  * @example
  * ```typescript
- * import { SandboxClient } from "langsmith/experimental/sandbox";
+ * import { SandboxClient } from "langsmith/sandbox";
  *
  * // Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment
  * const client = new SandboxClient();

package/dist/{experimental/sandbox → sandbox}/sandbox.cjs

@@ -25,8 +25,6 @@ const ws_execute_js_1 = require("./ws_execute.cjs");
  *   await sandbox.delete();
  * }
  * ```
- *
- * @experimental This feature is experimental, and breaking changes are expected.
  */
 class Sandbox {
     /** @internal */
@@ -80,26 +78,34 @@ class Sandbox {
             writable: true,
             value: void 0
         });
-        /** Maximum lifetime TTL in seconds (`0` means disabled). */
-        Object.defineProperty(this, "ttl_seconds", {
+        /**
+         * Idle timeout TTL in seconds (`0` means disabled).
+         * New sandboxes receive a server-side default of `600` seconds (10 minutes)
+         * when the caller did not set `idleTtlSeconds` explicitly. The launcher
+         * stops the sandbox after this many idle seconds.
+         */
+        Object.defineProperty(this, "idle_ttl_seconds", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
         /**
-         * Idle timeout TTL in seconds (`0` means disabled).
-         * New sandboxes receive a server-side default of `600` seconds (10 minutes)
-         * when the caller did not set `idleTtlSeconds` explicitly.
+         * Seconds after the sandbox enters the `stopped` state before it (and
+         * its filesystem clone) are permanently deleted (`0` means disabled).
          */
-        Object.defineProperty(this, "idle_ttl_seconds", {
+        Object.defineProperty(this, "delete_after_stop_seconds", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        /** Computed expiration timestamp when a TTL is active. */
-        Object.defineProperty(this, "expires_at", {
+        /**
+         * Timestamp when the sandbox transitioned to `stopped`, or `undefined`
+         * while running. The deletion deadline is
+         * `stopped_at + delete_after_stop_seconds`.
+         */
+        Object.defineProperty(this, "stopped_at", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -146,9 +152,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.delete_after_stop_seconds = data.delete_after_stop_seconds;
+        this.stopped_at = data.stopped_at ?? undefined;
         this.snapshot_id = data.snapshot_id;
         this.vCpus = data.vcpus;
         this.mem_bytes = data.mem_bytes;

package/dist/{experimental/sandbox → sandbox}/sandbox.d.ts

@@ -20,8 +20,6 @@ import { CommandHandle } from "./command_handle.js";
  *   await sandbox.delete();
  * }
  * ```
- *
- * @experimental This feature is experimental, and breaking changes are expected.
  */
 export declare class Sandbox {
     /** Display name (can be updated). */
@@ -38,16 +36,24 @@ 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).
      * New sandboxes receive a server-side default of `600` seconds (10 minutes)
-     * when the caller did not set `idleTtlSeconds` explicitly.
+     * when the caller did not set `idleTtlSeconds` explicitly. The launcher
+     * stops the sandbox after this many idle seconds.
      */
     readonly idle_ttl_seconds?: number;
-    /** Computed expiration timestamp when a TTL is active. */
-    readonly expires_at?: string;
+    /**
+     * Seconds after the sandbox enters the `stopped` state before it (and
+     * its filesystem clone) are permanently deleted (`0` means disabled).
+     */
+    readonly delete_after_stop_seconds?: number;
+    /**
+     * Timestamp when the sandbox transitioned to `stopped`, or `undefined`
+     * while running. The deletion deadline is
+     * `stopped_at + delete_after_stop_seconds`.
+     */
+    readonly stopped_at?: string;
     /** Snapshot ID used to create this sandbox. */
     readonly snapshot_id?: string;
     /** Number of vCPUs allocated. */

package/dist/{experimental/sandbox → sandbox}/sandbox.js

@@ -22,8 +22,6 @@ import { reconnectWsStream, runWsStream } from "./ws_execute.js";
  *   await sandbox.delete();
  * }
  * ```
- *
- * @experimental This feature is experimental, and breaking changes are expected.
  */
 export class Sandbox {
     /** @internal */
@@ -77,26 +75,34 @@ export class Sandbox {
             writable: true,
             value: void 0
         });
-        /** Maximum lifetime TTL in seconds (`0` means disabled). */
-        Object.defineProperty(this, "ttl_seconds", {
+        /**
+         * Idle timeout TTL in seconds (`0` means disabled).
+         * New sandboxes receive a server-side default of `600` seconds (10 minutes)
+         * when the caller did not set `idleTtlSeconds` explicitly. The launcher
+         * stops the sandbox after this many idle seconds.
+         */
+        Object.defineProperty(this, "idle_ttl_seconds", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
         /**
-         * Idle timeout TTL in seconds (`0` means disabled).
-         * New sandboxes receive a server-side default of `600` seconds (10 minutes)
-         * when the caller did not set `idleTtlSeconds` explicitly.
+         * Seconds after the sandbox enters the `stopped` state before it (and
+         * its filesystem clone) are permanently deleted (`0` means disabled).
          */
-        Object.defineProperty(this, "idle_ttl_seconds", {
+        Object.defineProperty(this, "delete_after_stop_seconds", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        /** Computed expiration timestamp when a TTL is active. */
-        Object.defineProperty(this, "expires_at", {
+        /**
+         * Timestamp when the sandbox transitioned to `stopped`, or `undefined`
+         * while running. The deletion deadline is
+         * `stopped_at + delete_after_stop_seconds`.
+         */
+        Object.defineProperty(this, "stopped_at", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -143,9 +149,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.delete_after_stop_seconds = data.delete_after_stop_seconds;
+        this.stopped_at = data.stopped_at ?? undefined;
         this.snapshot_id = data.snapshot_id;
         this.vCpus = data.vcpus;
         this.mem_bytes = data.mem_bytes;

package/dist/{experimental/sandbox → sandbox}/types.d.ts

@@ -53,12 +53,24 @@ 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 timeout in seconds. The launcher stops the sandbox after this
+     * many seconds of inactivity. `0` disables the idle stop;
+     * omitted/`undefined` means not set (the server applies a default).
+     */
     idle_ttl_seconds?: number;
-    /** Computed expiration timestamp when a TTL is active, else omitted/`undefined`. */
-    expires_at?: string;
+    /**
+     * Seconds after a sandbox enters the `stopped` state before it (and its
+     * filesystem clone) are permanently deleted. `0` disables stop-anchored
+     * deletion; omitted/`undefined` falls back to the server default.
+     */
+    delete_after_stop_seconds?: number;
+    /**
+     * Timestamp when the sandbox transitioned to the `stopped` state, or
+     * `undefined` while running. The deletion deadline is
+     * `stopped_at + delete_after_stop_seconds`.
+     */
+    stopped_at?: string;
     /** Snapshot ID used to create this sandbox. */
     snapshot_id?: string;
     /** Number of vCPUs allocated. */
@@ -243,8 +255,8 @@ export interface SandboxProxyConfig {
  */
 export interface CreateSandboxOptions {
     /**
-     * Snapshot name to boot from. Mutually exclusive with the positional
-     * `snapshotId` argument on `createSandbox`; exactly one must be provided.
+     * Optional snapshot name to boot from. Mutually exclusive with the positional
+     * `snapshotId`.
      * Resolved server-side to a snapshot owned by the caller's tenant.
      */
     snapshotName?: string;
@@ -264,16 +276,20 @@ export interface CreateSandboxOptions {
      */
     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.
+     * Idle timeout in seconds. The launcher stops the sandbox after this many
+     * seconds of inactivity. Must be a multiple of 60. Pass `0` to disable
+     * the idle stop. When omitted, the server applies a default of `600`
+     * seconds (10 minutes).
      */
-    ttlSeconds?: number;
+    idleTtlSeconds?: number;
     /**
-     * Idle timeout in seconds. The sandbox is deleted after this much inactivity.
-     * Must be a multiple of 60. Pass `0` to explicitly disable the idle timeout.
-     * When omitted, the server applies a default of `600` seconds (10 minutes).
+     * Seconds after the sandbox enters the `stopped` state before it (and
+     * its filesystem clone) are permanently deleted. Must be a multiple of
+     * 60. Pass `0` to disable stop-anchored deletion (manual cleanup
+     * required). When omitted, the server applies its configured default
+     * (typically 14 days).
      */
-    idleTtlSeconds?: number;
+    deleteAfterStopSeconds?: number;
     /** Number of vCPUs. */
     vCpus?: number;
     /** Memory in bytes. */
@@ -363,21 +379,23 @@ export interface StartSandboxOptions {
     signal?: AbortSignal;
 }
 /**
- * Options for updating a sandbox (name and/or TTL).
+ * Options for updating a sandbox (name and/or retention settings).
  */
 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.
+     * Idle timeout in seconds. Must be a multiple of 60. Pass `0` to disable
+     * the idle stop. Omit (or pass `undefined`) to leave the existing value
+     * unchanged.
      */
-    ttlSeconds?: number;
+    idleTtlSeconds?: number;
     /**
-     * Idle timeout in seconds. Must be a multiple of 60. Pass `0` to disable.
-     * Omit (or pass `undefined`) to leave the existing value unchanged.
+     * Seconds after entering `stopped` before deletion. Must be a multiple
+     * of 60. Pass `0` to disable stop-anchored deletion. Omit (or pass
+     * `undefined`) to leave the existing value unchanged.
      */
-    idleTtlSeconds?: number;
+    deleteAfterStopSeconds?: number;
 }
 /**
  * Options for waiting for a sandbox to become ready.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "pnpm@10.33.0",
   "files": [
@@ -97,10 +97,10 @@
     "experimental/anthropic.js",
     "experimental/anthropic.d.ts",
     "experimental/anthropic.d.cts",
-    "experimental/sandbox.cjs",
-    "experimental/sandbox.js",
-    "experimental/sandbox.d.ts",
-    "experimental/sandbox.d.cts",
+    "sandbox.cjs",
+    "sandbox.js",
+    "sandbox.d.ts",
+    "sandbox.d.cts",
     "index.cjs",
     "index.js",
     "index.d.ts",
@@ -156,7 +156,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.91.1",
+    "@anthropic-ai/sdk": "^0.94.0",
     "@babel/preset-env": "^7.22.4",
     "@faker-js/faker": "^8.4.1",
     "@google/genai": "^1.29.0",
@@ -167,9 +167,9 @@
     "@langchain/openai": "^0.6.17",
     "@openai/agents": "^0.8.3",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/auto-instrumentations-node": "^0.73.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.75.0",
     "@opentelemetry/context-async-hooks": "^2.6.1",
-    "@opentelemetry/sdk-node": "^0.215.0",
+    "@opentelemetry/sdk-node": "^0.217.0",
     "@opentelemetry/sdk-trace-base": "^2.0.0",
     "@opentelemetry/sdk-trace-node": "^2.0.0",
     "@tsconfig/recommended": "^1.0.2",
@@ -446,14 +446,14 @@
       "import": "./experimental/anthropic.js",
       "require": "./experimental/anthropic.cjs"
     },
-    "./experimental/sandbox": {
+    "./sandbox": {
       "types": {
-        "import": "./experimental/sandbox.d.ts",
-        "require": "./experimental/sandbox.d.cts",
-        "default": "./experimental/sandbox.d.ts"
+        "import": "./sandbox.d.ts",
+        "require": "./sandbox.d.cts",
+        "default": "./sandbox.d.ts"
       },
-      "import": "./experimental/sandbox.js",
-      "require": "./experimental/sandbox.cjs"
+      "import": "./sandbox.js",
+      "require": "./sandbox.cjs"
     },
     "./package.json": "./package.json"
   },

package/sandbox.cjs

@@ -0,0 +1 @@
+module.exports = require('./dist/sandbox/index.cjs');

package/sandbox.d.cts

@@ -0,0 +1 @@
+export * from './dist/sandbox/index.js'

package/sandbox.d.ts

@@ -0,0 +1 @@
+export * from './dist/sandbox/index.js'

package/sandbox.js

@@ -0,0 +1 @@
+export * from './dist/sandbox/index.js'

package/experimental/sandbox.cjs

@@ -1 +0,0 @@
-module.exports = require('../dist/experimental/sandbox/index.cjs');

package/experimental/sandbox.d.cts

@@ -1 +0,0 @@
-export * from '../dist/experimental/sandbox/index.js'

package/experimental/sandbox.d.ts

@@ -1 +0,0 @@
-export * from '../dist/experimental/sandbox/index.js'

package/experimental/sandbox.js

@@ -1 +0,0 @@
-export * from '../dist/experimental/sandbox/index.js'