@langchain/langgraph-sdk 1.4.4 → 1.4.5

package/dist/react/stream.custom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.custom.cjs","names":["BytesLineDecoder","SSEDecoder","IterableReadableStream","MessageTupleManager","StreamManager","useControllableThreadId","getToolCallsWithResults"],"sources":["../../src/react/stream.custom.tsx"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\n\n\"use client\";\n\nimport { useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport { EventStreamEvent, StreamManager } from \"../ui/manager.js\";\nimport type {\n  GetUpdateType,\n  GetCustomEventType,\n  GetInterruptType,\n  GetToolCallsType,\n  RunCallbackMeta,\n  GetConfigurableType,\n  UseStreamTransport,\n  UseStreamCustomOptions,\n  CustomSubmitOptions,\n} from \"../ui/types.js\";\nimport type { UseStreamCustom } from \"./types.js\";\nimport { type Message } from \"../types.messages.js\";\nimport { getToolCallsWithResults } from \"../utils/tools.js\";\nimport { MessageTupleManager } from \"../ui/messages.js\";\nimport { Interrupt } from \"../schema.js\";\nimport { BytesLineDecoder, SSEDecoder } from \"../utils/sse.js\";\nimport { IterableReadableStream } from \"../utils/stream.js\";\nimport { useControllableThreadId } from \"./thread.js\";\nimport { Command } from \"../types.js\";\nimport type { BagTemplate } from \"../types.template.js\";\n\ninterface FetchStreamTransportOptions {\n  /**\n   * The URL of the API to use.\n   */\n  apiUrl: string;\n\n  /**\n   * Default headers to send with requests.\n   */\n  defaultHeaders?: HeadersInit;\n\n  /**\n   * Specify a custom fetch implementation.\n   */\n  fetch?: typeof fetch | ((...args: any[]) => any); // eslint-disable-line @typescript-eslint/no-explicit-any\n\n  /**\n   * Callback that is called before the request is made.\n   */\n  onRequest?: (\n    url: string,\n    init: RequestInit\n  ) => Promise<RequestInit> | RequestInit;\n}\n\nexport class FetchStreamTransport<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate\n> implements UseStreamTransport<StateType, Bag>\n{\n  constructor(private readonly options: FetchStreamTransportOptions) {}\n\n  async stream(payload: {\n    input: GetUpdateType<Bag, StateType> | null | undefined;\n    context: GetConfigurableType<Bag> | undefined;\n    command: Command | undefined;\n    signal: AbortSignal;\n  }): Promise<AsyncGenerator<{ id?: string; event: string; data: unknown }>> {\n    const { signal, ...body } = payload;\n\n    let requestInit: RequestInit = {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...this.options.defaultHeaders,\n      },\n      body: JSON.stringify(body),\n      signal,\n    };\n\n    if (this.options.onRequest) {\n      requestInit = await this.options.onRequest(\n        this.options.apiUrl,\n        requestInit\n      );\n    }\n    const fetchFn = this.options.fetch ?? fetch;\n\n    const response = await fetchFn(this.options.apiUrl, requestInit);\n    if (!response.ok) {\n      throw new Error(`Failed to stream: ${response.statusText}`);\n    }\n\n    const stream = (\n      response.body || new ReadableStream({ start: (ctrl) => ctrl.close() })\n    )\n      .pipeThrough(BytesLineDecoder())\n      .pipeThrough(SSEDecoder());\n\n    return IterableReadableStream.fromReadableStream(stream);\n  }\n}\n\nexport function useStreamCustom<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate\n>(\n  options: UseStreamCustomOptions<StateType, Bag>\n): UseStreamCustom<StateType, Bag> {\n  type UpdateType = GetUpdateType<Bag, StateType>;\n  type CustomType = GetCustomEventType<Bag>;\n  type InterruptType = GetInterruptType<Bag>;\n  type ConfigurableType = GetConfigurableType<Bag>;\n  type ToolCallType = GetToolCallsType<StateType>;\n\n  const [messageManager] = useState(() => new MessageTupleManager());\n  const [stream] = useState(\n    () =>\n      new StreamManager<StateType, Bag>(messageManager, {\n        throttle: options.throttle ?? false,\n      })\n  );\n\n  useSyncExternalStore(\n    stream.subscribe,\n    stream.getSnapshot,\n    stream.getSnapshot\n  );\n\n  const [threadId, onThreadId] = useControllableThreadId(options);\n  const threadIdRef = useRef<string | null>(threadId);\n\n  // Cancel the stream if thread ID has changed\n  useEffect(() => {\n    if (threadIdRef.current !== threadId) {\n      threadIdRef.current = threadId;\n      stream.clear();\n    }\n  }, [threadId, stream]);\n\n  const getMessages = (value: StateType): Message[] => {\n    const messagesKey = options.messagesKey ?? \"messages\";\n    return Array.isArray(value[messagesKey])\n      ? (value[messagesKey] as Message[])\n      : [];\n  };\n\n  const setMessages = (current: StateType, messages: Message[]): StateType => {\n    const messagesKey = options.messagesKey ?? \"messages\";\n    return { ...current, [messagesKey]: messages };\n  };\n\n  const historyValues = options.initialValues ?? ({} as StateType);\n\n  const stop = () => stream.stop(historyValues, { onStop: options.onStop });\n\n  const submit = async (\n    values: UpdateType | null | undefined,\n    submitOptions?: CustomSubmitOptions<StateType, ConfigurableType>\n  ) => {\n    let callbackMeta: RunCallbackMeta | undefined;\n    let usableThreadId = threadId;\n\n    stream.setStreamValues(() => {\n      if (submitOptions?.optimisticValues != null) {\n        return {\n          ...historyValues,\n          ...(typeof submitOptions.optimisticValues === \"function\"\n            ? submitOptions.optimisticValues(historyValues)\n            : submitOptions.optimisticValues),\n        };\n      }\n\n      return { ...historyValues };\n    });\n\n    await stream.start(\n      async (signal: AbortSignal) => {\n        if (!usableThreadId) {\n          // generate random thread id\n          usableThreadId = crypto.randomUUID();\n          threadIdRef.current = usableThreadId;\n          onThreadId(usableThreadId);\n        }\n\n        if (!usableThreadId) {\n          throw new Error(\"Failed to obtain valid thread ID.\");\n        }\n\n        return options.transport.stream({\n          input: values,\n          context: submitOptions?.context,\n          command: submitOptions?.command,\n          signal,\n          config: {\n            ...submitOptions?.config,\n            configurable: {\n              thread_id: usableThreadId,\n              ...submitOptions?.config?.configurable,\n            } as unknown as GetConfigurableType<Bag>,\n          },\n        }) as Promise<\n          AsyncGenerator<EventStreamEvent<StateType, UpdateType, CustomType>>\n        >;\n      },\n      {\n        getMessages,\n        setMessages,\n\n        initialValues: {} as StateType,\n        callbacks: options,\n\n        onSuccess: () => undefined,\n        onError(error) {\n          options.onError?.(error, callbackMeta);\n        },\n      }\n    );\n  };\n\n  return {\n    get values() {\n      return stream.values ?? ({} as StateType);\n    },\n\n    error: stream.error,\n    isLoading: stream.isLoading,\n\n    stop,\n    submit,\n\n    get interrupt(): Interrupt<InterruptType> | undefined {\n      if (\n        stream.values != null &&\n        \"__interrupt__\" in stream.values &&\n        Array.isArray(stream.values.__interrupt__)\n      ) {\n        const valueInterrupts = stream.values.__interrupt__;\n        if (valueInterrupts.length === 0) return { when: \"breakpoint\" };\n        if (valueInterrupts.length === 1) return valueInterrupts[0];\n\n        // TODO: fix the typing of interrupts if multiple interrupts are returned\n        return valueInterrupts as Interrupt<InterruptType>;\n      }\n\n      return undefined;\n    },\n\n    get messages(): Message<ToolCallType>[] {\n      if (!stream.values) return [];\n      return getMessages(stream.values);\n    },\n\n    get toolCalls() {\n      if (!stream.values) return [];\n      const msgs = getMessages(stream.values);\n      return getToolCallsWithResults<ToolCallType>(msgs);\n    },\n\n    getToolCalls(message) {\n      if (!stream.values) return [];\n      const msgs = getMessages(stream.values);\n      const allToolCalls = getToolCallsWithResults<ToolCallType>(msgs);\n      return allToolCalls.filter((tc) => tc.aiMessage.id === message.id);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/react/stream.custom.d.cts

