langsmith 0.5.18 → 0.5.20

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

@@ -73,13 +73,35 @@ export interface ResourceStatus {
     /** Human-readable details when failed. */
     status_message?: string;
 }
+/**
+ * Represents a sandbox snapshot.
+ *
+ * Snapshots are built from Docker images or captured from running sandboxes.
+ * They are used to create new sandboxes.
+ */
+export interface Snapshot {
+    id: string;
+    name: string;
+    /** One of "building", "ready", "failed". */
+    status: string;
+    fs_capacity_bytes: number;
+    docker_image?: string;
+    image_digest?: string;
+    source_sandbox_id?: string;
+    status_message?: string;
+    fs_used_bytes?: number;
+    created_by?: string;
+    registry_id?: string;
+    created_at?: string;
+    updated_at?: string;
+}
 /**
  * Data representing a sandbox instance from the API.
  */
 export interface SandboxData {
     id?: string;
     name: string;
-    template_name: string;
+    template_name?: string;
     dataplane_url?: string;
     status?: string;
     status_message?: string;
@@ -91,6 +113,14 @@ export interface SandboxData {
     idle_ttl_seconds?: number;
     /** Computed expiration timestamp when a TTL is active, else omitted/`undefined`. */
     expires_at?: string;
+    /** Snapshot ID used to create this sandbox. */
+    snapshot_id?: string;
+    /** Number of vCPUs allocated. */
+    vcpus?: number;
+    /** Memory allocation in bytes. */
+    mem_bytes?: number;
+    /** Root filesystem capacity in bytes. */
+    fs_capacity_bytes?: number;
 }
 /**
  * Configuration options for the SandboxClient.
@@ -239,6 +269,11 @@ export interface RunOptions {
  * Options for creating a sandbox.
  */
 export interface CreateSandboxOptions {
+    /**
+     * Snapshot ID to boot from.
+     * Mutually exclusive with the `templateName` positional arg.
+     */
+    snapshotId?: string;
     /**
      * Optional sandbox name (auto-generated if not provided).
      */
@@ -264,6 +299,60 @@ export interface CreateSandboxOptions {
      * Must be a multiple of 60, or `0`/`undefined` to disable or omit.
      */
     idleTtlSeconds?: number;
+    /** Number of vCPUs. */
+    vCpus?: number;
+    /** Memory in bytes. */
+    memBytes?: number;
+    /** Root filesystem capacity in bytes. */
+    fsCapacityBytes?: number;
+}
+/**
+ * Options for creating a snapshot from a Docker image.
+ */
+export interface CreateSnapshotOptions {
+    /** Private registry ID (alternative to URL/credentials). */
+    registryId?: string;
+    /** Registry URL for private images. */
+    registryUrl?: string;
+    /** Registry username. */
+    registryUsername?: string;
+    /** Registry password. */
+    registryPassword?: string;
+    /** Timeout in seconds when waiting for ready. Default: 60. */
+    timeout?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Options for capturing a snapshot from a running sandbox.
+ */
+export interface CaptureSnapshotOptions {
+    /** Checkpoint timestamp to use. If omitted, creates a fresh checkpoint. */
+    checkpoint?: string;
+    /** Timeout in seconds when waiting for ready. Default: 60. */
+    timeout?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Options for waiting for a snapshot to become ready.
+ */
+export interface WaitForSnapshotOptions {
+    /** Maximum time in seconds to wait. Default: 300. */
+    timeout?: number;
+    /** Time in seconds between status polls. Default: 2.0. */
+    pollInterval?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Options for starting a stopped sandbox.
+ */
+export interface StartSandboxOptions {
+    /** Timeout in seconds when waiting for ready. Default: 120. */
+    timeout?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
 }
 /**
  * Options for updating a sandbox (name and/or TTL).
@@ -295,6 +384,8 @@ export interface WaitForSandboxOptions {
      * Default: 1.0.
      */
     pollInterval?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
 }
 /**
  * Options for creating a volume.

package/dist/experimental/vercel/index.cjs

@@ -118,11 +118,19 @@ const _resolveConfigs = (baseLsConfig, runtimeLsConfig) => {
         resolvedToolConfig,
     };
 };
+const _getLsAgentType = () => {
+    const parentRun = (0, traceable_js_1.getCurrentRunTree)(true);
+    if (parentRun != null && parentRun.run_type === "tool") {
+        return "subagent";
+    }
+    return "root";
+};
 const _getGenerateTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolvedLsConfig, hasExplicitOutput, hasExplicitExperimentalOutput, traceResponseMetadata, }) => {
     return {
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
+            ls_agent_type: _getLsAgentType(),
             ai_sdk_method: aiSdkMethodName ?? "ai.generateText",
             ...resolvedLsConfig?.metadata,
         },
@@ -198,6 +206,7 @@ const _getStreamTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolved
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
+            ls_agent_type: _getLsAgentType(),
             ai_sdk_method: aiSdkMethodName ?? "ai.streamText",
             ...resolvedLsConfig?.metadata,
         },
@@ -400,6 +409,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
+                    ls_agent_type: _getLsAgentType(),
                     ai_sdk_method: "ai.generateObject",
                     ...resolvedLsConfig?.metadata,
                 },
@@ -521,6 +531,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
+                    ls_agent_type: _getLsAgentType(),
                     ai_sdk_method: "ai.streamObject",
                     ...resolvedLsConfig?.metadata,
                 },

package/dist/experimental/vercel/index.js

@@ -1,6 +1,6 @@
 import { LangSmithMiddleware, } from "./middleware.js";
 import { convertMessageToTracedFormat } from "./utils.js";
-import { isTraceableFunction, traceable } from "../../traceable.js";
+import { isTraceableFunction, traceable, getCurrentRunTree, } from "../../traceable.js";
 const _wrapTools = (tools, lsConfig) => {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const wrappedTools = {};
@@ -114,11 +114,19 @@ const _resolveConfigs = (baseLsConfig, runtimeLsConfig) => {
         resolvedToolConfig,
     };
 };
+const _getLsAgentType = () => {
+    const parentRun = getCurrentRunTree(true);
+    if (parentRun != null && parentRun.run_type === "tool") {
+        return "subagent";
+    }
+    return "root";
+};
 const _getGenerateTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolvedLsConfig, hasExplicitOutput, hasExplicitExperimentalOutput, traceResponseMetadata, }) => {
     return {
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
+            ls_agent_type: _getLsAgentType(),
             ai_sdk_method: aiSdkMethodName ?? "ai.generateText",
             ...resolvedLsConfig?.metadata,
         },
@@ -194,6 +202,7 @@ const _getStreamTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolved
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
+            ls_agent_type: _getLsAgentType(),
             ai_sdk_method: aiSdkMethodName ?? "ai.streamText",
             ...resolvedLsConfig?.metadata,
         },
@@ -395,6 +404,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
+                    ls_agent_type: _getLsAgentType(),
                     ai_sdk_method: "ai.generateObject",
                     ...resolvedLsConfig?.metadata,
                 },
@@ -516,6 +526,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
+                    ls_agent_type: _getLsAgentType(),
                     ai_sdk_method: "ai.streamObject",
                     ...resolvedLsConfig?.metadata,
                 },

package/dist/index.cjs

@@ -18,4 +18,4 @@ Object.defineProperty(exports, "PromptCache", { enumerable: true, get: function
 Object.defineProperty(exports, "configureGlobalPromptCache", { enumerable: true, get: function () { return index_js_1.configureGlobalPromptCache; } });
 Object.defineProperty(exports, "promptCacheSingleton", { enumerable: true, get: function () { return index_js_1.promptCacheSingleton; } });
 // Update using pnpm bump-version
-exports.__version__ = "0.5.18";
+exports.__version__ = "0.5.20";

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

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "pnpm@10.33.0",
   "files": [
@@ -153,7 +153,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.82.0",
+    "@anthropic-ai/sdk": "^0.88.0",
     "@babel/preset-env": "^7.22.4",
     "@faker-js/faker": "^8.4.1",
     "@google/genai": "^1.29.0",