langsmith 0.8.0 → 0.8.2

package/dist/_openapi_client/resources/threads.d.ts

@@ -10,7 +10,7 @@ export declare class Threads extends APIResource {
      * @example
      * ```ts
      * // Automatically fetches more pages as needed.
-     * for await (const threadTraceListItem of client.threads.listTraces(
+     * for await (const threadTrace of client.threads.listTraces(
      *   'thread_id',
      *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
      * )) {
@@ -18,7 +18,7 @@ export declare class Threads extends APIResource {
      * }
      * ```
      */
-    listTraces(threadID: string, query: ThreadListTracesParams, options?: RequestOptions): PagePromise<ThreadTraceListItemsItemsCursorGetPagination, ThreadTraceListItem>;
+    listTraces(threadID: string, query: ThreadListTracesParams, options?: RequestOptions): PagePromise<ThreadTracesItemsCursorGetPagination, ThreadTrace>;
     /**
      * **Alpha:** The request and response contract may change; Query threads within a
      * project (session), with cursor-based pagination. Returns threads matching the
@@ -27,12 +27,12 @@ export declare class Threads extends APIResource {
      * @example
      * ```ts
      * // Automatically fetches more pages as needed.
-     * for await (const threadListItem of client.threads.query()) {
+     * for await (const thread of client.threads.query()) {
      *   // ...
      * }
      * ```
      */
-    query(body: ThreadQueryParams, options?: RequestOptions): PagePromise<ThreadListItemsItemsCursorPostPagination, ThreadListItem>;
+    query(body: ThreadQueryParams, options?: RequestOptions): PagePromise<ThreadsItemsCursorPostPagination, Thread>;
     /**
      * **Alpha:** The request and response contract may change; Compute aggregate stats
      * for a single thread (turn count, latency percentiles, token/cost sums, and
@@ -40,17 +40,20 @@ export declare class Threads extends APIResource {
      *
      * @example
      * ```ts
-     * const response = await client.threads.stats('thread_id', {
-     *   selects: ['TURNS'],
-     *   session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-     * });
+     * const threadStats = await client.threads.stats(
+     *   'thread_id',
+     *   {
+     *     selects: ['TURNS'],
+     *     session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   },
+     * );
      * ```
      */
-    stats(threadID: string, query: ThreadStatsParams, options?: RequestOptions): APIPromise<ThreadStatsResponse>;
+    stats(threadID: string, query: ThreadStatsParams, options?: RequestOptions): APIPromise<ThreadStats>;
 }