@@ -0,0 +1,40 @@
+import { Command } from "../types.cjs";
+import { BagTemplate } from "../types.template.cjs";
+import { GetConfigurableType, GetUpdateType, UseStreamTransport } from "../ui/types.cjs";
+
+//#region src/react/stream.custom.d.ts
+interface FetchStreamTransportOptions {
+  /**
+   * The URL of the API to use.
+   */
+  apiUrl: string;
+  /**
+   * Default headers to send with requests.
+   */
+  defaultHeaders?: HeadersInit;
+  /**
+   * Specify a custom fetch implementation.
+   */
+  fetch?: typeof fetch | ((...args: any[]) => any);
+  /**
+   * Callback that is called before the request is made.
+   */
+  onRequest?: (url: string, init: RequestInit) => Promise<RequestInit> | RequestInit;
+}
+declare class FetchStreamTransport<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> implements UseStreamTransport<StateType, Bag> {
+  private readonly options;
+  constructor(options: FetchStreamTransportOptions);
+  stream(payload: {
+    input: GetUpdateType<Bag, StateType> | null | undefined;
+    context: GetConfigurableType<Bag> | undefined;
+    command: Command | undefined;
+    signal: AbortSignal;
+  }): Promise<AsyncGenerator<{
+    id?: string;
+    event: string;
+    data: unknown;
+  }>>;
+}
+//#endregion
+export { FetchStreamTransport };
+//# sourceMappingURL=stream.custom.d.cts.map

package/dist/react/stream.custom.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.custom.d.cts","names":["GetUpdateType","GetConfigurableType","UseStreamTransport","UseStreamCustomOptions","UseStreamCustom","Command","BagTemplate","FetchStreamTransportOptions","HeadersInit","fetch","RequestInit","Promise","FetchStreamTransport","Record","StateType","Bag","AbortSignal","AsyncGenerator","useStreamCustom"],"sources":["../../src/react/stream.custom.d.ts"],"sourcesContent":["import type { GetUpdateType, GetConfigurableType, UseStreamTransport, UseStreamCustomOptions } from \"../ui/types.js\";\nimport type { UseStreamCustom } from \"./types.js\";\nimport { Command } from \"../types.js\";\nimport type { BagTemplate } from \"../types.template.js\";\ninterface FetchStreamTransportOptions {\n    /**\n     * The URL of the API to use.\n     */\n    apiUrl: string;\n    /**\n     * Default headers to send with requests.\n     */\n    defaultHeaders?: HeadersInit;\n    /**\n     * Specify a custom fetch implementation.\n     */\n    fetch?: typeof fetch | ((...args: any[]) => any);\n    /**\n     * Callback that is called before the request is made.\n     */\n    onRequest?: (url: string, init: RequestInit) => Promise<RequestInit> | RequestInit;\n}\nexport declare class FetchStreamTransport<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> implements UseStreamTransport<StateType, Bag> {\n    private readonly options;\n    constructor(options: FetchStreamTransportOptions);\n    stream(payload: {\n        input: GetUpdateType<Bag, StateType> | null | undefined;\n        context: GetConfigurableType<Bag> | undefined;\n        command: Command | undefined;\n        signal: AbortSignal;\n    }): Promise<AsyncGenerator<{\n        id?: string;\n        event: string;\n        data: unknown;\n    }>>;\n}\nexport declare function useStreamCustom<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamCustomOptions<StateType, Bag>): UseStreamCustom<StateType, Bag>;\nexport {};\n"],"mappings":";;;;;UAIUO,2BAAAA;EAAAA;;;QAYSE,EAAAA,MAAAA;;;;gBAIwDC,CAAAA,EARtDF,WAQsDE;EAAW;AAEtF;;OAA4DG,CAAAA,EAAAA,OANzCJ,KAMyCI,GAAAA,CAAAA,CAAAA,GAAAA,IAAAA,EAAAA,GAAAA,EAAAA,EAAAA,GAAAA,GAAAA,CAAAA;;;;WAAwHC,CAAAA,EAAAA,CAAAA,GAAAA,EAAAA,MAAAA,EAAAA,IAAAA,EAFhJJ,WAEgJI,EAAAA,GAFhIH,OAEgIG,CAFxHJ,WAEwHI,CAAAA,GAFzGJ,WAEyGI;;AAE3JP,cAFJK,oBAEIL,CAAAA,kBAFmCM,MAEnCN,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAF6DM,MAE7DN,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,EAAAA,YAFkGD,WAElGC,GAFgHD,WAEhHC,CAAAA,YAFwIL,kBAExIK,CAF2JO,SAE3JP,EAFsKQ,GAEtKR,CAAAA,CAAAA;mBAEIQ,OAAAA;aAAKD,CAAAA,OAAAA,EAFTP,2BAESO;QAAnBd,CAAAA,OAAAA,EAAAA;IACsBe,KAAAA,EADtBf,aACsBe,CADRA,GACQA,EADHD,SACGC,CAAAA,GAAAA,IAAAA,GAAAA,SAAAA;IAApBd,OAAAA,EAAAA,mBAAAA,CAAoBc,GAApBd,CAAAA,GAAAA,SAAAA;IACAI,OAAAA,EAAAA,OAAAA,GAAAA,SAAAA;IACDW,MAAAA,EAAAA,WAAAA;MACRL,OAAQM,CAAAA,cAAAA,CAAAA;IAARN,EAAAA,CAAAA,EAAAA,MAAAA;IARyJT,KAAAA,EAAAA,MAAAA;IAAkB,IAAA,EAAA,OAAA"}

package/dist/react/stream.custom.d.ts

@@ -0,0 +1,40 @@
+import { Command } from "../types.js";
+import { BagTemplate } from "../types.template.js";
+import { GetConfigurableType, GetUpdateType, UseStreamTransport } from "../ui/types.js";
+
+//#region src/react/stream.custom.d.ts
+interface FetchStreamTransportOptions {
+  /**
+   * The URL of the API to use.
+   */
+  apiUrl: string;
+  /**
+   * Default headers to send with requests.
+   */
+  defaultHeaders?: HeadersInit;
+  /**
+   * Specify a custom fetch implementation.
+   */
+  fetch?: typeof fetch | ((...args: any[]) => any);
+  /**
+   * Callback that is called before the request is made.
+   */
+  onRequest?: (url: string, init: RequestInit) => Promise<RequestInit> | RequestInit;
+}
+declare class FetchStreamTransport<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> implements UseStreamTransport<StateType, Bag> {
+  private readonly options;
+  constructor(options: FetchStreamTransportOptions);
+  stream(payload: {
+    input: GetUpdateType<Bag, StateType> | null | undefined;
+    context: GetConfigurableType<Bag> | undefined;
+    command: Command | undefined;
+    signal: AbortSignal;
+  }): Promise<AsyncGenerator<{
+    id?: string;
+    event: string;
+    data: unknown;
+  }>>;
+}
+//#endregion
+export { FetchStreamTransport };
+//# sourceMappingURL=stream.custom.d.ts.map

