@langchain/langgraph-sdk 0.0.93 → 0.0.95

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @langchain/langgraph-sdk
 
+## 0.0.95
+
+### Patch Changes
+
+- 39cc88f: useStream should receive and merge messages from subgraphs
+- c1ddda1: Fix fetching state with `fetchStateHistory: false` causing crash if thread is empty
+
+## 0.0.94
+
+### Patch Changes
+
+- 11e95e0: Add isStudioUser for custom auth
+
 ## 0.0.93
 
 ### Patch Changes

package/dist/auth/index.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HTTPException = exports.Auth = void 0;
+exports.isStudioUser = isStudioUser;
 class Auth {
     constructor() {
         /**
@@ -28,5 +29,17 @@ class Auth {
     }
 }
 exports.Auth = Auth;
+/**
+ * Check if the provided user was provided by LangGraph Studio.
+ *
+ * By default, if you add custom authorization on your resources, this will also apply to interactions made from the Studio.
+ * If you want, you can handle logged-in Studio users in a special way.
+ *
+ * @param user - The user to check
+ * @returns True if the user is a studio user, false otherwise
+ */
+function isStudioUser(user) {
+    return user.identity === "langgraph-studio-user";
+}
 var error_js_1 = require("./error.cjs");
 Object.defineProperty(exports, "HTTPException", { enumerable: true, get: function () { return error_js_1.HTTPException; } });

package/dist/auth/index.d.ts

@@ -12,5 +12,15 @@ TAuthReturn extends BaseAuthReturn = BaseAuthReturn, TUser extends BaseUser = To
     authenticate<T extends BaseAuthReturn>(cb: AuthenticateCallback<T>): Auth<TExtra, T>;
     on<T extends CallbackEvent>(event: T, callback: OnCallback<T, TUser>): this;
 }
+/**
+ * Check if the provided user was provided by LangGraph Studio.
+ *
+ * By default, if you add custom authorization on your resources, this will also apply to interactions made from the Studio.
+ * If you want, you can handle logged-in Studio users in a special way.
+ *
+ * @param user - The user to check
+ * @returns True if the user is a studio user, false otherwise
+ */
+export declare function isStudioUser(user: BaseUser): boolean;
 export type { Filters as AuthFilters, EventValueMap as AuthEventValueMap, } from "./types.js";
 export { HTTPException } from "./error.js";

package/dist/auth/index.js

@@ -24,4 +24,16 @@ export class Auth {
         return this;
     }
 }
+/**
+ * Check if the provided user was provided by LangGraph Studio.
+ *
+ * By default, if you add custom authorization on your resources, this will also apply to interactions made from the Studio.
+ * If you want, you can handle logged-in Studio users in a special way.
+ *
+ * @param user - The user to check
+ * @returns True if the user is a studio user, false otherwise
+ */
+export function isStudioUser(user) {
+    return user.identity === "langgraph-studio-user";
+}
 export { HTTPException } from "./error.js";

package/dist/react/stream.cjs

