@langchain/langgraph-sdk 0.0.25 → 0.0.27

package/dist/client.cjs

@@ -1,10 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = exports.StoreClient = exports.RunsClient = exports.ThreadsClient = exports.AssistantsClient = exports.CronsClient = void 0;
+exports.Client = exports.StoreClient = exports.RunsClient = exports.ThreadsClient = exports.AssistantsClient = exports.CronsClient = exports.getApiKey = void 0;
 const async_caller_js_1 = require("./utils/async_caller.cjs");
 const index_js_1 = require("./utils/eventsource-parser/index.cjs");
 const stream_js_1 = require("./utils/stream.cjs");
 const signals_js_1 = require("./utils/signals.cjs");
+/**
+ * Get the API key from the environment.
+ * Precedence:
+ *   1. explicit argument
+ *   2. LANGGRAPH_API_KEY
+ *   3. LANGSMITH_API_KEY
+ *   4. LANGCHAIN_API_KEY
+ *
+ * @param apiKey - Optional API key provided as an argument
+ * @returns The API key if found, otherwise undefined
+ */
+function getApiKey(apiKey) {
+    if (apiKey) {
+        return apiKey;
+    }
+    const prefixes = ["LANGGRAPH", "LANGSMITH", "LANGCHAIN"];
+    for (const prefix of prefixes) {
+        const envKey = process.env[`${prefix}_API_KEY`];
+        if (envKey) {
+            // Remove surrounding quotes
+            return envKey.trim().replace(/^["']|["']$/g, "");
+        }
+    }
+    return undefined;
+}
+exports.getApiKey = getApiKey;
 class BaseClient {
     constructor(config) {
         Object.defineProperty(this, "asyncCaller", {
@@ -39,10 +65,12 @@ class BaseClient {
         this.timeoutMs = config?.timeoutMs || 12_000;
         // default limit being capped by Chrome
         // https://github.com/nodejs/undici/issues/1373
-        this.apiUrl = config?.apiUrl || "http://localhost:8123";
+        // Regex to remove trailing slash, if present
+        this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || "http://localhost:8123";
         this.defaultHeaders = config?.defaultHeaders || {};
-        if (config?.apiKey != null) {
-            this.defaultHeaders["X-Api-Key"] = config.apiKey;
+        const apiKey = getApiKey(config?.apiKey);
+        if (apiKey) {
+            this.defaultHeaders["X-Api-Key"] = apiKey;
         }
     }
     prepareFetchOptions(path, options) {

package/dist/client.d.ts

@@ -1,6 +1,18 @@
 import { Assistant, AssistantGraph, CancelAction, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadState, Cron, AssistantVersion, Subgraphs, Checkpoint, SearchItemsResponse, ListNamespaceResponse, Item, ThreadStatus } from "./schema.js";
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
 import { RunsCreatePayload, RunsStreamPayload, RunsWaitPayload, StreamEvent, CronsCreatePayload, OnConflictBehavior } from "./types.js";
+/**
+ * Get the API key from the environment.
+ * Precedence:
+ *   1. explicit argument
+ *   2. LANGGRAPH_API_KEY
+ *   3. LANGSMITH_API_KEY
+ *   4. LANGCHAIN_API_KEY
+ *
+ * @param apiKey - Optional API key provided as an argument
+ * @returns The API key if found, otherwise undefined
+ */
+export declare function getApiKey(apiKey?: string): string | undefined;
 interface ClientConfig {
     apiUrl?: string;
     apiKey?: string;

package/dist/client.js

@@ -2,6 +2,31 @@ import { AsyncCaller } from "./utils/async_caller.js";
 import { createParser, } from "./utils/eventsource-parser/index.js";
 import { IterableReadableStream } from "./utils/stream.js";
 import { mergeSignals } from "./utils/signals.js";
+/**
+ * Get the API key from the environment.
+ * Precedence:
+ *   1. explicit argument
+ *   2. LANGGRAPH_API_KEY
+ *   3. LANGSMITH_API_KEY
+ *   4. LANGCHAIN_API_KEY
+ *
+ * @param apiKey - Optional API key provided as an argument
+ * @returns The API key if found, otherwise undefined
+ */
+export function getApiKey(apiKey) {
+    if (apiKey) {
+        return apiKey;
+    }
+    const prefixes = ["LANGGRAPH", "LANGSMITH", "LANGCHAIN"];
+    for (const prefix of prefixes) {
+        const envKey = process.env[`${prefix}_API_KEY`];
+        if (envKey) {
+            // Remove surrounding quotes
+            return envKey.trim().replace(/^["']|["']$/g, "");
+        }
+    }
+    return undefined;
+}
 class BaseClient {
     constructor(config) {
         Object.defineProperty(this, "asyncCaller", {
@@ -36,10 +61,12 @@ class BaseClient {
         this.timeoutMs = config?.timeoutMs || 12_000;
         // default limit being capped by Chrome
         // https://github.com/nodejs/undici/issues/1373
-        this.apiUrl = config?.apiUrl || "http://localhost:8123";
+        // Regex to remove trailing slash, if present
+        this.apiUrl = config?.apiUrl?.replace(/\/$/, "") || "http://localhost:8123";
         this.defaultHeaders = config?.defaultHeaders || {};
-        if (config?.apiKey != null) {
-            this.defaultHeaders["X-Api-Key"] = config.apiKey;
+        const apiKey = getApiKey(config?.apiKey);
+        if (apiKey) {
+            this.defaultHeaders["X-Api-Key"] = apiKey;
         }
     }
     prepareFetchOptions(path, options) {

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { Client } from "./client.js";
-export type { Assistant, AssistantVersion, AssistantGraph, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadTask, ThreadState, ThreadStatus, Cron, Checkpoint, } from "./schema.js";
-export type { OnConflictBehavior } from "./types.js";
+export type { Assistant, AssistantVersion, AssistantGraph, Config, DefaultValues, GraphSchema, Metadata, Run, Thread, ThreadTask, ThreadState, ThreadStatus, Cron, Checkpoint, Interrupt, } from "./schema.js";
+export type { OnConflictBehavior, Command } from "./types.js";

package/dist/schema.d.ts

@@ -100,6 +100,15 @@ export interface AssistantGraph {
         conditional?: boolean;
     }>;
 }
+/**
+ * An interrupt thrown inside a thread.
+ */
+export interface Interrupt {
+    value: unknown;
+    when: "during";
+    resumable: boolean;
+    ns?: string[];
+}
 export interface Thread<ValuesType = DefaultValues> {
     /** The ID of the thread. */
     thread_id: string;
@@ -113,6 +122,8 @@ export interface Thread<ValuesType = DefaultValues> {
     status: ThreadStatus;
     /** The current state of the thread. */
     values: ValuesType;
+    /** Interrupts which were thrown in this thread */
+    interrupts: Record<string, Array<Interrupt>>;
 }
 export interface Cron {
     /** The ID of the cron */
@@ -152,12 +163,7 @@ export interface ThreadTask {
     name: string;
     result?: unknown;
     error: Optional<string>;
-    interrupts: Array<{
-        value: unknown;
-        when: "during";
-        resumable: boolean;
-        ns?: string[];
-    }>;
+    interrupts: Array<Interrupt>;
     checkpoint: Optional<Checkpoint>;
     state: Optional<ThreadState>;
 }

package/dist/types.d.ts

@@ -10,8 +10,17 @@ export interface Send {
     input: Record<string, unknown> | null;
 }
 export interface Command {
+    /**
+     * An object to update the thread state with.
+     */
     update?: Record<string, unknown>;
+    /**
+     * The value to return from an `interrupt` function call.
+     */
     resume?: unknown;
+    /**
+     * A single, or array of `Send` commands to trigger nodes.
+     */
     send?: Send | Send[];
 }
 interface RunsInvokePayload {

package/package.json

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