package/dist/react/stream.custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.custom.d.ts","names":["GetUpdateType","GetConfigurableType","UseStreamTransport","UseStreamCustomOptions","UseStreamCustom","Command","BagTemplate","FetchStreamTransportOptions","HeadersInit","fetch","RequestInit","Promise","FetchStreamTransport","Record","StateType","Bag","AbortSignal","AsyncGenerator","useStreamCustom"],"sources":["../../src/react/stream.custom.d.ts"],"sourcesContent":["import type { GetUpdateType, GetConfigurableType, UseStreamTransport, UseStreamCustomOptions } from \"../ui/types.js\";\nimport type { UseStreamCustom } from \"./types.js\";\nimport { Command } from \"../types.js\";\nimport type { BagTemplate } from \"../types.template.js\";\ninterface FetchStreamTransportOptions {\n    /**\n     * The URL of the API to use.\n     */\n    apiUrl: string;\n    /**\n     * Default headers to send with requests.\n     */\n    defaultHeaders?: HeadersInit;\n    /**\n     * Specify a custom fetch implementation.\n     */\n    fetch?: typeof fetch | ((...args: any[]) => any);\n    /**\n     * Callback that is called before the request is made.\n     */\n    onRequest?: (url: string, init: RequestInit) => Promise<RequestInit> | RequestInit;\n}\nexport declare class FetchStreamTransport<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> implements UseStreamTransport<StateType, Bag> {\n    private readonly options;\n    constructor(options: FetchStreamTransportOptions);\n    stream(payload: {\n        input: GetUpdateType<Bag, StateType> | null | undefined;\n        context: GetConfigurableType<Bag> | undefined;\n        command: Command | undefined;\n        signal: AbortSignal;\n    }): Promise<AsyncGenerator<{\n        id?: string;\n        event: string;\n        data: unknown;\n    }>>;\n}\nexport declare function useStreamCustom<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamCustomOptions<StateType, Bag>): UseStreamCustom<StateType, Bag>;\nexport {};\n"],"mappings":";;;;;UAIUO,2BAAAA;EAAAA;;;QAYSE,EAAAA,MAAAA;;;;gBAIwDC,CAAAA,EARtDF,WAQsDE;EAAW;AAEtF;;OAA4DG,CAAAA,EAAAA,OANzCJ,KAMyCI,GAAAA,CAAAA,CAAAA,GAAAA,IAAAA,EAAAA,GAAAA,EAAAA,EAAAA,GAAAA,GAAAA,CAAAA;;;;WAAwHC,CAAAA,EAAAA,CAAAA,GAAAA,EAAAA,MAAAA,EAAAA,IAAAA,EAFhJJ,WAEgJI,EAAAA,GAFhIH,OAEgIG,CAFxHJ,WAEwHI,CAAAA,GAFzGJ,WAEyGI;;AAE3JP,cAFJK,oBAEIL,CAAAA,kBAFmCM,MAEnCN,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAF6DM,MAE7DN,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,EAAAA,YAFkGD,WAElGC,GAFgHD,WAEhHC,CAAAA,YAFwIL,kBAExIK,CAF2JO,SAE3JP,EAFsKQ,GAEtKR,CAAAA,CAAAA;mBAEIQ,OAAAA;aAAKD,CAAAA,OAAAA,EAFTP,2BAESO;QAAnBd,CAAAA,OAAAA,EAAAA;IACsBe,KAAAA,EADtBf,aACsBe,CADRA,GACQA,EADHD,SACGC,CAAAA,GAAAA,IAAAA,GAAAA,SAAAA;IAApBd,OAAAA,EAAAA,mBAAAA,CAAoBc,GAApBd,CAAAA,GAAAA,SAAAA;IACAI,OAAAA,EAAAA,OAAAA,GAAAA,SAAAA;IACDW,MAAAA,EAAAA,WAAAA;MACRL,OAAQM,CAAAA,cAAAA,CAAAA;IAARN,EAAAA,CAAAA,EAAAA,MAAAA;IARyJT,KAAAA,EAAAA,MAAAA;IAAkB,IAAA,EAAA,OAAA"}

package/dist/react/stream.custom.js

@@ -0,0 +1,133 @@
+"use client";
+
+import { BytesLineDecoder, SSEDecoder } from "../utils/sse.js";
+import { IterableReadableStream } from "../utils/stream.js";
+import { MessageTupleManager } from "../ui/messages.js";
+import { StreamManager } from "../ui/manager.js";
+import { getToolCallsWithResults } from "../utils/tools.js";
+import { useControllableThreadId } from "./thread.js";
+import { useEffect, useRef, useState, useSyncExternalStore } from "react";
+
+//#region src/react/stream.custom.tsx
+var FetchStreamTransport = class {
+	constructor(options) {
+		this.options = options;
+	}
+	async stream(payload) {
+		const { signal, ...body } = payload;
+		let requestInit = {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				...this.options.defaultHeaders
+			},
+			body: JSON.stringify(body),
+			signal
+		};
+		if (this.options.onRequest) requestInit = await this.options.onRequest(this.options.apiUrl, requestInit);
+		const response = await (this.options.fetch ?? fetch)(this.options.apiUrl, requestInit);
+		if (!response.ok) throw new Error(`Failed to stream: ${response.statusText}`);
+		const stream = (response.body || new ReadableStream({ start: (ctrl) => ctrl.close() })).pipeThrough(BytesLineDecoder()).pipeThrough(SSEDecoder());
+		return IterableReadableStream.fromReadableStream(stream);
+	}
+};
+function useStreamCustom(options) {
+	const [messageManager] = useState(() => new MessageTupleManager());
+	const [stream] = useState(() => new StreamManager(messageManager, { throttle: options.throttle ?? false }));
+	useSyncExternalStore(stream.subscribe, stream.getSnapshot, stream.getSnapshot);
+	const [threadId, onThreadId] = useControllableThreadId(options);
+	const threadIdRef = useRef(threadId);
+	useEffect(() => {
+		if (threadIdRef.current !== threadId) {
+			threadIdRef.current = threadId;
+			stream.clear();
+		}
+	}, [threadId, stream]);
+	const getMessages = (value) => {
+		const messagesKey = options.messagesKey ?? "messages";
+		return Array.isArray(value[messagesKey]) ? value[messagesKey] : [];
+	};
+	const setMessages = (current, messages) => {
+		const messagesKey = options.messagesKey ?? "messages";
+		return {
+			...current,
+			[messagesKey]: messages
+		};
+	};
+	const historyValues = options.initialValues ?? {};
+	const stop = () => stream.stop(historyValues, { onStop: options.onStop });
+	const submit = async (values, submitOptions) => {
+		let callbackMeta;
+		let usableThreadId = threadId;
+		stream.setStreamValues(() => {
+			if (submitOptions?.optimisticValues != null) return {
+				...historyValues,
+				...typeof submitOptions.optimisticValues === "function" ? submitOptions.optimisticValues(historyValues) : submitOptions.optimisticValues
+			};
+			return { ...historyValues };
+		});
+		await stream.start(async (signal) => {
+			if (!usableThreadId) {
+				usableThreadId = crypto.randomUUID();
+				threadIdRef.current = usableThreadId;
+				onThreadId(usableThreadId);
+			}
+			if (!usableThreadId) throw new Error("Failed to obtain valid thread ID.");
+			return options.transport.stream({
+				input: values,
+				context: submitOptions?.context,
+				command: submitOptions?.command,
+				signal,
+				config: {
+					...submitOptions?.config,
+					configurable: {
+						thread_id: usableThreadId,
+						...submitOptions?.config?.configurable
+					}
+				}
+			});
+		}, {
+			getMessages,
+			setMessages,
+			initialValues: {},
+			callbacks: options,
+			onSuccess: () => void 0,
+			onError(error) {
+				options.onError?.(error, callbackMeta);
+			}
+		});
+	};
+	return {
+		get values() {
+			return stream.values ?? {};
+		},
+		error: stream.error,
+		isLoading: stream.isLoading,
+		stop,
+		submit,
+		get interrupt() {
+			if (stream.values != null && "__interrupt__" in stream.values && Array.isArray(stream.values.__interrupt__)) {
+				const valueInterrupts = stream.values.__interrupt__;
+				if (valueInterrupts.length === 0) return { when: "breakpoint" };
+				if (valueInterrupts.length === 1) return valueInterrupts[0];
+				return valueInterrupts;
+			}
+		},
+		get messages() {
+			if (!stream.values) return [];
+			return getMessages(stream.values);
+		},
+		get toolCalls() {
+			if (!stream.values) return [];
+			return getToolCallsWithResults(getMessages(stream.values));
+		},
+		getToolCalls(message) {
+			if (!stream.values) return [];
+			return getToolCallsWithResults(getMessages(stream.values)).filter((tc) => tc.aiMessage.id === message.id);
+		}
+	};
+}
+
+//#endregion
+export { FetchStreamTransport, useStreamCustom };
+//# sourceMappingURL=stream.custom.js.map

