@langchain/langgraph-sdk 0.0.53 → 0.0.56

package/dist/client.cjs

@@ -686,6 +686,12 @@ class RunsClient extends BaseClient {
      *
      * @param threadId The ID of the thread.
      * @param runId The ID of the run.
+     * @param options Additional options for controlling the stream behavior:
+     *   - signal: An AbortSignal that can be used to cancel the stream request
+     *   - cancelOnDisconnect: When true, automatically cancels the run if the client disconnects from the stream
+     *   - streamMode: Controls what types of events to receive from the stream (can be a single mode or array of modes)
+     *        Must be a subset of the stream modes passed when creating the run. Background runs default to having the union of all
+     *        stream modes enabled.
      * @returns An async generator yielding stream parts.
      */
     async *joinStream(threadId, runId, options) {
@@ -698,7 +704,10 @@ class RunsClient extends BaseClient {
             method: "GET",
             timeoutMs: null,
             signal: opts?.signal,
-            params: { cancel_on_disconnect: opts?.cancelOnDisconnect ? "1" : "0" },
+            params: {
+                cancel_on_disconnect: opts?.cancelOnDisconnect ? "1" : "0",
+                stream_mode: opts?.streamMode,
+            },
         }));
         const stream = (response.body || new ReadableStream({ start: (ctrl) => ctrl.close() }))
             .pipeThrough(new sse_js_1.BytesLineDecoder())

package/dist/client.d.ts

@@ -364,11 +364,18 @@ export declare class RunsClient<TStateType = DefaultValues, TUpdateType = TState
      *
      * @param threadId The ID of the thread.
      * @param runId The ID of the run.
