langsmith 0.6.3 → 0.7.1

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.3";
+exports.__version__ = "0.7.1";

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

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

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,53 +153,14 @@ 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, 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");
+    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)(idleTtlSeconds, "idleTtlSeconds");
         (0, helpers_js_1.validateTtl)(deleteAfterStopSeconds, "deleteAfterStopSeconds");

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.

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,53 +150,14 @@ 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, idleTtlSeconds, deleteAfterStopSeconds, 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(idleTtlSeconds, "idleTtlSeconds");
         validateTtl(deleteAfterStopSeconds, "deleteAfterStopSeconds");

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 */

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). */

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 */

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

@@ -255,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;

package/experimental/sandbox.cjs

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

package/experimental/sandbox.d.cts

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

package/experimental/sandbox.d.ts

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

package/experimental/sandbox.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.6.3",
+  "version": "0.7.1",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "pnpm@10.33.0",
   "files": [
@@ -101,6 +101,10 @@
     "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 +160,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 +171,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",
@@ -455,6 +459,15 @@
       "import": "./experimental/sandbox.js",
       "require": "./experimental/sandbox.cjs"
     },
+    "./sandbox": {
+      "types": {
+        "import": "./sandbox.d.ts",
+        "require": "./sandbox.d.cts",
+        "default": "./sandbox.d.ts"
+      },
+      "import": "./sandbox.js",
+      "require": "./sandbox.cjs"
+    },
     "./package.json": "./package.json"
   },
   "pnpm": {

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'