package/dist/react/stream.custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.custom.js","names":[],"sources":["../../src/react/stream.custom.tsx"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\n\n\"use client\";\n\nimport { useEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport { EventStreamEvent, StreamManager } from \"../ui/manager.js\";\nimport type {\n  GetUpdateType,\n  GetCustomEventType,\n  GetInterruptType,\n  GetToolCallsType,\n  RunCallbackMeta,\n  GetConfigurableType,\n  UseStreamTransport,\n  UseStreamCustomOptions,\n  CustomSubmitOptions,\n} from \"../ui/types.js\";\nimport type { UseStreamCustom } from \"./types.js\";\nimport { type Message } from \"../types.messages.js\";\nimport { getToolCallsWithResults } from \"../utils/tools.js\";\nimport { MessageTupleManager } from \"../ui/messages.js\";\nimport { Interrupt } from \"../schema.js\";\nimport { BytesLineDecoder, SSEDecoder } from \"../utils/sse.js\";\nimport { IterableReadableStream } from \"../utils/stream.js\";\nimport { useControllableThreadId } from \"./thread.js\";\nimport { Command } from \"../types.js\";\nimport type { BagTemplate } from \"../types.template.js\";\n\ninterface FetchStreamTransportOptions {\n  /**\n   * The URL of the API to use.\n   */\n  apiUrl: string;\n\n  /**\n   * Default headers to send with requests.\n   */\n  defaultHeaders?: HeadersInit;\n\n  /**\n   * Specify a custom fetch implementation.\n   */\n  fetch?: typeof fetch | ((...args: any[]) => any); // eslint-disable-line @typescript-eslint/no-explicit-any\n\n  /**\n   * Callback that is called before the request is made.\n   */\n  onRequest?: (\n    url: string,\n    init: RequestInit\n  ) => Promise<RequestInit> | RequestInit;\n}\n\nexport class FetchStreamTransport<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate\n> implements UseStreamTransport<StateType, Bag>\n{\n  constructor(private readonly options: FetchStreamTransportOptions) {}\n\n  async stream(payload: {\n    input: GetUpdateType<Bag, StateType> | null | undefined;\n    context: GetConfigurableType<Bag> | undefined;\n    command: Command | undefined;\n    signal: AbortSignal;\n  }): Promise<AsyncGenerator<{ id?: string; event: string; data: unknown }>> {\n    const { signal, ...body } = payload;\n\n    let requestInit: RequestInit = {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...this.options.defaultHeaders,\n      },\n      body: JSON.stringify(body),\n      signal,\n    };\n\n    if (this.options.onRequest) {\n      requestInit = await this.options.onRequest(\n        this.options.apiUrl,\n        requestInit\n      );\n    }\n    const fetchFn = this.options.fetch ?? fetch;\n\n    const response = await fetchFn(this.options.apiUrl, requestInit);\n    if (!response.ok) {\n      throw new Error(`Failed to stream: ${response.statusText}`);\n    }\n\n    const stream = (\n      response.body || new ReadableStream({ start: (ctrl) => ctrl.close() })\n    )\n      .pipeThrough(BytesLineDecoder())\n      .pipeThrough(SSEDecoder());\n\n    return IterableReadableStream.fromReadableStream(stream);\n  }\n}\n\nexport function useStreamCustom<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate\n>(\n  options: UseStreamCustomOptions<StateType, Bag>\n): UseStreamCustom<StateType, Bag> {\n  type UpdateType = GetUpdateType<Bag, StateType>;\n  type CustomType = GetCustomEventType<Bag>;\n  type InterruptType = GetInterruptType<Bag>;\n  type ConfigurableType = GetConfigurableType<Bag>;\n  type ToolCallType = GetToolCallsType<StateType>;\n\n  const [messageManager] = useState(() => new MessageTupleManager());\n  const [stream] = useState(\n    () =>\n      new StreamManager<StateType, Bag>(messageManager, {\n        throttle: options.throttle ?? false,\n      })\n  );\n\n  useSyncExternalStore(\n    stream.subscribe,\n    stream.getSnapshot,\n    stream.getSnapshot\n  );\n\n  const [threadId, onThreadId] = useControllableThreadId(options);\n  const threadIdRef = useRef<string | null>(threadId);\n\n  // Cancel the stream if thread ID has changed\n  useEffect(() => {\n    if (threadIdRef.current !== threadId) {\n      threadIdRef.current = threadId;\n      stream.clear();\n    }\n  }, [threadId, stream]);\n\n  const getMessages = (value: StateType): Message[] => {\n    const messagesKey = options.messagesKey ?? \"messages\";\n    return Array.isArray(value[messagesKey])\n      ? (value[messagesKey] as Message[])\n      : [];\n  };\n\n  const setMessages = (current: StateType, messages: Message[]): StateType => {\n    const messagesKey = options.messagesKey ?? \"messages\";\n    return { ...current, [messagesKey]: messages };\n  };\n\n  const historyValues = options.initialValues ?? ({} as StateType);\n\n  const stop = () => stream.stop(historyValues, { onStop: options.onStop });\n\n  const submit = async (\n    values: UpdateType | null | undefined,\n    submitOptions?: CustomSubmitOptions<StateType, ConfigurableType>\n  ) => {\n    let callbackMeta: RunCallbackMeta | undefined;\n    let usableThreadId = threadId;\n\n    stream.setStreamValues(() => {\n      if (submitOptions?.optimisticValues != null) {\n        return {\n          ...historyValues,\n          ...(typeof submitOptions.optimisticValues === \"function\"\n            ? submitOptions.optimisticValues(historyValues)\n            : submitOptions.optimisticValues),\n        };\n      }\n\n      return { ...historyValues };\n    });\n\n    await stream.start(\n      async (signal: AbortSignal) => {\n        if (!usableThreadId) {\n          // generate random thread id\n          usableThreadId = crypto.randomUUID();\n          threadIdRef.current = usableThreadId;\n          onThreadId(usableThreadId);\n        }\n\n        if (!usableThreadId) {\n          throw new Error(\"Failed to obtain valid thread ID.\");\n        }\n\n        return options.transport.stream({\n          input: values,\n          context: submitOptions?.context,\n          command: submitOptions?.command,\n          signal,\n          config: {\n            ...submitOptions?.config,\n            configurable: {\n              thread_id: usableThreadId,\n              ...submitOptions?.config?.configurable,\n            } as unknown as GetConfigurableType<Bag>,\n          },\n        }) as Promise<\n          AsyncGenerator<EventStreamEvent<StateType, UpdateType, CustomType>>\n        >;\n      },\n      {\n        getMessages,\n        setMessages,\n\n        initialValues: {} as StateType,\n        callbacks: options,\n\n        onSuccess: () => undefined,\n        onError(error) {\n          options.onError?.(error, callbackMeta);\n        },\n      }\n    );\n  };\n\n  return {\n    get values() {\n      return stream.values ?? ({} as StateType);\n    },\n\n    error: stream.error,\n    isLoading: stream.isLoading,\n\n    stop,\n    submit,\n\n    get interrupt(): Interrupt<InterruptType> | undefined {\n      if (\n        stream.values != null &&\n        \"__interrupt__\" in stream.values &&\n        Array.isArray(stream.values.__interrupt__)\n      ) {\n        const valueInterrupts = stream.values.__interrupt__;\n        if (valueInterrupts.length === 0) return { when: \"breakpoint\" };\n        if (valueInterrupts.length === 1) return valueInterrupts[0];\n\n        // TODO: fix the typing of interrupts if multiple interrupts are returned\n        return valueInterrupts as Interrupt<InterruptType>;\n      }\n\n      return undefined;\n    },\n\n    get messages(): Message<ToolCallType>[] {\n      if (!stream.values) return [];\n      return getMessages(stream.values);\n    },\n\n    get toolCalls() {\n      if (!stream.values) return [];\n      const msgs = getMessages(stream.values);\n      return getToolCallsWithResults<ToolCallType>(msgs);\n    },\n\n    getToolCalls(message) {\n      if (!stream.values) return [];\n      const msgs = getMessages(stream.values);\n      const allToolCalls = getToolCallsWithResults<ToolCallType>(msgs);\n      return allToolCalls.filter((tc) => tc.aiMessage.id === message.id);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/react/stream.d.cts