+     * @param options Additional options for controlling the stream behavior:
+     *   - signal: An AbortSignal that can be used to cancel the stream request
+     *   - cancelOnDisconnect: When true, automatically cancels the run if the client disconnects from the stream
+     *   - streamMode: Controls what types of events to receive from the stream (can be a single mode or array of modes)
+     *        Must be a subset of the stream modes passed when creating the run. Background runs default to having the union of all
+     *        stream modes enabled.
      * @returns An async generator yielding stream parts.
      */
     joinStream(threadId: string, runId: string, options?: {
         signal?: AbortSignal;
         cancelOnDisconnect?: boolean;
+        streamMode?: StreamMode | StreamMode[];
     } | AbortSignal): AsyncGenerator<{
         event: StreamEvent;
         data: any;

package/dist/client.js

@@ -679,6 +679,12 @@ export class RunsClient extends BaseClient {
      *
      * @param threadId The ID of the thread.
      * @param runId The ID of the run.
+     * @param options Additional options for controlling the stream behavior:
+     *   - signal: An AbortSignal that can be used to cancel the stream request
+     *   - cancelOnDisconnect: When true, automatically cancels the run if the client disconnects from the stream
+     *   - streamMode: Controls what types of events to receive from the stream (can be a single mode or array of modes)
+     *        Must be a subset of the stream modes passed when creating the run. Background runs default to having the union of all
+     *        stream modes enabled.
      * @returns An async generator yielding stream parts.
      */
     async *joinStream(threadId, runId, options) {
@@ -691,7 +697,10 @@ export class RunsClient extends BaseClient {
             method: "GET",
             timeoutMs: null,
             signal: opts?.signal,
-            params: { cancel_on_disconnect: opts?.cancelOnDisconnect ? "1" : "0" },
+            params: {
+                cancel_on_disconnect: opts?.cancelOnDisconnect ? "1" : "0",
+                stream_mode: opts?.streamMode,
+            },
         }));
         const stream = (response.body || new ReadableStream({ start: (ctrl) => ctrl.close() }))
             .pipeThrough(new BytesLineDecoder())

package/dist/react-ui/client.cjs

@@ -87,7 +87,7 @@ class ComponentStore {
 const COMPONENT_STORE = new ComponentStore();
 const EXT_STORE_SYMBOL = Symbol.for("LGUI_EXT_STORE");
 const REQUIRE_SYMBOL = Symbol.for("LGUI_REQUIRE");
-function LoadExternalComponent({ stream, message, meta, fallback, components, ...props }) {
+function LoadExternalComponent({ stream, namespace, message, meta, fallback, components, ...props }) {
     const ref = React.useRef(null);
     const id = React.useId();
     const shadowRootId = `child-shadow-${id}`;
@@ -95,11 +95,12 @@ function LoadExternalComponent({ stream, message, meta, fallback, components, ..
     const state = React.useSyncExternalStore(store.subscribe, store.getSnapshot);
     const clientComponent = components?.[message.name];
     const hasClientComponent = clientComponent != null;
+    const uiNamespace = namespace ?? stream.assistantId;
     const uiClient = stream.client["~ui"];
     React.useEffect(() => {
         if (hasClientComponent)
             return;
-        uiClient.getComponent(stream.assistantId, message.name).then((html) => {
+        uiClient.getComponent(uiNamespace, message.name).then((html) => {
             const dom = ref.current;
             if (!dom)
                 return;
@@ -109,13 +110,7 @@ function LoadExternalComponent({ stream, message, meta, fallback, components, ..
                 .createContextualFragment(html.replace("{{shadowRootId}}", shadowRootId));
             root.appendChild(fragment);
         });
-    }, [
-        uiClient,
-        stream.assistantId,
-        message.name,
-        shadowRootId,
-        hasClientComponent,
-    ]);
+    }, [uiClient, uiNamespace, message.name, shadowRootId, hasClientComponent]);
     if (hasClientComponent) {
         return React.createElement(clientComponent, message.props);
     }

package/dist/react-ui/client.d.ts

@@ -51,6 +51,8 @@ declare const REQUIRE_SYMBOL: unique symbol;
 interface LoadExternalComponentProps extends Pick<React.HTMLAttributes<HTMLDivElement>, "style" | "className"> {
     /** Stream of the assistant */
     stream: ReturnType<typeof useStream>;
+    /** Namespace of UI components. Defaults to assistant ID. */
+    namespace?: string;
     /** UI message to be rendered */
     message: UIMessage;
     /** Additional context to be passed to the child component */
@@ -63,7 +65,7 @@ interface LoadExternalComponentProps extends Pick<React.HTMLAttributes<HTMLDivEl
      */
     components?: Record<string, React.FunctionComponent | React.ComponentClass>;
 }
-export declare function LoadExternalComponent({ stream, message, meta, fallback, components, ...props }: LoadExternalComponentProps): JsxRuntime.JSX.Element;
+export declare function LoadExternalComponent({ stream, namespace, message, meta, fallback, components, ...props }: LoadExternalComponentProps): JsxRuntime.JSX.Element;
 declare global {
     interface Window {
         [EXT_STORE_SYMBOL]: ComponentStore;

package/dist/react-ui/client.js

@@ -60,7 +60,7 @@ class ComponentStore {
 const COMPONENT_STORE = new ComponentStore();
 const EXT_STORE_SYMBOL = Symbol.for("LGUI_EXT_STORE");
 const REQUIRE_SYMBOL = Symbol.for("LGUI_REQUIRE");
-export function LoadExternalComponent({ stream, message, meta, fallback, components, ...props }) {
+export function LoadExternalComponent({ stream, namespace, message, meta, fallback, components, ...props }) {
     const ref = React.useRef(null);
     const id = React.useId();
     const shadowRootId = `child-shadow-${id}`;
@@ -68,11 +68,12 @@ export function LoadExternalComponent({ stream, message, meta, fallback, compone
     const state = React.useSyncExternalStore(store.subscribe, store.getSnapshot);
     const clientComponent = components?.[message.name];
     const hasClientComponent = clientComponent != null;
+    const uiNamespace = namespace ?? stream.assistantId;
     const uiClient = stream.client["~ui"];
     React.useEffect(() => {
         if (hasClientComponent)
             return;
-        uiClient.getComponent(stream.assistantId, message.name).then((html) => {
+        uiClient.getComponent(uiNamespace, message.name).then((html) => {
             const dom = ref.current;
             if (!dom)
                 return;
@@ -82,13 +83,7 @@ export function LoadExternalComponent({ stream, message, meta, fallback, compone
                 .createContextualFragment(html.replace("{{shadowRootId}}", shadowRootId));
             root.appendChild(fragment);
         });
-    }, [
-        uiClient,
-        stream.assistantId,
-        message.name,
-        shadowRootId,
-        hasClientComponent,
-    ]);
+    }, [uiClient, uiNamespace, message.name, shadowRootId, hasClientComponent]);
     if (hasClientComponent) {
         return React.createElement(clientComponent, message.props);
     }

package/package.json

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