@@ -124,7 +124,9 @@ function getBranchSequence(history) {
             task.sequence.items.push(fork);
         }
         for (const value of children) {
-            const id = value.checkpoint.checkpoint_id;
+            const id = value.checkpoint?.checkpoint_id;
+            if (id == null)
+                continue;
             let { sequence } = task;
             let { path } = task;
             if (fork != null) {
@@ -159,7 +161,10 @@ function getBranchView(sequence, paths, branch) {
         const item = queue.shift();
         if (item.type === "node") {
             history.push(item.value);
-            branchByCheckpoint[item.value.checkpoint.checkpoint_id] = {
+            const checkpointId = item.value.checkpoint?.checkpoint_id;
+            if (checkpointId == null)
+                continue;
+            branchByCheckpoint[checkpointId] = {
                 branch: item.path.join(PATH_SEP),
                 branchOptions: (item.path.length > 0
                     ? pathMap[item.path.at(-2) ?? ROOT_ID] ?? []
@@ -173,7 +178,7 @@ function getBranchView(sequence, paths, branch) {
                     const firstItem = value.items.at(0);
                     if (!firstItem || firstItem.type !== "node")
                         return false;
-                    return firstItem.value.checkpoint.checkpoint_id === forkId;
+                    return firstItem.value.checkpoint?.checkpoint_id === forkId;
                 })
                 : -1;
             const nextItems = item.items.at(index)?.items ?? [];
@@ -184,9 +189,11 @@ function getBranchView(sequence, paths, branch) {
 }
 function fetchHistory(client, threadId, options) {
     if (options?.limit === false) {
-        return client.threads
-            .getState(threadId)
-            .then((state) => [state]);
+        return client.threads.getState(threadId).then((state) => {
+            if (state.checkpoint == null)
+                return [];
+            return [state];
+        });
     }
     const limit = typeof options?.limit === "number" ? options.limit : 1000;
     return client.threads.getHistory(threadId, { limit });
@@ -368,8 +375,9 @@ function useStream(options) {
                 .map((m, idx) => m.id ?? idx)
                 .includes(messageId));
             const firstSeen = history.data[firstSeenIdx];
-            let branch = firstSeen
-                ? branchByCheckpoint[firstSeen.checkpoint.checkpoint_id]
+            const checkpointId = firstSeen?.checkpoint?.checkpoint_id;
+            let branch = firstSeen && checkpointId != null
+                ? branchByCheckpoint[checkpointId]
                 : undefined;
             if (!branch?.branch?.length)
                 branch = undefined;
@@ -434,7 +442,10 @@ function useStream(options) {
                     }
                     setStreamValues(data);
                 }
-                if (event === "messages") {
+                if (event === "messages" ||
+                    // if `streamSubgraphs: true`, then we also want
+                    // to also receive messages from subgraphs
+                    event.startsWith("messages|")) {
                     const [serialized] = data;
                     const messageId = messageManagerRef.current.add(serialized);
                     if (!messageId) {

package/dist/react/stream.js

@@ -120,7 +120,9 @@ function getBranchSequence(history) {
             task.sequence.items.push(fork);
         }
         for (const value of children) {
-            const id = value.checkpoint.checkpoint_id;
+            const id = value.checkpoint?.checkpoint_id;
+            if (id == null)
+                continue;
             let { sequence } = task;
             let { path } = task;
             if (fork != null) {
@@ -155,7 +157,10 @@ function getBranchView(sequence, paths, branch) {
         const item = queue.shift();
         if (item.type === "node") {
             history.push(item.value);
-            branchByCheckpoint[item.value.checkpoint.checkpoint_id] = {
+            const checkpointId = item.value.checkpoint?.checkpoint_id;
+            if (checkpointId == null)
+                continue;
+            branchByCheckpoint[checkpointId] = {
                 branch: item.path.join(PATH_SEP),
                 branchOptions: (item.path.length > 0
                     ? pathMap[item.path.at(-2) ?? ROOT_ID] ?? []
@@ -169,7 +174,7 @@ function getBranchView(sequence, paths, branch) {
                     const firstItem = value.items.at(0);
                     if (!firstItem || firstItem.type !== "node")
                         return false;
-                    return firstItem.value.checkpoint.checkpoint_id === forkId;
+                    return firstItem.value.checkpoint?.checkpoint_id === forkId;
                 })
                 : -1;
             const nextItems = item.items.at(index)?.items ?? [];
@@ -180,9 +185,11 @@ function getBranchView(sequence, paths, branch) {
 }
 function fetchHistory(client, threadId, options) {
     if (options?.limit === false) {
-        return client.threads
-            .getState(threadId)
-            .then((state) => [state]);
+        return client.threads.getState(threadId).then((state) => {
+            if (state.checkpoint == null)
+                return [];
+            return [state];
+        });
     }
     const limit = typeof options?.limit === "number" ? options.limit : 1000;
     return client.threads.getHistory(threadId, { limit });
@@ -364,8 +371,9 @@ export function useStream(options) {
                 .map((m, idx) => m.id ?? idx)
                 .includes(messageId));
             const firstSeen = history.data[firstSeenIdx];
-            let branch = firstSeen
-                ? branchByCheckpoint[firstSeen.checkpoint.checkpoint_id]
+            const checkpointId = firstSeen?.checkpoint?.checkpoint_id;
+            let branch = firstSeen && checkpointId != null
+                ? branchByCheckpoint[checkpointId]
                 : undefined;
             if (!branch?.branch?.length)
                 branch = undefined;
@@ -430,7 +438,10 @@ export function useStream(options) {
                     }
                     setStreamValues(data);
                 }
-                if (event === "messages") {
+                if (event === "messages" ||
+                    // if `streamSubgraphs: true`, then we also want
+                    // to also receive messages from subgraphs
+                    event.startsWith("messages|")) {
                     const [serialized] = data;
                     const messageId = messageManagerRef.current.add(serialized);
                     if (!messageId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.93",
+  "version": "0.0.95",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "scripts": {