@@ -0,0 +1,155 @@
+import { Message } from "../types.messages.cjs";
+import { BagTemplate } from "../types.template.cjs";
+import { InferAgentToolCalls, UseStreamCustomOptions, UseStreamOptions } from "../ui/types.cjs";
+import { UseStream, UseStreamCustom } from "./types.cjs";
+
+//#region src/react/stream.d.ts
+
+/**
+ * Helper type that infers StateType based on whether T is an agent-like type, a CompiledGraph/Pregel instance, or a state type.
+ * - If T has `~agentTypes`, returns a state with typed messages based on the agent's tools
+ * - If T has `~RunOutput` (CompiledGraph/CompiledStateGraph), returns the state type
+ * - If T has `~OutputType` (Pregel), returns the output type as state
+ * - Otherwise, returns T (direct state type)
+ */
+type InferStateType<T> = T extends {
+  "~agentTypes": unknown;
+} ? {
+  messages: Message<InferAgentToolCalls<T>>[];
+} : T extends {
+  "~RunOutput": infer S;
+} ? S extends Record<string, unknown> ? S : Record<string, unknown> : T extends {
+  "~OutputType": infer O;
+} ? O extends Record<string, unknown> ? O : Record<string, unknown> : T extends Record<string, unknown> ? T : Record<string, unknown>;
+/**
+ * Helper type that infers Bag based on whether T is an agent-like type.
+ * - If T has `~agentTypes`, extracts bag from the agent's tools
+ * - Otherwise, returns the default BagTemplate
+ */
+type InferBag<T, B extends BagTemplate = BagTemplate> = T extends {
+  "~agentTypes": unknown;
+} ? BagTemplate : B;
+/**
+ * A React hook that provides seamless integration with LangGraph streaming capabilities.
+ *
+ * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,
+ * letting you focus on building great chat experiences. It provides automatic state management for
+ * messages, interrupts, loading states, and errors.
+ *
+ * ## Usage with ReactAgent (recommended for createAgent users)
+ *
+ * When using `createAgent` from `@langchain/langgraph`, you can pass `typeof agent` as the
+ * type parameter to automatically infer tool call types:
+ *
+ * @example
+ * ```typescript
+ * // In your agent file (e.g., agent.ts)
+ * import { createAgent, tool } from "@langchain/langgraph";
+ * import { z } from "zod";
+ *
+ * const getWeather = tool(
+ *   async ({ location }) => `Weather in ${location}`,
+ *   { name: "get_weather", schema: z.object({ location: z.string() }) }
+ * );
+ *
+ * export const agent = createAgent({
+ *   model: "openai:gpt-4o",
+ *   tools: [getWeather],
+ * });
+ *
+ * // In your React component
+ * import { agent } from "./agent";
+ *
+ * function Chat() {
+ *   // Tool calls are automatically typed from the agent's tools!
+ *   const stream = useStream<typeof agent>({
+ *     assistantId: "agent",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   // stream.toolCalls[0].call.name is typed as "get_weather"
+ *   // stream.toolCalls[0].call.args is typed as { location: string }
+ * }
+ * ```
+ *
+ * ## Usage with StateGraph (for custom LangGraph applications)
+ *
+ * When building custom graphs with `StateGraph`, embed your tool call types directly
+ * in your state's messages property using `Message<MyToolCalls>`:
+ *
+ * @example
+ * ```typescript
+ * import { Message } from "@langchain/langgraph-sdk";
+ *
+ * // Define your tool call types as a discriminated union
+ * type MyToolCalls =
+ *   | { name: "search"; args: { query: string }; id?: string }
+ *   | { name: "calculate"; args: { expression: string }; id?: string };
+ *
+ * // Embed tool call types in your state's messages
+ * interface MyGraphState {
+ *   messages: Message<MyToolCalls>[];
+ *   context?: string;
+ * }
+ *
+ * function Chat() {
+ *   const stream = useStream<MyGraphState>({
+ *     assistantId: "my-graph",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   // stream.values is typed as MyGraphState
+ *   // stream.toolCalls[0].call.name is typed as "search" | "calculate"
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With additional type configuration (interrupts, configurable)
+ * interface MyGraphState {
+ *   messages: Message<MyToolCalls>[];
+ * }
+ *
+ * function Chat() {
+ *   const stream = useStream<MyGraphState, {
+ *     InterruptType: { question: string };
+ *     ConfigurableType: { userId: string };
+ *   }>({
+ *     assistantId: "my-graph",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   // stream.interrupt is typed as { question: string } | undefined
+ * }
+ * ```
+ *
+ * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)
+ * @template Bag Type configuration bag containing:
+ *   - `ConfigurableType`: Type for the `config.configurable` property
+ *   - `InterruptType`: Type for interrupt values
+ *   - `CustomEventType`: Type for custom events
+ *   - `UpdateType`: Type for the submit function updates
+ *
+ * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}
+ */
+declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamOptions<InferStateType<T>, InferBag<T, Bag>>): UseStream<InferStateType<T>, InferBag<T, Bag>>;
+/**
+ * A React hook that provides seamless integration with LangGraph streaming capabilities.
+ *
+ * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,
+ * letting you focus on building great chat experiences. It provides automatic state management for
+ * messages, interrupts, loading states, and errors.
+ *
+ * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)
+ * @template Bag Type configuration bag containing:
+ *   - `ConfigurableType`: Type for the `config.configurable` property
+ *   - `InterruptType`: Type for interrupt values
+ *   - `CustomEventType`: Type for custom events
+ *   - `UpdateType`: Type for the submit function updates
+ *
+ * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}
+ */
+declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>): UseStreamCustom<InferStateType<T>, InferBag<T, Bag>>;
+//#endregion
+export { useStream };
+//# sourceMappingURL=stream.d.cts.map

