langsmith 0.10.3 → 0.10.5

package/dist/sandbox/ws_execute.cjs

@@ -136,10 +136,20 @@ class WSStreamControl {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "_closeStdinPending", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
     }
     /** Bind to the active WebSocket. Called inside the generator. */
     _bind(ws) {
         this._ws = ws;
+        if (this._closeStdinPending) {
+            this._closeStdinPending = false;
+            this.sendCloseStdin();
+        }
     }
     /** Mark as closed. Called when the generator exits. */
     _unbind() {
@@ -163,6 +173,22 @@ class WSStreamControl {
             this._ws.send(JSON.stringify({ type: "input", data }));
         }
     }
+    /**
+     * Half-close the command's stdin so it reads EOF.
+     *
+     * A reconnected stream binds its socket only once iteration starts, so a
+     * close arriving before that is queued and sent on bind — dropping it would
+     * leave the command waiting for an EOF that never comes.
+     */
+    sendCloseStdin() {
+        if (this._closed)
+            return;
+        if (this._ws && this._ws.readyState === 1) {
+            this._ws.send(JSON.stringify({ type: "close_stdin" }));
+            return;
+        }
+        this._closeStdinPending = true;
+    }
 }
 exports.WSStreamControl = WSStreamControl;
 // =============================================================================
