langsmith 0.1.3 → 0.1.6

package/README.md

@@ -91,8 +91,8 @@ Langsmith's `traceable` wrapper function makes it easy to trace any function or
 
 <!-- markdown-link-check-disable -->
 
-The easiest ways to trace calls from the [OpenAI SDK](https://platform.openai.com/docs/api-reference) with LangSmith
-is using the `traceable` wrapper function available in LangSmith 0.1.0 and up.
+The easiest way to trace calls from the [OpenAI SDK](https://platform.openai.com/docs/api-reference) with LangSmith
+is using the `wrapOpenAI` wrapper function available in LangSmith 0.1.3 and up.
 
 In order to use, you first need to set your LangSmith API key:
 
@@ -106,7 +106,7 @@ Next, you will need to install the LangSmith SDK and the OpenAI SDK:
 npm install langsmith openai
 ```
 
-After that, initialize your OpenAI client and wrap the client with `wrapOpenAI` method to enable tracing for Completion and Chat completion API:
+After that, initialize your OpenAI client and wrap the client with `wrapOpenAI` method to enable tracing for the completions and chat completions methods:
 
 ```ts
 import { OpenAI } from "openai";

package/dist/cli/docker-compose.yaml

@@ -29,6 +29,8 @@ services:
         condition: service_healthy
       clickhouse-setup:
         condition: service_completed_successfully
+      postgres-setup:
+        condition: service_completed_successfully
     restart: always
   langchain-queue:
     image: langchain/${_LANGSMITH_IMAGE_PREFIX-}langchainplus-backend:${_LANGSMITH_IMAGE_VERSION:-latest}
@@ -44,6 +46,8 @@ services:
         condition: service_healthy
       clickhouse-setup:
         condition: service_completed_successfully
+      postgres-setup:
+        condition: service_completed_successfully
     restart: always
   langchain-hub:
     image: langchain/${_LANGSMITH_IMAGE_PREFIX-}langchainhub-backend:${_LANGSMITH_IMAGE_VERSION:-latest}
@@ -55,7 +59,15 @@ services:
     ports:
       - 1985:1985
     depends_on:
-      - langchain-db
+      langchain-db:
+        condition: service_healthy
+      langchain-redis:
+        condition: service_healthy
+      clickhouse-setup:
+        condition: service_completed_successfully
+      postgres-setup:
+        condition: service_completed_successfully
+    restart: always
   langchain-db:
     image: postgres:14.7
     command:
@@ -114,13 +126,29 @@ services:
     depends_on:
       langchain-clickhouse:
         condition: service_healthy
-    restart: "no"
+    restart: "on-failure:10"
     entrypoint:
       [
         "bash",
         "-c",
         "migrate -source file://clickhouse/migrations -database 'clickhouse://langchain-clickhouse:9000?username=default&password=password&database=default&x-multi-statement=true&x-migrations-table-engine=MergeTree' up",
       ]
+  postgres-setup:
+    image: langchain/${_LANGSMITH_IMAGE_PREFIX-}langchainplus-backend:${_LANGSMITH_IMAGE_VERSION:-latest}
+    depends_on:
+      langchain-db:
+        condition: service_healthy
+    environment:
+      - LANGCHAIN_ENV=local_docker
+      - LOG_LEVEL=warning
+      - LANGSMITH_LICENSE_KEY=${LANGSMITH_LICENSE_KEY}
+    restart: "on-failure:10"
+    entrypoint:
+      [
+        "bash",
+        "-c",
+        "alembic upgrade head",
+      ]
 volumes:
   langchain-db-data:
   langchain-redis-data:

package/dist/client.cjs

@@ -98,6 +98,18 @@ function assertUuid(str) {
         throw new Error(`Invalid UUID: ${str}`);
     }
 }
+const handle429 = async (response) => {
+    if (response?.status === 429) {
+        const retryAfter = parseInt(response.headers.get("retry-after") ?? "30", 10) * 1000;
+        if (retryAfter > 0) {
+            await new Promise((resolve) => setTimeout(resolve, retryAfter));
+            // Return directly after calling this check
+            return true;
+        }
+    }
+    // Fall back to existing status checks
+    return false;
+};
 class Queue {
     constructor() {
         Object.defineProperty(this, "items", {
@@ -161,6 +173,12 @@ class Client {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "batchIngestCaller", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "timeout_ms", {
             enumerable: true,
             configurable: true,
@@ -244,9 +262,12 @@ class Client {
         this.apiUrl = trimQuotes(config.apiUrl ?? defaultConfig.apiUrl) ?? "";
         this.apiKey = trimQuotes(config.apiKey ?? defaultConfig.apiKey);
         this.webUrl = trimQuotes(config.webUrl ?? defaultConfig.webUrl);
-        this.validateApiKeyIfHosted();
         this.timeout_ms = config.timeout_ms ?? 12000;
         this.caller = new async_caller_js_1.AsyncCaller(config.callerOptions ?? {});
+        this.batchIngestCaller = new async_caller_js_1.AsyncCaller({
+            ...(config.callerOptions ?? {}),
+            onFailedResponseHook: handle429,
+        });
         this.hideInputs = config.hideInputs ?? defaultConfig.hideInputs;
         this.hideOutputs = config.hideOutputs ?? defaultConfig.hideOutputs;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
@@ -267,12 +288,6 @@ class Client {
             hideOutputs: hideOutputs,
         };
     }
-    validateApiKeyIfHosted() {
-        const isLocal = isLocalhost(this.apiUrl);
-        if (!isLocal && !this.apiKey) {
-            throw new Error("API key must be provided when using hosted LangSmith API");
-        }
-    }
     getHostUrl() {
         if (this.webUrl) {
             return this.webUrl;
@@ -455,7 +470,9 @@ class Client {
         if (this.autoBatchQueue.size > 0) {
             this.autoBatchTimeout = setTimeout(() => {
                 this.autoBatchTimeout = undefined;
-                void this.drainAutoBatchQueue();
+                // This error would happen in the background and is uncatchable
+                // from the outside. So just log instead.
+                void this.drainAutoBatchQueue().catch(console.error);
             }, oldTimeout
                 ? this.autoBatchAggregationDelayMs
                 : this.autoBatchInitialDelayMs);
@@ -494,7 +511,7 @@ class Client {
             void this.processRunOperation({
                 action: "create",
                 item: runCreate,
-            });
+            }).catch(console.error);
             return;
         }
         const mergedRunCreateParams = await mergeRuntimeEnvIntoRunCreates([
@@ -569,7 +586,7 @@ class Client {
             "Content-Type": "application/json",
             Accept: "application/json",
         };
-        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/batch`, {
+        const response = await this.batchIngestCaller.call(fetch, `${this.apiUrl}/runs/batch`, {
             method: "POST",
             headers,
             body: JSON.stringify(body),
@@ -600,7 +617,7 @@ class Client {
                 return;
             }
             else {
-                void this.processRunOperation({ action: "update", item: data });
+                void this.processRunOperation({ action: "update", item: data }).catch(console.error);
             }
             return;
         }

package/dist/client.d.ts

@@ -77,6 +77,7 @@ export declare class Client {
     private apiUrl;
     private webUrl?;
     private caller;
+    private batchIngestCaller;
     private timeout_ms;
     private _tenantId;
     private hideInputs?;
@@ -98,7 +99,6 @@ export declare class Client {
         hideInputs?: boolean;
         hideOutputs?: boolean;
     };
-    private validateApiKeyIfHosted;
     private getHostUrl;
     private get headers();
     private processInputs;

package/dist/client.js

@@ -72,6 +72,18 @@ function assertUuid(str) {
         throw new Error(`Invalid UUID: ${str}`);
     }
 }
+const handle429 = async (response) => {
+    if (response?.status === 429) {
+        const retryAfter = parseInt(response.headers.get("retry-after") ?? "30", 10) * 1000;
+        if (retryAfter > 0) {
+            await new Promise((resolve) => setTimeout(resolve, retryAfter));
+            // Return directly after calling this check
+            return true;
+        }
+    }
+    // Fall back to existing status checks
+    return false;
+};
 export class Queue {
     constructor() {
         Object.defineProperty(this, "items", {
@@ -134,6 +146,12 @@ export class Client {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "batchIngestCaller", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "timeout_ms", {
             enumerable: true,
             configurable: true,
@@ -217,9 +235,12 @@ export class Client {
         this.apiUrl = trimQuotes(config.apiUrl ?? defaultConfig.apiUrl) ?? "";
         this.apiKey = trimQuotes(config.apiKey ?? defaultConfig.apiKey);
         this.webUrl = trimQuotes(config.webUrl ?? defaultConfig.webUrl);
-        this.validateApiKeyIfHosted();
         this.timeout_ms = config.timeout_ms ?? 12000;
         this.caller = new AsyncCaller(config.callerOptions ?? {});
+        this.batchIngestCaller = new AsyncCaller({
+            ...(config.callerOptions ?? {}),
+            onFailedResponseHook: handle429,
+        });
         this.hideInputs = config.hideInputs ?? defaultConfig.hideInputs;
         this.hideOutputs = config.hideOutputs ?? defaultConfig.hideOutputs;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
@@ -240,12 +261,6 @@ export class Client {
             hideOutputs: hideOutputs,
         };
     }
-    validateApiKeyIfHosted() {
-        const isLocal = isLocalhost(this.apiUrl);
-        if (!isLocal && !this.apiKey) {
-            throw new Error("API key must be provided when using hosted LangSmith API");
-        }
-    }
     getHostUrl() {
         if (this.webUrl) {
             return this.webUrl;
@@ -428,7 +443,9 @@ export class Client {
         if (this.autoBatchQueue.size > 0) {
             this.autoBatchTimeout = setTimeout(() => {
                 this.autoBatchTimeout = undefined;
-                void this.drainAutoBatchQueue();
+                // This error would happen in the background and is uncatchable
+                // from the outside. So just log instead.
+                void this.drainAutoBatchQueue().catch(console.error);
             }, oldTimeout
                 ? this.autoBatchAggregationDelayMs
                 : this.autoBatchInitialDelayMs);
@@ -467,7 +484,7 @@ export class Client {
             void this.processRunOperation({
                 action: "create",
                 item: runCreate,
-            });
+            }).catch(console.error);
             return;
         }
         const mergedRunCreateParams = await mergeRuntimeEnvIntoRunCreates([
@@ -542,7 +559,7 @@ export class Client {
             "Content-Type": "application/json",
             Accept: "application/json",
         };
-        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/batch`, {
+        const response = await this.batchIngestCaller.call(fetch, `${this.apiUrl}/runs/batch`, {
             method: "POST",
             headers,
             body: JSON.stringify(body),
@@ -573,7 +590,7 @@ export class Client {
                 return;
             }
             else {
-                void this.processRunOperation({ action: "update", item: data });
+                void this.processRunOperation({ action: "update", item: data }).catch(console.error);
             }
             return;
         }

package/dist/index.cjs

@@ -6,4 +6,4 @@ Object.defineProperty(exports, "Client", { enumerable: true, get: function () {
 var run_trees_js_1 = require("./run_trees.cjs");
 Object.defineProperty(exports, "RunTree", { enumerable: true, get: function () { return run_trees_js_1.RunTree; } });
 // Update using yarn bump-version
-exports.__version__ = "0.1.3";
+exports.__version__ = "0.1.6";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { Client } from "./client.js";
 export type { Dataset, Example, TracerSession, Run, Feedback, } from "./schemas.js";
 export { RunTree, type RunTreeConfig } from "./run_trees.js";
-export declare const __version__ = "0.1.3";
+export declare const __version__ = "0.1.6";

package/dist/index.js

@@ -1,4 +1,4 @@
 export { Client } from "./client.js";
 export { RunTree } from "./run_trees.js";
 // Update using yarn bump-version
-export const __version__ = "0.1.3";
+export const __version__ = "0.1.6";

package/dist/run_trees.cjs

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRunTree = exports.RunTree = exports.convertToDottedOrderFormat = void 0;
+exports.isRunnableConfigLike = exports.isRunTree = exports.RunTree = exports.convertToDottedOrderFormat = void 0;
 const uuid = __importStar(require("uuid"));
 const env_js_1 = require("./utils/env.cjs");
 const client_js_1 = require("./client.cjs");
@@ -98,6 +98,12 @@ class RunTree {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "tags", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "error", {
             enumerable: true,
             configurable: true,
@@ -153,10 +159,11 @@ class RunTree {
             value: void 0
         });
         const defaultConfig = RunTree.getDefaultConfig();
-        Object.assign(this, { ...defaultConfig, ...config });
+        const client = config.client ?? new client_js_1.Client();
+        Object.assign(this, { ...defaultConfig, ...config, client });
         if (!this.trace_id) {
             if (this.parent_run) {
-                this.trace_id = this.parent_run.trace_id;
+                this.trace_id = this.parent_run.trace_id ?? this.id;
             }
             else {
                 this.trace_id = this.id;
@@ -173,6 +180,35 @@ class RunTree {
             }
         }
     }
+    static fromRunnableConfig(config, props) {
+        // We only handle the callback manager case for now
+        const callbackManager = config?.callbacks;
+        let parentRun;
+        let projectName;
+        if (callbackManager) {
+            const parentRunId = callbackManager?.getParentRunId?.() ?? "";
+            const langChainTracer = callbackManager?.handlers?.find((handler) => handler?.name == "langchain_tracer");
+            parentRun = langChainTracer?.getRun?.(parentRunId);
+            projectName = langChainTracer?.projectName;
+        }
+        const deduppedTags = [
+            ...new Set((parentRun?.tags ?? []).concat(config?.tags ?? [])),
+        ];
+        const dedupedMetadata = {
+            ...parentRun?.extra?.metadata,
+            ...config?.metadata,
+        };
+        const rt = new RunTree({
+            name: props?.name ?? "<lambda>",
+            parent_run: parentRun,
+            tags: deduppedTags,
+            extra: {
+                metadata: dedupedMetadata,
+            },
+            project_name: projectName,
+        });
+        return rt;
+    }
     static getDefaultConfig() {
         return {
             id: uuid.v4(),
@@ -188,7 +224,6 @@ class RunTree {
             serialized: {},
             inputs: {},
             extra: {},
-            client: new client_js_1.Client({}),
         };
     }
     async createChild(config) {
@@ -244,6 +279,7 @@ class RunTree {
             parent_run_id: parent_run_id,
             trace_id: run.trace_id,
             dotted_order: run.dotted_order,
+            tags: run.tags,
         };
         return persistedRun;
     }
@@ -268,6 +304,7 @@ class RunTree {
             events: this.events,
             dotted_order: this.dotted_order,
             trace_id: this.trace_id,
+            tags: this.tags,
         };
         await this.client.updateRun(this.id, runUpdate);
     }
@@ -279,3 +316,22 @@ function isRunTree(x) {
         typeof x.postRun === "function");
 }
 exports.isRunTree = isRunTree;
+function containsLangChainTracerLike(x) {
+    return (Array.isArray(x) &&
+        x.some((callback) => {
+            return (typeof callback.name === "string" &&
+                callback.name === "langchain_tracer");
+        }));
+}
+function isRunnableConfigLike(x) {
+    // Check that it's an object with a callbacks arg
+    // that has either a CallbackManagerLike object with a langchain tracer within it
+    // or an array with a LangChainTracerLike object within it
+    return (x !== undefined &&
+        typeof x.callbacks === "object" &&
+        // Callback manager with a langchain tracer
+        (containsLangChainTracerLike(x.callbacks?.handlers) ||
+            // Or it's an array with a LangChainTracerLike object within it
+            containsLangChainTracerLike(x.callbacks)));
+}
+exports.isRunnableConfigLike = isRunnableConfigLike;

package/dist/run_trees.d.ts

@@ -7,10 +7,12 @@ export interface RunTreeConfig {
     id?: string;
     project_name?: string;
     parent_run?: RunTree;
+    parent_run_id?: string;
     child_runs?: RunTree[];
     start_time?: number;
     end_time?: number;
     extra?: KVMap;
+    tags?: string[];
     error?: string;
     serialized?: object;
     inputs?: KVMap;
@@ -18,16 +20,34 @@ export interface RunTreeConfig {
     reference_example_id?: string;
     client?: Client;
 }
+export interface RunnableConfigLike {
+    /**
+     * Tags for this call and any sub-calls (eg. a Chain calling an LLM).
+     * You can use these to filter calls.
+     */
+    tags?: string[];
+    /**
+     * Metadata for this call and any sub-calls (eg. a Chain calling an LLM).
+     * Keys should be strings, values should be JSON-serializable.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Callbacks for this call and any sub-calls (eg. a Chain calling an LLM).
+     * Tags are passed to all callbacks, metadata is passed to handle*Start callbacks.
+     */
+    callbacks?: any;
+}
 export declare class RunTree implements BaseRun {
     id: string;
     name: RunTreeConfig["name"];
     run_type: string;
     project_name: string;
-    parent_run?: RunTree;
+    parent_run?: BaseRun;
     child_runs: RunTree[];
     start_time: number;
     end_time?: number;
     extra: KVMap;
+    tags?: string[];
     error?: string;
     serialized: object;
     inputs: KVMap;
@@ -38,6 +58,11 @@ export declare class RunTree implements BaseRun {
     trace_id: string;
     dotted_order: string;
     constructor(config: RunTreeConfig);
+    static fromRunnableConfig(config: RunnableConfigLike, props: {
+        name: string;
+        tags?: string[];
+        metadata?: KVMap;
+    }): RunTree;
     private static getDefaultConfig;
     createChild(config: RunTreeConfig): Promise<RunTree>;
     end(outputs?: KVMap, error?: string, endTime?: number): Promise<void>;
@@ -46,3 +71,4 @@ export declare class RunTree implements BaseRun {
     patchRun(): Promise<void>;
 }
 export declare function isRunTree(x?: unknown): x is RunTree;
+export declare function isRunnableConfigLike(x?: unknown): x is RunnableConfigLike;

package/dist/run_trees.js

@@ -71,6 +71,12 @@ export class RunTree {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "tags", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "error", {
             enumerable: true,
             configurable: true,
@@ -126,10 +132,11 @@ export class RunTree {
             value: void 0
         });
         const defaultConfig = RunTree.getDefaultConfig();
-        Object.assign(this, { ...defaultConfig, ...config });
+        const client = config.client ?? new Client();
+        Object.assign(this, { ...defaultConfig, ...config, client });
         if (!this.trace_id) {
             if (this.parent_run) {
-                this.trace_id = this.parent_run.trace_id;
+                this.trace_id = this.parent_run.trace_id ?? this.id;
             }
             else {
                 this.trace_id = this.id;
@@ -146,6 +153,35 @@ export class RunTree {
             }
         }
     }
+    static fromRunnableConfig(config, props) {
+        // We only handle the callback manager case for now
+        const callbackManager = config?.callbacks;
+        let parentRun;
+        let projectName;
+        if (callbackManager) {
+            const parentRunId = callbackManager?.getParentRunId?.() ?? "";
+            const langChainTracer = callbackManager?.handlers?.find((handler) => handler?.name == "langchain_tracer");
+            parentRun = langChainTracer?.getRun?.(parentRunId);
+            projectName = langChainTracer?.projectName;
+        }
+        const deduppedTags = [
+            ...new Set((parentRun?.tags ?? []).concat(config?.tags ?? [])),
+        ];
+        const dedupedMetadata = {
+            ...parentRun?.extra?.metadata,
+            ...config?.metadata,
+        };
+        const rt = new RunTree({
+            name: props?.name ?? "<lambda>",
+            parent_run: parentRun,
+            tags: deduppedTags,
+            extra: {
+                metadata: dedupedMetadata,
+            },
+            project_name: projectName,
+        });
+        return rt;
+    }
     static getDefaultConfig() {
         return {
             id: uuid.v4(),
@@ -161,7 +197,6 @@ export class RunTree {
             serialized: {},
             inputs: {},
             extra: {},
-            client: new Client({}),
         };
     }
     async createChild(config) {
@@ -217,6 +252,7 @@ export class RunTree {
             parent_run_id: parent_run_id,
             trace_id: run.trace_id,
             dotted_order: run.dotted_order,
+            tags: run.tags,
         };
         return persistedRun;
     }
@@ -241,6 +277,7 @@ export class RunTree {
             events: this.events,
             dotted_order: this.dotted_order,
             trace_id: this.trace_id,
+            tags: this.tags,
         };
         await this.client.updateRun(this.id, runUpdate);
     }
@@ -250,3 +287,21 @@ export function isRunTree(x) {
         typeof x.createChild === "function" &&
         typeof x.postRun === "function");
 }
+function containsLangChainTracerLike(x) {
+    return (Array.isArray(x) &&
+        x.some((callback) => {
+            return (typeof callback.name === "string" &&
+                callback.name === "langchain_tracer");
+        }));
+}
+export function isRunnableConfigLike(x) {
+    // Check that it's an object with a callbacks arg
+    // that has either a CallbackManagerLike object with a langchain tracer within it
+    // or an array with a LangChainTracerLike object within it
+    return (x !== undefined &&
+        typeof x.callbacks === "object" &&
+        // Callback manager with a langchain tracer
+        (containsLangChainTracerLike(x.callbacks?.handlers) ||
+            // Or it's an array with a LangChainTracerLike object within it
+            containsLangChainTracerLike(x.callbacks)));
+}

package/dist/schemas.d.ts

@@ -118,6 +118,7 @@ export interface RunUpdate {
     id?: string;
     end_time?: number;
     extra?: KVMap;
+    tags?: string[];
     error?: string;
     inputs?: KVMap;
     outputs?: KVMap;

package/dist/traceable.cjs

@@ -36,6 +36,10 @@ function traceable(wrappedFunc, config) {
             currentRunTree = args[0];
             rawInputs = args.slice(1);
         }
+        else if ((0, run_trees_js_1.isRunnableConfigLike)(args[0])) {
+            currentRunTree = run_trees_js_1.RunTree.fromRunnableConfig(args[0], ensuredConfig);
+            rawInputs = args.slice(1);
+        }
         else if (previousRunTree !== undefined) {
             currentRunTree = await previousRunTree.createChild(ensuredConfig);
             rawInputs = args;

package/dist/traceable.d.ts

@@ -1,4 +1,4 @@
-import { RunTree, RunTreeConfig } from "./run_trees.js";
+import { RunTree, RunTreeConfig, RunnableConfigLike } from "./run_trees.js";
 export type RunTreeLike = RunTree;
 type WrapArgReturnPair<Pair> = Pair extends [
     infer Args extends any[],
@@ -6,6 +6,7 @@ type WrapArgReturnPair<Pair> = Pair extends [
 ] ? {
     (...args: Args): Promise<Return>;
     (...args: [runTree: RunTreeLike, ...rest: Args]): Promise<Return>;
+    (...args: [config: RunnableConfigLike, ...rest: Args]): Promise<Return>;
 } : never;
 type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
 export type TraceableFunction<Func extends (...args: any[]) => any> = Func extends {

package/dist/traceable.js

@@ -1,5 +1,5 @@
 import { AsyncLocalStorage } from "async_hooks";
-import { RunTree, isRunTree } from "./run_trees.js";
+import { RunTree, isRunTree, isRunnableConfigLike, } from "./run_trees.js";
 const asyncLocalStorage = new AsyncLocalStorage();
 const isAsyncIterable = (x) => x != null &&
     typeof x === "object" &&
@@ -33,6 +33,10 @@ export function traceable(wrappedFunc, config) {
             currentRunTree = args[0];
             rawInputs = args.slice(1);
         }
+        else if (isRunnableConfigLike(args[0])) {
+            currentRunTree = RunTree.fromRunnableConfig(args[0], ensuredConfig);
+            rawInputs = args.slice(1);
+        }
         else if (previousRunTree !== undefined) {
             currentRunTree = await previousRunTree.createChild(ensuredConfig);
             rawInputs = args;

package/dist/utils/async_caller.cjs

@@ -52,13 +52,21 @@ class AsyncCaller {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "onFailedResponseHook", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.maxConcurrency = params.maxConcurrency ?? Infinity;
         this.maxRetries = params.maxRetries ?? 6;
         const PQueue = "default" in p_queue_1.default ? p_queue_1.default.default : p_queue_1.default;
         this.queue = new PQueue({ concurrency: this.maxConcurrency });
+        this.onFailedResponseHook = params?.onFailedResponseHook;
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     call(callable, ...args) {
+        const onFailedResponseHook = this.onFailedResponseHook;
         return this.queue.add(() => (0, p_retry_1.default)(() => callable(...args).catch((error) => {
             // eslint-disable-next-line no-instanceof/no-instanceof
             if (error instanceof Error) {
@@ -68,7 +76,7 @@ class AsyncCaller {
                 throw new Error(error);
             }
         }), {
-            onFailedAttempt(error) {
+            async onFailedAttempt(error) {
                 if (error.message.startsWith("Cancel") ||
                     error.message.startsWith("TimeoutError") ||
                     error.message.startsWith("AbortError")) {
@@ -79,7 +87,8 @@ class AsyncCaller {
                     throw error;
                 }
                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                const status = error?.response?.status;
+                const response = error?.response;
+                const status = response?.status;
                 if (status) {
                     if (STATUS_NO_RETRY.includes(+status)) {
                         throw error;
@@ -87,6 +96,9 @@ class AsyncCaller {
                     else if (STATUS_IGNORE.includes(+status)) {
                         return;
                     }
+                    if (onFailedResponseHook) {
+                        await onFailedResponseHook(response);
+                    }
                 }
             },
             // If needed we can change some of the defaults here,

package/dist/utils/async_caller.d.ts

@@ -1,3 +1,4 @@
+type ResponseCallback = (response?: Response) => Promise<boolean>;
 export interface AsyncCallerParams {
     /**
      * The maximum number of concurrent calls that can be made.
@@ -9,6 +10,7 @@ export interface AsyncCallerParams {
      * with an exponential backoff between each attempt. Defaults to 6.
      */
     maxRetries?: number;
+    onFailedResponseHook?: ResponseCallback;
 }
 export interface AsyncCallerCallOptions {
     signal?: AbortSignal;
@@ -30,8 +32,10 @@ export declare class AsyncCaller {
     protected maxConcurrency: AsyncCallerParams["maxConcurrency"];
     protected maxRetries: AsyncCallerParams["maxRetries"];
     private queue;
+    private onFailedResponseHook?;
     constructor(params: AsyncCallerParams);
     call<A extends any[], T extends (...args: A) => Promise<any>>(callable: T, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;
     callWithOptions<A extends any[], T extends (...args: A) => Promise<any>>(options: AsyncCallerCallOptions, callable: T, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;
     fetch(...args: Parameters<typeof fetch>): ReturnType<typeof fetch>;
 }
+export {};

package/dist/utils/async_caller.js

@@ -46,13 +46,21 @@ export class AsyncCaller {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "onFailedResponseHook", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.maxConcurrency = params.maxConcurrency ?? Infinity;
         this.maxRetries = params.maxRetries ?? 6;
         const PQueue = "default" in PQueueMod ? PQueueMod.default : PQueueMod;
         this.queue = new PQueue({ concurrency: this.maxConcurrency });
+        this.onFailedResponseHook = params?.onFailedResponseHook;
     }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     call(callable, ...args) {
+        const onFailedResponseHook = this.onFailedResponseHook;
         return this.queue.add(() => pRetry(() => callable(...args).catch((error) => {
             // eslint-disable-next-line no-instanceof/no-instanceof
             if (error instanceof Error) {
@@ -62,7 +70,7 @@ export class AsyncCaller {
                 throw new Error(error);
             }
         }), {
-            onFailedAttempt(error) {
+            async onFailedAttempt(error) {
                 if (error.message.startsWith("Cancel") ||
                     error.message.startsWith("TimeoutError") ||
                     error.message.startsWith("AbortError")) {
@@ -73,7 +81,8 @@ export class AsyncCaller {
                     throw error;
                 }
                 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                const status = error?.response?.status;
+                const response = error?.response;
+                const status = response?.status;
                 if (status) {
                     if (STATUS_NO_RETRY.includes(+status)) {
                         throw error;
@@ -81,6 +90,9 @@ export class AsyncCaller {
                     else if (STATUS_IGNORE.includes(+status)) {
                         return;
                     }
+                    if (onFailedResponseHook) {
+                        await onFailedResponseHook(response);
+                    }
                 }
             },
             // If needed we can change some of the defaults here,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [
@@ -69,7 +69,8 @@
   "devDependencies": {
     "@babel/preset-env": "^7.22.4",
     "@jest/globals": "^29.5.0",
-    "@langchain/core": "^0.1.28",
+    "@langchain/core": "^0.1.32",
+    "@langchain/langgraph": "^0.0.8",
     "@tsconfig/recommended": "^1.0.2",
     "@types/jest": "^29.5.1",
     "@typescript-eslint/eslint-plugin": "^5.59.8",