package/dist/react/stream.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.cts","names":["UseStreamOptions","InferAgentToolCalls","Message","BagTemplate","UseStream","UseStreamCustom","UseStreamCustomOptions","InferStateType","T","S","Record","O","InferBag","B","useStream","Bag"],"sources":["../../src/react/stream.d.ts"],"sourcesContent":["import type { UseStreamOptions, InferAgentToolCalls } from \"../ui/types.js\";\nimport type { Message } from \"../types.messages.js\";\nimport type { BagTemplate } from \"../types.template.js\";\nimport type { UseStream, UseStreamCustom, UseStreamCustomOptions } from \"./types.js\";\n/**\n * Helper type that infers StateType based on whether T is an agent-like type, a CompiledGraph/Pregel instance, or a state type.\n * - If T has `~agentTypes`, returns a state with typed messages based on the agent's tools\n * - If T has `~RunOutput` (CompiledGraph/CompiledStateGraph), returns the state type\n * - If T has `~OutputType` (Pregel), returns the output type as state\n * - Otherwise, returns T (direct state type)\n */\ntype InferStateType<T> = T extends {\n    \"~agentTypes\": unknown;\n} ? {\n    messages: Message<InferAgentToolCalls<T>>[];\n} : T extends {\n    \"~RunOutput\": infer S;\n} ? S extends Record<string, unknown> ? S : Record<string, unknown> : T extends {\n    \"~OutputType\": infer O;\n} ? O extends Record<string, unknown> ? O : Record<string, unknown> : T extends Record<string, unknown> ? T : Record<string, unknown>;\n/**\n * Helper type that infers Bag based on whether T is an agent-like type.\n * - If T has `~agentTypes`, extracts bag from the agent's tools\n * - Otherwise, returns the default BagTemplate\n */\ntype InferBag<T, B extends BagTemplate = BagTemplate> = T extends {\n    \"~agentTypes\": unknown;\n} ? BagTemplate : B;\n/**\n * A React hook that provides seamless integration with LangGraph streaming capabilities.\n *\n * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,\n * letting you focus on building great chat experiences. It provides automatic state management for\n * messages, interrupts, loading states, and errors.\n *\n * ## Usage with ReactAgent (recommended for createAgent users)\n *\n * When using `createAgent` from `@langchain/langgraph`, you can pass `typeof agent` as the\n * type parameter to automatically infer tool call types:\n *\n * @example\n * ```typescript\n * // In your agent file (e.g., agent.ts)\n * import { createAgent, tool } from \"@langchain/langgraph\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n *   async ({ location }) => `Weather in ${location}`,\n *   { name: \"get_weather\", schema: z.object({ location: z.string() }) }\n * );\n *\n * export const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [getWeather],\n * });\n *\n * // In your React component\n * import { agent } from \"./agent\";\n *\n * function Chat() {\n *   // Tool calls are automatically typed from the agent's tools!\n *   const stream = useStream<typeof agent>({\n *     assistantId: \"agent\",\n *     apiUrl: \"http://localhost:2024\",\n *   });\n *\n *   // stream.toolCalls[0].call.name is typed as \"get_weather\"\n *   // stream.toolCalls[0].call.args is typed as { location: string }\n * }\n * ```\n *\n * ## Usage with StateGraph (for custom LangGraph applications)\n *\n * When building custom graphs with `StateGraph`, embed your tool call types directly\n * in your state's messages property using `Message<MyToolCalls>`:\n *\n * @example\n * ```typescript\n * import { Message } from \"@langchain/langgraph-sdk\";\n *\n * // Define your tool call types as a discriminated union\n * type MyToolCalls =\n *   | { name: \"search\"; args: { query: string }; id?: string }\n *   | { name: \"calculate\"; args: { expression: string }; id?: string };\n *\n * // Embed tool call types in your state's messages\n * interface MyGraphState {\n *   messages: Message<MyToolCalls>[];\n *   context?: string;\n * }\n *\n * function Chat() {\n *   const stream = useStream<MyGraphState>({\n *     assistantId: \"my-graph\",\n *     apiUrl: \"http://localhost:2024\",\n *   });\n *\n *   // stream.values is typed as MyGraphState\n *   // stream.toolCalls[0].call.name is typed as \"search\" | \"calculate\"\n * }\n * ```\n *\n * @example\n * ```typescript\n * // With additional type configuration (interrupts, configurable)\n * interface MyGraphState {\n *   messages: Message<MyToolCalls>[];\n * }\n *\n * function Chat() {\n *   const stream = useStream<MyGraphState, {\n *     InterruptType: { question: string };\n *     ConfigurableType: { userId: string };\n *   }>({\n *     assistantId: \"my-graph\",\n *     apiUrl: \"http://localhost:2024\",\n *   });\n *\n *   // stream.interrupt is typed as { question: string } | undefined\n * }\n * ```\n *\n * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)\n * @template Bag Type configuration bag containing:\n *   - `ConfigurableType`: Type for the `config.configurable` property\n *   - `InterruptType`: Type for interrupt values\n *   - `CustomEventType`: Type for custom events\n *   - `UpdateType`: Type for the submit function updates\n *\n * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}\n */\nexport declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamOptions<InferStateType<T>, InferBag<T, Bag>>): UseStream<InferStateType<T>, InferBag<T, Bag>>;\n/**\n * A React hook that provides seamless integration with LangGraph streaming capabilities.\n *\n * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,\n * letting you focus on building great chat experiences. It provides automatic state management for\n * messages, interrupts, loading states, and errors.\n *\n * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)\n * @template Bag Type configuration bag containing:\n *   - `ConfigurableType`: Type for the `config.configurable` property\n *   - `InterruptType`: Type for interrupt values\n *   - `CustomEventType`: Type for custom events\n *   - `UpdateType`: Type for the submit function updates\n *\n * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}\n */\nexport declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>): UseStreamCustom<InferStateType<T>, InferBag<T, Bag>>;\nexport {};\n"],"mappings":";;;;;;;;;AAGqF;;;;;KAQhFO,cAGSL,CAAAA,CAAAA,CAAAA,GAHWM,CAGXN,SAAAA;eACVM,EAAAA,OAAAA;;UAEUE,EAHAR,OAGAQ,CAHQT,mBAGRS,CAH4BF,CAG5BE,CAAAA,CAAAA,EAAAA;IAFVF,UAEoCC;cAAIC,EAAAA,KAAAA,EAAAA;IAAxCD,UAAUC,MAAwDF,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAA9BC,CAA8BD,GAA1BE,MAA0BF,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAAAA,CAAAA,SAAAA;eAElEG,EAAAA,KAAAA,EAAAA;IAAAA,UAAUD,MAAAA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAA0BC,CAA1BD,GAA8BA,MAA9BA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAAwDF,CAAxDE,SAAkEA,MAAlEA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAA4FF,CAA5FE,GAAgGA,MAAhGA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;;;;;;KAMTE,QANyGF,CAAAA,CAAAA,EAAAA,UAMnFP,WANmFO,GAMrEP,WANqEO,CAAAA,GAMtDF,CANsDE,SAAAA;EAAM,aAAA,EAAA,OAAA;AAAA,CAAA,GAQhHP,WAFS,GAEKU,CAFL;;;;;;;;AA0Gb;;;;;;;;;;;;;;;;;;AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAjBwBC,cAAcJ,qCAAqCP,cAAcA,sBAAsBH,iBAAiBO,eAAeC,IAAII,SAASJ,GAAGO,QAAQX,UAAUG,eAAeC,IAAII,SAASJ,GAAGO;;;;;;;;;;;;;;;;;iBAiBxLD,cAAcJ,qCAAqCP,cAAcA,sBAAsBG,uBAAuBC,eAAeC,IAAII,SAASJ,GAAGO,QAAQV,gBAAgBE,eAAeC,IAAII,SAASJ,GAAGO"}

