langsmith 0.8.12 → 0.10.0

package/dist/utils/sampling.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Deterministic trace sampling, kept consistent across LangSmith SDKs.
+ */
+/**
+ * Decide whether `identifier` is sampled in at `samplingRate`.
+ *
+ * The decision is a pure function of the identifier, so every process and
+ * every SDK agrees on it, and a run's create and patch never disagree.
+ */
+export declare const isSampledById: (identifier: string | null | undefined, samplingRate: number | undefined) => boolean;

package/dist/utils/sampling.js

@@ -0,0 +1,30 @@
+/**
+ * Deterministic trace sampling, kept consistent across LangSmith SDKs.
+ */
+import { XXH3_128 } from "./xxhash/xxhash.js";
+const SAMPLING_HASH_MODULUS = 1000000n;
+// Reused across calls: constructing a TextEncoder per hash costs more than the
+// hash itself.
+const encoder = new TextEncoder();
+/**
+ * Decide whether `identifier` is sampled in at `samplingRate`.
+ *
+ * The decision is a pure function of the identifier, so every process and
+ * every SDK agrees on it, and a run's create and patch never disagree.
+ */
+export const isSampledById = (identifier, samplingRate) => {
+    if (samplingRate === undefined || samplingRate >= 1) {
+        return true;
+    }
+    if (samplingRate <= 0) {
+        return false;
+    }
+    if (identifier == null) {
+        return true;
+    }
+    // XXH3-128 over the UTF-8 bytes, matching the Python SDK's `xxhash.xxh3_128`.
+    // The identifier is sampled in when its fraction of the modulus falls below
+    // the rate, which is also expressed in [0, 1).
+    const bucket = XXH3_128(encoder.encode(identifier.toLowerCase())) % SAMPLING_HASH_MODULUS;
+    return Number(bucket) / Number(SAMPLING_HASH_MODULUS) < samplingRate;
+};

package/dist/wrappers/anthropic.cjs

@@ -5,7 +5,7 @@ exports.createUsageMetadata = createUsageMetadata;
 const anthropic_managed_js_1 = require("./utils/anthropic_managed.cjs");
 const traceable_js_1 = require("../traceable.cjs");
 const usage_js_1 = require("../utils/usage.cjs");
