@langchain/react 0.0.1

package/dist/react-ui/server/server.cjs

@@ -0,0 +1,57 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let uuid = require("uuid");
+
+//#region src/react-ui/server/server.ts
+/**
+* Helper to send and persist UI messages. Accepts a map of component names to React components
+* as type argument to provide type safety. Will also write to the `options?.stateKey` state.
+*
+* @param config LangGraphRunnableConfig
+* @param options
+* @returns
+*/
+const typedUi = (config, options) => {
+	const items = [];
+	const stateKey = options?.stateKey ?? "ui";
+	const runId = config.metadata?.run_id ?? config.runId;
+	if (!runId) throw new Error("run_id is required");
+	function handlePush(message, options) {
+		const evt = {
+			type: "ui",
+			id: message?.id ?? (0, uuid.v4)(),
+			name: message?.name,
+			props: message?.props,
+			metadata: {
+				merge: options?.merge || void 0,
+				run_id: runId,
+				tags: config.tags,
+				name: config.runName,
+				...message?.metadata,
+				...options?.message ? { message_id: options.message.id } : null
+			}
+		};
+		items.push(evt);
+		config.writer?.(evt);
+		config.configurable?.__pregel_send?.([[stateKey, evt]]);
+		return evt;
+	}
+	const handleDelete = (id) => {
+		const evt = {
+			type: "remove-ui",
+			id
+		};
+		items.push(evt);
+		config.writer?.(evt);
+		config.configurable?.__pregel_send?.([[stateKey, evt]]);
+		return evt;
+	};
+	return {
+		push: handlePush,
+		delete: handleDelete,
+		items
+	};
+};
+
+//#endregion
+exports.typedUi = typedUi;
+//# sourceMappingURL=server.cjs.map

package/dist/react-ui/server/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":[],"sources":["../../../src/react-ui/server/server.ts"],"sourcesContent":["import { v4 as uuidv4 } from \"uuid\";\nimport type { ComponentPropsWithoutRef, ElementType } from \"react\";\nimport type { RemoveUIMessage, UIMessage } from \"../types.js\";\n\ninterface MessageLike {\n  id?: string;\n}\n\n/**\n * Helper to send and persist UI messages. Accepts a map of component names to React components\n * as type argument to provide type safety. Will also write to the `options?.stateKey` state.\n *\n * @param config LangGraphRunnableConfig\n * @param options\n * @returns\n */\nexport const typedUi = <Decl extends Record<string, ElementType>>(\n  config: {\n    writer?: (chunk: unknown) => void;\n    runId?: string;\n    metadata?: Record<string, unknown>;\n    tags?: string[];\n    runName?: string;\n    configurable?: {\n      __pregel_send?: (writes_: [string, unknown][]) => void;\n      [key: string]: unknown;\n    };\n  },\n  options?: {\n    /** The key to write the UI messages to. Defaults to `ui`. */\n    stateKey?: string;\n  },\n) => {\n  type PropMap = { [K in keyof Decl]: ComponentPropsWithoutRef<Decl[K]> };\n  const items: (UIMessage | RemoveUIMessage)[] = [];\n  const stateKey = options?.stateKey ?? \"ui\";\n\n  const runId = (config.metadata?.run_id as string | undefined) ?? config.runId;\n  if (!runId) throw new Error(\"run_id is required\");\n\n  function handlePush<K extends keyof PropMap & string>(\n    message: {\n      id?: string;\n      name: K;\n      props: PropMap[K];\n      metadata?: Record<string, unknown>;\n    },\n    options?: { message?: MessageLike; merge?: boolean },\n  ): UIMessage<K, PropMap[K]>;\n\n  function handlePush<K extends keyof PropMap & string>(\n    message: {\n      id?: string;\n      name: K;\n      props: Partial<PropMap[K]>;\n      metadata?: Record<string, unknown>;\n    },\n    options: { message?: MessageLike; merge: true },\n  ): UIMessage<K, Partial<PropMap[K]>>;\n\n  function handlePush<K extends keyof PropMap & string>(\n    message: {\n      id?: string;\n      name: K;\n      props: PropMap[K] | Partial<PropMap[K]>;\n      metadata?: Record<string, unknown>;\n    },\n    options?: { message?: MessageLike; merge?: boolean },\n  ): UIMessage<K, PropMap[K] | Partial<PropMap[K]>> {\n    const evt: UIMessage<K, PropMap[K] | Partial<PropMap[K]>> = {\n      type: \"ui\" as const,\n      id: message?.id ?? uuidv4(),\n      name: message?.name,\n      props: message?.props,\n      metadata: {\n        merge: options?.merge || undefined,\n        run_id: runId,\n        tags: config.tags,\n        name: config.runName,\n        ...message?.metadata,\n        ...(options?.message ? { message_id: options.message.id } : null),\n      },\n    };\n    items.push(evt);\n    config.writer?.(evt);\n    config.configurable?.__pregel_send?.([[stateKey, evt]]);\n    return evt;\n  }\n\n  const handleDelete = (id: string): RemoveUIMessage => {\n    const evt: RemoveUIMessage = { type: \"remove-ui\", id };\n    items.push(evt);\n    config.writer?.(evt);\n    config.configurable?.__pregel_send?.([[stateKey, evt]]);\n    return evt;\n  };\n\n  return { push: handlePush, delete: handleDelete, items };\n};\n"],"mappings":";;;;;;;;;;;;AAgBA,MAAa,WACX,QAWA,YAIG;CAEH,MAAM,QAAyC,EAAE;CACjD,MAAM,WAAW,SAAS,YAAY;CAEtC,MAAM,QAAS,OAAO,UAAU,UAAiC,OAAO;AACxE,KAAI,CAAC,MAAO,OAAM,IAAI,MAAM,qBAAqB;CAsBjD,SAAS,WACP,SAMA,SACgD;EAChD,MAAM,MAAsD;GAC1D,MAAM;GACN,IAAI,SAAS,oBAAc;GAC3B,MAAM,SAAS;GACf,OAAO,SAAS;GAChB,UAAU;IACR,OAAO,SAAS,SAAS;IACzB,QAAQ;IACR,MAAM,OAAO;IACb,MAAM,OAAO;IACb,GAAG,SAAS;IACZ,GAAI,SAAS,UAAU,EAAE,YAAY,QAAQ,QAAQ,IAAI,GAAG;IAC7D;GACF;AACD,QAAM,KAAK,IAAI;AACf,SAAO,SAAS,IAAI;AACpB,SAAO,cAAc,gBAAgB,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;AACvD,SAAO;;CAGT,MAAM,gBAAgB,OAAgC;EACpD,MAAM,MAAuB;GAAE,MAAM;GAAa;GAAI;AACtD,QAAM,KAAK,IAAI;AACf,SAAO,SAAS,IAAI;AACpB,SAAO,cAAc,gBAAgB,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;AACvD,SAAO;;AAGT,QAAO;EAAE,MAAM;EAAY,QAAQ;EAAc;EAAO"}

