langsmith 0.8.6 → 0.8.7

package/dist/index.cjs

@@ -35,6 +35,6 @@ Object.defineProperty(exports, "UnprocessableEntityError", { enumerable: true, g
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return error_js_1.RateLimitError; } });
 Object.defineProperty(exports, "InternalServerError", { enumerable: true, get: function () { return error_js_1.InternalServerError; } });
 // Update using pnpm bump-version
-exports.__version__ = "0.8.6";
+exports.__version__ = "0.8.7";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 exports.LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { computeRunIdForSecondaryReplica, uuid7, uuid7FromTime, } from "./uuid.j
 export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, type CacheConfig, type CacheMetrics, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 export { LangsmithError, APIError, APIUserAbortError, APIConnectionError, APIConnectionTimeoutError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./_openapi_client/core/error.js";
-export declare const __version__ = "0.8.6";
+export declare const __version__ = "0.8.7";
 export declare const LS_MESSAGE_VIEW_EXCLUDE: "ls_message_view_exclude";

package/dist/index.js

@@ -7,6 +7,6 @@ export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 export { LangsmithError, APIError, APIUserAbortError, APIConnectionError, APIConnectionTimeoutError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./_openapi_client/core/error.js";
 // Update using pnpm bump-version
-export const __version__ = "0.8.6";
+export const __version__ = "0.8.7";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 export const LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/sandbox/sandbox.cjs

@@ -199,8 +199,9 @@ class Sandbox {
             // wait=true with callbacks: drain stream and return result
             return handle.result;
         }
-        // wait=true, no callbacks: try WS, fall back to HTTP
-        try {
+        // wait=true, no callbacks: use WebSocket when the 'ws' package is
+        // available, otherwise the blocking HTTP endpoint. WS errors propagate.
+        if (await this._wsAvailable()) {
             const handle = await this._runWs(command, {
                 ...restOptions,
                 idleTimeout,
@@ -210,17 +211,14 @@ class Sandbox {
             });
             return await handle.result;
         }
-        catch (e) {
-            // Fall back to HTTP on connection errors or missing ws package
-            const name = e != null && typeof e === "object" ? e.name : "";
-            const message = e != null && typeof e === "object" ? (e.message ?? "") : "";
-            if (name === "LangSmithSandboxConnectionError" ||
-                name === "LangSmithSandboxServerReloadError" ||
-                message.includes("'ws' package")) {
-                return this._runHttp(command, restOptions);
-            }
-            throw e;
-        }
+        return this._runHttp(command, restOptions);
+    }
+    /**
+     * Whether the optional `ws` package is importable (resolved once).
+     * @internal
+     */
+    _wsAvailable() {
+        return (0, ws_execute_js_1.isWsAvailable)();
     }
     /**
      * Execute a command via WebSocket streaming.

package/dist/sandbox/sandbox.d.ts

@@ -78,7 +78,8 @@ export declare class Sandbox {
      * Execute a command in the sandbox.
      *
      * When `wait` is true (default) and no streaming callbacks are provided,
-     * tries WebSocket first and falls back to HTTP POST.
+     * uses WebSocket, falling back to HTTP POST only when the optional `ws`
+     * package isn't installed.
      *
      * When `wait` is false or streaming callbacks are provided, uses WebSocket
      * (required). Returns a CommandHandle for streaming output.

package/dist/sandbox/sandbox.js

@@ -5,7 +5,7 @@ import { uuid7 } from "../uuid.js";
 import { LangSmithDataplaneNotConfiguredError, LangSmithStreamEndedBeforeStartedError, } from "./errors.js";
 import { handleSandboxHttpError } from "./helpers.js";
 import { CommandHandle } from "./command_handle.js";
-import { reconnectWsStream, runWsStream } from "./ws_execute.js";
+import { isWsAvailable, reconnectWsStream, runWsStream } from "./ws_execute.js";
 /**
  * Represents an active sandbox for running commands and file operations.
  *
@@ -196,8 +196,9 @@ export class Sandbox {
             // wait=true with callbacks: drain stream and return result
             return handle.result;
         }
-        // wait=true, no callbacks: try WS, fall back to HTTP
-        try {
+        // wait=true, no callbacks: use WebSocket when the 'ws' package is
+        // available, otherwise the blocking HTTP endpoint. WS errors propagate.
+        if (await this._wsAvailable()) {
             const handle = await this._runWs(command, {
                 ...restOptions,
                 idleTimeout,
@@ -207,17 +208,14 @@ export class Sandbox {
             });
             return await handle.result;
         }
-        catch (e) {
-            // Fall back to HTTP on connection errors or missing ws package
-            const name = e != null && typeof e === "object" ? e.name : "";
-            const message = e != null && typeof e === "object" ? (e.message ?? "") : "";
-            if (name === "LangSmithSandboxConnectionError" ||
-                name === "LangSmithSandboxServerReloadError" ||
-                message.includes("'ws' package")) {
-                return this._runHttp(command, restOptions);
-            }
-            throw e;
-        }
+        return this._runHttp(command, restOptions);
+    }
+    /**
+     * Whether the optional `ws` package is importable (resolved once).
+     * @internal
+     */
+    _wsAvailable() {
+        return isWsAvailable();
     }
     /**
      * Execute a command via WebSocket streaming.

package/dist/sandbox/ws_execute.cjs

@@ -7,21 +7,28 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WSStreamControl = void 0;
+exports.isWsAvailable = isWsAvailable;
 exports.buildWsUrl = buildWsUrl;
 exports.buildAuthHeaders = buildAuthHeaders;
 exports.raiseForWsError = raiseForWsError;
 exports.runWsStream = runWsStream;
 exports.reconnectWsStream = reconnectWsStream;
 const errors_js_1 = require("./errors.cjs");
+// Load the optional 'ws' package once, at module load, instead of importing on
+// every call. Resolves to the WebSocket constructor, or null if 'ws' isn't
+// installed. run() reads isWsAvailable() to choose WS vs the HTTP fallback.
+const wsWebSocketPromise = import("ws").then((ws) => ws.default || ws.WebSocket || ws, () => null);
+/** Whether the optional `ws` package could be loaded (resolved once). */
+async function isWsAvailable() {
+    return (await wsWebSocketPromise) !== null;
+}
 async function ensureWs() {
-    try {
-        const ws = await import("ws");
-        return { WebSocket: ws.default || ws.WebSocket || ws };
-    }
-    catch {
+    const WebSocket = await wsWebSocketPromise;
+    if (!WebSocket) {
         throw new Error("WebSocket-based execution requires the 'ws' package. " +
             "Install it with: npm install ws");
     }
+    return { WebSocket };
 }
 // =============================================================================
 // URL and Auth Helpers

package/dist/sandbox/ws_execute.d.ts

@@ -6,6 +6,8 @@
  */
 import type { WsMessage, WsRunOptions } from "./types.js";
 type WsWebSocket = any;
+/** Whether the optional `ws` package could be loaded (resolved once). */
+export declare function isWsAvailable(): Promise<boolean>;
 /**
  * Convert a dataplane HTTP URL to a WebSocket URL for /execute/ws.
  */

package/dist/sandbox/ws_execute.js

@@ -5,15 +5,21 @@
  * Install with: npm install ws
  */
 import { LangSmithCommandTimeoutError, LangSmithSandboxConnectionError, LangSmithSandboxOperationError, LangSmithSandboxServerReloadError, } from "./errors.js";
+// Load the optional 'ws' package once, at module load, instead of importing on
+// every call. Resolves to the WebSocket constructor, or null if 'ws' isn't
+// installed. run() reads isWsAvailable() to choose WS vs the HTTP fallback.
+const wsWebSocketPromise = import("ws").then((ws) => ws.default || ws.WebSocket || ws, () => null);
+/** Whether the optional `ws` package could be loaded (resolved once). */
+export async function isWsAvailable() {
+    return (await wsWebSocketPromise) !== null;
+}
 async function ensureWs() {
-    try {
-        const ws = await import("ws");
-        return { WebSocket: ws.default || ws.WebSocket || ws };
-    }
-    catch {
+    const WebSocket = await wsWebSocketPromise;
+    if (!WebSocket) {
         throw new Error("WebSocket-based execution requires the 'ws' package. " +
             "Install it with: npm install ws");
     }
+    return { WebSocket };
 }
 // =============================================================================
 // URL and Auth Helpers

package/package.json

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