@@ -330,7 +356,7 @@ async function* readWsMessages(ws) {
  * data arrives in addition to yielding the messages.
  */
 async function runWsStream(dataplaneUrl, apiKey, command, options = {}) {
-    const { timeout = 60, env, cwd, shell = "/bin/bash", onStdout, onStderr, commandId, idleTimeout = 300, killOnDisconnect = false, ttlSeconds = 600, pty, headers: extraHeaders, openTimeout = exports.WS_OPEN_TIMEOUT, } = options;
+    const { timeout = 60, env, cwd, shell = "/bin/bash", onStdout, onStderr, commandId, idleTimeout = 300, killOnDisconnect = false, ttlSeconds = 600, pty, runConfig, closeStdin, headers: extraHeaders, openTimeout = exports.WS_OPEN_TIMEOUT, } = options;
     const wsUrl = buildWsUrl(dataplaneUrl);
     const headers = buildAuthHeaders(apiKey, extraHeaders);
     const control = new WSStreamControl();
@@ -353,6 +379,10 @@ async function runWsStream(dataplaneUrl, apiKey, command, options = {}) {
                 payload.env = env;
             if (cwd)
                 payload.cwd = cwd;
+            if (runConfig)
+                payload.run_config = runConfig;
+            if (closeStdin)
+                payload.close_stdin = true;
             if (commandId)
                 payload.command_id = commandId;
             if (pty)

package/dist/sandbox/ws_execute.d.ts

@@ -35,6 +35,7 @@ export declare class WSStreamControl {
     private _ws;
     private _closed;
     private _killed;
+    private _closeStdinPending;
     /** Bind to the active WebSocket. Called inside the generator. */
     _bind(ws: WsWebSocket): void;
     /** Mark as closed. Called when the generator exits. */
@@ -45,6 +46,14 @@ export declare class WSStreamControl {
     sendKill(): void;
     /** Send stdin data to the running command. */
     sendInput(data: string): void;
+    /**
+     * Half-close the command's stdin so it reads EOF.
+     *
+     * A reconnected stream binds its socket only once iteration starts, so a
+     * close arriving before that is queued and sent on bind — dropping it would
+     * leave the command waiting for an EOF that never comes.
+     */
+    sendCloseStdin(): void;
 }
 /**
  * Raise the appropriate exception from a server error message.

package/dist/sandbox/ws_execute.js

@@ -124,10 +124,20 @@ export class WSStreamControl {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "_closeStdinPending", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
     }
     /** Bind to the active WebSocket. Called inside the generator. */
     _bind(ws) {
         this._ws = ws;
+        if (this._closeStdinPending) {
+            this._closeStdinPending = false;
+            this.sendCloseStdin();
+        }
     }
     /** Mark as closed. Called when the generator exits. */
     _unbind() {
@@ -151,6 +161,22 @@ export class WSStreamControl {
             this._ws.send(JSON.stringify({ type: "input", data }));
         }
     }
+    /**
+     * Half-close the command's stdin so it reads EOF.
+     *
+     * A reconnected stream binds its socket only once iteration starts, so a
+     * close arriving before that is queued and sent on bind — dropping it would
+     * leave the command waiting for an EOF that never comes.
+     */
+    sendCloseStdin() {
+        if (this._closed)
+            return;
+        if (this._ws && this._ws.readyState === 1) {
+            this._ws.send(JSON.stringify({ type: "close_stdin" }));
+            return;
+        }
+        this._closeStdinPending = true;
+    }
 }
 // =============================================================================
 // Error Handling
@@ -317,7 +343,7 @@ async function* readWsMessages(ws) {
  * data arrives in addition to yielding the messages.
  */
 export async function runWsStream(dataplaneUrl, apiKey, command, options = {}) {
-    const { timeout = 60, env, cwd, shell = "/bin/bash", onStdout, onStderr, commandId, idleTimeout = 300, killOnDisconnect = false, ttlSeconds = 600, pty, headers: extraHeaders, openTimeout = WS_OPEN_TIMEOUT, } = options;
+    const { timeout = 60, env, cwd, shell = "/bin/bash", onStdout, onStderr, commandId, idleTimeout = 300, killOnDisconnect = false, ttlSeconds = 600, pty, runConfig, closeStdin, headers: extraHeaders, openTimeout = WS_OPEN_TIMEOUT, } = options;
     const wsUrl = buildWsUrl(dataplaneUrl);
     const headers = buildAuthHeaders(apiKey, extraHeaders);
     const control = new WSStreamControl();
@@ -340,6 +366,10 @@ export async function runWsStream(dataplaneUrl, apiKey, command, options = {}) {
                 payload.env = env;
             if (cwd)
                 payload.cwd = cwd;
+            if (runConfig)
+                payload.run_config = runConfig;
+            if (closeStdin)
+                payload.close_stdin = true;
             if (commandId)
                 payload.command_id = commandId;
             if (pty)

package/dist/utils/error.cjs

@@ -140,32 +140,27 @@ async function raiseForStatus(response, context, consumeOnSuccess) {
         }
         return;
     }
+    try {
+        errorBody = await response.text();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    }
+    catch (_e) {
+        errorBody = "";
+    }
     if (response.status === 403) {
+        let errorData;
         try {
-            const errorData = await response.json();
-            const errorCode = errorData?.error;
-            if (errorCode === "org_scoped_key_requires_workspace") {
-                errorBody =
-                    "This API key is org-scoped and requires workspace specification. " +
-                        "Please provide 'workspaceId' parameter, " +
-                        "or set LANGSMITH_WORKSPACE_ID environment variable.";
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        }
-        catch (_e) {
-            const errorWithStatus = new Error(`${response.status} ${response.statusText}`);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            errorWithStatus.status = response?.status;
-            throw errorWithStatus;
+            errorData = JSON.parse(errorBody);
         }
-    }
-    if (errorBody === undefined) {
-        try {
-            errorBody = await response.text();
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        catch {
+            // Non-JSON body (e.g. a proxy in front of a self-hosted instance):
+            // fall through and surface the raw body like every other status.
         }
-        catch (_e) {
-            errorBody = "";
+        if (errorData?.error === "org_scoped_key_requires_workspace") {
+            errorBody =
+                "This API key is org-scoped and requires workspace specification. " +
+                    "Please provide 'workspaceId' parameter, " +
+                    "or set LANGSMITH_WORKSPACE_ID environment variable.";
         }
     }
     const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Message: ${errorBody}`;

package/dist/utils/error.js

@@ -129,32 +129,27 @@ export async function raiseForStatus(response, context, consumeOnSuccess) {
         }
         return;
     }
+    try {
+        errorBody = await response.text();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    }
+    catch (_e) {
+        errorBody = "";
+    }
     if (response.status === 403) {
+        let errorData;
         try {
-            const errorData = await response.json();
-            const errorCode = errorData?.error;
-            if (errorCode === "org_scoped_key_requires_workspace") {
-                errorBody =
-                    "This API key is org-scoped and requires workspace specification. " +
-                        "Please provide 'workspaceId' parameter, " +
-                        "or set LANGSMITH_WORKSPACE_ID environment variable.";
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        }
-        catch (_e) {
-            const errorWithStatus = new Error(`${response.status} ${response.statusText}`);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            errorWithStatus.status = response?.status;
-            throw errorWithStatus;
+            errorData = JSON.parse(errorBody);
         }
-    }
-    if (errorBody === undefined) {
-        try {
-            errorBody = await response.text();
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        catch {
+            // Non-JSON body (e.g. a proxy in front of a self-hosted instance):
+            // fall through and surface the raw body like every other status.
         }
-        catch (_e) {
-            errorBody = "";
+        if (errorData?.error === "org_scoped_key_requires_workspace") {
+            errorBody =
+                "This API key is org-scoped and requires workspace specification. " +
+                    "Please provide 'workspaceId' parameter, " +
+                    "or set LANGSMITH_WORKSPACE_ID environment variable.";
         }
     }
     const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Message: ${errorBody}`;

package/dist/wrappers/openai_agents.cjs

@@ -369,6 +369,33 @@ function createResponsesUsageMetadata(usage) {
     }
     return result;
 }
+/**
+ * Return an ls_agent_type for the span, or undefined to leave it alone.
+ *
+ * If the run already has middleware/subagent/compaction, keep it. Otherwise
+ * guardrails become middleware and agents under any tool become subagents.
+ *
+ * Openai-agents structural counterpart to resolveVercelLsAgentType.
+ */
+function _resolveOpenAIAgentsLsAgentType(spanData, parentRun, existingTag) {
+    if (typeof existingTag === "string" &&
+        ls_agent_type_js_1.NON_ROOT_LS_AGENT_TYPES.has(existingTag)) {
+        return undefined;
+    }
+    if (spanData.type === "guardrail")
+        return "middleware";
+    // Walk the full parent chain, not just the direct parent: asTool inserts
+    // a chain run between the tool and the inner agent span.
+    if (spanData.type === "agent") {
+        let cursor = parentRun;
+        while (cursor !== undefined) {
+            if (cursor.run_type === "tool")
+                return "subagent";
+            cursor = cursor.parent_run;
+        }
+    }
+    return undefined;
+}
 /**
  * Tracing processor for the [OpenAI Agents SDK](https://openai.github.io/openai-agents-js/).
  *
@@ -463,12 +490,6 @@ class OpenAIAgentsTracingProcessor {
             writable: true,
             value: new Map()
         });
-        Object.defineProperty(this, "_spanDataTypes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
         Object.defineProperty(this, "_unpostedTraces", {
             enumerable: true,
             configurable: true,
@@ -684,28 +705,17 @@ class OpenAIAgentsTracingProcessor {
             console.error("Error creating span run:", e);
             return;
         }
-        // Add ls_agent_type metadata for agent spans that are children of
-        // function spans (i.e., agents used as tools).
-        // Handoff agents are not considered subagents.
-        if (spanData.type === "agent") {
-            const parentSpanType = parentId
-                ? this._spanDataTypes.get(parentId)
-                : undefined;
-            if (parentSpanType === "function") {
-                if (!childRun.extra) {
-                    childRun.extra = {};
-                }
-                if (!childRun.extra.metadata) {
-                    childRun.extra.metadata = {};
-                }
-                const meta = childRun.extra.metadata;
-                if (!ls_agent_type_js_1.NON_ROOT_LS_AGENT_TYPES.has(meta.ls_agent_type)) {
-                    meta.ls_agent_type = "subagent";
-                }
-            }
+        // Handoffs replace the caller rather than run as a tool, so a handoff
+        // agent has no tool ancestor and correctly stays untagged here.
+        if (!childRun.extra)
+            childRun.extra = {};
+        if (!childRun.extra.metadata)
+            childRun.extra.metadata = {};
+        const meta = childRun.extra.metadata;
+        const structuralTag = _resolveOpenAIAgentsLsAgentType(spanData, parentRun, meta.ls_agent_type);
+        if (structuralTag !== undefined) {
+            meta.ls_agent_type = structuralTag;
         }
-        // Track span data type for parent lookups
-        this._spanDataTypes.set(span.spanId, spanData.type);
         this._runs.set(span.spanId, childRun);
         // Enter AsyncLocalStorage context synchronously so nested traceable()
         // calls inside the span's body nest under this run. Remember the
@@ -741,7 +751,6 @@ class OpenAIAgentsTracingProcessor {
             enterRunTreeContext(previousStore);
         }
         const run = this._runs.get(span.spanId);
-        this._spanDataTypes.delete(span.spanId);
         if (!run) {
             return;
         }

package/dist/wrappers/openai_agents.d.ts

@@ -69,7 +69,6 @@ export declare class OpenAIAgentsTracingProcessor implements TracingProcessor {
     private _firstResponseInputs;
     private _lastResponseOutputs;
     private _runs;
-    private _spanDataTypes;
     private _unpostedTraces;
     private _unpostedSpans;
     private _previousStoreByTrace;

package/dist/wrappers/openai_agents.js

@@ -366,6 +366,33 @@ function createResponsesUsageMetadata(usage) {
     }
     return result;
 }
+/**
+ * Return an ls_agent_type for the span, or undefined to leave it alone.
+ *
+ * If the run already has middleware/subagent/compaction, keep it. Otherwise
+ * guardrails become middleware and agents under any tool become subagents.
+ *
+ * Openai-agents structural counterpart to resolveVercelLsAgentType.
+ */
+function _resolveOpenAIAgentsLsAgentType(spanData, parentRun, existingTag) {
+    if (typeof existingTag === "string" &&
+        NON_ROOT_LS_AGENT_TYPES.has(existingTag)) {
+        return undefined;
+    }
+    if (spanData.type === "guardrail")
+        return "middleware";
+    // Walk the full parent chain, not just the direct parent: asTool inserts
+    // a chain run between the tool and the inner agent span.
+    if (spanData.type === "agent") {
+        let cursor = parentRun;
+        while (cursor !== undefined) {
+            if (cursor.run_type === "tool")
+                return "subagent";
+            cursor = cursor.parent_run;
+        }
+    }
+    return undefined;
+}
 /**
  * Tracing processor for the [OpenAI Agents SDK](https://openai.github.io/openai-agents-js/).
  *
@@ -460,12 +487,6 @@ export class OpenAIAgentsTracingProcessor {
             writable: true,
             value: new Map()
         });
-        Object.defineProperty(this, "_spanDataTypes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
         Object.defineProperty(this, "_unpostedTraces", {
             enumerable: true,
             configurable: true,
@@ -681,28 +702,17 @@ export class OpenAIAgentsTracingProcessor {
             console.error("Error creating span run:", e);
             return;
         }
-        // Add ls_agent_type metadata for agent spans that are children of
-        // function spans (i.e., agents used as tools).
-        // Handoff agents are not considered subagents.
-        if (spanData.type === "agent") {
-            const parentSpanType = parentId
-                ? this._spanDataTypes.get(parentId)
-                : undefined;
-            if (parentSpanType === "function") {
-                if (!childRun.extra) {
-                    childRun.extra = {};
-                }
-                if (!childRun.extra.metadata) {
-                    childRun.extra.metadata = {};
-                }
-                const meta = childRun.extra.metadata;
-                if (!NON_ROOT_LS_AGENT_TYPES.has(meta.ls_agent_type)) {
-                    meta.ls_agent_type = "subagent";
-                }
-            }
+        // Handoffs replace the caller rather than run as a tool, so a handoff
+        // agent has no tool ancestor and correctly stays untagged here.
+        if (!childRun.extra)
+            childRun.extra = {};
+        if (!childRun.extra.metadata)
+            childRun.extra.metadata = {};
+        const meta = childRun.extra.metadata;
+        const structuralTag = _resolveOpenAIAgentsLsAgentType(spanData, parentRun, meta.ls_agent_type);
+        if (structuralTag !== undefined) {
+            meta.ls_agent_type = structuralTag;
         }
-        // Track span data type for parent lookups
-        this._spanDataTypes.set(span.spanId, spanData.type);
         this._runs.set(span.spanId, childRun);
         // Enter AsyncLocalStorage context synchronously so nested traceable()
         // calls inside the span's body nest under this run. Remember the
@@ -738,7 +748,6 @@ export class OpenAIAgentsTracingProcessor {
             enterRunTreeContext(previousStore);
         }
         const run = this._runs.get(span.spanId);
-        this._spanDataTypes.delete(span.spanId);
         if (!run) {
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "pnpm@10.33.0",
   "files": [
@@ -488,7 +488,7 @@
       "brace-expansion@>=3.0.0 <5.0.7": "5.0.7",
       "fast-uri": "3.1.6",
       "postcss": "8.5.23",
-      "js-yaml": "4.3.1",
+      "js-yaml": "4.3.2",
       "hono": "4.13.5",
       "ip-address": "10.3.1",
       "undici@>=7.0.0 <8.0.0": "7.29.0",