langsmith 0.9.0 → 0.10.0

package/dist/client.js

@@ -7,6 +7,7 @@ import { getEnvironmentVariable, getLangSmithEnvVarsMetadata, getLangSmithEnviro
 import { __version__ } from "./index.js";
 import { Langsmith as OpenAPILangsmith } from "./_openapi_client/index.js";
 import { assertUuid } from "./utils/_uuid.js";
+import { isSampledById } from "./utils/sampling.js";
 import { warnOnce } from "./utils/warn.js";
 import { getQueryBackend, QueryBackend } from "./utils/v2_migration.js";
 import { parseHubIdentifier } from "./utils/prompts.js";
@@ -597,12 +598,6 @@ export class Client {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "filteredPostUuids", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Set()
-        });
         Object.defineProperty(this, "autoBatchTracing", {
             enumerable: true,
             configurable: true,
@@ -1035,14 +1030,23 @@ export class Client {
         return headers;
     }
     /**
-     * The auth options and caller headers to build the generated client with.
+     * The options to build the generated client with: its auth, and the headers
+     * it should send on every request.
      *
      * The generated client applies `defaultHeaders` *after* its own auth headers,
      * so the ones this SDK sets are already dropped from `_callerHeaders` to keep
      * the precedence of `_mergedHeaders`, where required headers win.
      */
-    get _openAPIAuth() {
+    get _openAPIClientOptions() {
         const headers = { ...this._callerHeaders };
+        // Without this the generated client falls back to its own
+        // `Langsmith/JS <generated version>`, so the same client would identify
+        // itself two different ways depending on which path a call takes. A
+        // caller-supplied one still wins, matched case-insensitively so the header
+        // is not sent twice.
+        if (!Object.keys(headers).some((name) => name.toLowerCase() === "user-agent")) {
+            headers["User-Agent"] = `langsmith-js/${__version__}`;
+        }
         // A caller may authenticate by supplying `x-api-key` themselves. The
         // generated client rejects that as a header (its `validateHeaders` requires
         // its own `apiKey` to be set), so hand it over as the `apiKey` option and
@@ -1094,25 +1098,25 @@ export class Client {
      * its token is refreshed.
      */
     get openAPIClient() {
-        const auth = this._openAPIAuth;
-        const signature = JSON.stringify([auth.apiKey, auth.defaultHeaders]);
+        const options = this._openAPIClientOptions;
+        const signature = JSON.stringify([options.apiKey, options.defaultHeaders]);
         if (this._openAPIClient === undefined ||
             this._openAPIClientSignature !== signature) {
             this._openAPIClientSignature = signature;
-            this._openAPIClient = this._newOpenAPIClient(auth);
+            this._openAPIClient = this._newOpenAPIClient(options);
         }
         return this._openAPIClient;
     }
-    _newOpenAPIClient(auth = this._openAPIAuth) {
+    _newOpenAPIClient(options = this._openAPIClientOptions) {
         const { method: _method, body: _body, signal: _signal, ...openAPIFetchOptions } = this.fetchOptions;
         return new OpenAPILangsmith({
-            apiKey: auth.apiKey,
+            apiKey: options.apiKey,
             tenantID: this.workspaceId,
             baseURL: this._getOpenAPIBaseUrl(),
             timeout: this.timeout_ms,
             fetch: this._fetch,
             fetchOptions: openAPIFetchOptions,
-            defaultHeaders: auth.defaultHeaders,
+            defaultHeaders: options.defaultHeaders,
         });
     }
     _getPlatformEndpointPath(path) {
@@ -1340,53 +1344,14 @@ export class Client {
         }
     }
     // Allows mocking for tests
-    _shouldSample() {
-        if (this.tracingSampleRate === undefined) {
-            return true;
-        }
-        return Math.random() < this.tracingSampleRate;
+    _shouldSample(identifier) {
+        return isSampledById(identifier, this.tracingSampleRate);
     }
-    _filterForSampling(runs, patch = false) {
-        if (this.tracingSampleRate === undefined) {
-            return runs;
-        }
-        if (patch) {
-            const sampled = [];
-            for (const run of runs) {
-                if (!this.filteredPostUuids.has(run.trace_id)) {
-                    sampled.push(run);
-                }
-                else if (run.id === run.trace_id) {
-                    this.filteredPostUuids.delete(run.trace_id);
-                }
-            }
-            return sampled;
-        }
-        else {
-            // For new runs, sample at trace level to maintain consistency
-            const sampled = [];
-            for (const run of runs) {
-                const traceId = run.trace_id ?? run.id;
-                // If we've already made a decision about this trace, follow it
-                if (this.filteredPostUuids.has(traceId)) {
-                    continue;
-                }
-                // For new traces, apply sampling
-                if (run.id === traceId) {
-                    if (this._shouldSample()) {
-                        sampled.push(run);
-                    }
-                    else {
-                        this.filteredPostUuids.add(traceId);
-                    }
-                }
-                else {
-                    // Child runs follow their trace's sampling decision
-                    sampled.push(run);
-                }
-            }
-            return sampled;
-        }
+    _filterForSampling(runs) {
+        // updateRun() may omit trace_id; dotted order's first segment is the root.
+        return runs.filter((run) => this._shouldSample(run.trace_id ??
+            run.dotted_order?.split(".", 1)[0].split("Z")[1] ??
+            run.id));
     }
     async _getBatchSizeLimitBytes() {
         const serverInfo = await this._ensureServerInfo();
@@ -1709,7 +1674,7 @@ export class Client {
      * feedback has no sessionId.
      */
     async _checkFeedbackSessionId() {
-        const docs = "https://docs.langchain.com/langsmith/smithdb-sdk-migration#feedback-create";
+        const docs = "https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#feedback-create";
         const serverInfo = await this._ensureServerInfo();
         if (getQueryBackend(serverInfo.instance_flags) === QueryBackend.SMITHDB_ONLY) {
             throw new Error(`sessionId must be provided when creating feedback for a run: this ` +
@@ -2178,7 +2143,7 @@ export class Client {
         }
         // TODO: Untangle types
         const data = { ...run, id: runId };
-        if (!this._filterForSampling([data], true).length) {
+        if (!this._filterForSampling([data]).length) {
             return;
         }
         if (this.autoBatchTracing &&
@@ -2236,11 +2201,11 @@ export class Client {
             return res;
         });
     }
-    /** @deprecated Use `client.runs.retrieve()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#runs-retrieve for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.runs.retrieve()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-runs#runs-retrieve for the migration guide. Will be removed after Jan 31, 2027. */
     async readRun(runId, { loadChildRuns } = { loadChildRuns: false }) {
         warnOnce("readRun() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.runs.retrieve() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#runs-retrieve for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_READ_RUN" });
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-runs#runs-retrieve for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_READ_RUN" });
         return this._readRun(runId, { loadChildRuns });
     }
     /**
@@ -2259,11 +2224,11 @@ export class Client {
         }
         return run;
     }
-    /** @deprecated Use `client.runs.getURL()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#runs-get-url for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.runs.getURL()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-runs#runs-get-url for the migration guide. Will be removed after Jan 31, 2027. */
     async getRunUrl({ runId, run, projectOpts, }) {
         warnOnce("getRunUrl() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.runs.getURL() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#runs-get-url for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_GET_RUN_URL" });
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-runs#runs-get-url for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_GET_RUN_URL" });
         if (run !== undefined) {
             let sessionId;
             if (run.session_id) {
@@ -2332,7 +2297,7 @@ export class Client {
     }
     /**
      * List runs from the LangSmith server.
-     * @deprecated Use `client.runs.query()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#runs-query for the migration guide. Will be removed after Jan 31, 2027.
+     * @deprecated Use `client.runs.query()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-query-runs#runs-query for the migration guide. Will be removed after Jan 31, 2027.
      * @param projectId - The ID of the project to filter by.
      * @param projectName - The name of the project to filter by.
      * @param parentRunId - The ID of the parent run to filter by.
@@ -2416,7 +2381,7 @@ export class Client {
     async *listRuns(props) {
         warnOnce("listRuns() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.runs.query() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#runs-query for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_LIST_RUNS" });
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-query-runs#runs-query for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_LIST_RUNS" });
         yield* this._listRuns(props);
     }
     /**
@@ -2561,11 +2526,11 @@ export class Client {
             }
         }
     }
-    /** @deprecated Use `client.threads.listTraces()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#threads-list-traces for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.threads.listTraces()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-threads#threads-list-traces for the migration guide. Will be removed after Jan 31, 2027. */
     async *readThread(props) {
         warnOnce("readThread() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.threads.listTraces() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#threads-list-traces for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_READ_THREAD" });
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-threads#threads-list-traces for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_READ_THREAD" });
         const { threadId, projectId, projectName, isRoot = true, limit, filter: userFilter, order = "asc", } = props;
         if (!projectId && !projectName) {
             throw new Error("threadId requires projectId or projectName");
@@ -2585,11 +2550,11 @@ export class Client {
             order,
         });
     }
-    /** @deprecated Use `client.threads.query()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#threads-query for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.threads.query()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-threads#threads-query for the migration guide. Will be removed after Jan 31, 2027. */
     async listThreads(props) {
         warnOnce("listThreads() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.threads.query() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#threads-query for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_LIST_THREADS" });
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-threads#threads-query for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_LIST_THREADS" });
         const { projectId, projectName, limit, offset = 0, filter, startTime, isRoot = true, } = props;
         if (!projectId && !projectName) {
             throw new Error("Either projectId or projectName must be provided");
@@ -2739,11 +2704,11 @@ export class Client {
         const result = await response.json();
         return result;
     }
-    /** @deprecated Use `client.runs.share.create()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.runs.share.create()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
     async shareRun(runId, { shareId } = {}) {
         warnOnce("shareRun() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.runs.share.create() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_SHARE_RUN" });
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_SHARE_RUN" });
         const data = {
             run_id: runId,
             share_token: shareId || uuid.v4(),
@@ -2767,11 +2732,11 @@ export class Client {
         }
         return `${this.getHostUrl()}/public/${result["share_token"]}/r`;
     }
-    /** @deprecated Use `client.runs.share.delete()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.runs.share.delete()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
     async unshareRun(runId) {
         warnOnce("unshareRun() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.runs.share.delete() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_UNSHARE_RUN" });
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide.", { type: "DeprecationWarning", code: "LANGSMITH_DEPRECATED_UNSHARE_RUN" });
         assertUuid(runId);
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/runs/${runId}/share`, {
@@ -2784,11 +2749,11 @@ export class Client {
             return res;
         });
     }
-    /** @deprecated Use `client.runs.retrieve({ selects: ["SHARE_URL"] })` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.runs.retrieve({ selects: ["SHARE_URL"] })` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
     async readRunSharedLink(runId) {
         warnOnce("readRunSharedLink() is deprecated and will be removed after Jan 31, 2027. " +
             'Use client.runs.retrieve({ selects: ["SHARE_URL"] }) instead. ' +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide.", {
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide.", {
             type: "DeprecationWarning",
             code: "LANGSMITH_DEPRECATED_READ_RUN_SHARED_LINK",
         });
@@ -2809,11 +2774,11 @@ export class Client {
         }
         return `${this.getHostUrl()}/public/${result["share_token"]}/r`;
     }
-    /** @deprecated Use `client.public.runs.query()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
+    /** @deprecated Use `client.public.runs.query()` instead. See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide. Will be removed after Jan 31, 2027. */
     async listSharedRuns(shareToken, { runIds, } = {}) {
         warnOnce("listSharedRuns() is deprecated and will be removed after Jan 31, 2027. " +
             "Use client.public.runs.query() instead. " +
-            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#share-and-read-public-runs for the migration guide.", {
+            "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#share-and-read-public-runs for the migration guide.", {
             type: "DeprecationWarning",
             code: "LANGSMITH_DEPRECATED_LIST_SHARED_RUNS",
         });
@@ -3887,7 +3852,7 @@ export class Client {
         });
     }
     async createFeedback(runIdOrParams, keyArg, optionsArg) {
-        const { runId = null, key, score, value, correction, comment, sourceInfo, feedbackSourceType = "api", sourceRunId, feedbackId, feedbackConfig, projectId, comparativeExperimentId, sessionId, startTime, extendTraceRetention, } = typeof runIdOrParams === "object" && runIdOrParams !== null
+        const { runId = null, key, score, value, correction, comment, sourceInfo, feedbackSourceType = "api", sourceRunId, feedbackId, feedbackConfig, projectId, traceId, comparativeExperimentId, sessionId, startTime, extendTraceRetention, } = typeof runIdOrParams === "object" && runIdOrParams !== null
             ? runIdOrParams
             : { runId: runIdOrParams, key: keyArg, ...optionsArg };
         if (!runId && !projectId) {
@@ -3915,6 +3880,7 @@ export class Client {
         const feedback = {
             id: feedbackId ?? uuid.v7(),
             run_id: runId,
+            trace_id: traceId,
             key,
             score: _formatFeedbackScore(score),
             value,
@@ -3927,6 +3893,10 @@ export class Client {
             start_time: startTime,
             extend_trace_retention: extendTraceRetention,
         };
+        const samplingId = traceId ?? runId;
+        if (samplingId != null && !this._shouldSample(samplingId)) {
+            return feedback;
+        }
         const body = JSON.stringify(feedback);
         const url = `${this.apiUrl}/feedback`;
         await this.caller.call(async () => {
@@ -4148,6 +4118,9 @@ export class Client {
                 feedbackSourceType: "model",
                 sessionId: run?.session_id ?? sessionId,
                 startTime: run?.start_time,
+                // If an evaluator result targets a different run, we can't
+                // guarantee to know its trace ID.
+                traceId: runId_ === run?.id ? run?.trace_id : undefined,
             }));
         }
         return [evalResults, feedbacks];
@@ -4413,7 +4386,7 @@ export class Client {
      *   by SmithDB; routes to `POST /runs/by-key`.
      * - `string[]`: a plain list of run IDs. **Deprecated**: this path will be
      *   removed after Jan 31, 2027; prefer the key form. Routes to `POST /runs`.
-     *   See https://docs.langchain.com/langsmith/smithdb-sdk-migration#annotation-queues-add-runs.
+     *   See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#annotation-queues-add-runs.
      *
      * If every element is a string (or the list is empty) it is treated as run
      * IDs; otherwise the list is treated as `RunKey` objects.
@@ -4446,7 +4419,7 @@ export class Client {
         else {
             warnOnce("Passing run IDs as strings to addRunsToAnnotationQueue() is deprecated and will be removed after Jan 31, 2027. " +
                 "Use RunKey[] instead. " +
-                "See https://docs.langchain.com/langsmith/smithdb-sdk-migration#annotation-queues-add-runs for the migration guide.", {
+                "See https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#annotation-queues-add-runs for the migration guide.", {
                 type: "DeprecationWarning",
                 code: "LANGSMITH_DEPRECATED_ADD_RUNS_STRING_IDS",
             });

package/dist/env.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isEnvTracingEnabled = void 0;
+exports.allowUnprocessedPayloads = exports.isEnvTracingEnabled = void 0;
 const env_js_1 = require("./utils/env.cjs");
 const isEnvTracingEnabled = (tracingEnabled) => {
     if (tracingEnabled !== undefined) {
@@ -10,3 +10,16 @@ const isEnvTracingEnabled = (tracingEnabled) => {
     return !!envVars.find((envVar) => (0, env_js_1.getLangSmithEnvironmentVariable)(envVar) === "true");
 };
 exports.isEnvTracingEnabled = isEnvTracingEnabled;
+/**
+ * Whether a failed redactor should fall back to tracing the raw payload.
+ *
+ * Set `LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS` to restore the pre-fail-closed
+ * behavior in an emergency. It uploads data no redactor processed, so it is off
+ * by default and the caller logs a warning naming it whenever it takes effect.
+ * Read only on failure, so it stays off the hot path.
+ */
+const allowUnprocessedPayloads = () => {
+    const value = (0, env_js_1.getLangSmithEnvironmentVariable)("ALLOW_UNPROCESSED_PAYLOADS");
+    return value?.toLowerCase() === "true" || value === "1";
+};
+exports.allowUnprocessedPayloads = allowUnprocessedPayloads;

package/dist/env.d.ts

@@ -1 +1,10 @@
 export declare const isEnvTracingEnabled: (tracingEnabled?: boolean) => boolean;
+/**
+ * Whether a failed redactor should fall back to tracing the raw payload.
+ *
+ * Set `LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS` to restore the pre-fail-closed
+ * behavior in an emergency. It uploads data no redactor processed, so it is off
+ * by default and the caller logs a warning naming it whenever it takes effect.
+ * Read only on failure, so it stays off the hot path.
+ */
+export declare const allowUnprocessedPayloads: () => boolean;

package/dist/env.js

@@ -6,3 +6,15 @@ export const isEnvTracingEnabled = (tracingEnabled) => {
     const envVars = ["TRACING_V2", "TRACING"];
     return !!envVars.find((envVar) => getLangSmithEnvironmentVariable(envVar) === "true");
 };
+/**
+ * Whether a failed redactor should fall back to tracing the raw payload.
+ *
+ * Set `LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS` to restore the pre-fail-closed
+ * behavior in an emergency. It uploads data no redactor processed, so it is off
+ * by default and the caller logs a warning naming it whenever it takes effect.
+ * Read only on failure, so it stays off the hot path.
+ */
+export const allowUnprocessedPayloads = () => {
+    const value = getLangSmithEnvironmentVariable("ALLOW_UNPROCESSED_PAYLOADS");
+    return value?.toLowerCase() === "true" || value === "1";
+};

package/dist/evaluation/evaluate_comparative.cjs

@@ -201,6 +201,8 @@ async function evaluateComparative(experiments, options) {
                 comparativeExperimentId: comparativeExperiment.id,
                 sessionId: run?.session_id,
                 startTime: run?.start_time,
+                // `run` is the run being scored, so its trace is the right key.
+                traceId: run?.trace_id,
             });
         }
         return result;

package/dist/evaluation/evaluate_comparative.js

@@ -194,6 +194,8 @@ export async function evaluateComparative(experiments, options) {
                 comparativeExperimentId: comparativeExperiment.id,
                 sessionId: run?.session_id,
                 startTime: run?.start_time,
+                // `run` is the run being scored, so its trace is the right key.
+                traceId: run?.trace_id,
             });
         }
         return result;

package/dist/experimental/vercel/telemetry.cjs

@@ -2,8 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LangSmithTelemetry = LangSmithTelemetry;
 const run_trees_js_1 = require("../../run_trees.cjs");
-const traceable_js_1 = require("../../traceable.cjs");
 const env_js_1 = require("../../env.cjs");
+const constants_js_1 = require("../../singletons/constants.cjs");
+const traceable_js_1 = require("../../traceable.cjs");
+const env_js_2 = require("../../env.cjs");
 const utils_js_1 = require("./utils.cjs");
 const utils_js_2 = require("./utils.cjs");
 const types_js_1 = require("../../utils/types.cjs");
@@ -53,6 +55,17 @@ event, traceRawHttp) {
     }
     return (0, utils_js_1.convertMessageToTracedFormat)(output);
 }
+// Fail closed: a redactor that threw has redacted nothing, so the payload it
+// was handed must not be traced. LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS opts out.
+function droppedPayload(payload, hook, raw, e) {
+    if ((0, env_js_1.allowUnprocessedPayloads)()) {
+        console.error(`Error in ${hook}. Tracing unprocessed ${payload} because ` +
+            "LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS is set:", e);
+        return raw;
+    }
+    console.error(`Error in ${hook}. Dropping ${payload}:`, e);
+    return { [constants_js_1._PROCESSING_FAILED_KEY]: (0, constants_js_1._processingFailed)(payload, hook) };
+}
 function _hasNonzeroUsageMetadata(runTree) {
     const usageMetadata = runTree.extra?.metadata?.usage_metadata;
     if (!(0, types_js_1.isRecord)(usageMetadata))
@@ -146,7 +159,7 @@ function LangSmithTelemetry(config) {
     /** Per-generation state keyed by AI SDK `callId` (stable across nested calls). */
     const invocationsByCallId = new Map();
     const onStart = async (event) => {
-        if (!(0, env_js_1.isEnvTracingEnabled)(tracingEnabled))
+        if (!(0, env_js_2.isEnvTracingEnabled)(tracingEnabled))
             return;
         if (!("callId" in event) || typeof event.callId !== "string")
             return;
@@ -181,7 +194,7 @@ function LangSmithTelemetry(config) {
                     inputs = processInputs(inputs);
                 }
                 catch (e) {
-                    console.error("Error in processInputs, using raw inputs:", e);
+                    inputs = droppedPayload("inputs", "processInputs", inputs, e);
                 }
             }
         }
@@ -251,7 +264,7 @@ function LangSmithTelemetry(config) {
                     inputs = processChildLLMRunInputs(inputs);
                 }
                 catch (e) {
-                    console.error("Error in processChildLLMRunInputs, using raw inputs:", e);
+                    inputs = droppedPayload("inputs", "processChildLLMRunInputs", inputs, e);
                 }
             }
         }
@@ -395,7 +408,7 @@ function LangSmithTelemetry(config) {
                     outputs = processChildLLMRunOutputs(outputs);
                 }
                 catch (e) {
-                    console.error("Error in processChildLLMRunOutputs, using raw outputs:", e);
+                    outputs = droppedPayload("outputs", "processChildLLMRunOutputs", outputs, e);
                 }
             }
         }
@@ -503,7 +516,7 @@ function LangSmithTelemetry(config) {
                     outputs = processOutputs(outputs);
                 }
                 catch (e) {
-                    console.error("Error in processOutputs, using raw outputs:", e);
+                    outputs = droppedPayload("outputs", "processOutputs", outputs, e);
                 }
             }
         }

package/dist/experimental/vercel/telemetry.js

@@ -1,4 +1,6 @@
 import { isRunTree, RunTree } from "../../run_trees.js";
+import { allowUnprocessedPayloads } from "../../env.js";
+import { _PROCESSING_FAILED_KEY, _processingFailed, } from "../../singletons/constants.js";
 import { getCurrentRunTree, withRunTree } from "../../traceable.js";
 import { isEnvTracingEnabled } from "../../env.js";
 import { convertMessageToTracedFormat } from "./utils.js";
@@ -50,6 +52,17 @@ event, traceRawHttp) {
     }
     return convertMessageToTracedFormat(output);
 }
+// Fail closed: a redactor that threw has redacted nothing, so the payload it
+// was handed must not be traced. LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS opts out.
+function droppedPayload(payload, hook, raw, e) {
+    if (allowUnprocessedPayloads()) {
+        console.error(`Error in ${hook}. Tracing unprocessed ${payload} because ` +
+            "LANGSMITH_ALLOW_UNPROCESSED_PAYLOADS is set:", e);
+        return raw;
+    }
+    console.error(`Error in ${hook}. Dropping ${payload}:`, e);
+    return { [_PROCESSING_FAILED_KEY]: _processingFailed(payload, hook) };
+}
 function _hasNonzeroUsageMetadata(runTree) {
     const usageMetadata = runTree.extra?.metadata?.usage_metadata;
     if (!isRecord(usageMetadata))
@@ -178,7 +191,7 @@ export function LangSmithTelemetry(config) {
                     inputs = processInputs(inputs);
                 }
                 catch (e) {
-                    console.error("Error in processInputs, using raw inputs:", e);
+                    inputs = droppedPayload("inputs", "processInputs", inputs, e);
                 }
             }
         }
@@ -248,7 +261,7 @@ export function LangSmithTelemetry(config) {
                     inputs = processChildLLMRunInputs(inputs);
                 }
                 catch (e) {
-                    console.error("Error in processChildLLMRunInputs, using raw inputs:", e);
+                    inputs = droppedPayload("inputs", "processChildLLMRunInputs", inputs, e);
                 }
             }
         }
@@ -392,7 +405,7 @@ export function LangSmithTelemetry(config) {
                     outputs = processChildLLMRunOutputs(outputs);
                 }
                 catch (e) {
-                    console.error("Error in processChildLLMRunOutputs, using raw outputs:", e);
+                    outputs = droppedPayload("outputs", "processChildLLMRunOutputs", outputs, e);
                 }
             }
         }
@@ -500,7 +513,7 @@ export function LangSmithTelemetry(config) {
                     outputs = processOutputs(outputs);
                 }
                 catch (e) {
-                    console.error("Error in processOutputs, using raw outputs:", e);
+                    outputs = droppedPayload("outputs", "processOutputs", outputs, e);
                 }
             }
         }

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

package/dist/schemas.d.ts

@@ -288,6 +288,8 @@ export interface FeedbackBase {
     created_at: string;
     modified_at: string;
     run_id: string;
+    /** The trace the run belongs to. Equals run_id for a root run. */
+    trace_id?: string;
     key: string;
     score: ScoreType;
     value: ValueType;

package/dist/singletons/constants.cjs

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._REPLICA_TRACE_ROOTS_KEY = exports._LC_CHILD_RUN_END_PROMISES_KEY = exports._LC_CONTEXT_VARIABLES_KEY = void 0;
+exports._processingFailed = exports._PROCESSING_FAILED_PREFIX = exports._PROCESSING_FAILED_KEY = exports._REPLICA_TRACE_ROOTS_KEY = exports._LC_CHILD_RUN_END_PROMISES_KEY = exports._LC_CONTEXT_VARIABLES_KEY = void 0;
 exports._LC_CONTEXT_VARIABLES_KEY = Symbol.for("lc:context_variables");
 exports._LC_CHILD_RUN_END_PROMISES_KEY = Symbol.for("lc:child_run_end_promises");
 exports._REPLICA_TRACE_ROOTS_KEY = Symbol.for("langsmith:replica_trace_roots");
+// Marker for a payload whose redactor threw.
+// Takes the hook name, never the error: reading e.constructor runs user code.
+exports._PROCESSING_FAILED_KEY = "ls_error";
+exports._PROCESSING_FAILED_PREFIX = "Processing failed; ";
+const _processingFailed = (payload, hook) => `${exports._PROCESSING_FAILED_PREFIX}${payload} dropped (${hook})`;
+exports._processingFailed = _processingFailed;

package/dist/singletons/constants.d.ts

@@ -1,3 +1,6 @@
 export declare const _LC_CONTEXT_VARIABLES_KEY: unique symbol;
 export declare const _LC_CHILD_RUN_END_PROMISES_KEY: unique symbol;
 export declare const _REPLICA_TRACE_ROOTS_KEY: unique symbol;
+export declare const _PROCESSING_FAILED_KEY = "ls_error";
+export declare const _PROCESSING_FAILED_PREFIX = "Processing failed; ";
+export declare const _processingFailed: (payload: "inputs" | "outputs", hook: string) => string;

package/dist/singletons/constants.js

@@ -1,3 +1,8 @@
 export const _LC_CONTEXT_VARIABLES_KEY = Symbol.for("lc:context_variables");
 export const _LC_CHILD_RUN_END_PROMISES_KEY = Symbol.for("lc:child_run_end_promises");
 export const _REPLICA_TRACE_ROOTS_KEY = Symbol.for("langsmith:replica_trace_roots");
+// Marker for a payload whose redactor threw.
+// Takes the hook name, never the error: reading e.constructor runs user code.
+export const _PROCESSING_FAILED_KEY = "ls_error";
+export const _PROCESSING_FAILED_PREFIX = "Processing failed; ";
+export const _processingFailed = (payload, hook) => `${_PROCESSING_FAILED_PREFIX}${payload} dropped (${hook})`;