langsmith 0.6.1 → 0.6.3

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/experimental/otel/translator.cjs

@@ -46,6 +46,11 @@ const WELL_KNOWN_OPERATION_NAMES = {
 function getOperationName(runType) {
     return WELL_KNOWN_OPERATION_NAMES[runType] || runType;
 }
+function isPrimitive(value) {
+    return (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean");
+}
 class LangSmithToOTELTranslator {
     constructor() {
         Object.defineProperty(this, "spans", {
@@ -178,6 +183,12 @@ class LangSmithToOTELTranslator {
         if (modelName) {
             span.setAttribute(constants.GEN_AI_REQUEST_MODEL, modelName);
         }
+        // Set usage from metadata if available
+        // This can be overriden by `run.outputs.usage_metadata` later if present.
+        if (runInfo.extra?.metadata?.usage_metadata &&
+            typeof runInfo.extra.metadata.usage_metadata === "object") {
+            span.setAttribute(constants.LANGSMITH_USAGE_METADATA, JSON.stringify(runInfo.extra.metadata.usage_metadata));
+        }
         // Set token usage information
         if ("prompt_tokens" in runInfo &&
             typeof runInfo.prompt_tokens === "number") {
@@ -196,7 +207,7 @@ class LangSmithToOTELTranslator {
         const metadata = runInfo.extra?.metadata || {};
         for (const [key, value] of Object.entries(metadata)) {
             if (value !== null && value !== undefined) {
-                span.setAttribute(`${constants.LANGSMITH_METADATA}.${key}`, String(value));
+                span.setAttribute(`${constants.LANGSMITH_METADATA}.${key}`, isPrimitive(value) ? String(value) : JSON.stringify(value));
             }
         }
         const tags = runInfo.tags;
@@ -365,6 +376,9 @@ class LangSmithToOTELTranslator {
                     if (outputs.usage_metadata &&
                         typeof outputs.usage_metadata === "object") {
                         const usageMetadata = outputs.usage_metadata;
+                        // Set usage from outputs if available
+                        // This overrides the usage from metadata if present.
+                        span.setAttribute(constants.LANGSMITH_USAGE_METADATA, JSON.stringify(usageMetadata));
                         if (usageMetadata.input_token_details) {
                             span.setAttribute(constants.GEN_AI_USAGE_INPUT_TOKEN_DETAILS, JSON.stringify(usageMetadata.input_token_details));
                         }

package/dist/experimental/otel/translator.js

@@ -10,6 +10,11 @@ const WELL_KNOWN_OPERATION_NAMES = {
 function getOperationName(runType) {
     return WELL_KNOWN_OPERATION_NAMES[runType] || runType;
 }
+function isPrimitive(value) {
+    return (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean");
+}
 export class LangSmithToOTELTranslator {
     constructor() {
         Object.defineProperty(this, "spans", {
@@ -142,6 +147,12 @@ export class LangSmithToOTELTranslator {
         if (modelName) {
             span.setAttribute(constants.GEN_AI_REQUEST_MODEL, modelName);
         }
+        // Set usage from metadata if available
+        // This can be overriden by `run.outputs.usage_metadata` later if present.
+        if (runInfo.extra?.metadata?.usage_metadata &&
+            typeof runInfo.extra.metadata.usage_metadata === "object") {
+            span.setAttribute(constants.LANGSMITH_USAGE_METADATA, JSON.stringify(runInfo.extra.metadata.usage_metadata));
+        }
         // Set token usage information
         if ("prompt_tokens" in runInfo &&
             typeof runInfo.prompt_tokens === "number") {
@@ -160,7 +171,7 @@ export class LangSmithToOTELTranslator {
         const metadata = runInfo.extra?.metadata || {};
         for (const [key, value] of Object.entries(metadata)) {
             if (value !== null && value !== undefined) {
-                span.setAttribute(`${constants.LANGSMITH_METADATA}.${key}`, String(value));
+                span.setAttribute(`${constants.LANGSMITH_METADATA}.${key}`, isPrimitive(value) ? String(value) : JSON.stringify(value));
             }
         }
         const tags = runInfo.tags;
@@ -329,6 +340,9 @@ export class LangSmithToOTELTranslator {
                     if (outputs.usage_metadata &&
                         typeof outputs.usage_metadata === "object") {
                         const usageMetadata = outputs.usage_metadata;
+                        // Set usage from outputs if available
+                        // This overrides the usage from metadata if present.
+                        span.setAttribute(constants.LANGSMITH_USAGE_METADATA, JSON.stringify(usageMetadata));
                         if (usageMetadata.input_token_details) {
                             span.setAttribute(constants.GEN_AI_USAGE_INPUT_TOKEN_DETAILS, JSON.stringify(usageMetadata.input_token_details));
                         }

package/dist/experimental/sandbox/client.cjs

@@ -204,12 +204,12 @@ class SandboxClient {
      * ```
      */
     async createSandbox(snapshotId, options = {}) {
-        const { snapshotName, name, timeout = 30, waitForReady = true, ttlSeconds, idleTtlSeconds, vCpus, memBytes, fsCapacityBytes, proxyConfig, } = options;
+        const { snapshotName, name, timeout = 30, waitForReady = true, idleTtlSeconds, deleteAfterStopSeconds, 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");
         }
-        (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 +226,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 +299,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 +312,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/client.d.ts

@@ -111,14 +111,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/client.js

@@ -201,12 +201,12 @@ export class SandboxClient {
      * ```
      */
     async createSandbox(snapshotId, options = {}) {
-        const { snapshotName, name, timeout = 30, waitForReady = true, ttlSeconds, idleTtlSeconds, vCpus, memBytes, fsCapacityBytes, proxyConfig, } = options;
+        const { snapshotName, name, timeout = 30, waitForReady = true, idleTtlSeconds, deleteAfterStopSeconds, vCpus, memBytes, fsCapacityBytes, proxyConfig, } = options;
         if (!!snapshotId === !!snapshotName) {
             throw new LangSmithValidationError("Exactly one of snapshotId or options.snapshotName must 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 +223,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 +296,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 +309,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.cjs

@@ -80,26 +80,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 +154,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.d.ts

@@ -38,16 +38,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.js

@@ -77,26 +77,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 +151,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/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. */
@@ -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/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.1";
+exports.__version__ = "0.6.3";

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

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

package/package.json

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