-const index_js_1 = require("../anonymizer/index.cjs");
+const redaction_js_1 = require("../utils/redaction.cjs");
 const TRACED_INVOCATION_KEYS = ["top_k", "top_p", "stream", "thinking"];
 /** Keys of an MCP server definition that are safe to trace. */
 const MCP_SERVER_SAFE_KEYS = new Set([
@@ -14,27 +14,20 @@ const MCP_SERVER_SAFE_KEYS = new Set([
     "url",
     "tool_configuration",
 ]);
-/**
- * Mask credentials in `mcp_servers` before tracing. Anything outside
- * {@link MCP_SERVER_SAFE_KEYS} keeps its name but gets
- * {@link SECRET_PLACEHOLDER} as its value, so the trace shows the field was set
- * without exposing it, and fields the API adds later are masked by default.
- *
- * Returns new objects; the caller's are also sent to Anthropic.
- */
+/** Mask `mcp_servers` credentials outside {@link MCP_SERVER_SAFE_KEYS}. */
 function redactMcpServers(servers) {
     if (!Array.isArray(servers))
         return servers;
-    return servers.map((server) => {
-        if (typeof server !== "object" || server == null || Array.isArray(server)) {
-            return server;
-        }
-        return Object.fromEntries(Object.entries(server).map(([key, value]) => [
-            key,
-            MCP_SERVER_SAFE_KEYS.has(key) ? value : index_js_1.SECRET_PLACEHOLDER,
-        ]));
-    });
+    return servers.map((server) => (0, redaction_js_1.redactOutside)(server, MCP_SERVER_SAFE_KEYS));
 }
+/** Request-transport keys that are credentials by construction. */
+const TRANSPORT_SECRET_KEYS = new Set([
+    "headers",
+    "query",
+    "extra_headers",
+    "extra_body",
+    "extra_query",
+]);
 /**
  * Create usage metadata from Anthropic's token usage format.
  */
@@ -246,17 +239,18 @@ const wrapAnthropic = (anthropic, options) => {
         ...options,
         metadata: restMetadata,
     };
-    /**
-     * Transform system parameter into visible message for playground editability.
-     * This provides parity with the Python SDK behavior and enables system prompts
-     * to be viewed and edited in the LangSmith playground.
-     */
-    function processTracedInputs(params) {
+    /** Mask credentials and surface `system` as a message the playground can edit. */
+    function redactAnthropicParams(params) {
         // Copy first: `params` also goes to the API and must keep its real values.
         const processed = { ...params };
         if (processed.mcp_servers != null) {
             processed.mcp_servers = redactMcpServers(processed.mcp_servers);
         }
+        for (const key of TRANSPORT_SECRET_KEYS) {
+            if (processed[key] != null) {
+                processed[key] = (0, redaction_js_1.mask)(processed[key]);
+            }
+        }
         if (!params.system) {
             return processed;
         }
@@ -275,6 +269,9 @@ const wrapAnthropic = (anthropic, options) => {
         delete processed.system;
         return processed;
     }
+    function processTracedInputs(inputs) {
+        return (0, redaction_js_1.overParams)(inputs, redactAnthropicParams);
+    }
     // Common configuration for messages.create
     const messagesCreateConfig = {
         name: "ChatAnthropic",

package/dist/wrappers/anthropic.js

@@ -1,7 +1,7 @@
 import { wrapManagedAgentSessionEvents } from "./utils/anthropic_managed.js";
 import { isTraceableFunction, traceable, } from "../traceable.js";
 import { convertAnthropicUsageToInputTokenDetails } from "../utils/usage.js";
-import { SECRET_PLACEHOLDER } from "../anonymizer/index.js";
+import { mask, overParams, redactOutside } from "../utils/redaction.js";
 const TRACED_INVOCATION_KEYS = ["top_k", "top_p", "stream", "thinking"];
 /** Keys of an MCP server definition that are safe to trace. */
 const MCP_SERVER_SAFE_KEYS = new Set([
@@ -10,27 +10,20 @@ const MCP_SERVER_SAFE_KEYS = new Set([
     "url",
     "tool_configuration",
 ]);
-/**
- * Mask credentials in `mcp_servers` before tracing. Anything outside
- * {@link MCP_SERVER_SAFE_KEYS} keeps its name but gets
- * {@link SECRET_PLACEHOLDER} as its value, so the trace shows the field was set
- * without exposing it, and fields the API adds later are masked by default.
- *
- * Returns new objects; the caller's are also sent to Anthropic.
- */
+/** Mask `mcp_servers` credentials outside {@link MCP_SERVER_SAFE_KEYS}. */
 function redactMcpServers(servers) {
     if (!Array.isArray(servers))
         return servers;
-    return servers.map((server) => {
-        if (typeof server !== "object" || server == null || Array.isArray(server)) {
-            return server;
-        }
-        return Object.fromEntries(Object.entries(server).map(([key, value]) => [
-            key,
-            MCP_SERVER_SAFE_KEYS.has(key) ? value : SECRET_PLACEHOLDER,
-        ]));
-    });
+    return servers.map((server) => redactOutside(server, MCP_SERVER_SAFE_KEYS));
 }
+/** Request-transport keys that are credentials by construction. */
+const TRANSPORT_SECRET_KEYS = new Set([
+    "headers",
+    "query",
+    "extra_headers",
+    "extra_body",
+    "extra_query",
+]);
 /**
  * Create usage metadata from Anthropic's token usage format.
  */
@@ -242,17 +235,18 @@ export const wrapAnthropic = (anthropic, options) => {
         ...options,
         metadata: restMetadata,
     };
-    /**
-     * Transform system parameter into visible message for playground editability.
-     * This provides parity with the Python SDK behavior and enables system prompts
-     * to be viewed and edited in the LangSmith playground.
-     */
-    function processTracedInputs(params) {
+    /** Mask credentials and surface `system` as a message the playground can edit. */
+    function redactAnthropicParams(params) {
         // Copy first: `params` also goes to the API and must keep its real values.
         const processed = { ...params };
         if (processed.mcp_servers != null) {
             processed.mcp_servers = redactMcpServers(processed.mcp_servers);
         }
+        for (const key of TRANSPORT_SECRET_KEYS) {
+            if (processed[key] != null) {
+                processed[key] = mask(processed[key]);
+            }
+        }
         if (!params.system) {
             return processed;
         }
@@ -271,6 +265,9 @@ export const wrapAnthropic = (anthropic, options) => {
         delete processed.system;
         return processed;
     }
+    function processTracedInputs(inputs) {
+        return overParams(inputs, redactAnthropicParams);
+    }
     // Common configuration for messages.create
     const messagesCreateConfig = {
         name: "ChatAnthropic",

package/dist/wrappers/openai_agents.cjs

@@ -717,6 +717,7 @@ class OpenAIAgentsTracingProcessor {
             // available at start.
             if (spanData.type === "generation" ||
                 spanData.type === "response" ||
+                spanData.type === "agent" ||
                 spanData.type === "function" ||
                 spanData.type === "handoff") {
                 this._unpostedSpans.add(span.spanId);
@@ -818,7 +819,7 @@ class OpenAIAgentsTracingProcessor {
                 await run.postRun();
             }
             else {
-                await run.patchRun(span.spanData.type === "agent" ? undefined : { excludeInputs: true });
+                await run.patchRun({ excludeInputs: true });
             }
         }
         catch (e) {

package/dist/wrappers/openai_agents.js

@@ -714,6 +714,7 @@ export class OpenAIAgentsTracingProcessor {
             // available at start.
             if (spanData.type === "generation" ||
                 spanData.type === "response" ||
+                spanData.type === "agent" ||
                 spanData.type === "function" ||
                 spanData.type === "handoff") {
                 this._unpostedSpans.add(span.spanId);
@@ -815,7 +816,7 @@ export class OpenAIAgentsTracingProcessor {
                 await run.postRun();
             }
             else {
-                await run.patchRun(span.spanData.type === "agent" ? undefined : { excludeInputs: true });
+                await run.patchRun({ excludeInputs: true });
             }
         }
         catch (e) {

package/package.json

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