langsmith 0.3.73 → 0.3.75

package/dist/client.cjs

@@ -1558,6 +1558,9 @@ class Client {
             is_root: isRoot,
             order,
         };
+        if (body.select.includes("child_run_ids")) {
+            (0, warn_js_1.warnOnce)("Deprecated: 'child_run_ids' in the listRuns select parameter is deprecated and will be removed in a future version.");
+        }
         let runsYielded = 0;
         for await (const runs of this._getCursorPaginatedList("/runs/query", body)) {
             if (limit) {

package/dist/client.d.ts

@@ -131,6 +131,9 @@ interface ListRunsParams {
     treeFilter?: string;
     /**
      * The values to include in the response.
+     *
+     * Note: The 'child_run_ids' value is deprecated and will be removed in a future version.
+     * This field is no longer populated by the API.
      */
     select?: string[];
 }

package/dist/client.js

@@ -1520,6 +1520,9 @@ export class Client {
             is_root: isRoot,
             order,
         };
+        if (body.select.includes("child_run_ids")) {
+            warnOnce("Deprecated: 'child_run_ids' in the listRuns select parameter is deprecated and will be removed in a future version.");
+        }
         let runsYielded = 0;
         for await (const runs of this._getCursorPaginatedList("/runs/query", body)) {
             if (limit) {

package/dist/index.cjs

@@ -10,4 +10,4 @@ Object.defineProperty(exports, "overrideFetchImplementation", { enumerable: true
 var project_js_1 = require("./utils/project.cjs");
 Object.defineProperty(exports, "getDefaultProjectName", { enumerable: true, get: function () { return project_js_1.getDefaultProjectName; } });
 // Update using yarn bump-version
-exports.__version__ = "0.3.73";
+exports.__version__ = "0.3.75";

package/dist/index.d.ts

@@ -3,4 +3,4 @@ export type { Dataset, Example, TracerSession, Run, Feedback, RetrieverOutput, }
 export { RunTree, type RunTreeConfig } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
-export declare const __version__ = "0.3.73";
+export declare const __version__ = "0.3.75";

package/dist/index.js

@@ -3,4 +3,4 @@ export { RunTree } from "./run_trees.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 // Update using yarn bump-version
-export const __version__ = "0.3.73";
+export const __version__ = "0.3.75";

package/dist/traceable.cjs

@@ -91,7 +91,9 @@ const runInputsToMap = (rawInputs) => {
     }
     return inputs;
 };
-const handleRunInputs = (inputs, processInputs) => {
+const handleRunInputs = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+inputs, processInputs) => {
     try {
         return processInputs(inputs);
     }
@@ -147,6 +149,7 @@ function isAsyncFn(fn) {
 // Note: This mutates the run tree
 async function handleRunOutputs(params) {
     const { runTree, rawOutputs, processOutputsFn, on_end, postRunPromise, excludeInputs, } = params;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     let outputs;
     if ((0, asserts_js_1.isKVMap)(rawOutputs)) {
         outputs = { ...rawOutputs };

package/dist/traceable.d.ts

@@ -2,6 +2,18 @@ import { RunTreeConfig } from "./run_trees.js";
 import { Attachments, InvocationParamsSchema, KVMap } from "./schemas.js";
 import type { TraceableFunction } from "./singletons/types.js";
 import { OTELTracer } from "./experimental/otel/types.js";
+export type ProcessInputs<Args extends unknown[]> = Args extends [] ? Record<string, never> : Args extends [infer Input] ? Input extends KVMap ? Input extends Iterable<infer Item> | AsyncIterable<infer Item> ? {
+    input: Array<Item>;
+} : Input : {
+    input: Input;
+} : {
+    args: Args;
+};
+export type ProcessOutputs<ReturnValue> = ReturnValue extends KVMap ? ReturnValue extends Iterable<infer Item> | AsyncIterable<infer Item> ? {
+    outputs: Array<Item>;
+} : ReturnValue : {
+    outputs: ReturnValue;
+};
 export type TraceableConfig<Func extends (...args: any[]) => any> = Partial<Omit<RunTreeConfig, "inputs" | "outputs">> & {
     aggregator?: (args: any[]) => any;
     argsConfigPath?: [number] | [number, string];
@@ -27,19 +39,31 @@ export type TraceableConfig<Func extends (...args: any[]) => any> = Partial<Omit
      * This function should NOT mutate the inputs.
      * `processInputs` is not inherited by nested traceable functions.
      *
+     * The input to this function is determined as follows based on the
+     * arguments passed to the wrapped function:
+     * - If called with one argument that is an object, it will be the unchanged argument
+     * - If called with one argument that is not an object, it will be `{ input: arg }`
+     * - If called with multiple arguments, it will be `{ args: [...arguments] }`
+     * - If called with no arguments, it will be an empty object `{}`
+     *
      * @param inputs Key-value map of the function inputs.
      * @returns Transformed key-value map
      */
-    processInputs?: (inputs: Readonly<KVMap>) => KVMap;
+    processInputs?: (inputs: Readonly<ProcessInputs<Parameters<Func>>>) => KVMap;
     /**
      * Apply transformations to the outputs before logging.
      * This function should NOT mutate the outputs.
      * `processOutputs` is not inherited by nested traceable functions.
      *
+     * The input to this function is determined as follows based on the
+     * return value of the wrapped function:
+     * - If the return value is an object, it will be the unchanged return value
+     * - If the return value is not an object, it will wrapped as `{ outputs: returnValue }`
+     *
      * @param outputs Key-value map of the function outputs
      * @returns Transformed key-value map
      */
-    processOutputs?: (outputs: Readonly<KVMap>) => KVMap | Promise<KVMap>;
+    processOutputs?: (outputs: Readonly<ProcessOutputs<Awaited<ReturnType<Func>>>>) => KVMap | Promise<KVMap>;
 };
 /**
  * Higher-order function that takes function as input and returns a

package/dist/traceable.js

@@ -87,7 +87,9 @@ const runInputsToMap = (rawInputs) => {
     }
     return inputs;
 };
-const handleRunInputs = (inputs, processInputs) => {
+const handleRunInputs = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+inputs, processInputs) => {
     try {
         return processInputs(inputs);
     }
@@ -143,6 +145,7 @@ function isAsyncFn(fn) {
 // Note: This mutates the run tree
 async function handleRunOutputs(params) {
     const { runTree, rawOutputs, processOutputsFn, on_end, postRunPromise, excludeInputs, } = params;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     let outputs;
     if (isKVMap(rawOutputs)) {
         outputs = { ...rawOutputs };

package/dist/wrappers/openai.cjs

@@ -127,49 +127,77 @@ const textAggregator = (allChunks
     ];
     return aggregatedOutput;
 };
+function isChatCompletionUsage(usage) {
+    return usage != null && typeof usage === "object" && "prompt_tokens" in usage;
+}
 function processChatCompletion(outputs) {
-    const chatCompletion = outputs;
-    const recognizedServiceTier = ["priority", "flex"].includes(chatCompletion.service_tier ?? "")
-        ? chatCompletion.service_tier
+    const openAICompletion = outputs;
+    const recognizedServiceTier = ["priority", "flex"].includes(openAICompletion.service_tier ?? "")
+        ? openAICompletion.service_tier
         : undefined;
     const serviceTierPrefix = recognizedServiceTier
         ? `${recognizedServiceTier}_`
         : "";
     // copy the original object, minus usage
-    const result = { ...chatCompletion };
-    const usage = chatCompletion.usage;
+    const result = { ...openAICompletion };
+    const usage = openAICompletion.usage;
     if (usage) {
-        const inputTokenDetails = {
-            ...(usage.prompt_tokens_details?.audio_tokens !== null && {
-                audio: usage.prompt_tokens_details?.audio_tokens,
-            }),
-            ...(usage.prompt_tokens_details?.cached_tokens !== null && {
-                [`${serviceTierPrefix}cache_read`]: usage.prompt_tokens_details?.cached_tokens,
-            }),
-        };
-        const outputTokenDetails = {
-            ...(usage.completion_tokens_details?.audio_tokens !== null && {
-                audio: usage.completion_tokens_details?.audio_tokens,
-            }),
-            ...(usage.completion_tokens_details?.reasoning_tokens !== null && {
-                [`${serviceTierPrefix}reasoning`]: usage.completion_tokens_details?.reasoning_tokens,
-            }),
-        };
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let totalTokens = 0;
+        let inputTokenDetails = {};
+        let outputTokenDetails = {};
+        if (isChatCompletionUsage(usage)) {
+            inputTokens = usage.prompt_tokens ?? 0;
+            outputTokens = usage.completion_tokens ?? 0;
+            totalTokens = usage.total_tokens ?? 0;
+            inputTokenDetails = {
+                ...(usage.prompt_tokens_details?.audio_tokens !== null && {
+                    audio: usage.prompt_tokens_details?.audio_tokens,
+                }),
+                ...(usage.prompt_tokens_details?.cached_tokens !== null && {
+                    [`${serviceTierPrefix}cache_read`]: usage.prompt_tokens_details?.cached_tokens,
+                }),
+            };
+            outputTokenDetails = {
+                ...(usage.completion_tokens_details?.audio_tokens !== null && {
+                    audio: usage.completion_tokens_details?.audio_tokens,
+                }),
+                ...(usage.completion_tokens_details?.reasoning_tokens !== null && {
+                    [`${serviceTierPrefix}reasoning`]: usage.completion_tokens_details?.reasoning_tokens,
+                }),
+            };
+        }
+        else {
+            inputTokens = usage.input_tokens ?? 0;
+            outputTokens = usage.output_tokens ?? 0;
+            totalTokens = usage.total_tokens ?? 0;
+            inputTokenDetails = {
+                ...(usage.input_tokens_details?.cached_tokens !== null && {
+                    [`${serviceTierPrefix}cache_read`]: usage.input_tokens_details?.cached_tokens,
+                }),
+            };
+            outputTokenDetails = {
+                ...(usage.output_tokens_details?.reasoning_tokens !== null && {
+                    [`${serviceTierPrefix}reasoning`]: usage.output_tokens_details?.reasoning_tokens,
+                }),
+            };
+        }
         if (recognizedServiceTier) {
             // Avoid counting cache read and reasoning tokens towards the
             // service tier token count since service tier tokens are already
             // priced differently
             inputTokenDetails[recognizedServiceTier] =
-                usage.prompt_tokens -
+                inputTokens -
                     (inputTokenDetails[`${serviceTierPrefix}cache_read`] ?? 0);
             outputTokenDetails[recognizedServiceTier] =
-                usage.completion_tokens -
+                outputTokens -
                     (outputTokenDetails[`${serviceTierPrefix}reasoning`] ?? 0);
         }
         result.usage_metadata = {
-            input_tokens: usage.prompt_tokens ?? 0,
-            output_tokens: usage.completion_tokens ?? 0,
-            total_tokens: usage.total_tokens ?? 0,
+            input_tokens: inputTokens ?? 0,
+            output_tokens: outputTokens ?? 0,
+            total_tokens: totalTokens ?? 0,
             ...(Object.keys(inputTokenDetails).length > 0 && {
                 input_token_details: inputTokenDetails,
             }),

package/dist/wrappers/openai.js

@@ -124,49 +124,77 @@ const textAggregator = (allChunks
     ];
     return aggregatedOutput;
 };
+function isChatCompletionUsage(usage) {
+    return usage != null && typeof usage === "object" && "prompt_tokens" in usage;
+}
 function processChatCompletion(outputs) {
-    const chatCompletion = outputs;
-    const recognizedServiceTier = ["priority", "flex"].includes(chatCompletion.service_tier ?? "")
-        ? chatCompletion.service_tier
+    const openAICompletion = outputs;
+    const recognizedServiceTier = ["priority", "flex"].includes(openAICompletion.service_tier ?? "")
+        ? openAICompletion.service_tier
         : undefined;
     const serviceTierPrefix = recognizedServiceTier
         ? `${recognizedServiceTier}_`
         : "";
     // copy the original object, minus usage
-    const result = { ...chatCompletion };
-    const usage = chatCompletion.usage;
+    const result = { ...openAICompletion };
+    const usage = openAICompletion.usage;
     if (usage) {
-        const inputTokenDetails = {
-            ...(usage.prompt_tokens_details?.audio_tokens !== null && {
-                audio: usage.prompt_tokens_details?.audio_tokens,
-            }),
-            ...(usage.prompt_tokens_details?.cached_tokens !== null && {
-                [`${serviceTierPrefix}cache_read`]: usage.prompt_tokens_details?.cached_tokens,
-            }),
-        };
-        const outputTokenDetails = {
-            ...(usage.completion_tokens_details?.audio_tokens !== null && {
-                audio: usage.completion_tokens_details?.audio_tokens,
-            }),
-            ...(usage.completion_tokens_details?.reasoning_tokens !== null && {
-                [`${serviceTierPrefix}reasoning`]: usage.completion_tokens_details?.reasoning_tokens,
-            }),
-        };
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let totalTokens = 0;
+        let inputTokenDetails = {};
+        let outputTokenDetails = {};
+        if (isChatCompletionUsage(usage)) {
+            inputTokens = usage.prompt_tokens ?? 0;
+            outputTokens = usage.completion_tokens ?? 0;
+            totalTokens = usage.total_tokens ?? 0;
+            inputTokenDetails = {
+                ...(usage.prompt_tokens_details?.audio_tokens !== null && {
+                    audio: usage.prompt_tokens_details?.audio_tokens,
+                }),
+                ...(usage.prompt_tokens_details?.cached_tokens !== null && {
+                    [`${serviceTierPrefix}cache_read`]: usage.prompt_tokens_details?.cached_tokens,
+                }),
+            };
+            outputTokenDetails = {
+                ...(usage.completion_tokens_details?.audio_tokens !== null && {
+                    audio: usage.completion_tokens_details?.audio_tokens,
+                }),
+                ...(usage.completion_tokens_details?.reasoning_tokens !== null && {
+                    [`${serviceTierPrefix}reasoning`]: usage.completion_tokens_details?.reasoning_tokens,
+                }),
+            };
+        }
+        else {
+            inputTokens = usage.input_tokens ?? 0;
+            outputTokens = usage.output_tokens ?? 0;
+            totalTokens = usage.total_tokens ?? 0;
+            inputTokenDetails = {
+                ...(usage.input_tokens_details?.cached_tokens !== null && {
+                    [`${serviceTierPrefix}cache_read`]: usage.input_tokens_details?.cached_tokens,
+                }),
+            };
+            outputTokenDetails = {
+                ...(usage.output_tokens_details?.reasoning_tokens !== null && {
+                    [`${serviceTierPrefix}reasoning`]: usage.output_tokens_details?.reasoning_tokens,
+                }),
+            };
+        }
         if (recognizedServiceTier) {
             // Avoid counting cache read and reasoning tokens towards the
             // service tier token count since service tier tokens are already
             // priced differently
             inputTokenDetails[recognizedServiceTier] =
-                usage.prompt_tokens -
+                inputTokens -
                     (inputTokenDetails[`${serviceTierPrefix}cache_read`] ?? 0);
             outputTokenDetails[recognizedServiceTier] =
-                usage.completion_tokens -
+                outputTokens -
                     (outputTokenDetails[`${serviceTierPrefix}reasoning`] ?? 0);
         }
         result.usage_metadata = {
-            input_tokens: usage.prompt_tokens ?? 0,
-            output_tokens: usage.completion_tokens ?? 0,
-            total_tokens: usage.total_tokens ?? 0,
+            input_tokens: inputTokens ?? 0,
+            output_tokens: outputTokens ?? 0,
+            total_tokens: totalTokens ?? 0,
             ...(Object.keys(inputTokenDetails).length > 0 && {
                 input_token_details: inputTokenDetails,
             }),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "langsmith",
-  "version": "0.3.73",
-  "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
+  "version": "0.3.75",
+  "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [
     "dist/",