langsmith 0.10.3 → 0.10.4

package/dist/client.cjs

@@ -82,7 +82,7 @@ function _normalizeRunTimestamps(run) {
         end_time: _ensureUTCTimestamp(run.end_time),
     };
 }
-function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo) {
+function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo, tracingSampleRate) {
     if (omitTracedRuntimeInfo) {
         return run;
     }
@@ -105,6 +105,9 @@ function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo) {
                 }
                 : {}),
             ...metadata,
+            ...(tracingSampleRate !== undefined
+                ? { ls_tracing_sample_rate: tracingSampleRate }
+                : {}),
         },
     };
     return run;
@@ -1617,7 +1620,7 @@ class Client {
         };
     }
     async _mergeRuntimeEnvAndMaskMetadata(run) {
-        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo, this.tracingSampleRate);
         if (this.omitTracedRuntimeInfo) {
             return merged;
         }
@@ -1626,7 +1629,7 @@ class Client {
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
-        item.item = mergeRuntimeEnvIntoRun(item.item, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        item.item = mergeRuntimeEnvIntoRun(item.item, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo, this.tracingSampleRate);
         const itemPromise = this.autoBatchQueue.push(item);
         if (this.manualFlushMode) {
             // Rely on manual flushing in serverless environments
@@ -2227,7 +2230,9 @@ class Client {
         if (options?.workspaceId !== undefined) {
             headers["x-tenant-id"] = options.workspaceId;
         }
-        const body = (0, index_js_4.serialize)(run, `Serializing payload to update run with id: ${runId}`);
+        const body = (0, index_js_4.serialize)(run.extra
+            ? mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo, this.tracingSampleRate)
+            : run, `Serializing payload to update run with id: ${runId}`);
         await this.caller.call(async () => {
             const res = await this._fetch(`${options?.apiUrl ?? this.apiUrl}/runs/${runId}`, {
                 method: "PATCH",

package/dist/client.d.ts

@@ -445,7 +445,7 @@ type Thread = {
 export interface ListThreadsItem extends Thread {
     runs: Run[];
 }
-export declare function mergeRuntimeEnvIntoRun<T extends RunCreate | RunUpdate>(run: T, cachedEnvVars?: Record<string, string>, omitTracedRuntimeInfo?: boolean): T;
+export declare function mergeRuntimeEnvIntoRun<T extends RunCreate | RunUpdate>(run: T, cachedEnvVars?: Record<string, string>, omitTracedRuntimeInfo?: boolean, tracingSampleRate?: number): T;
 export declare function _checkBackendVersion(backendVersion: string, minVersion: string): void;
 export declare const DEFAULT_UNCOMPRESSED_BATCH_SIZE_LIMIT_BYTES: number;
 /** Default maximum memory (1GB) for queue size limits. */

package/dist/client.js

@@ -44,7 +44,7 @@ function _normalizeRunTimestamps(run) {
         end_time: _ensureUTCTimestamp(run.end_time),
     };
 }
-export function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo) {
+export function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo, tracingSampleRate) {
     if (omitTracedRuntimeInfo) {
         return run;
     }
@@ -67,6 +67,9 @@ export function mergeRuntimeEnvIntoRun(run, cachedEnvVars, omitTracedRuntimeInfo
                 }
                 : {}),
             ...metadata,
+            ...(tracingSampleRate !== undefined
+                ? { ls_tracing_sample_rate: tracingSampleRate }
+                : {}),
         },
     };
     return run;
@@ -1578,7 +1581,7 @@ export class Client {
         };
     }
     async _mergeRuntimeEnvAndMaskMetadata(run) {
-        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo, this.tracingSampleRate);
         if (this.omitTracedRuntimeInfo) {
             return merged;
         }
@@ -1587,7 +1590,7 @@ export class Client {
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
-        item.item = mergeRuntimeEnvIntoRun(item.item, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        item.item = mergeRuntimeEnvIntoRun(item.item, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo, this.tracingSampleRate);
         const itemPromise = this.autoBatchQueue.push(item);
         if (this.manualFlushMode) {
             // Rely on manual flushing in serverless environments
@@ -2188,7 +2191,9 @@ export class Client {
         if (options?.workspaceId !== undefined) {
             headers["x-tenant-id"] = options.workspaceId;
         }
-        const body = serializePayloadForTracing(run, `Serializing payload to update run with id: ${runId}`);
+        const body = serializePayloadForTracing(run.extra
+            ? mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo, this.tracingSampleRate)
+            : run, `Serializing payload to update run with id: ${runId}`);
         await this.caller.call(async () => {
             const res = await this._fetch(`${options?.apiUrl ?? this.apiUrl}/runs/${runId}`, {
                 method: "PATCH",

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.10.3";
+exports.__version__ = "0.10.4";
 // 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.10.3";
+export declare const __version__ = "0.10.4";
 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.10.3";
+export const __version__ = "0.10.4";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 export const LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

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.4",
   "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",