package/dist/react/stream.d.ts

@@ -0,0 +1,155 @@
+import { Message } from "../types.messages.js";
+import { BagTemplate } from "../types.template.js";
+import { InferAgentToolCalls, UseStreamCustomOptions, UseStreamOptions } from "../ui/types.js";
+import { UseStream, UseStreamCustom } from "./types.js";
+
+//#region src/react/stream.d.ts
+
+/**
+ * Helper type that infers StateType based on whether T is an agent-like type, a CompiledGraph/Pregel instance, or a state type.
+ * - If T has `~agentTypes`, returns a state with typed messages based on the agent's tools
+ * - If T has `~RunOutput` (CompiledGraph/CompiledStateGraph), returns the state type
+ * - If T has `~OutputType` (Pregel), returns the output type as state
+ * - Otherwise, returns T (direct state type)
+ */
+type InferStateType<T> = T extends {
+  "~agentTypes": unknown;
+} ? {
+  messages: Message<InferAgentToolCalls<T>>[];
+} : T extends {
+  "~RunOutput": infer S;
+} ? S extends Record<string, unknown> ? S : Record<string, unknown> : T extends {
+  "~OutputType": infer O;
+} ? O extends Record<string, unknown> ? O : Record<string, unknown> : T extends Record<string, unknown> ? T : Record<string, unknown>;
+/**
+ * Helper type that infers Bag based on whether T is an agent-like type.
+ * - If T has `~agentTypes`, extracts bag from the agent's tools
+ * - Otherwise, returns the default BagTemplate
+ */
+type InferBag<T, B extends BagTemplate = BagTemplate> = T extends {
+  "~agentTypes": unknown;
+} ? BagTemplate : B;
+/**
+ * A React hook that provides seamless integration with LangGraph streaming capabilities.
+ *
+ * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,
+ * letting you focus on building great chat experiences. It provides automatic state management for
+ * messages, interrupts, loading states, and errors.
+ *
+ * ## Usage with ReactAgent (recommended for createAgent users)
+ *
+ * When using `createAgent` from `@langchain/langgraph`, you can pass `typeof agent` as the
+ * type parameter to automatically infer tool call types:
+ *
+ * @example
+ * ```typescript
+ * // In your agent file (e.g., agent.ts)
+ * import { createAgent, tool } from "@langchain/langgraph";
+ * import { z } from "zod";
+ *
+ * const getWeather = tool(
+ *   async ({ location }) => `Weather in ${location}`,
+ *   { name: "get_weather", schema: z.object({ location: z.string() }) }
+ * );
+ *
+ * export const agent = createAgent({
+ *   model: "openai:gpt-4o",
+ *   tools: [getWeather],
+ * });
+ *
+ * // In your React component
+ * import { agent } from "./agent";
+ *
+ * function Chat() {
+ *   // Tool calls are automatically typed from the agent's tools!
+ *   const stream = useStream<typeof agent>({
+ *     assistantId: "agent",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   // stream.toolCalls[0].call.name is typed as "get_weather"
+ *   // stream.toolCalls[0].call.args is typed as { location: string }
+ * }
+ * ```
+ *
+ * ## Usage with StateGraph (for custom LangGraph applications)
+ *
+ * When building custom graphs with `StateGraph`, embed your tool call types directly
+ * in your state's messages property using `Message<MyToolCalls>`:
+ *
+ * @example
+ * ```typescript
+ * import { Message } from "@langchain/langgraph-sdk";
+ *
+ * // Define your tool call types as a discriminated union
+ * type MyToolCalls =
+ *   | { name: "search"; args: { query: string }; id?: string }
+ *   | { name: "calculate"; args: { expression: string }; id?: string };
+ *
+ * // Embed tool call types in your state's messages
+ * interface MyGraphState {
+ *   messages: Message<MyToolCalls>[];
+ *   context?: string;
+ * }
+ *
+ * function Chat() {
+ *   const stream = useStream<MyGraphState>({
+ *     assistantId: "my-graph",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   // stream.values is typed as MyGraphState
+ *   // stream.toolCalls[0].call.name is typed as "search" | "calculate"
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With additional type configuration (interrupts, configurable)
+ * interface MyGraphState {
+ *   messages: Message<MyToolCalls>[];
+ * }
+ *
+ * function Chat() {
+ *   const stream = useStream<MyGraphState, {
+ *     InterruptType: { question: string };
+ *     ConfigurableType: { userId: string };
+ *   }>({
+ *     assistantId: "my-graph",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   // stream.interrupt is typed as { question: string } | undefined
+ * }
+ * ```
+ *
+ * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)
+ * @template Bag Type configuration bag containing:
+ *   - `ConfigurableType`: Type for the `config.configurable` property
+ *   - `InterruptType`: Type for interrupt values
+ *   - `CustomEventType`: Type for custom events
+ *   - `UpdateType`: Type for the submit function updates
+ *
+ * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}
+ */
+declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamOptions<InferStateType<T>, InferBag<T, Bag>>): UseStream<InferStateType<T>, InferBag<T, Bag>>;
+/**
+ * A React hook that provides seamless integration with LangGraph streaming capabilities.
+ *
+ * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,
+ * letting you focus on building great chat experiences. It provides automatic state management for
+ * messages, interrupts, loading states, and errors.
+ *
+ * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)
+ * @template Bag Type configuration bag containing:
+ *   - `ConfigurableType`: Type for the `config.configurable` property
+ *   - `InterruptType`: Type for interrupt values
+ *   - `CustomEventType`: Type for custom events
+ *   - `UpdateType`: Type for the submit function updates
+ *
+ * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}
+ */
+declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>): UseStreamCustom<InferStateType<T>, InferBag<T, Bag>>;
+//#endregion
+export { useStream };
+//# sourceMappingURL=stream.d.ts.map