package/dist/react-ui/server/server.d.cts

@@ -0,0 +1,54 @@
+import { RemoveUIMessage, UIMessage } from "../types.cjs";
+import { ComponentPropsWithoutRef, ElementType } from "react";
+
+//#region src/react-ui/server/server.d.ts
+interface MessageLike {
+  id?: string;
+}
+/**
+ * Helper to send and persist UI messages. Accepts a map of component names to React components
+ * as type argument to provide type safety. Will also write to the `options?.stateKey` state.
+ *
+ * @param config LangGraphRunnableConfig
+ * @param options
+ * @returns
+ */
+declare const typedUi: <Decl extends Record<string, ElementType>>(config: {
+  writer?: ((chunk: unknown) => void) | undefined;
+  runId?: string | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  tags?: string[] | undefined;
+  runName?: string | undefined;
+  configurable?: {
+    [key: string]: unknown;
+    __pregel_send?: ((writes_: [string, unknown][]) => void) | undefined;
+  } | undefined;
+}, options?: {
+  /** The key to write the UI messages to. Defaults to `ui`. */stateKey?: string | undefined;
+} | undefined) => {
+  push: {
+    <K extends keyof Decl & string>(message: {
+      id?: string | undefined;
+      name: K;
+      props: { [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K];
+      metadata?: Record<string, unknown> | undefined;
+    }, options?: {
+      message?: MessageLike | undefined;
+      merge?: boolean | undefined;
+    } | undefined): UIMessage<K, { [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K]>;
+    <K extends keyof Decl & string>(message: {
+      id?: string | undefined;
+      name: K;
+      props: Partial<{ [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K]>;
+      metadata?: Record<string, unknown> | undefined;
+    }, options: {
+      message?: MessageLike | undefined;
+      merge: true;
+    }): UIMessage<K, Partial<{ [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K]>>;
+  };
+  delete: (id: string) => RemoveUIMessage;
+  items: (RemoveUIMessage | UIMessage<string, Record<string, unknown>>)[];
+};
+//#endregion
+export { typedUi };
+//# sourceMappingURL=server.d.cts.map

package/dist/react-ui/server/server.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.cts","names":[],"sources":["../../../src/react-ui/server/server.ts"],"mappings":";;;;UAIU,WAAA;EACR,EAAA;AAAA;;;;;AAWF;;;;cAAa,OAAA,gBAAe,MAAA,SAAA,WAAA,GAAA,MAAA;;;;;;;;;;;;;;qBAwBL,IAAA,WAAA,OAAA;;;;;;;;;qBAUA,IAAA,WAAA,OAAA"}

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

@@ -0,0 +1,54 @@
+import { RemoveUIMessage, UIMessage } from "../types.js";
+import { ComponentPropsWithoutRef, ElementType } from "react";
+
+//#region src/react-ui/server/server.d.ts
+interface MessageLike {
+  id?: string;
+}
+/**
+ * Helper to send and persist UI messages. Accepts a map of component names to React components
+ * as type argument to provide type safety. Will also write to the `options?.stateKey` state.
+ *
+ * @param config LangGraphRunnableConfig
+ * @param options
+ * @returns
+ */
+declare const typedUi: <Decl extends Record<string, ElementType>>(config: {
+  writer?: ((chunk: unknown) => void) | undefined;
+  runId?: string | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  tags?: string[] | undefined;
+  runName?: string | undefined;
+  configurable?: {
+    [key: string]: unknown;
+    __pregel_send?: ((writes_: [string, unknown][]) => void) | undefined;
+  } | undefined;
+}, options?: {
+  /** The key to write the UI messages to. Defaults to `ui`. */stateKey?: string | undefined;
+} | undefined) => {
+  push: {
+    <K extends keyof Decl & string>(message: {
+      id?: string | undefined;
+      name: K;
+      props: { [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K];
+      metadata?: Record<string, unknown> | undefined;
+    }, options?: {
+      message?: MessageLike | undefined;
+      merge?: boolean | undefined;
+    } | undefined): UIMessage<K, { [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K]>;
+    <K extends keyof Decl & string>(message: {
+      id?: string | undefined;
+      name: K;
+      props: Partial<{ [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K]>;
+      metadata?: Record<string, unknown> | undefined;
+    }, options: {
+      message?: MessageLike | undefined;
+      merge: true;
+    }): UIMessage<K, Partial<{ [K_1 in keyof Decl]: ComponentPropsWithoutRef<Decl[K_1]> }[K]>>;
+  };
+  delete: (id: string) => RemoveUIMessage;
+  items: (RemoveUIMessage | UIMessage<string, Record<string, unknown>>)[];
+};
+//#endregion
+export { typedUi };
+//# sourceMappingURL=server.d.ts.map

package/dist/react-ui/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","names":[],"sources":["../../../src/react-ui/server/server.ts"],"mappings":";;;;UAIU,WAAA;EACR,EAAA;AAAA;;;;;AAWF;;;;cAAa,OAAA,gBAAe,MAAA,SAAA,WAAA,GAAA,MAAA;;;;;;;;;;;;;;qBAwBL,IAAA,WAAA,OAAA;;;;;;;;;qBAUA,IAAA,WAAA,OAAA"}

package/dist/react-ui/server/server.js

@@ -0,0 +1,56 @@
+import { v4 } from "uuid";
+
+//#region src/react-ui/server/server.ts
+/**
+* Helper to send and persist UI messages. Accepts a map of component names to React components
+* as type argument to provide type safety. Will also write to the `options?.stateKey` state.
+*
+* @param config LangGraphRunnableConfig
+* @param options
+* @returns
+*/
+const typedUi = (config, options) => {
+	const items = [];
+	const stateKey = options?.stateKey ?? "ui";
+	const runId = config.metadata?.run_id ?? config.runId;
+	if (!runId) throw new Error("run_id is required");
+	function handlePush(message, options) {
+		const evt = {
+			type: "ui",
+			id: message?.id ?? v4(),
+			name: message?.name,
+			props: message?.props,
+			metadata: {
+				merge: options?.merge || void 0,
+				run_id: runId,
+				tags: config.tags,
+				name: config.runName,
+				...message?.metadata,
+				...options?.message ? { message_id: options.message.id } : null
+			}
+		};
+		items.push(evt);
+		config.writer?.(evt);
+		config.configurable?.__pregel_send?.([[stateKey, evt]]);
+		return evt;
+	}
+	const handleDelete = (id) => {
+		const evt = {
+			type: "remove-ui",
+			id
+		};
+		items.push(evt);
+		config.writer?.(evt);
+		config.configurable?.__pregel_send?.([[stateKey, evt]]);
+		return evt;
+	};
+	return {
+		push: handlePush,
+		delete: handleDelete,
+		items
+	};
+};
+
+//#endregion
+export { typedUi };
+//# sourceMappingURL=server.js.map

package/dist/react-ui/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":["uuidv4"],"sources":["../../../src/react-ui/server/server.ts"],"sourcesContent":["import { v4 as uuidv4 } from \"uuid\";\nimport type { ComponentPropsWithoutRef, ElementType } from \"react\";\nimport type { RemoveUIMessage, UIMessage } from \"../types.js\";\n\ninterface MessageLike {\n  id?: string;\n}\n\n/**\n * Helper to send and persist UI messages. Accepts a map of component names to React components\n * as type argument to provide type safety. Will also write to the `options?.stateKey` state.\n *\n * @param config LangGraphRunnableConfig\n * @param options\n * @returns\n */\nexport const typedUi = <Decl extends Record<string, ElementType>>(\n  config: {\n    writer?: (chunk: unknown) => void;\n    runId?: string;\n    metadata?: Record<string, unknown>;\n    tags?: string[];\n    runName?: string;\n    configurable?: {\n      __pregel_send?: (writes_: [string, unknown][]) => void;\n      [key: string]: unknown;\n    };\n  },\n  options?: {\n    /** The key to write the UI messages to. Defaults to `ui`. */\n    stateKey?: string;\n  },\n) => {\n  type PropMap = { [K in keyof Decl]: ComponentPropsWithoutRef<Decl[K]> };\n  const items: (UIMessage | RemoveUIMessage)[] = [];\n  const stateKey = options?.stateKey ?? \"ui\";\n\n  const runId = (config.metadata?.run_id as string | undefined) ?? config.runId;\n  if (!runId) throw new Error(\"run_id is required\");\n\n  function handlePush<K extends keyof PropMap & string>(\n    message: {\n      id?: string;\n      name: K;\n      props: PropMap[K];\n      metadata?: Record<string, unknown>;\n    },\n    options?: { message?: MessageLike; merge?: boolean },\n  ): UIMessage<K, PropMap[K]>;\n\n  function handlePush<K extends keyof PropMap & string>(\n    message: {\n      id?: string;\n      name: K;\n      props: Partial<PropMap[K]>;\n      metadata?: Record<string, unknown>;\n    },\n    options: { message?: MessageLike; merge: true },\n  ): UIMessage<K, Partial<PropMap[K]>>;\n\n  function handlePush<K extends keyof PropMap & string>(\n    message: {\n      id?: string;\n      name: K;\n      props: PropMap[K] | Partial<PropMap[K]>;\n      metadata?: Record<string, unknown>;\n    },\n    options?: { message?: MessageLike; merge?: boolean },\n  ): UIMessage<K, PropMap[K] | Partial<PropMap[K]>> {\n    const evt: UIMessage<K, PropMap[K] | Partial<PropMap[K]>> = {\n      type: \"ui\" as const,\n      id: message?.id ?? uuidv4(),\n      name: message?.name,\n      props: message?.props,\n      metadata: {\n        merge: options?.merge || undefined,\n        run_id: runId,\n        tags: config.tags,\n        name: config.runName,\n        ...message?.metadata,\n        ...(options?.message ? { message_id: options.message.id } : null),\n      },\n    };\n    items.push(evt);\n    config.writer?.(evt);\n    config.configurable?.__pregel_send?.([[stateKey, evt]]);\n    return evt;\n  }\n\n  const handleDelete = (id: string): RemoveUIMessage => {\n    const evt: RemoveUIMessage = { type: \"remove-ui\", id };\n    items.push(evt);\n    config.writer?.(evt);\n    config.configurable?.__pregel_send?.([[stateKey, evt]]);\n    return evt;\n  };\n\n  return { push: handlePush, delete: handleDelete, items };\n};\n"],"mappings":";;;;;;;;;;;AAgBA,MAAa,WACX,QAWA,YAIG;CAEH,MAAM,QAAyC,EAAE;CACjD,MAAM,WAAW,SAAS,YAAY;CAEtC,MAAM,QAAS,OAAO,UAAU,UAAiC,OAAO;AACxE,KAAI,CAAC,MAAO,OAAM,IAAI,MAAM,qBAAqB;CAsBjD,SAAS,WACP,SAMA,SACgD;EAChD,MAAM,MAAsD;GAC1D,MAAM;GACN,IAAI,SAAS,MAAMA,IAAQ;GAC3B,MAAM,SAAS;GACf,OAAO,SAAS;GAChB,UAAU;IACR,OAAO,SAAS,SAAS;IACzB,QAAQ;IACR,MAAM,OAAO;IACb,MAAM,OAAO;IACb,GAAG,SAAS;IACZ,GAAI,SAAS,UAAU,EAAE,YAAY,QAAQ,QAAQ,IAAI,GAAG;IAC7D;GACF;AACD,QAAM,KAAK,IAAI;AACf,SAAO,SAAS,IAAI;AACpB,SAAO,cAAc,gBAAgB,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;AACvD,SAAO;;CAGT,MAAM,gBAAgB,OAAgC;EACpD,MAAM,MAAuB;GAAE,MAAM;GAAa;GAAI;AACtD,QAAM,KAAK,IAAI;AACf,SAAO,SAAS,IAAI;AACpB,SAAO,cAAc,gBAAgB,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;AACvD,SAAO;;AAGT,QAAO;EAAE,MAAM;EAAY,QAAQ;EAAc;EAAO"}

package/dist/react-ui/types.cjs

@@ -0,0 +1,38 @@
+
+//#region src/react-ui/types.ts
+function isUIMessage(message) {
+	if (typeof message !== "object" || message == null) return false;
+	if (!("type" in message)) return false;
+	return message.type === "ui";
+}
+function isRemoveUIMessage(message) {
+	if (typeof message !== "object" || message == null) return false;
+	if (!("type" in message)) return false;
+	return message.type === "remove-ui";
+}
+function uiMessageReducer(state, update) {
+	const events = Array.isArray(update) ? update : [update];
+	let newState = state.slice();
+	for (const event of events) {
+		if (event.type === "remove-ui") {
+			newState = newState.filter((ui) => ui.id !== event.id);
+			continue;
+		}
+		const index = state.findIndex((ui) => ui.id === event.id);
+		if (index !== -1) newState[index] = typeof event.metadata === "object" && event.metadata != null && event.metadata.merge ? {
+			...event,
+			props: {
+				...state[index].props,
+				...event.props
+			}
+		} : event;
+		else newState.push(event);
+	}
+	return newState;
+}
+
+//#endregion
+exports.isRemoveUIMessage = isRemoveUIMessage;
+exports.isUIMessage = isUIMessage;
+exports.uiMessageReducer = uiMessageReducer;
+//# sourceMappingURL=types.cjs.map

package/dist/react-ui/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/react-ui/types.ts"],"sourcesContent":["export interface UIMessage<\n  TName extends string = string,\n  TProps extends Record<string, unknown> = Record<string, unknown>,\n> {\n  type: \"ui\";\n\n  id: string;\n  name: TName;\n  props: TProps;\n  metadata?: {\n    merge?: boolean;\n    run_id?: string;\n    name?: string;\n    tags?: string[];\n    message_id?: string;\n    [key: string]: unknown;\n  };\n}\n\nexport interface RemoveUIMessage {\n  type: \"remove-ui\";\n  id: string;\n}\n\nexport function isUIMessage(message: unknown): message is UIMessage {\n  if (typeof message !== \"object\" || message == null) return false;\n  if (!(\"type\" in message)) return false;\n  return message.type === \"ui\";\n}\n\nexport function isRemoveUIMessage(\n  message: unknown,\n): message is RemoveUIMessage {\n  if (typeof message !== \"object\" || message == null) return false;\n  if (!(\"type\" in message)) return false;\n  return message.type === \"remove-ui\";\n}\n\nexport function uiMessageReducer(\n  state: UIMessage[],\n  update: UIMessage | RemoveUIMessage | (UIMessage | RemoveUIMessage)[],\n) {\n  const events = Array.isArray(update) ? update : [update];\n  let newState = state.slice();\n\n  for (const event of events) {\n    if (event.type === \"remove-ui\") {\n      newState = newState.filter((ui) => ui.id !== event.id);\n      continue;\n    }\n\n    const index = state.findIndex((ui) => ui.id === event.id);\n    if (index !== -1) {\n      newState[index] =\n        typeof event.metadata === \"object\" &&\n        event.metadata != null &&\n        event.metadata.merge\n          ? { ...event, props: { ...state[index].props, ...event.props } }\n          : event;\n    } else {\n      newState.push(event);\n    }\n  }\n\n  return newState;\n}\n"],"mappings":";;AAwBA,SAAgB,YAAY,SAAwC;AAClE,KAAI,OAAO,YAAY,YAAY,WAAW,KAAM,QAAO;AAC3D,KAAI,EAAE,UAAU,SAAU,QAAO;AACjC,QAAO,QAAQ,SAAS;;AAG1B,SAAgB,kBACd,SAC4B;AAC5B,KAAI,OAAO,YAAY,YAAY,WAAW,KAAM,QAAO;AAC3D,KAAI,EAAE,UAAU,SAAU,QAAO;AACjC,QAAO,QAAQ,SAAS;;AAG1B,SAAgB,iBACd,OACA,QACA;CACA,MAAM,SAAS,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO;CACxD,IAAI,WAAW,MAAM,OAAO;AAE5B,MAAK,MAAM,SAAS,QAAQ;AAC1B,MAAI,MAAM,SAAS,aAAa;AAC9B,cAAW,SAAS,QAAQ,OAAO,GAAG,OAAO,MAAM,GAAG;AACtD;;EAGF,MAAM,QAAQ,MAAM,WAAW,OAAO,GAAG,OAAO,MAAM,GAAG;AACzD,MAAI,UAAU,GACZ,UAAS,SACP,OAAO,MAAM,aAAa,YAC1B,MAAM,YAAY,QAClB,MAAM,SAAS,QACX;GAAE,GAAG;GAAO,OAAO;IAAE,GAAG,MAAM,OAAO;IAAO,GAAG,MAAM;IAAO;GAAE,GAC9D;MAEN,UAAS,KAAK,MAAM;;AAIxB,QAAO"}

package/dist/react-ui/types.d.cts

@@ -0,0 +1,25 @@
+//#region src/react-ui/types.d.ts
+interface UIMessage<TName extends string = string, TProps extends Record<string, unknown> = Record<string, unknown>> {
+  type: "ui";
+  id: string;
+  name: TName;
+  props: TProps;
+  metadata?: {
+    merge?: boolean;
+    run_id?: string;
+    name?: string;
+    tags?: string[];
+    message_id?: string;
+    [key: string]: unknown;
+  };
+}
+interface RemoveUIMessage {
+  type: "remove-ui";
+  id: string;
+}
+declare function isUIMessage(message: unknown): message is UIMessage;
+declare function isRemoveUIMessage(message: unknown): message is RemoveUIMessage;
+declare function uiMessageReducer(state: UIMessage[], update: UIMessage | RemoveUIMessage | (UIMessage | RemoveUIMessage)[]): UIMessage<string, Record<string, unknown>>[];
+//#endregion
+export { RemoveUIMessage, UIMessage, isRemoveUIMessage, isUIMessage, uiMessageReducer };
+//# sourceMappingURL=types.d.cts.map

package/dist/react-ui/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/react-ui/types.ts"],"mappings":";UAAiB,SAAA,+CAEA,MAAA,oBAA0B,MAAA;EAEzC,IAAA;EAEA,EAAA;EACA,IAAA,EAAM,KAAA;EACN,KAAA,EAAO,MAAA;EACP,QAAA;IACE,KAAA;IACA,MAAA;IACA,IAAA;IACA,IAAA;IACA,UAAA;IAAA,CACC,GAAA;EAAA;AAAA;AAAA,UAIY,eAAA;EACf,IAAA;EACA,EAAA;AAAA;AAAA,iBAGc,WAAA,CAAY,OAAA,YAAmB,OAAA,IAAW,SAAA;AAAA,iBAM1C,iBAAA,CACd,OAAA,YACC,OAAA,IAAW,eAAA;AAAA,iBAME,gBAAA,CACd,KAAA,EAAO,SAAA,IACP,MAAA,EAAQ,SAAA,GAAY,eAAA,IAAmB,SAAA,GAAY,eAAA,MAAkB,SAAA,SAAA,MAAA"}

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

@@ -0,0 +1,25 @@
+//#region src/react-ui/types.d.ts
+interface UIMessage<TName extends string = string, TProps extends Record<string, unknown> = Record<string, unknown>> {
+  type: "ui";
+  id: string;
+  name: TName;
+  props: TProps;
+  metadata?: {
+    merge?: boolean;
+    run_id?: string;
+    name?: string;
+    tags?: string[];
+    message_id?: string;
+    [key: string]: unknown;
+  };
+}
+interface RemoveUIMessage {
+  type: "remove-ui";
+  id: string;
+}
+declare function isUIMessage(message: unknown): message is UIMessage;
+declare function isRemoveUIMessage(message: unknown): message is RemoveUIMessage;
+declare function uiMessageReducer(state: UIMessage[], update: UIMessage | RemoveUIMessage | (UIMessage | RemoveUIMessage)[]): UIMessage<string, Record<string, unknown>>[];
+//#endregion
+export { RemoveUIMessage, UIMessage, isRemoveUIMessage, isUIMessage, uiMessageReducer };
+//# sourceMappingURL=types.d.ts.map

package/dist/react-ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/react-ui/types.ts"],"mappings":";UAAiB,SAAA,+CAEA,MAAA,oBAA0B,MAAA;EAEzC,IAAA;EAEA,EAAA;EACA,IAAA,EAAM,KAAA;EACN,KAAA,EAAO,MAAA;EACP,QAAA;IACE,KAAA;IACA,MAAA;IACA,IAAA;IACA,IAAA;IACA,UAAA;IAAA,CACC,GAAA;EAAA;AAAA;AAAA,UAIY,eAAA;EACf,IAAA;EACA,EAAA;AAAA;AAAA,iBAGc,WAAA,CAAY,OAAA,YAAmB,OAAA,IAAW,SAAA;AAAA,iBAM1C,iBAAA,CACd,OAAA,YACC,OAAA,IAAW,eAAA;AAAA,iBAME,gBAAA,CACd,KAAA,EAAO,SAAA,IACP,MAAA,EAAQ,SAAA,GAAY,eAAA,IAAmB,SAAA,GAAY,eAAA,MAAkB,SAAA,SAAA,MAAA"}

package/dist/react-ui/types.js

@@ -0,0 +1,35 @@
+//#region src/react-ui/types.ts
+function isUIMessage(message) {
+	if (typeof message !== "object" || message == null) return false;
+	if (!("type" in message)) return false;
+	return message.type === "ui";
+}
+function isRemoveUIMessage(message) {
+	if (typeof message !== "object" || message == null) return false;
+	if (!("type" in message)) return false;
+	return message.type === "remove-ui";
+}
+function uiMessageReducer(state, update) {
+	const events = Array.isArray(update) ? update : [update];
+	let newState = state.slice();
+	for (const event of events) {
+		if (event.type === "remove-ui") {
+			newState = newState.filter((ui) => ui.id !== event.id);
+			continue;
+		}
+		const index = state.findIndex((ui) => ui.id === event.id);
+		if (index !== -1) newState[index] = typeof event.metadata === "object" && event.metadata != null && event.metadata.merge ? {
+			...event,
+			props: {
+				...state[index].props,
+				...event.props
+			}
+		} : event;
+		else newState.push(event);
+	}
+	return newState;
+}
+
+//#endregion
+export { isRemoveUIMessage, isUIMessage, uiMessageReducer };
+//# sourceMappingURL=types.js.map

package/dist/react-ui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/react-ui/types.ts"],"sourcesContent":["export interface UIMessage<\n  TName extends string = string,\n  TProps extends Record<string, unknown> = Record<string, unknown>,\n> {\n  type: \"ui\";\n\n  id: string;\n  name: TName;\n  props: TProps;\n  metadata?: {\n    merge?: boolean;\n    run_id?: string;\n    name?: string;\n    tags?: string[];\n    message_id?: string;\n    [key: string]: unknown;\n  };\n}\n\nexport interface RemoveUIMessage {\n  type: \"remove-ui\";\n  id: string;\n}\n\nexport function isUIMessage(message: unknown): message is UIMessage {\n  if (typeof message !== \"object\" || message == null) return false;\n  if (!(\"type\" in message)) return false;\n  return message.type === \"ui\";\n}\n\nexport function isRemoveUIMessage(\n  message: unknown,\n): message is RemoveUIMessage {\n  if (typeof message !== \"object\" || message == null) return false;\n  if (!(\"type\" in message)) return false;\n  return message.type === \"remove-ui\";\n}\n\nexport function uiMessageReducer(\n  state: UIMessage[],\n  update: UIMessage | RemoveUIMessage | (UIMessage | RemoveUIMessage)[],\n) {\n  const events = Array.isArray(update) ? update : [update];\n  let newState = state.slice();\n\n  for (const event of events) {\n    if (event.type === \"remove-ui\") {\n      newState = newState.filter((ui) => ui.id !== event.id);\n      continue;\n    }\n\n    const index = state.findIndex((ui) => ui.id === event.id);\n    if (index !== -1) {\n      newState[index] =\n        typeof event.metadata === \"object\" &&\n        event.metadata != null &&\n        event.metadata.merge\n          ? { ...event, props: { ...state[index].props, ...event.props } }\n          : event;\n    } else {\n      newState.push(event);\n    }\n  }\n\n  return newState;\n}\n"],"mappings":";AAwBA,SAAgB,YAAY,SAAwC;AAClE,KAAI,OAAO,YAAY,YAAY,WAAW,KAAM,QAAO;AAC3D,KAAI,EAAE,UAAU,SAAU,QAAO;AACjC,QAAO,QAAQ,SAAS;;AAG1B,SAAgB,kBACd,SAC4B;AAC5B,KAAI,OAAO,YAAY,YAAY,WAAW,KAAM,QAAO;AAC3D,KAAI,EAAE,UAAU,SAAU,QAAO;AACjC,QAAO,QAAQ,SAAS;;AAG1B,SAAgB,iBACd,OACA,QACA;CACA,MAAM,SAAS,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO;CACxD,IAAI,WAAW,MAAM,OAAO;AAE5B,MAAK,MAAM,SAAS,QAAQ;AAC1B,MAAI,MAAM,SAAS,aAAa;AAC9B,cAAW,SAAS,QAAQ,OAAO,GAAG,OAAO,MAAM,GAAG;AACtD;;EAGF,MAAM,QAAQ,MAAM,WAAW,OAAO,GAAG,OAAO,MAAM,GAAG;AACzD,MAAI,UAAU,GACZ,UAAS,SACP,OAAO,MAAM,aAAa,YAC1B,MAAM,YAAY,QAClB,MAAM,SAAS,QACX;GAAE,GAAG;GAAO,OAAO;IAAE,GAAG,MAAM,OAAO;IAAO,GAAG,MAAM;IAAO;GAAE,GAC9D;MAEN,UAAS,KAAK,MAAM;;AAIxB,QAAO"}

package/dist/stream.cjs

@@ -0,0 +1,18 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_stream_lgp = require('./stream.lgp.cjs');
+const require_stream_custom = require('./stream.custom.cjs');
+let react = require("react");
+
+//#region src/stream.tsx
+function isCustomOptions(options) {
+	return "transport" in options;
+}
+function useStream(options) {
+	const [isCustom] = (0, react.useState)(isCustomOptions(options));
+	if (isCustom) return require_stream_custom.useStreamCustom(options);
+	return require_stream_lgp.useStreamLGP(options);
+}
+
+//#endregion
+exports.useStream = useStream;
+//# sourceMappingURL=stream.cjs.map

package/dist/stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.cjs","names":["useStreamCustom","useStreamLGP"],"sources":["../src/stream.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type {\n  BaseMessage,\n  ToolMessage as CoreToolMessage,\n  AIMessage as CoreAIMessage,\n} from \"@langchain/core/messages\";\nimport type { BagTemplate, ToolCallWithResult } from \"@langchain/langgraph-sdk\";\nimport type {\n  UseStreamOptions,\n  ResolveStreamInterface,\n  ResolveStreamOptions,\n  InferBag,\n  InferStateType,\n  MessageMetadata,\n} from \"@langchain/langgraph-sdk/ui\";\nimport { useStreamLGP } from \"./stream.lgp.js\";\nimport { useStreamCustom } from \"./stream.custom.js\";\nimport type { UseStreamCustomOptions } from \"./types.js\";\n\nfunction isCustomOptions<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate,\n>(\n  options:\n    | UseStreamOptions<StateType, Bag>\n    | UseStreamCustomOptions<StateType, Bag>,\n): options is UseStreamCustomOptions<StateType, Bag> {\n  return \"transport\" in options;\n}\n\ntype ClassToolCallWithResult<T> =\n  T extends ToolCallWithResult<infer TC, unknown, unknown>\n    ? ToolCallWithResult<TC, CoreToolMessage, CoreAIMessage>\n    : T;\n\n/**\n * Maps a stream interface to use @langchain/core BaseMessage class instances\n * instead of plain Message objects for the `messages` property, and remaps\n * tool call types to use @langchain/core message classes.\n */\ntype WithClassMessages<T> = Omit<\n  T,\n  \"messages\" | \"getMessagesMetadata\" | \"toolCalls\" | \"getToolCalls\"\n> & {\n  messages: BaseMessage[];\n  getMessagesMetadata: (\n    message: BaseMessage,\n    index?: number,\n  ) => MessageMetadata<Record<string, unknown>> | undefined;\n} & (\"toolCalls\" extends keyof T\n    ? {\n        toolCalls: T extends { toolCalls: (infer TC)[] }\n          ? ClassToolCallWithResult<TC>[]\n          : never;\n      }\n    : unknown) &\n  (\"getToolCalls\" extends keyof T\n    ? {\n        getToolCalls: T extends {\n          getToolCalls: (message: infer _M) => (infer TC)[];\n        }\n          ? (message: CoreAIMessage) => ClassToolCallWithResult<TC>[]\n          : never;\n      }\n    : unknown);\n\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, subagent streams, 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\";\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 * ## Usage with Deep Agents (subagent streaming, experimental)\n *\n * For agents that spawn subagents (nested graphs), use `filterSubagentMessages`\n * to keep the main message stream clean while tracking subagent activity separately:\n *\n * @example\n * ```typescript\n * import { useStream, SubagentStream } from \"@langchain/langgraph-sdk/react\";\n * import type { agent } from \"./agent\";\n *\n * function DeepAgentChat() {\n *   const stream = useStream<typeof agent>({\n *     assistantId: \"deepagent\",\n *     apiUrl: \"http://localhost:2024\",\n *     // Filter subagent messages from main stream\n *     filterSubagentMessages: true,\n *   });\n *\n *   const handleSubmit = (content: string) => {\n *     stream.submit(\n *       { messages: [{ content, type: \"human\" }] },\n *       { streamSubgraphs: true } // Enable subgraph streaming\n *     );\n *   };\n *\n *   // Access subagent streams via stream.subagents (Map<string, SubagentStream>)\n *   const subagentList = [...stream.subagents.values()];\n *\n *   return (\n *     <div>\n *       {stream.messages.map((msg) => <Message key={msg.id} message={msg} />)}\n *\n *       {subagentList.map((subagent) => (\n *         <SubagentCard\n *           key={subagent.id}\n *           status={subagent.status} // \"pending\" | \"running\" | \"complete\" | \"error\"\n *           messages={subagent.messages}\n *           toolCalls={subagent.toolCalls}\n *         />\n *       ))}\n *     </div>\n *   );\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 function useStream<\n  T = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate,\n>(\n  options: ResolveStreamOptions<T, InferBag<T, Bag>>,\n): WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>;\n\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 function useStream<\n  T = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate,\n>(\n  options: UseStreamCustomOptions<InferStateType<T>, InferBag<T, Bag>>,\n): WithClassMessages<ResolveStreamInterface<T, InferBag<T, Bag>>>;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useStream(options: any): any {\n  // Store this in useState to make sure we're not changing the implementation in re-renders\n  const [isCustom] = useState(isCustomOptions(options));\n\n  if (isCustom) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks\n    return useStreamCustom(options);\n  }\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  return useStreamLGP(options);\n}\n"],"mappings":";;;;;;AAmBA,SAAS,gBAIP,SAGmD;AACnD,QAAO,eAAe;;AA0NxB,SAAgB,UAAU,SAAmB;CAE3C,MAAM,CAAC,gCAAqB,gBAAgB,QAAQ,CAAC;AAErD,KAAI,SAEF,QAAOA,sCAAgB,QAAQ;AAIjC,QAAOC,gCAAa,QAAQ"}

package/dist/stream.custom.cjs

@@ -0,0 +1,162 @@
+"use client";
+
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_thread = require('./thread.cjs');
+let react = require("react");
+let _langchain_langgraph_sdk_ui = require("@langchain/langgraph-sdk/ui");
+let _langchain_langgraph_sdk_utils = require("@langchain/langgraph-sdk/utils");
+
+//#region src/stream.custom.tsx
+function useStreamCustom(options) {
+	const [messageManager] = (0, react.useState)(() => new _langchain_langgraph_sdk_ui.MessageTupleManager());
+	const [stream] = (0, react.useState)(() => new _langchain_langgraph_sdk_ui.StreamManager(messageManager, {
+		throttle: options.throttle ?? false,
+		subagentToolNames: options.subagentToolNames,
+		filterSubagentMessages: options.filterSubagentMessages,
+		toMessage: options.toMessage ?? _langchain_langgraph_sdk_ui.toMessageClass
+	}));
+	(0, react.useSyncExternalStore)(stream.subscribe, stream.getSnapshot, stream.getSnapshot);
+	const [threadId, onThreadId] = require_thread.useControllableThreadId(options);
+	const threadIdRef = (0, react.useRef)(threadId);
+	(0, react.useEffect)(() => {
+		if (threadIdRef.current !== threadId) {
+			threadIdRef.current = threadId;
+			stream.clear();
+		}
+	}, [threadId, stream]);
+	const switchThread = (0, react.useCallback)((newThreadId) => {
+		if (newThreadId !== threadIdRef.current) {
+			threadIdRef.current = newThreadId;
+			stream.clear();
+		}
+	}, [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 historyMessages = getMessages(historyValues);
+	const shouldReconstructSubagents = options.filterSubagentMessages && !stream.isLoading && historyMessages.length > 0;
+	(0, react.useEffect)(() => {
+		if (shouldReconstructSubagents) stream.reconstructSubagents(historyMessages, { skipIfPopulated: true });
+	}, [shouldReconstructSubagents, historyMessages.length]);
+	const stop = () => stream.stop(historyValues, { onStop: options.onStop });
+	const submitDirect = async (values, submitOptions) => {
+		if (threadId !== threadIdRef.current) {
+			threadIdRef.current = threadId;
+			stream.clear();
+		}
+		let usableThreadId = threadIdRef.current;
+		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, void 0);
+			}
+		});
+	};
+	const submit = async (values, submitOptions) => {
+		await submitDirect(values, submitOptions);
+	};
+	return {
+		get values() {
+			return stream.values ?? {};
+		},
+		error: stream.error,
+		isLoading: stream.isLoading,
+		stop,
+		submit,
+		switchThread,
+		get interrupts() {
+			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" }];
+				return valueInterrupts;
+			}
+			return [];
+		},
+		get interrupt() {
+			return (0, _langchain_langgraph_sdk_ui.extractInterrupts)(stream.values);
+		},
+		get messages() {
+			if (!stream.values) return [];
+			return getMessages(stream.values);
+		},
+		get toolCalls() {
+			if (!stream.values) return [];
+			return (0, _langchain_langgraph_sdk_utils.getToolCallsWithResults)(getMessages(stream.values));
+		},
+		getToolCalls(message) {
+			if (!stream.values) return [];
+			return (0, _langchain_langgraph_sdk_utils.getToolCallsWithResults)(getMessages(stream.values)).filter((tc) => tc.aiMessage.id === message.id);
+		},
+		get subagents() {
+			return stream.getSubagents();
+		},
+		get activeSubagents() {
+			return stream.getActiveSubagents();
+		},
+		getSubagent(toolCallId) {
+			return stream.getSubagent(toolCallId);
+		},
+		getSubagentsByType(type) {
+			return stream.getSubagentsByType(type);
+		},
+		getSubagentsByMessage(messageId) {
+			return stream.getSubagentsByMessage(messageId);
+		},
+		queue: {
+			get entries() {
+				return [];
+			},
+			get size() {
+				return 0;
+			},
+			async cancel() {
+				return false;
+			},
+			async clear() {}
+		}
+	};
+}
+
+//#endregion
+exports.useStreamCustom = useStreamCustom;
+//# sourceMappingURL=stream.custom.cjs.map

