langsmith 0.8.12 → 0.10.0

package/dist/client.cjs

@@ -45,6 +45,7 @@ const env_js_1 = require("./utils/env.cjs");
 const index_js_1 = require("./index.cjs");
 const index_js_2 = require("./_openapi_client/index.cjs");
 const _uuid_js_1 = require("./utils/_uuid.cjs");
+const sampling_js_1 = require("./utils/sampling.cjs");
 const warn_js_1 = require("./utils/warn.cjs");
 const v2_migration_js_1 = require("./utils/v2_migration.cjs");
 const prompts_js_1 = require("./utils/prompts.cjs");
@@ -636,12 +637,6 @@ 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,
@@ -1074,14 +1069,23 @@ 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/${index_js_1.__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
@@ -1133,25 +1137,25 @@ 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 index_js_2.Langsmith({
-            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) {
@@ -1379,53 +1383,14 @@ class Client {
         }
     }
     // Allows mocking for tests
-    _shouldSample() {
-        if (this.tracingSampleRate === undefined) {
-            return true;
-        }
-        return Math.random() < this.tracingSampleRate;
+    _shouldSample(identifier) {
+        return (0, sampling_js_1.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();
@@ -1748,7 +1713,7 @@ 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 ((0, v2_migration_js_1.getQueryBackend)(serverInfo.instance_flags) === v2_migration_js_1.QueryBackend.SMITHDB_ONLY) {
             throw new Error(`sessionId must be provided when creating feedback for a run: this ` +
@@ -2217,7 +2182,7 @@ 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 &&
@@ -2275,11 +2240,11 @@ 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 }) {
         (0, warn_js_1.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 });
     }
     /**
@@ -2298,11 +2263,11 @@ 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, }) {
         (0, warn_js_1.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) {
@@ -2371,7 +2336,7 @@ 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.
@@ -2455,7 +2420,7 @@ class Client {
     async *listRuns(props) {
         (0, warn_js_1.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);
     }
     /**
@@ -2600,11 +2565,11 @@ 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) {
         (0, warn_js_1.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");
@@ -2624,11 +2589,11 @@ 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) {
         (0, warn_js_1.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");
@@ -2778,11 +2743,11 @@ 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 } = {}) {
         (0, warn_js_1.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(),
@@ -2806,11 +2771,11 @@ 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) {
         (0, warn_js_1.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" });
         (0, _uuid_js_1.assertUuid)(runId);
         await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/runs/${runId}/share`, {
@@ -2823,11 +2788,11 @@ 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) {
         (0, warn_js_1.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",
         });
@@ -2848,11 +2813,11 @@ 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, } = {}) {
         (0, warn_js_1.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",
         });
@@ -3926,7 +3891,7 @@ 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) {
@@ -3954,6 +3919,7 @@ class Client {
         const feedback = {
             id: feedbackId ?? uuid.v7(),
             run_id: runId,
+            trace_id: traceId,
             key,
             score: _formatFeedbackScore(score),
             value,
@@ -3966,6 +3932,10 @@ 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 () => {
@@ -4187,6 +4157,9 @@ 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];
@@ -4452,7 +4425,7 @@ 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.
@@ -4485,7 +4458,7 @@ class Client {
         else {
             (0, warn_js_1.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/client.d.ts

@@ -348,6 +348,8 @@ export type CreateFeedbackOptions = {
     feedbackConfig?: FeedbackConfig;
     sourceRunId?: string;
     feedbackId?: string;
+    /** The trace the run belongs to. Omit for a root run. */
+    traceId?: string;
     comparativeExperimentId?: string;
     /**
      * The run's start time, ISO string or epoch ms. Better performance if provided.
@@ -363,7 +365,7 @@ export type CreateFeedbackLegacyOptions = Omit<CreateFeedbackOptions, "key"> & {
     /**
      * The session (project) ID of the run. Required for run-level feedback;
      * omitting it is deprecated. See
-     * https://docs.langchain.com/langsmith/smithdb-sdk-migration#feedback-create
+     * https://docs.langchain.com/langsmith/smithdb-sdk-migration-feedback#feedback-create
      */
     sessionId?: string;
     /** The project (or experiment) to provide feedback on, for session-level feedback. */
@@ -495,7 +497,6 @@ export declare class Client implements LangSmithTracingClientInterface {
     private anonymizer?;
     private omitTracedRuntimeInfo?;
     private tracingSampleRate?;
-    private filteredPostUuids;
     private autoBatchTracing;
     private autoBatchQueue;
     private autoBatchTimeout;
@@ -579,13 +580,14 @@ export declare class Client implements LangSmithTracingClientInterface {
     private get _callerHeaders();
     private get _mergedHeaders();
     /**
-     * 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.
      */
-    private get _openAPIAuth();
+    private get _openAPIClientOptions();
     /**
      * Get or set custom headers for the client.
      * Custom headers are merged with default headers (User-Agent, x-api-key, x-tenant-id).
@@ -730,11 +732,11 @@ export declare class Client implements LangSmithTracingClientInterface {
         apiUrl?: string;
         workspaceId?: string;
     }): Promise<void>;
-    /** @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. */
     readRun(runId: string, { loadChildRuns }?: {
         loadChildRuns: boolean;
     }): Promise<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. */
     getRunUrl({ runId, run, projectOpts, }: {
         runId?: string;
         run?: Run;
@@ -743,7 +745,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     private _loadChildRuns;
     /**
      * 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.
@@ -826,9 +828,9 @@ export declare class Client implements LangSmithTracingClientInterface {
      */
     listRuns(props: ListRunsParams): AsyncIterable<Run>;
     listGroupRuns(props: GroupRunsParams): AsyncIterable<Thread>;
-    /** @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. */
     readThread(props: ReadThreadParams): AsyncIterable<Run>;
-    /** @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. */
     listThreads(props: ListThreadsParams): Promise<ListThreadsItem[]>;
     getRunStats({ id, trace, parentRun, runType, projectNames, projectIds, referenceExampleIds, startTime, endTime, error, query, filter, traceFilter, treeFilter, isRoot, dataSourceType, }: {
         id?: string[];
@@ -848,15 +850,15 @@ export declare class Client implements LangSmithTracingClientInterface {
         isRoot?: boolean;
         dataSourceType?: string;
     }): Promise<any>;
-    /** @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. */
     shareRun(runId: string, { shareId }?: {
         shareId?: string;
     }): Promise<string>;
-    /** @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. */
     unshareRun(runId: string): Promise<void>;
-    /** @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. */
     readRunSharedLink(runId: string): Promise<string | undefined>;
-    /** @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. */
     listSharedRuns(shareToken: string, { runIds, }?: {
         runIds?: string[];
     }): Promise<Run[]>;
@@ -1251,7 +1253,7 @@ export declare class Client implements LangSmithTracingClientInterface {
      *   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.