-export type ThreadTraceListItemsItemsCursorGetPagination = ItemsCursorGetPagination<ThreadTraceListItem>;
-export type ThreadListItemsItemsCursorPostPagination = ItemsCursorPostPagination<ThreadListItem>;
-export interface ThreadListItem {
+export type ThreadTracesItemsCursorGetPagination = ItemsCursorGetPagination<ThreadTrace>;
+export type ThreadsItemsCursorPostPagination = ItemsCursorPostPagination<Thread>;
+export interface Thread {
     /**
      * `count` is how many root traces (conversation turns) fall in this thread for the
      * query time range.
@@ -61,7 +64,7 @@ export interface ThreadListItem {
      * by feedback key; shape matches `feedback_stats` on a single run.
      */
     feedback_stats?: {
-        [key: string]: ThreadListItem.FeedbackStats;
+        [key: string]: Thread.FeedbackStats;
     };
     /**
      * `first_inputs` is a truncated preview of inputs from the earliest trace in the
@@ -156,7 +159,7 @@ export interface ThreadListItem {
      */
     trace_id?: string;
 }
-export declare namespace ThreadListItem {
+export declare namespace Thread {
     interface FeedbackStats {
         /**
          * `avg` is the arithmetic mean of numeric feedback scores for this key on the run,
@@ -222,172 +225,7 @@ export declare namespace ThreadListItem {
         };
     }
 }
-export interface ThreadTraceListItem {
-    /**
-     * `completion_cost` is the estimated USD cost for the completion. Omitted unless
-     * included in `selects`.
-     */
-    completion_cost?: number;
-    /**
-     * `completion_cost_details` is the USD cost breakdown for completion-side
-     * categories; per-category values are under `raw`. Omitted unless included in
-     * `selects`.
-     */
-    completion_cost_details?: ThreadTraceListItem.CompletionCostDetails;
-    /**
-     * `completion_token_details` is the completion-side token breakdown by category;
-     * per-category counts are under `raw`. Omitted unless included in `selects`.
-     */
-    completion_token_details?: ThreadTraceListItem.CompletionTokenDetails;
-    /**
-     * `completion_tokens` is the completion-side token count. Omitted unless included
-     * in `selects`.
-     */
-    completion_tokens?: number;
-    /**
-     * `end_time` is when the root run ended (RFC3339 date-time). JSON null if the run
-     * is still in progress. Omitted unless included in `selects`.
-     */
-    end_time?: string;
-    /**
-     * `error_preview` is a short error summary when the run failed. Omitted unless
-     * included in `selects`.
-     */
-    error_preview?: string;
-    /**
-     * `first_token_time` is when the first output token was produced (RFC3339
-     * date-time), for streamed runs when that metadata exists. Omitted unless included
-     * in `selects`.
-     */
-    first_token_time?: string;
-    /**
-     * `inputs_preview` is a truncated text preview of inputs. Omitted unless included
-     * in `selects`.
-     */
-    inputs_preview?: string;
-    /**
-     * `latency` is wall-clock duration from start to end in seconds. Omitted unless
-     * included in `selects`.
-     */
-    latency?: number;
-    /**
-     * `name` is a human-readable label for the root run (for example the model name,
-     * function name, or step name chosen when the run was traced). Omitted unless
-     * included in `selects`.
-     */
-    name?: string;
-    /**
-     * `op` is a numeric code identifying the root run's `run_type` (for example LLM
-     * vs. tool vs. chain). Encoded as a number for compatibility with legacy clients;
-     * prefer the string `run_type` on `RunResponse` when available. Omitted unless
-     * included in `selects`.
-     */
-    op?: number;
-    /**
-     * `outputs_preview` is a truncated text preview of outputs. Omitted unless
-     * included in `selects`.
-     */
-    outputs_preview?: string;
-    /**
-     * `prompt_cost` is the estimated USD cost for the prompt. Omitted unless included
-     * in `selects`.
-     */
-    prompt_cost?: number;
-    /**
-     * `prompt_cost_details` is the USD cost breakdown for prompt-side categories;
-     * per-category values are under `raw`. Omitted unless included in `selects`.
-     */
-    prompt_cost_details?: ThreadTraceListItem.PromptCostDetails;
-    /**
-     * `prompt_token_details` is the prompt-side token breakdown by category;
-     * per-category counts are under nested `raw`. Omitted unless included in
-     * `selects`.
-     */
-    prompt_token_details?: ThreadTraceListItem.PromptTokenDetails;
-    /**
-     * `prompt_tokens` is the prompt-side token count. Omitted unless included in
-     * `selects`.
-     */
-    prompt_tokens?: number;
-    /**
-     * `start_time` is when the trace started (RFC3339 date-time). Omitted unless
-     * included in `selects`.
-     */
-    start_time?: string;
-    /**
-     * `thread_id` is the conversation thread UUID that contains this trace. Matches
-     * the `thread_id` path parameter of the request. Omitted unless included in
-     * `selects`.
-     */
-    thread_id?: string;
-    /**
-     * `total_cost` is the estimated total USD cost for the root run. Omitted unless
-     * included in `selects`.
-     */
-    total_cost?: number;
-    /**
-     * `total_tokens` is the total token count (prompt plus completion). Omitted unless
-     * included in `selects`.
-     */
-    total_tokens?: number;
-    /**
-     * `trace_id` is the UUID of this trace (the root run). Always present.
-     */
-    trace_id?: string;
-}
-export declare namespace ThreadTraceListItem {
-    /**
-     * `completion_cost_details` is the USD cost breakdown for completion-side
-     * categories; per-category values are under `raw`. Omitted unless included in
-     * `selects`.
-     */
-    interface CompletionCostDetails {
-        /**
-         * `raw` maps each category name to its estimated USD cost.
-         */
-        raw?: {
-            [key: string]: number;
-        };
-    }
-    /**
-     * `completion_token_details` is the completion-side token breakdown by category;
-     * per-category counts are under `raw`. Omitted unless included in `selects`.
-     */
-    interface CompletionTokenDetails {
-        /**
-         * `raw` maps each category name to its completion-token count.
-         */
-        raw?: {
-            [key: string]: number;
-        };
-    }
-    /**
-     * `prompt_cost_details` is the USD cost breakdown for prompt-side categories;
-     * per-category values are under `raw`. Omitted unless included in `selects`.
-     */
-    interface PromptCostDetails {
-        /**
-         * `raw` maps each category name to its estimated USD cost.
-         */
-        raw?: {
-            [key: string]: number;
-        };
-    }
-    /**
-     * `prompt_token_details` is the prompt-side token breakdown by category;
-     * per-category counts are under nested `raw`. Omitted unless included in
-     * `selects`.
-     */
-    interface PromptTokenDetails {
-        /**
-         * `raw` maps each category name to its prompt-token count.
-         */
-        raw?: {
-            [key: string]: number;
-        };
-    }
-}
-export interface ThreadStatsResponse {
+export interface ThreadStats {
     /**
      * `completion_cost` is the sum of per-trace completion costs across the thread, in
      * USD. Populated when `COMPLETION_COST` is selected.
@@ -397,13 +235,13 @@ export interface ThreadStatsResponse {
      * `completion_cost_details` is the per-sub-category sum of completion cost details
      * across the thread. Populated when `COMPLETION_COST_DETAILS` is selected.
      */
-    completion_cost_details?: ThreadStatsResponse.CompletionCostDetails;
+    completion_cost_details?: ThreadStats.CompletionCostDetails;
     /**
      * `completion_token_details` is the per-sub-category sum of completion token
      * details across the thread. Populated when `COMPLETION_TOKEN_DETAILS` is
      * selected.
      */
-    completion_token_details?: ThreadStatsResponse.CompletionTokenDetails;
+    completion_token_details?: ThreadStats.CompletionTokenDetails;
     /**
      * `completion_tokens` is the sum of per-trace completion token counts across the
      * thread. Populated when `COMPLETION_TOKENS` is selected.
@@ -414,7 +252,7 @@ export interface ThreadStatsResponse {
      * by feedback key. Populated when `FEEDBACK_STATS` is selected.
      */
     feedback_stats?: {
-        [key: string]: ThreadStatsResponse.FeedbackStats;
+        [key: string]: ThreadStats.FeedbackStats;
     };
     /**
      * `first_start_time` is the earliest trace start time in the thread (RFC3339).
@@ -450,12 +288,12 @@ export interface ThreadStatsResponse {
      * `prompt_cost_details` is the per-sub-category sum of prompt cost details across
      * the thread. Populated when `PROMPT_COST_DETAILS` is selected.
      */
-    prompt_cost_details?: ThreadStatsResponse.PromptCostDetails;
+    prompt_cost_details?: ThreadStats.PromptCostDetails;
     /**
      * `prompt_token_details` is the per-sub-category sum of prompt token details
      * across the thread. Populated when `PROMPT_TOKEN_DETAILS` is selected.
      */
-    prompt_token_details?: ThreadStatsResponse.PromptTokenDetails;
+    prompt_token_details?: ThreadStats.PromptTokenDetails;
     /**
      * `prompt_tokens` is the sum of per-trace prompt token counts across the thread.
      * Populated when `PROMPT_TOKENS` is selected.
@@ -477,7 +315,7 @@ export interface ThreadStatsResponse {
      */
     turns?: number;
 }
-export declare namespace ThreadStatsResponse {
+export declare namespace ThreadStats {
     /**
      * `completion_cost_details` is the per-sub-category sum of completion cost details
      * across the thread. Populated when `COMPLETION_COST_DETAILS` is selected.
@@ -592,6 +430,171 @@ export declare namespace ThreadStatsResponse {
         };
     }
 }
+export interface ThreadTrace {
+    /**
+     * `completion_cost` is the estimated USD cost for the completion. Omitted unless
+     * included in `selects`.
+     */
+    completion_cost?: number;
+    /**
+     * `completion_cost_details` is the USD cost breakdown for completion-side
+     * categories; per-category values are under `raw`. Omitted unless included in
+     * `selects`.
+     */
+    completion_cost_details?: ThreadTrace.CompletionCostDetails;
+    /**
+     * `completion_token_details` is the completion-side token breakdown by category;
+     * per-category counts are under `raw`. Omitted unless included in `selects`.
+     */
+    completion_token_details?: ThreadTrace.CompletionTokenDetails;
+    /**
+     * `completion_tokens` is the completion-side token count. Omitted unless included
+     * in `selects`.
+     */
+    completion_tokens?: number;
+    /**
+     * `end_time` is when the root run ended (RFC3339 date-time). JSON null if the run
+     * is still in progress. Omitted unless included in `selects`.
+     */
+    end_time?: string;
+    /**
+     * `error_preview` is a short error summary when the run failed. Omitted unless
+     * included in `selects`.
+     */
+    error_preview?: string;
+    /**
+     * `first_token_time` is when the first output token was produced (RFC3339
+     * date-time), for streamed runs when that metadata exists. Omitted unless included
+     * in `selects`.
+     */
+    first_token_time?: string;
+    /**
+     * `inputs_preview` is a truncated text preview of inputs. Omitted unless included
+     * in `selects`.
+     */
+    inputs_preview?: string;
+    /**
+     * `latency` is wall-clock duration from start to end in seconds. Omitted unless
+     * included in `selects`.
+     */
+    latency?: number;
+    /**
+     * `name` is a human-readable label for the root run (for example the model name,
+     * function name, or step name chosen when the run was traced). Omitted unless
+     * included in `selects`.
+     */
+    name?: string;
+    /**
+     * `op` is a numeric code identifying the root run's `run_type` (for example LLM
+     * vs. tool vs. chain). Encoded as a number for compatibility with legacy clients;
+     * prefer the string `run_type` on `RunResponse` when available. Omitted unless
+     * included in `selects`.
+     */
+    op?: number;
+    /**
+     * `outputs_preview` is a truncated text preview of outputs. Omitted unless
+     * included in `selects`.
+     */
+    outputs_preview?: string;
+    /**
+     * `prompt_cost` is the estimated USD cost for the prompt. Omitted unless included
+     * in `selects`.
+     */
+    prompt_cost?: number;
+    /**
+     * `prompt_cost_details` is the USD cost breakdown for prompt-side categories;
+     * per-category values are under `raw`. Omitted unless included in `selects`.
+     */
+    prompt_cost_details?: ThreadTrace.PromptCostDetails;
+    /**
+     * `prompt_token_details` is the prompt-side token breakdown by category;
+     * per-category counts are under nested `raw`. Omitted unless included in
+     * `selects`.
+     */
+    prompt_token_details?: ThreadTrace.PromptTokenDetails;
+    /**
+     * `prompt_tokens` is the prompt-side token count. Omitted unless included in
+     * `selects`.
+     */
+    prompt_tokens?: number;
+    /**
+     * `start_time` is when the trace started (RFC3339 date-time). Omitted unless
+     * included in `selects`.
+     */
+    start_time?: string;
+    /**
+     * `thread_id` is the conversation thread UUID that contains this trace. Matches
+     * the `thread_id` path parameter of the request. Omitted unless included in
+     * `selects`.
+     */
+    thread_id?: string;
+    /**
+     * `total_cost` is the estimated total USD cost for the root run. Omitted unless
+     * included in `selects`.
+     */
+    total_cost?: number;
+    /**
+     * `total_tokens` is the total token count (prompt plus completion). Omitted unless
+     * included in `selects`.
+     */
+    total_tokens?: number;
+    /**
+     * `trace_id` is the UUID of this trace (the root run). Always present.
+     */
+    trace_id?: string;
+}
+export declare namespace ThreadTrace {
+    /**
+     * `completion_cost_details` is the USD cost breakdown for completion-side
+     * categories; per-category values are under `raw`. Omitted unless included in
+     * `selects`.
+     */
+    interface CompletionCostDetails {
+        /**
+         * `raw` maps each category name to its estimated USD cost.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
+    /**
+     * `completion_token_details` is the completion-side token breakdown by category;
+     * per-category counts are under `raw`. Omitted unless included in `selects`.
+     */
+    interface CompletionTokenDetails {
+        /**
+         * `raw` maps each category name to its completion-token count.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
+    /**
+     * `prompt_cost_details` is the USD cost breakdown for prompt-side categories;
+     * per-category values are under `raw`. Omitted unless included in `selects`.
+     */
+    interface PromptCostDetails {
+        /**
+         * `raw` maps each category name to its estimated USD cost.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
+    /**
+     * `prompt_token_details` is the prompt-side token breakdown by category;
+     * per-category counts are under nested `raw`. Omitted unless included in
+     * `selects`.
+     */
+    interface PromptTokenDetails {
+        /**
+         * `raw` maps each category name to its prompt-token count.
+         */
+        raw?: {
+            [key: string]: number;
+        };
+    }
+}
 export interface ThreadListTracesParams extends ItemsCursorGetPaginationParams {
     /**
      * `project_id` is the tracing project UUID (required).
@@ -624,12 +627,12 @@ export interface ThreadQueryParams extends ItemsCursorPostPaginationParams {
     filter?: string;
     /**
      * `max_start_time` is the exclusive upper bound on thread activity (RFC3339
-     * date-time).
+     * date-time). Defaults to now (UTC) when omitted.
      */
     max_start_time?: string;
     /**
      * `min_start_time` is the inclusive lower bound on thread activity (RFC3339
-     * date-time).
+     * date-time). Defaults to 1 day before now (UTC) when omitted.
      */
     min_start_time?: string;
     /**
@@ -648,7 +651,15 @@ export interface ThreadStatsParams {
      * `session_id` is the tracing project (session) UUID (required).
      */
     session_id: string;
+    /**
+     * `filter` narrows which of the thread's traces are aggregated, using a LangSmith
+     * filter expression. For example: lt(start_time, "2025-01-01T00:00:00Z") or
+     * eq(trace_id, "0190a1b2-c3d4-7ef0-a5b6-6ea3a82e9328"). See
+     * https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language
+     * for syntax.
+     */
+    filter?: string;
 }
 export declare namespace Threads {
-    export { type ThreadListItem as ThreadListItem, type ThreadTraceListItem as ThreadTraceListItem, type ThreadStatsResponse as ThreadStatsResponse, type ThreadTraceListItemsItemsCursorGetPagination as ThreadTraceListItemsItemsCursorGetPagination, type ThreadListItemsItemsCursorPostPagination as ThreadListItemsItemsCursorPostPagination, type ThreadListTracesParams as ThreadListTracesParams, type ThreadQueryParams as ThreadQueryParams, type ThreadStatsParams as ThreadStatsParams, };
+    export { type Thread as Thread, type ThreadStats as ThreadStats, type ThreadTrace as ThreadTrace, type ThreadTracesItemsCursorGetPagination as ThreadTracesItemsCursorGetPagination, type ThreadsItemsCursorPostPagination as ThreadsItemsCursorPostPagination, type ThreadListTracesParams as ThreadListTracesParams, type ThreadQueryParams as ThreadQueryParams, type ThreadStatsParams as ThreadStatsParams, };
 }

package/dist/_openapi_client/resources/threads.js

@@ -11,7 +11,7 @@ export class Threads extends APIResource {
      * @example
      * ```ts
      * // Automatically fetches more pages as needed.
-     * for await (const threadTraceListItem of client.threads.listTraces(
+     * for await (const threadTrace of client.threads.listTraces(
      *   'thread_id',
      *   { project_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
      * )) {
@@ -30,7 +30,7 @@ export class Threads extends APIResource {
      * @example
      * ```ts
      * // Automatically fetches more pages as needed.
-     * for await (const threadListItem of client.threads.query()) {
+     * for await (const thread of client.threads.query()) {
      *   // ...
      * }
      * ```
@@ -49,10 +49,13 @@ export class Threads extends APIResource {
      *
      * @example
      * ```ts
-     * const response = await client.threads.stats('thread_id', {
-     *   selects: ['TURNS'],
-     *   session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-     * });
+     * const threadStats = await client.threads.stats(
+     *   'thread_id',
+     *   {
+     *     selects: ['TURNS'],
+     *     session_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   },
+     * );
      * ```
      */
     stats(threadID, query, options) {

package/dist/client.cjs

@@ -238,6 +238,7 @@ class AutoBatchQueue {
             otelContext: item.otelContext,
             apiKey: item.apiKey,
             apiUrl: item.apiUrl,
+            workspaceId: item.workspaceId,
             // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
             itemPromiseResolve: itemPromiseResolve,
             itemPromise,
@@ -278,6 +279,7 @@ class AutoBatchQueue {
                 otelContext: it.otelContext,
                 apiKey: it.apiKey,
                 apiUrl: it.apiUrl,
+                workspaceId: it.workspaceId,
                 size: it.size,
             })),
             () => popped.forEach((it) => it.itemPromiseResolve()),
@@ -1256,8 +1258,13 @@ class Client {
             const batchesByDestination = batch.reduce((acc, item) => {
                 const apiUrl = item.apiUrl ?? this.apiUrl;
                 const apiKey = item.apiKey ?? this.apiKey;
-                const isDefault = item.apiKey === this.apiKey && item.apiUrl === this.apiUrl;
-                const batchKey = isDefault ? "default" : `${apiUrl}|${apiKey}`;
+                const workspaceId = item.workspaceId ?? this.workspaceId;
+                const isDefault = item.apiKey === this.apiKey &&
+                    item.apiUrl === this.apiUrl &&
+                    item.workspaceId === this.workspaceId;
+                const batchKey = isDefault
+                    ? "default"
+                    : `${apiUrl}|${apiKey}|${workspaceId ?? ""}`;
                 if (!acc[batchKey]) {
                     acc[batchKey] = [];
                 }
@@ -1266,9 +1273,13 @@ class Client {
             }, {});
             const batchPromises = [];
             for (const [batchKey, batch] of Object.entries(batchesByDestination)) {
+                const isDefault = batchKey === "default";
+                const parts = isDefault ? [] : batchKey.split("|");
+                const workspaceIdPart = parts[2];
                 const batchPromise = this._processBatch(batch, {
-                    apiUrl: batchKey === "default" ? undefined : batchKey.split("|")[0],
-                    apiKey: batchKey === "default" ? undefined : batchKey.split("|")[1],
+                    apiUrl: isDefault ? undefined : parts[0],
+                    apiKey: isDefault ? undefined : parts[1],
+                    workspaceId: isDefault || !workspaceIdPart ? undefined : workspaceIdPart,
                 });
                 batchPromises.push(batchPromise);
             }
@@ -1548,6 +1559,7 @@ class Client {
                 otelContext,
                 apiKey: options?.apiKey,
                 apiUrl: options?.apiUrl,
+                workspaceId: options?.workspaceId,
             }).catch(console.error);
             return;
         }
@@ -1642,6 +1654,9 @@ class Client {
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }
+        if (options?.workspaceId !== undefined) {
+            headers["x-tenant-id"] = options.workspaceId;
+        }
         await this.batchIngestCaller.callWithOptions({ sizeBytes: options?.sizeBytes }, async () => {
             const res = await this._fetch(`${options?.apiUrl ?? this.apiUrl}/runs/batch`, {
                 method: "POST",
@@ -1865,6 +1880,9 @@ class Client {
                 if (options?.apiKey !== undefined) {
                     headers["x-api-key"] = options.apiKey;
                 }
+                if (options?.workspaceId !== undefined) {
+                    headers["x-tenant-id"] = options.workspaceId;
+                }
                 let transformedBody = body;
                 if (options?.useGzip &&
                     typeof body === "object" &&
@@ -1967,6 +1985,7 @@ class Client {
                     otelContext,
                     apiKey: options?.apiKey,
                     apiUrl: options?.apiUrl,
+                    workspaceId: options?.workspaceId,
                 }).catch(console.error);
                 return;
             }
@@ -1977,6 +1996,7 @@ class Client {
                     otelContext,
                     apiKey: options?.apiKey,
                     apiUrl: options?.apiUrl,
+                    workspaceId: options?.workspaceId,
                 }).catch(console.error);
             }
             return;
@@ -4085,13 +4105,48 @@ class Client {
     }
     /**
      * Add runs to an annotation queue with the specified queue ID.
+     *
+     * The second argument is either:
+     * - `RunKey[]` (preferred): each entry carries the run's full lookup key, so
+     *   it can be located directly without a scan. Required for workspaces served
+     *   by SmithDB; routes to `POST /runs/by-key`.
+     * - `string[]`: a plain list of run IDs. This path will be deprecated in a
+     *   future release; prefer the key form. Routes to `POST /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.
+     *
      * @param queueId - The ID of the annotation queue
-     * @param runIds - The IDs of the runs to be added to the annotation queue
+     * @param runs - Either a list of run IDs (deprecated) or a list of run keys.
      */
-    async addRunsToAnnotationQueue(queueId, runIds) {
-        const body = JSON.stringify(runIds.map((id, i) => (0, _uuid_js_1.assertUuid)(id, `runIds[${i}]`).toString()));
+    async addRunsToAnnotationQueue(queueId, runs) {
+        const base = `${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.assertUuid)(queueId, "queueId")}/runs`;
+        // All strings (including empty) -> legacy /runs; otherwise treat as run keys.
+        const allStrings = runs.every((r) => typeof r === "string");
+        let url;
+        let body;
+        if (!allStrings) {
+            url = `${base}/by-key`;
+            body = JSON.stringify(runs.map((run, i) => {
+                const serialized = {
+                    run_id: (0, _uuid_js_1.assertUuid)(run.runId, `runs[${i}].runId`).toString(),
+                    session_id: (0, _uuid_js_1.assertUuid)(run.sessionId, `runs[${i}].sessionId`).toString(),
+                    start_time: typeof run.startTime === "string"
+                        ? run.startTime
+                        : new Date(run.startTime).toISOString(),
+                };
+                if (run.sourceProposedExampleId != null) {
+                    serialized.source_proposed_example_id = (0, _uuid_js_1.assertUuid)(run.sourceProposedExampleId, `runs[${i}].sourceProposedExampleId`).toString();
+                }
+                return serialized;
+            }));
+        }
+        else {
+            url = base;
+            body = JSON.stringify(runs.map((id, i) => (0, _uuid_js_1.assertUuid)(id, `runs[${i}]`).toString()));
+        }
         await this.caller.call(async () => {
-            const res = await this._fetch(`${this.apiUrl}/annotation-queues/${(0, _uuid_js_1.assertUuid)(queueId, "queueId")}/runs`, {
+            const res = await this._fetch(url, {
                 method: "POST",
                 headers: {
                     ...this._mergedHeaders,