package/dist/stream.custom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.custom.cjs","names":["MessageTupleManager","StreamManager","toMessageClass","useControllableThreadId"],"sources":["../src/stream.custom.tsx"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\n\n\"use client\";\n\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from \"react\";\nimport {\n  StreamManager,\n  MessageTupleManager,\n  extractInterrupts,\n  FetchStreamTransport,\n  toMessageClass,\n  type EventStreamEvent,\n  type GetUpdateType,\n  type GetCustomEventType,\n  type GetInterruptType,\n  type GetToolCallsType,\n  type GetConfigurableType,\n  type AnyStreamCustomOptions,\n  type CustomSubmitOptions,\n} from \"@langchain/langgraph-sdk/ui\";\nimport { getToolCallsWithResults } from \"@langchain/langgraph-sdk/utils\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport type { BagTemplate, Message, Interrupt } from \"@langchain/langgraph-sdk\";\nimport { useControllableThreadId } from \"./thread.js\";\nimport type { UseStreamCustom } from \"./types.js\";\n\nexport { FetchStreamTransport };\n\nexport function useStreamCustom<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate,\n>(\n  options: AnyStreamCustomOptions<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        subagentToolNames: options.subagentToolNames,\n        filterSubagentMessages: options.filterSubagentMessages,\n        toMessage: options.toMessage ?? toMessageClass,\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 switchThread = useCallback(\n    (newThreadId: string | null) => {\n      if (newThreadId !== threadIdRef.current) {\n        threadIdRef.current = newThreadId;\n        stream.clear();\n      }\n    },\n    [stream],\n  );\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  // Reconstruct subagents from initialValues when:\n  // 1. Subagent filtering is enabled\n  // 2. Not currently streaming\n  // 3. initialValues has messages\n  // This ensures subagent visualization works with cached/persisted state\n  const historyMessages = getMessages(historyValues);\n  const shouldReconstructSubagents =\n    options.filterSubagentMessages &&\n    !stream.isLoading &&\n    historyMessages.length > 0;\n\n  useEffect(() => {\n    if (shouldReconstructSubagents) {\n      // skipIfPopulated: true ensures we don't overwrite subagents from active streaming\n      stream.reconstructSubagents(historyMessages, { skipIfPopulated: true });\n    }\n    // We intentionally only run this when shouldReconstructSubagents changes\n    // to avoid unnecessary reconstructions during streaming\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [shouldReconstructSubagents, historyMessages.length]);\n\n  const stop = () => stream.stop(historyValues, { onStop: options.onStop });\n\n  const submitDirect = async (\n    values: UpdateType | null | undefined,\n    submitOptions?: CustomSubmitOptions<StateType, ConfigurableType>,\n  ) => {\n    if (threadId !== threadIdRef.current) {\n      threadIdRef.current = threadId;\n      stream.clear();\n    }\n\n    let usableThreadId = threadIdRef.current;\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          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, undefined);\n        },\n      },\n    );\n  };\n\n  const submit = async (\n    values: UpdateType | null | undefined,\n    submitOptions?: CustomSubmitOptions<StateType, ConfigurableType>,\n  ) => {\n    await submitDirect(values, submitOptions);\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    switchThread,\n\n    get interrupts(): Interrupt<InterruptType>[] {\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        return valueInterrupts;\n      }\n\n      return [];\n    },\n\n    get interrupt(): Interrupt<InterruptType> | undefined {\n      return extractInterrupts<InterruptType>(stream.values);\n    },\n\n    get messages(): BaseMessage[] {\n      if (!stream.values) return [];\n      return getMessages(stream.values) as unknown as BaseMessage[];\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    get subagents() {\n      return stream.getSubagents();\n    },\n\n    get activeSubagents() {\n      return stream.getActiveSubagents();\n    },\n\n    getSubagent(toolCallId: string) {\n      return stream.getSubagent(toolCallId);\n    },\n\n    getSubagentsByType(type: string) {\n      return stream.getSubagentsByType(type);\n    },\n\n    getSubagentsByMessage(messageId: string) {\n      return stream.getSubagentsByMessage(messageId);\n    },\n\n    queue: {\n      get entries() {\n        return [];\n      },\n      get size() {\n        return 0;\n      },\n      async cancel() {\n        return false;\n      },\n      async clear() {},\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/stream.custom.d.cts

@@ -0,0 +1,3 @@
+import { BagTemplate } from "@langchain/langgraph-sdk";
+import { FetchStreamTransport } from "@langchain/langgraph-sdk/ui";
+export { FetchStreamTransport };

package/dist/stream.custom.d.ts

@@ -0,0 +1,4 @@
+import "./types.js";
+import { FetchStreamTransport } from "@langchain/langgraph-sdk/ui";
+import { BagTemplate } from "@langchain/langgraph-sdk";
+export { FetchStreamTransport };