@langchain/langgraph-sdk 0.0.79 → 0.0.81

package/dist/client.cjs

@@ -71,6 +71,12 @@ class BaseClient {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "onRequest", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         const callerOptions = {
             maxRetries: 4,
             maxConcurrency: 4,
@@ -95,6 +101,7 @@ class BaseClient {
         // Regex to remove trailing slash, if present
         this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || defaultApiUrl;
         this.defaultHeaders = config?.defaultHeaders || {};
+        this.onRequest = config?.onRequest;
         const apiKey = getApiKey(config?.apiKey);
         if (apiKey) {
             this.defaultHeaders["X-Api-Key"] = apiKey;
@@ -141,7 +148,12 @@ class BaseClient {
         return [targetUrl, mutatedOptions];
     }
     async fetch(path, options) {
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(path, options));
+        const [url, init] = this.prepareFetchOptions(path, options);
+        let finalInit = init;
+        if (this.onRequest) {
+            finalInit = await this.onRequest(url, init);
+        }
+        const response = await this.asyncCaller.fetch(url, finalInit);
         const body = (() => {
             if (response.status === 202 || response.status === 204) {
                 return undefined;
@@ -614,6 +626,7 @@ class RunsClient extends BaseClient {
             after_seconds: payload?.afterSeconds,
             if_not_exists: payload?.ifNotExists,
             checkpoint_during: payload?.checkpointDuring,
+            langsmith_tracer: payload?._langsmithTracer,
         };
         const [run, response] = await this.fetch(`/threads/${threadId}/runs`, {
             method: "POST",
@@ -669,6 +682,12 @@ class RunsClient extends BaseClient {
             after_seconds: payload?.afterSeconds,
             if_not_exists: payload?.ifNotExists,
             checkpoint_during: payload?.checkpointDuring,
+            langsmith_tracer: payload?._langsmithTracer
+                ? {
+                    project_name: payload?._langsmithTracer?.projectName,
+                    example_id: payload?._langsmithTracer?.exampleId,
+                }
+                : undefined,
         };
         const endpoint = threadId == null ? `/runs/wait` : `/threads/${threadId}/runs/wait`;
         const [run, response] = await this.fetch(endpoint, {

package/dist/client.d.ts

@@ -14,18 +14,21 @@ import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
  * @returns The API key if found, otherwise undefined
  */
 export declare function getApiKey(apiKey?: string): string | undefined;
+export type RequestHook = (url: URL, init: RequestInit) => Promise<RequestInit> | RequestInit;
 export interface ClientConfig {
     apiUrl?: string;
     apiKey?: string;
     callerOptions?: AsyncCallerParams;
     timeoutMs?: number;
     defaultHeaders?: Record<string, string | null | undefined>;
+    onRequest?: RequestHook;
 }
 declare class BaseClient {
     protected asyncCaller: AsyncCaller;
     protected timeoutMs: number | undefined;
     protected apiUrl: string;
     protected defaultHeaders: Record<string, string | null | undefined>;
+    protected onRequest?: RequestHook;
     constructor(config?: ClientConfig);
     protected prepareFetchOptions(path: string, options?: RequestInit & {
         json?: unknown;

package/dist/client.js

@@ -67,6 +67,12 @@ class BaseClient {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "onRequest", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         const callerOptions = {
             maxRetries: 4,
             maxConcurrency: 4,
@@ -91,6 +97,7 @@ class BaseClient {
         // Regex to remove trailing slash, if present
         this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || defaultApiUrl;
         this.defaultHeaders = config?.defaultHeaders || {};
+        this.onRequest = config?.onRequest;
         const apiKey = getApiKey(config?.apiKey);
         if (apiKey) {
             this.defaultHeaders["X-Api-Key"] = apiKey;
@@ -137,7 +144,12 @@ class BaseClient {
         return [targetUrl, mutatedOptions];
     }
     async fetch(path, options) {
-        const response = await this.asyncCaller.fetch(...this.prepareFetchOptions(path, options));
+        const [url, init] = this.prepareFetchOptions(path, options);
+        let finalInit = init;
+        if (this.onRequest) {
+            finalInit = await this.onRequest(url, init);
+        }
+        const response = await this.asyncCaller.fetch(url, finalInit);
         const body = (() => {
             if (response.status === 202 || response.status === 204) {
                 return undefined;
@@ -607,6 +619,7 @@ export class RunsClient extends BaseClient {
             after_seconds: payload?.afterSeconds,
             if_not_exists: payload?.ifNotExists,
             checkpoint_during: payload?.checkpointDuring,
+            langsmith_tracer: payload?._langsmithTracer,
         };
         const [run, response] = await this.fetch(`/threads/${threadId}/runs`, {
             method: "POST",
@@ -662,6 +675,12 @@ export class RunsClient extends BaseClient {
             after_seconds: payload?.afterSeconds,
             if_not_exists: payload?.ifNotExists,
             checkpoint_during: payload?.checkpointDuring,
+            langsmith_tracer: payload?._langsmithTracer
+                ? {
+                    project_name: payload?._langsmithTracer?.projectName,
+                    example_id: payload?._langsmithTracer?.exampleId,
+                }
+                : undefined,
         };
         const endpoint = threadId == null ? `/runs/wait` : `/threads/${threadId}/runs/wait`;
         const [run, response] = await this.fetch(endpoint, {

package/dist/index.cjs

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.overrideFetchImplementation = exports.Client = void 0;
+exports.overrideFetchImplementation = exports.getApiKey = exports.Client = void 0;
 var client_js_1 = require("./client.cjs");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_js_1.Client; } });
+Object.defineProperty(exports, "getApiKey", { enumerable: true, get: function () { return client_js_1.getApiKey; } });
 var fetch_js_1 = require("./singletons/fetch.cjs");
 Object.defineProperty(exports, "overrideFetchImplementation", { enumerable: true, get: function () { return fetch_js_1.overrideFetchImplementation; } });

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { Client } from "./client.js";
-export type { AssistantBase, Assistant, AssistantVersion, AssistantGraph, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadTask, ThreadState, ThreadStatus, Cron, Checkpoint, Interrupt, ListNamespaceResponse, Item, SearchItem, SearchItemsResponse, CronCreateResponse, CronCreateForThreadResponse, } from "./schema.js";
+export { Client, getApiKey } from "./client.js";
+export type { ClientConfig, RequestHook } from "./client.js";
+export type { Assistant, AssistantBase, AssistantGraph, AssistantVersion, Checkpoint, Config, Cron, CronCreateForThreadResponse, CronCreateResponse, DefaultValues, GraphSchema, Interrupt, Item, ListNamespaceResponse, Metadata, Run, SearchItem, SearchItemsResponse, Thread, ThreadState, ThreadStatus, ThreadTask, } from "./schema.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
-export type { OnConflictBehavior, Command } from "./types.js";
-export type { StreamMode } from "./types.stream.js";
-export type { ValuesStreamEvent, MessagesTupleStreamEvent, MetadataStreamEvent, UpdatesStreamEvent, CustomStreamEvent, MessagesStreamEvent, DebugStreamEvent, EventsStreamEvent, ErrorStreamEvent, FeedbackStreamEvent, } from "./types.stream.js";
-export type { Message, HumanMessage, AIMessage, ToolMessage, SystemMessage, FunctionMessage, RemoveMessage, } from "./types.messages.js";
+export type { Command, OnConflictBehavior, RunsInvokePayload, } from "./types.js";
+export type { AIMessage, FunctionMessage, HumanMessage, Message, RemoveMessage, SystemMessage, ToolMessage, } from "./types.messages.js";
+export type { CustomStreamEvent, DebugStreamEvent, ErrorStreamEvent, EventsStreamEvent, FeedbackStreamEvent, MessagesStreamEvent, MessagesTupleStreamEvent, MetadataStreamEvent, StreamMode, UpdatesStreamEvent, ValuesStreamEvent, } from "./types.stream.js";

package/dist/index.js

@@ -1,2 +1,2 @@
-export { Client } from "./client.js";
+export { Client, getApiKey } from "./client.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import { LangChainTracer } from "@langchain/core/tracers/tracer_langchain";
 import { Checkpoint, Config, Metadata } from "./schema.js";
 import { StreamMode } from "./types.stream.js";
 export type MultitaskStrategy = "reject" | "interrupt" | "rollback" | "enqueue";
@@ -25,7 +26,7 @@ export interface Command {
      */
     goto?: Send | Send[] | string | string[];
 }
-interface RunsInvokePayload {
+export interface RunsInvokePayload {
     /**
      * Input to the run. Pass `null` to resume from the current state of the thread.
      */
@@ -111,6 +112,11 @@ interface RunsInvokePayload {
         run_id: string;
         thread_id?: string;
     }) => void;
+    /**
+     * @internal
+     * For LangSmith tracing purposes only. Not part of the public API.
+     */
+    _langsmithTracer?: LangChainTracer;
 }
 export interface RunsStreamPayload<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false> extends RunsInvokePayload {
     /**
@@ -159,4 +165,3 @@ export interface RunsWaitPayload extends RunsStreamPayload {
      */
     raiseError?: boolean;
 }
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.79",
+  "version": "0.0.81",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "packageManager": "yarn@1.22.19",