package/dist/react/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","names":["UseStreamOptions","InferAgentToolCalls","Message","BagTemplate","UseStream","UseStreamCustom","UseStreamCustomOptions","InferStateType","T","S","Record","O","InferBag","B","useStream","Bag"],"sources":["../../src/react/stream.d.ts"],"sourcesContent":["import type { UseStreamOptions, InferAgentToolCalls } from \"../ui/types.js\";\nimport type { Message } from \"../types.messages.js\";\nimport type { BagTemplate } from \"../types.template.js\";\nimport type { UseStream, UseStreamCustom, UseStreamCustomOptions } from \"./types.js\";\n/**\n * Helper type that infers StateType based on whether T is an agent-like type, a CompiledGraph/Pregel instance, or a state type.\n * - If T has `~agentTypes`, returns a state with typed messages based on the agent's tools\n * - If T has `~RunOutput` (CompiledGraph/CompiledStateGraph), returns the state type\n * - If T has `~OutputType` (Pregel), returns the output type as state\n * - Otherwise, returns T (direct state type)\n */\ntype InferStateType<T> = T extends {\n    \"~agentTypes\": unknown;\n} ? {\n    messages: Message<InferAgentToolCalls<T>>[];\n} : T extends {\n    \"~RunOutput\": infer S;\n} ? S extends Record<string, unknown> ? S : Record<string, unknown> : T extends {\n    \"~OutputType\": infer O;\n} ? O extends Record<string, unknown> ? O : Record<string, unknown> : T extends Record<string, unknown> ? T : Record<string, unknown>;\n/**\n * Helper type that infers Bag based on whether T is an agent-like type.\n * - If T has `~agentTypes`, extracts bag from the agent's tools\n * - Otherwise, returns the default BagTemplate\n */\ntype InferBag<T, B extends BagTemplate = BagTemplate> = T extends {\n    \"~agentTypes\": unknown;\n} ? BagTemplate : B;\n/**\n * A React hook that provides seamless integration with LangGraph streaming capabilities.\n *\n * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,\n * letting you focus on building great chat experiences. It provides automatic state management for\n * messages, interrupts, loading states, and errors.\n *\n * ## Usage with ReactAgent (recommended for createAgent users)\n *\n * When using `createAgent` from `@langchain/langgraph`, you can pass `typeof agent` as the\n * type parameter to automatically infer tool call types:\n *\n * @example\n * ```typescript\n * // In your agent file (e.g., agent.ts)\n * import { createAgent, tool } from \"@langchain/langgraph\";\n * import { z } from \"zod\";\n *\n * const getWeather = tool(\n *   async ({ location }) => `Weather in ${location}`,\n *   { name: \"get_weather\", schema: z.object({ location: z.string() }) }\n * );\n *\n * export const agent = createAgent({\n *   model: \"openai:gpt-4o\",\n *   tools: [getWeather],\n * });\n *\n * // In your React component\n * import { agent } from \"./agent\";\n *\n * function Chat() {\n *   // Tool calls are automatically typed from the agent's tools!\n *   const stream = useStream<typeof agent>({\n *     assistantId: \"agent\",\n *     apiUrl: \"http://localhost:2024\",\n *   });\n *\n *   // stream.toolCalls[0].call.name is typed as \"get_weather\"\n *   // stream.toolCalls[0].call.args is typed as { location: string }\n * }\n * ```\n *\n * ## Usage with StateGraph (for custom LangGraph applications)\n *\n * When building custom graphs with `StateGraph`, embed your tool call types directly\n * in your state's messages property using `Message<MyToolCalls>`:\n *\n * @example\n * ```typescript\n * import { Message } from \"@langchain/langgraph-sdk\";\n *\n * // Define your tool call types as a discriminated union\n * type MyToolCalls =\n *   | { name: \"search\"; args: { query: string }; id?: string }\n *   | { name: \"calculate\"; args: { expression: string }; id?: string };\n *\n * // Embed tool call types in your state's messages\n * interface MyGraphState {\n *   messages: Message<MyToolCalls>[];\n *   context?: string;\n * }\n *\n * function Chat() {\n *   const stream = useStream<MyGraphState>({\n *     assistantId: \"my-graph\",\n *     apiUrl: \"http://localhost:2024\",\n *   });\n *\n *   // stream.values is typed as MyGraphState\n *   // stream.toolCalls[0].call.name is typed as \"search\" | \"calculate\"\n * }\n * ```\n *\n * @example\n * ```typescript\n * // With additional type configuration (interrupts, configurable)\n * interface MyGraphState {\n *   messages: Message<MyToolCalls>[];\n * }\n *\n * function Chat() {\n *   const stream = useStream<MyGraphState, {\n *     InterruptType: { question: string };\n *     ConfigurableType: { userId: string };\n *   }>({\n *     assistantId: \"my-graph\",\n *     apiUrl: \"http://localhost:2024\",\n *   });\n *\n *   // stream.interrupt is typed as { question: string } | undefined\n * }\n * ```\n *\n * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)\n * @template Bag Type configuration bag containing:\n *   - `ConfigurableType`: Type for the `config.configurable` property\n *   - `InterruptType`: Type for interrupt values\n *   - `CustomEventType`: Type for custom events\n *   - `UpdateType`: Type for the submit function updates\n *\n * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}\n */\nexport declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamOptions<InferStateType<T>, InferBag<T, Bag>>): UseStream<InferStateType<T>, InferBag<T, Bag>>;\n/**\n * A React hook that provides seamless integration with LangGraph streaming capabilities.\n *\n * The `useStream` hook handles all the complexities of streaming, state management, and branching logic,\n * letting you focus on building great chat experiences. It provides automatic state management for\n * messages, interrupts, loading states, and errors.\n *\n * @template T Either a ReactAgent type (with `~agentTypes`) or a state type (`Record<string, unknown>`)\n * @template Bag Type configuration bag containing:\n *   - `ConfigurableType`: Type for the `config.configurable` property\n *   - `InterruptType`: Type for interrupt values\n *   - `CustomEventType`: Type for custom events\n *   - `UpdateType`: Type for the submit function updates\n *\n * @see {@link https://docs.langchain.com/langgraph-platform/use-stream-react | LangGraph React Integration Guide}\n */\nexport declare function useStream<T = Record<string, unknown>, Bag extends BagTemplate = BagTemplate>(options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>): UseStreamCustom<InferStateType<T>, InferBag<T, Bag>>;\nexport {};\n"],"mappings":";;;;;;;;;AAGqF;;;;;KAQhFO,cAGSL,CAAAA,CAAAA,CAAAA,GAHWM,CAGXN,SAAAA;eACVM,EAAAA,OAAAA;;UAEUE,EAHAR,OAGAQ,CAHQT,mBAGRS,CAH4BF,CAG5BE,CAAAA,CAAAA,EAAAA;IAFVF,UAEoCC;cAAIC,EAAAA,KAAAA,EAAAA;IAAxCD,UAAUC,MAAwDF,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAA9BC,CAA8BD,GAA1BE,MAA0BF,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAAAA,CAAAA,SAAAA;eAElEG,EAAAA,KAAAA,EAAAA;IAAAA,UAAUD,MAAAA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAA0BC,CAA1BD,GAA8BA,MAA9BA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAAwDF,CAAxDE,SAAkEA,MAAlEA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA,GAA4FF,CAA5FE,GAAgGA,MAAhGA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;;;;;;KAMTE,QANyGF,CAAAA,CAAAA,EAAAA,UAMnFP,WANmFO,GAMrEP,WANqEO,CAAAA,GAMtDF,CANsDE,SAAAA;EAAM,aAAA,EAAA,OAAA;AAAA,CAAA,GAQhHP,WAFS,GAEKU,CAFL;;;;;;;;AA0Gb;;;;;;;;;;;;;;;;;;AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAjBwBC,cAAcJ,qCAAqCP,cAAcA,sBAAsBH,iBAAiBO,eAAeC,IAAII,SAASJ,GAAGO,QAAQX,UAAUG,eAAeC,IAAII,SAASJ,GAAGO;;;;;;;;;;;;;;;;;iBAiBxLD,cAAcJ,qCAAqCP,cAAcA,sBAAsBG,uBAAuBC,eAAeC,IAAII,SAASJ,GAAGO,QAAQV,gBAAgBE,eAAeC,IAAII,SAASJ,GAAGO"}

package/dist/react/stream.js

@@ -0,0 +1,17 @@
+import { useStreamLGP } from "./stream.lgp.js";
+import { useStreamCustom } from "./stream.custom.js";
+import { useState } from "react";
+
+//#region src/react/stream.tsx
+function isCustomOptions(options) {
+	return "transport" in options;
+}
+function useStream(options) {
+	const [isCustom] = useState(isCustomOptions(options));
+	if (isCustom) return useStreamCustom(options);
+	return useStreamLGP(options);
+}
+
+//#endregion
+export { useStream };
+//# sourceMappingURL=stream.js.map