@langchain/langgraph-sdk 0.1.9 → 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":["Client","ClientConfig","ThreadState","Interrupt","Config","Checkpoint","Metadata","Command","MultitaskStrategy","OnCompletionBehavior","DisconnectMode","Durability","Message","UpdatesStreamEvent","CustomStreamEvent","MetadataStreamEvent","EventsStreamEvent","DebugStreamEvent","CheckpointsStreamEvent","TasksStreamEvent","StreamMode","Sequence","MessageMetadata","Record","StateType","BagTemplate","GetUpdateType","Bag","Partial","GetConfigurableType","GetInterruptType","GetCustomEventType","RunCallbackMeta","UseStreamThread","Promise","UseStreamOptions","RunMetadataStorage","UseStream","SubmitOptions","ConfigWithConfigurable","ConfigurableType","ContextType","Omit","Array","UseStreamTransport","AbortSignal","AsyncGenerator","UseStreamCustomOptions","Pick","UseStreamCustom","CustomSubmitOptions"],"sources":["../../src/react/types.d.ts"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\nimport type { Client, ClientConfig } from \"../client.js\";\nimport type { ThreadState, Interrupt, Config, Checkpoint, Metadata } from \"../schema.js\";\nimport type { Command, MultitaskStrategy, OnCompletionBehavior, DisconnectMode, Durability } from \"../types.js\";\nimport type { Message } from \"../types.messages.js\";\nimport type { UpdatesStreamEvent, CustomStreamEvent, MetadataStreamEvent, EventsStreamEvent, DebugStreamEvent, CheckpointsStreamEvent, TasksStreamEvent, StreamMode } from \"../types.stream.js\";\nimport type { Sequence } from \"../ui/branching.js\";\nexport type MessageMetadata<StateType extends Record<string, unknown>> = {\n    /**\n     * The ID of the message used.\n     */\n    messageId: string;\n    /**\n     * The first thread state the message was seen in.\n     */\n    firstSeenState: ThreadState<StateType> | undefined;\n    /**\n     * The branch of the message.\n     */\n    branch: string | undefined;\n    /**\n     * The list of branches this message is part of.\n     * This is useful for displaying branching controls.\n     */\n    branchOptions: string[] | undefined;\n    /**\n     * Metadata sent alongside the message during run streaming.\n     * @remarks This metadata only exists temporarily in browser memory during streaming and is not persisted after completion.\n     */\n    streamMetadata: Record<string, unknown> | undefined;\n};\nexport type BagTemplate = {\n    ConfigurableType?: Record<string, unknown>;\n    InterruptType?: unknown;\n    CustomEventType?: unknown;\n    UpdateType?: unknown;\n};\nexport type GetUpdateType<Bag extends BagTemplate, StateType extends Record<string, unknown>> = Bag extends {\n    UpdateType: unknown;\n} ? Bag[\"UpdateType\"] : Partial<StateType>;\nexport type GetConfigurableType<Bag extends BagTemplate> = Bag extends {\n    ConfigurableType: Record<string, unknown>;\n} ? Bag[\"ConfigurableType\"] : Record<string, unknown>;\nexport type GetInterruptType<Bag extends BagTemplate> = Bag extends {\n    InterruptType: unknown;\n} ? Bag[\"InterruptType\"] : unknown;\nexport type GetCustomEventType<Bag extends BagTemplate> = Bag extends {\n    CustomEventType: unknown;\n} ? Bag[\"CustomEventType\"] : unknown;\nexport interface RunCallbackMeta {\n    run_id: string;\n    thread_id: string;\n}\nexport interface UseStreamThread<StateType extends Record<string, unknown>> {\n    data: ThreadState<StateType>[] | null | undefined;\n    error: unknown;\n    isLoading: boolean;\n    mutate: (mutateId?: string) => Promise<ThreadState<StateType>[] | null | undefined>;\n}\nexport interface UseStreamOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {\n    /**\n     * The ID of the assistant to use.\n     */\n    assistantId: string;\n    /**\n     * Client used to send requests.\n     */\n    client?: Client;\n    /**\n     * The URL of the API to use.\n     */\n    apiUrl?: ClientConfig[\"apiUrl\"];\n    /**\n     * The API key to use.\n     */\n    apiKey?: ClientConfig[\"apiKey\"];\n    /**\n     * Custom call options, such as custom fetch implementation.\n     */\n    callerOptions?: ClientConfig[\"callerOptions\"];\n    /**\n     * Default headers to send with requests.\n     */\n    defaultHeaders?: ClientConfig[\"defaultHeaders\"];\n    /**\n     * Specify the key within the state that contains messages.\n     * Defaults to \"messages\".\n     *\n     * @default \"messages\"\n     */\n    messagesKey?: string;\n    /**\n     * Callback that is called when an error occurs.\n     */\n    onError?: (error: unknown, run: RunCallbackMeta | undefined) => void;\n    /**\n     * Callback that is called when the stream is finished.\n     */\n    onFinish?: (state: ThreadState<StateType>, run: RunCallbackMeta | undefined) => void;\n    /**\n     * Callback that is called when a new stream is created.\n     */\n    onCreated?: (run: RunCallbackMeta) => void;\n    /**\n     * Callback that is called when an update event is received.\n     */\n    onUpdateEvent?: (data: UpdatesStreamEvent<GetUpdateType<Bag, StateType>>[\"data\"], options: {\n        namespace: string[] | undefined;\n        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;\n    }) => void;\n    /**\n     * Callback that is called when a custom event is received.\n     */\n    onCustomEvent?: (data: CustomStreamEvent<GetCustomEventType<Bag>>[\"data\"], options: {\n        namespace: string[] | undefined;\n        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;\n    }) => void;\n    /**\n     * Callback that is called when a metadata event is received.\n     */\n    onMetadataEvent?: (data: MetadataStreamEvent[\"data\"]) => void;\n    /**\n     * Callback that is called when a LangChain event is received.\n     * @see https://langchain-ai.github.io/langgraph/cloud/how-tos/stream_events/#stream-graph-in-events-mode for more details.\n     */\n    onLangChainEvent?: (data: EventsStreamEvent[\"data\"]) => void;\n    /**\n     * Callback that is called when a debug event is received.\n     * @internal This API is experimental and subject to change.\n     */\n    onDebugEvent?: (data: DebugStreamEvent[\"data\"], options: {\n        namespace: string[] | undefined;\n    }) => void;\n    /**\n     * Callback that is called when a checkpoints event is received.\n     */\n    onCheckpointEvent?: (data: CheckpointsStreamEvent<StateType>[\"data\"], options: {\n        namespace: string[] | undefined;\n    }) => void;\n    /**\n     * Callback that is called when a tasks event is received.\n     */\n    onTaskEvent?: (data: TasksStreamEvent<StateType, GetUpdateType<Bag, StateType>>[\"data\"], options: {\n        namespace: string[] | undefined;\n    }) => void;\n    /**\n     * Callback that is called when the stream is stopped by the user.\n     * Provides a mutate function to update the stream state immediately\n     * without requiring a server roundtrip.\n     *\n     * @example\n     * ```typescript\n     * onStop: ({ mutate }) => {\n     *   mutate((prev) => ({\n     *     ...prev,\n     *     ui: prev.ui?.map(component =>\n     *       component.props.isLoading\n     *         ? { ...component, props: { ...component.props, stopped: true, isLoading: false }}\n     *         : component\n     *     )\n     *   }));\n     * }\n     * ```\n     */\n    onStop?: (options: {\n        mutate: (update: Partial<StateType> | ((prev: StateType) => Partial<StateType>)) => void;\n    }) => void;\n    /**\n     * The ID of the thread to fetch history and current values from.\n     */\n    threadId?: string | null;\n    /**\n     * Callback that is called when the thread ID is updated (ie when a new thread is created).\n     */\n    onThreadId?: (threadId: string) => void;\n    /** Will reconnect the stream on mount */\n    reconnectOnMount?: boolean | (() => RunMetadataStorage);\n    /**\n     * Initial values to display immediately when loading a thread.\n     * Useful for displaying cached thread data while official history loads.\n     * These values will be replaced when official thread data is fetched.\n     *\n     * Note: UI components from initialValues will render immediately if they're\n     * predefined in LoadExternalComponent's components prop, providing instant\n     * cached UI display without server fetches.\n     */\n    initialValues?: StateType | null;\n    /**\n     * Whether to fetch the history of the thread.\n     * If true, the history will be fetched from the server. Defaults to 10 entries.\n     * If false, only the last state will be fetched from the server.\n     * @default true\n     */\n    fetchStateHistory?: boolean | {\n        limit: number;\n    };\n    /**\n     * Manage the thread state externally.\n     * @experimental\n     */\n    experimental_thread?: UseStreamThread<StateType>;\n}\ninterface RunMetadataStorage {\n    getItem(key: `lg:stream:${string}`): string | null;\n    setItem(key: `lg:stream:${string}`, value: string): void;\n    removeItem(key: `lg:stream:${string}`): void;\n}\nexport interface UseStream<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {\n    /**\n     * The current values of the thread.\n     */\n    values: StateType;\n    /**\n     * Last seen error from the thread or during streaming.\n     */\n    error: unknown;\n    /**\n     * Whether the stream is currently running.\n     */\n    isLoading: boolean;\n    /**\n     * Whether the thread is currently being loaded.\n     */\n    isThreadLoading: boolean;\n    /**\n     * Stops the stream.\n     */\n    stop: () => Promise<void>;\n    /**\n     * Create and stream a run to the thread.\n     */\n    submit: (values: GetUpdateType<Bag, StateType> | null | undefined, options?: SubmitOptions<StateType, GetConfigurableType<Bag>>) => Promise<void>;\n    /**\n     * The current branch of the thread.\n     */\n    branch: string;\n    /**\n     * Set the branch of the thread.\n     */\n    setBranch: (branch: string) => void;\n    /**\n     * Flattened history of thread states of a thread.\n     */\n    history: ThreadState<StateType>[];\n    /**\n     * Tree of all branches for the thread.\n     * @experimental\n     */\n    experimental_branchTree: Sequence<StateType>;\n    /**\n     * Get the interrupt value for the stream if interrupted.\n     */\n    interrupt: Interrupt<GetInterruptType<Bag>> | undefined;\n    /**\n     * Messages inferred from the thread.\n     * Will automatically update with incoming message chunks.\n     */\n    messages: Message[];\n    /**\n     * Get the metadata for a message, such as first thread state the message\n     * was seen in and branch information.\n     \n     * @param message - The message to get the metadata for.\n     * @param index - The index of the message in the thread.\n     * @returns The metadata for the message.\n     */\n    getMessagesMetadata: (message: Message, index?: number) => MessageMetadata<StateType> | undefined;\n    /**\n     * LangGraph SDK client used to send request and receive responses.\n     */\n    client: Client;\n    /**\n     * The ID of the assistant to use.\n     */\n    assistantId: string;\n    /**\n     * Join an active stream.\n     */\n    joinStream: (runId: string, lastEventId?: string, options?: {\n        streamMode?: StreamMode | StreamMode[];\n    }) => Promise<void>;\n}\ntype ConfigWithConfigurable<ConfigurableType extends Record<string, unknown>> = Config & {\n    configurable?: ConfigurableType;\n};\nexport interface SubmitOptions<StateType extends Record<string, unknown> = Record<string, unknown>, ContextType extends Record<string, unknown> = Record<string, unknown>> {\n    config?: ConfigWithConfigurable<ContextType>;\n    context?: ContextType;\n    checkpoint?: Omit<Checkpoint, \"thread_id\"> | null;\n    command?: Command;\n    interruptBefore?: \"*\" | string[];\n    interruptAfter?: \"*\" | string[];\n    metadata?: Metadata;\n    multitaskStrategy?: MultitaskStrategy;\n    onCompletion?: OnCompletionBehavior;\n    onDisconnect?: DisconnectMode;\n    feedbackKeys?: string[];\n    streamMode?: Array<StreamMode>;\n    optimisticValues?: Partial<StateType> | ((prev: StateType) => Partial<StateType>);\n    /**\n     * Whether or not to stream the nodes of any subgraphs called\n     * by the assistant.\n     * @default false\n     */\n    streamSubgraphs?: boolean;\n    /**\n     * Mark the stream as resumable. All events emitted during the run will be temporarily persisted\n     * in order to be re-emitted if the stream is re-joined.\n     * @default false\n     */\n    streamResumable?: boolean;\n    /**\n     * Whether to checkpoint during the run (or only at the end/interruption).\n     * - `\"async\"`: Save checkpoint asynchronously while the next step executes (default).\n     * - `\"sync\"`: Save checkpoint synchronously before the next step starts.\n     * - `\"exit\"`: Save checkpoint only when the graph exits.\n     * @default \"async\"\n     */\n    durability?: Durability;\n    /**\n     * The ID to use when creating a new thread. When provided, this ID will be used\n     * for thread creation when threadId is `null` or `undefined`.\n     * This enables optimistic UI updates where you know the thread ID\n     * before the thread is actually created.\n     */\n    threadId?: string;\n}\n/**\n * Transport used to stream the thread.\n * Only applicable for custom endpoints using `toLangGraphEventStream` or `toLangGraphEventStreamResponse`.\n */\nexport interface UseStreamTransport<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> {\n    stream: (payload: {\n        input: GetUpdateType<Bag, StateType> | null | undefined;\n        context: GetConfigurableType<Bag> | undefined;\n        command: Command | undefined;\n        config: ConfigWithConfigurable<GetConfigurableType<Bag>> | undefined;\n        signal: AbortSignal;\n    }) => Promise<AsyncGenerator<{\n        id?: string;\n        event: string;\n        data: unknown;\n    }>>;\n}\nexport type UseStreamCustomOptions<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> = Pick<UseStreamOptions<StateType, Bag>, \"messagesKey\" | \"threadId\" | \"onThreadId\" | \"onError\" | \"onCreated\" | \"onUpdateEvent\" | \"onCustomEvent\" | \"onMetadataEvent\" | \"onLangChainEvent\" | \"onDebugEvent\" | \"onCheckpointEvent\" | \"onTaskEvent\" | \"onStop\" | \"initialValues\"> & {\n    transport: UseStreamTransport<StateType, Bag>;\n};\nexport type UseStreamCustom<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> = Pick<UseStream<StateType, Bag>, \"values\" | \"error\" | \"isLoading\" | \"stop\" | \"interrupt\" | \"messages\"> & {\n    submit: (values: GetUpdateType<Bag, StateType> | null | undefined, options?: CustomSubmitOptions<StateType, GetConfigurableType<Bag>>) => Promise<void>;\n};\nexport type CustomSubmitOptions<StateType extends Record<string, unknown> = Record<string, unknown>, ConfigurableType extends Record<string, unknown> = Record<string, unknown>> = Pick<SubmitOptions<StateType, ConfigurableType>, \"optimisticValues\" | \"context\" | \"command\" | \"config\">;\nexport {};\n"],"mappings":"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"}

package/dist/react-ui/client.cjs

@@ -1,198 +1,137 @@
-"use strict";
 "use client";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useStreamContext = useStreamContext;
-exports.LoadExternalComponent = LoadExternalComponent;
-exports.experimental_loadShare = experimental_loadShare;
-exports.bootstrapUiContext = bootstrapUiContext;
-const jsx_runtime_1 = require("react/jsx-runtime");
-const React = __importStar(require("react"));
-const ReactDOM = __importStar(require("react-dom"));
-const JsxRuntime = __importStar(require("react/jsx-runtime"));
-const index_js_1 = require("../react/index.cjs");
-const UseStreamContext = React.createContext(null);
+
+
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_stream = require('../react/stream.cjs');
+require('../react/index.cjs');
+const react = require_rolldown_runtime.__toESM(require("react"));
+const react_dom = require_rolldown_runtime.__toESM(require("react-dom"));
+const react_jsx_runtime = require_rolldown_runtime.__toESM(require("react/jsx-runtime"));
+
+//#region src/react-ui/client.tsx
+const UseStreamContext = react.createContext(null);
 function useStreamContext() {
-    const ctx = React.useContext(UseStreamContext);
-    if (!ctx) {
-        throw new Error("useStreamContext must be used within a LoadExternalComponent");
-    }
-    return new Proxy(ctx, {
-        get(target, prop) {
-            if (prop === "meta")
-                return target.meta;
-            return target.stream[prop];
-        },
-    });
-}
-class ComponentStore {
-    constructor() {
-        Object.defineProperty(this, "cache", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "boundCache", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "callbacks", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-    }
-    respond(shadowRootId, comp, targetElement) {
-        this.cache[shadowRootId] = { comp, target: targetElement };
-        this.callbacks[shadowRootId]?.forEach((c) => c(comp, targetElement));
-    }
-    getBoundStore(shadowRootId) {
-        this.boundCache[shadowRootId] ??= {
-            subscribe: (onStoreChange) => {
-                this.callbacks[shadowRootId] ??= [];
-                this.callbacks[shadowRootId].push(onStoreChange);
-                return () => {
-                    this.callbacks[shadowRootId] = this.callbacks[shadowRootId].filter((c) => c !== onStoreChange);
-                };
-            },
-            getSnapshot: () => this.cache[shadowRootId],
-        };
-        return this.boundCache[shadowRootId];
-    }
+	const ctx = react.useContext(UseStreamContext);
+	if (!ctx) throw new Error("useStreamContext must be used within a LoadExternalComponent");
+	return new Proxy(ctx, { get(target, prop) {
+		if (prop === "meta") return target.meta;
+		return target.stream[prop];
+	} });
 }
+var ComponentStore = class {
+	cache = {};
+	boundCache = {};
+	callbacks = {};
+	respond(shadowRootId, comp, targetElement) {
+		this.cache[shadowRootId] = {
+			comp,
+			target: targetElement
+		};
+		this.callbacks[shadowRootId]?.forEach((c) => c(comp, targetElement));
+	}
+	getBoundStore(shadowRootId) {
+		this.boundCache[shadowRootId] ??= {
+			subscribe: (onStoreChange) => {
+				this.callbacks[shadowRootId] ??= [];
+				this.callbacks[shadowRootId].push(onStoreChange);
+				return () => {
+					this.callbacks[shadowRootId] = this.callbacks[shadowRootId].filter((c) => c !== onStoreChange);
+				};
+			},
+			getSnapshot: () => this.cache[shadowRootId]
+		};
+		return this.boundCache[shadowRootId];
+	}
+};
 const COMPONENT_STORE = new ComponentStore();
 const EXT_STORE_SYMBOL = Symbol.for("LGUI_EXT_STORE");
 const REQUIRE_SYMBOL = Symbol.for("LGUI_REQUIRE");
 const REQUIRE_EXTRA_SYMBOL = Symbol.for("LGUI_REQUIRE_EXTRA");
 const isIterable = (value) => value != null && typeof value === "object" && Symbol.iterator in value;
-const isPromise = (value) => value != null &&
-    typeof value === "object" &&
-    "then" in value &&
-    typeof value.then === "function";
+const isPromise = (value) => value != null && typeof value === "object" && "then" in value && typeof value.then === "function";
 const isReactNode = (value) => {
-    if (React.isValidElement(value))
-        return true;
-    if (value == null)
-        return true;
-    if (typeof value === "string" ||
-        typeof value === "number" ||
-        typeof value === "bigint" ||
-        typeof value === "boolean") {
-        return true;
-    }
-    if (isIterable(value))
-        return true;
-    if (isPromise(value))
-        return true;
-    return false;
+	if (react.isValidElement(value)) return true;
+	if (value == null) return true;
+	if (typeof value === "string" || typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") return true;
+	if (isIterable(value)) return true;
+	if (isPromise(value)) return true;
+	return false;
 };
-function LoadExternalComponent({ stream, namespace, message, meta, fallback, components, ...props }) {
-    const ref = React.useRef(null);
-    const id = React.useId();
-    const shadowRootId = `child-shadow-${id}`;
-    const store = React.useMemo(() => COMPONENT_STORE.getBoundStore(shadowRootId), [shadowRootId]);
-    const state = React.useSyncExternalStore(store.subscribe, store.getSnapshot);
-    const clientComponent = components?.[message.name];
-    const hasClientComponent = clientComponent != null;
-    let fallbackComponent = null;
-    if (isReactNode(fallback)) {
-        fallbackComponent = fallback;
-    }
-    else if (typeof fallback === "object" && fallback != null) {
-        fallbackComponent = fallback?.[message.name];
-    }
-    const uiNamespace = namespace ?? stream.assistantId;
-    const uiClient = stream.client["~ui"];
-    React.useEffect(() => {
-        if (hasClientComponent)
-            return;
-        void uiClient.getComponent(uiNamespace, message.name).then((html) => {
-            const dom = ref.current;
-            if (!dom)
-                return;
-            const root = dom.shadowRoot ?? dom.attachShadow({ mode: "open" });
-            const fragment = document
-                .createRange()
-                .createContextualFragment(html.replace("{{shadowRootId}}", shadowRootId));
-            root.appendChild(fragment);
-        });
-    }, [uiClient, uiNamespace, message.name, shadowRootId, hasClientComponent]);
-    if (hasClientComponent) {
-        return ((0, jsx_runtime_1.jsx)(UseStreamContext.Provider, { value: { stream, meta }, children: React.createElement(clientComponent, message.props) }));
-    }
-    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("div", { id: shadowRootId, ref: ref, ...props }), (0, jsx_runtime_1.jsx)(UseStreamContext.Provider, { value: { stream, meta }, children: state?.target != null
-                    ? ReactDOM.createPortal(React.createElement(state.comp, message.props), state.target)
-                    : fallbackComponent })] }));
+function LoadExternalComponent({ stream, namespace, message, meta, fallback, components,...props }) {
+	const ref = react.useRef(null);
+	const id = react.useId();
+	const shadowRootId = `child-shadow-${id}`;
+	const store = react.useMemo(() => COMPONENT_STORE.getBoundStore(shadowRootId), [shadowRootId]);
+	const state = react.useSyncExternalStore(store.subscribe, store.getSnapshot);
+	const clientComponent = components?.[message.name];
+	const hasClientComponent = clientComponent != null;
+	let fallbackComponent = null;
+	if (isReactNode(fallback)) fallbackComponent = fallback;
+	else if (typeof fallback === "object" && fallback != null) fallbackComponent = fallback?.[message.name];
+	const uiNamespace = namespace ?? stream.assistantId;
+	const uiClient = stream.client["~ui"];
+	react.useEffect(() => {
+		if (hasClientComponent) return;
+		uiClient.getComponent(uiNamespace, message.name).then((html) => {
+			const dom = ref.current;
+			if (!dom) return;
+			const root = dom.shadowRoot ?? dom.attachShadow({ mode: "open" });
+			const fragment = document.createRange().createContextualFragment(html.replace("{{shadowRootId}}", shadowRootId));
+			root.appendChild(fragment);
+		});
+	}, [
+		uiClient,
+		uiNamespace,
+		message.name,
+		shadowRootId,
+		hasClientComponent
+	]);
+	if (hasClientComponent) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UseStreamContext.Provider, {
+		value: {
+			stream,
+			meta
+		},
+		children: react.createElement(clientComponent, message.props)
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		id: shadowRootId,
+		ref,
+		...props
+	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UseStreamContext.Provider, {
+		value: {
+			stream,
+			meta
+		},
+		children: state?.target != null ? react_dom.createPortal(react.createElement(state.comp, message.props), state.target) : fallbackComponent
+	})] });
 }
-function experimental_loadShare(name, module) {
-    if (typeof window === "undefined")
-        return;
-    window[REQUIRE_EXTRA_SYMBOL] ??= {};
-    window[REQUIRE_EXTRA_SYMBOL][name] = module;
+function experimental_loadShare(name, module$1) {
+	if (typeof window === "undefined") return;
+	window[REQUIRE_EXTRA_SYMBOL] ??= {};
+	window[REQUIRE_EXTRA_SYMBOL][name] = module$1;
 }
 function bootstrapUiContext() {
-    if (typeof window === "undefined") {
-        return;
-    }
-    window[EXT_STORE_SYMBOL] = COMPONENT_STORE;
-    window[REQUIRE_SYMBOL] = (name) => {
-        if (name === "react")
-            return React;
-        if (name === "react-dom")
-            return ReactDOM;
-        if (name === "react/jsx-runtime")
-            return JsxRuntime;
-        if (name === "@langchain/langgraph-sdk/react")
-            return { useStream: index_js_1.useStream };
-        if (name === "@langchain/langgraph-sdk/react-ui") {
-            return {
-                useStreamContext,
-                LoadExternalComponent: () => {
-                    throw new Error("Nesting LoadExternalComponent is not supported");
-                },
-            };
-        }
-        if (window[REQUIRE_EXTRA_SYMBOL] != null &&
-            typeof window[REQUIRE_EXTRA_SYMBOL] === "object" &&
-            name in window[REQUIRE_EXTRA_SYMBOL]) {
-            return window[REQUIRE_EXTRA_SYMBOL][name];
-        }
-        throw new Error(`Unknown module...: ${name}`);
-    };
+	if (typeof window === "undefined") return;
+	window[EXT_STORE_SYMBOL] = COMPONENT_STORE;
+	window[REQUIRE_SYMBOL] = (name) => {
+		if (name === "react") return react;
+		if (name === "react-dom") return react_dom;
+		if (name === "react/jsx-runtime") return react_jsx_runtime;
+		if (name === "@langchain/langgraph-sdk/react") return { useStream: require_stream.useStream };
+		if (name === "@langchain/langgraph-sdk/react-ui") return {
+			useStreamContext,
+			LoadExternalComponent: () => {
+				throw new Error("Nesting LoadExternalComponent is not supported");
+			}
+		};
+		if (window[REQUIRE_EXTRA_SYMBOL] != null && typeof window[REQUIRE_EXTRA_SYMBOL] === "object" && name in window[REQUIRE_EXTRA_SYMBOL]) return window[REQUIRE_EXTRA_SYMBOL][name];
+		throw new Error(`Unknown module...: ${name}`);
+	};
 }
+
+//#endregion
+exports.LoadExternalComponent = LoadExternalComponent;
+exports.bootstrapUiContext = bootstrapUiContext;
+exports.experimental_loadShare = experimental_loadShare;
+exports.useStreamContext = useStreamContext;
+//# sourceMappingURL=client.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","names":["React","ReactDOM","module","JsxRuntime"],"sources":["../../src/react-ui/client.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport * as ReactDOM from \"react-dom\";\nimport * as JsxRuntime from \"react/jsx-runtime\";\nimport type { UIMessage } from \"./types.js\";\nimport { useStream } from \"../react/index.js\";\nimport type { UseStream } from \"../react/types.js\";\n\nconst UseStreamContext = React.createContext<{\n  stream: ReturnType<typeof useStream>;\n  meta: unknown;\n}>(null!);\n\ntype BagTemplate = {\n  ConfigurableType?: Record<string, unknown>;\n  InterruptType?: unknown;\n  CustomEventType?: unknown;\n  UpdateType?: unknown;\n  MetaType?: unknown;\n};\n\ntype GetMetaType<Bag extends BagTemplate> = Bag extends { MetaType: unknown }\n  ? Bag[\"MetaType\"]\n  : unknown;\n\ninterface UseStreamContext<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends BagTemplate = BagTemplate\n> extends UseStream<StateType, Bag> {\n  meta?: GetMetaType<Bag>;\n}\n\nexport function useStreamContext<\n  StateType extends Record<string, unknown> = Record<string, unknown>,\n  Bag extends {\n    ConfigurableType?: Record<string, unknown>;\n    InterruptType?: unknown;\n    CustomEventType?: unknown;\n    UpdateType?: unknown;\n    MetaType?: unknown;\n  } = BagTemplate\n>(): UseStreamContext<StateType, Bag> {\n  const ctx = React.useContext(UseStreamContext);\n  if (!ctx) {\n    throw new Error(\n      \"useStreamContext must be used within a LoadExternalComponent\"\n    );\n  }\n\n  return new Proxy(ctx, {\n    get(target, prop: keyof UseStreamContext<StateType, Bag>) {\n      if (prop === \"meta\") return target.meta;\n      return target.stream[prop];\n    },\n  }) as unknown as UseStreamContext<StateType, Bag>;\n}\n\ninterface ComponentTarget {\n  comp: React.FunctionComponent | React.ComponentClass;\n  target: HTMLElement;\n}\n\nclass ComponentStore {\n  private cache: Record<string, ComponentTarget> = {};\n\n  private boundCache: Record<\n    string,\n    {\n      subscribe: (onStoreChange: () => void) => () => void;\n      getSnapshot: () => ComponentTarget | undefined;\n    }\n  > = {};\n\n  private callbacks: Record<\n    string,\n    ((\n      comp: React.FunctionComponent | React.ComponentClass,\n      el: HTMLElement\n    ) => void)[]\n  > = {};\n\n  respond(\n    shadowRootId: string,\n    comp: React.FunctionComponent | React.ComponentClass,\n    targetElement: HTMLElement\n  ) {\n    this.cache[shadowRootId] = { comp, target: targetElement };\n    this.callbacks[shadowRootId]?.forEach((c) => c(comp, targetElement));\n  }\n\n  getBoundStore(shadowRootId: string) {\n    this.boundCache[shadowRootId] ??= {\n      subscribe: (onStoreChange: () => void) => {\n        this.callbacks[shadowRootId] ??= [];\n        this.callbacks[shadowRootId].push(onStoreChange);\n        return () => {\n          this.callbacks[shadowRootId] = this.callbacks[shadowRootId].filter(\n            (c) => c !== onStoreChange\n          );\n        };\n      },\n      getSnapshot: () => this.cache[shadowRootId],\n    };\n\n    return this.boundCache[shadowRootId];\n  }\n}\n\nconst COMPONENT_STORE = new ComponentStore();\nconst EXT_STORE_SYMBOL = Symbol.for(\"LGUI_EXT_STORE\");\nconst REQUIRE_SYMBOL = Symbol.for(\"LGUI_REQUIRE\");\nconst REQUIRE_EXTRA_SYMBOL = Symbol.for(\"LGUI_REQUIRE_EXTRA\");\n\ninterface LoadExternalComponentProps\n  extends Pick<React.HTMLAttributes<HTMLDivElement>, \"style\" | \"className\"> {\n  /** Stream of the assistant */\n  stream: ReturnType<typeof useStream>;\n\n  /** Namespace of UI components. Defaults to assistant ID. */\n  namespace?: string;\n\n  /** UI message to be rendered */\n  message: UIMessage;\n\n  /** Additional context to be passed to the child component */\n  meta?: unknown;\n\n  /** Fallback to be rendered when the component is loading */\n  fallback?: React.ReactNode | Record<string, React.ReactNode>;\n\n  /**\n   * Map of components that can be rendered directly without fetching the UI code\n   * from the server.\n   */\n  components?: Record<string, React.FunctionComponent | React.ComponentClass>;\n}\n\nconst isIterable = (value: unknown): value is Iterable<unknown> =>\n  value != null && typeof value === \"object\" && Symbol.iterator in value;\n\nconst isPromise = (value: unknown): value is Promise<unknown> =>\n  value != null &&\n  typeof value === \"object\" &&\n  \"then\" in value &&\n  typeof value.then === \"function\";\n\nconst isReactNode = (value: unknown): value is React.ReactNode => {\n  if (React.isValidElement(value)) return true;\n  if (value == null) return true;\n  if (\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"bigint\" ||\n    typeof value === \"boolean\"\n  ) {\n    return true;\n  }\n\n  if (isIterable(value)) return true;\n  if (isPromise(value)) return true;\n\n  return false;\n};\n\nexport function LoadExternalComponent({\n  stream,\n  namespace,\n  message,\n  meta,\n  fallback,\n  components,\n  ...props\n}: LoadExternalComponentProps) {\n  const ref = React.useRef<HTMLDivElement>(null);\n  const id = React.useId();\n  const shadowRootId = `child-shadow-${id}`;\n\n  const store = React.useMemo(\n    () => COMPONENT_STORE.getBoundStore(shadowRootId),\n    [shadowRootId]\n  );\n  const state = React.useSyncExternalStore(store.subscribe, store.getSnapshot);\n\n  const clientComponent = components?.[message.name];\n  const hasClientComponent = clientComponent != null;\n\n  let fallbackComponent = null;\n  if (isReactNode(fallback)) {\n    fallbackComponent = fallback;\n  } else if (typeof fallback === \"object\" && fallback != null) {\n    fallbackComponent = fallback?.[message.name];\n  }\n\n  const uiNamespace = namespace ?? stream.assistantId;\n  const uiClient = stream.client[\"~ui\"];\n  React.useEffect(() => {\n    if (hasClientComponent) return;\n    void uiClient.getComponent(uiNamespace, message.name).then((html) => {\n      const dom = ref.current;\n      if (!dom) return;\n      const root = dom.shadowRoot ?? dom.attachShadow({ mode: \"open\" });\n      const fragment = document\n        .createRange()\n        .createContextualFragment(\n          html.replace(\"{{shadowRootId}}\", shadowRootId)\n        );\n      root.appendChild(fragment);\n    });\n  }, [uiClient, uiNamespace, message.name, shadowRootId, hasClientComponent]);\n\n  if (hasClientComponent) {\n    return (\n      <UseStreamContext.Provider value={{ stream, meta }}>\n        {React.createElement(clientComponent, message.props)}\n      </UseStreamContext.Provider>\n    );\n  }\n\n  return (\n    <>\n      <div id={shadowRootId} ref={ref} {...props} />\n\n      <UseStreamContext.Provider value={{ stream, meta }}>\n        {state?.target != null\n          ? ReactDOM.createPortal(\n              React.createElement(state.comp, message.props),\n              state.target\n            )\n          : fallbackComponent}\n      </UseStreamContext.Provider>\n    </>\n  );\n}\n\ndeclare global {\n  interface Window {\n    [EXT_STORE_SYMBOL]: ComponentStore;\n    [REQUIRE_SYMBOL]: (name: string) => unknown;\n    [REQUIRE_EXTRA_SYMBOL]: Record<string, unknown>;\n  }\n}\n\nexport function experimental_loadShare(name: string, module: unknown) {\n  if (typeof window === \"undefined\") return;\n\n  window[REQUIRE_EXTRA_SYMBOL] ??= {};\n  window[REQUIRE_EXTRA_SYMBOL][name] = module;\n}\n\nexport function bootstrapUiContext() {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  window[EXT_STORE_SYMBOL] = COMPONENT_STORE;\n  window[REQUIRE_SYMBOL] = (name: string) => {\n    if (name === \"react\") return React;\n    if (name === \"react-dom\") return ReactDOM;\n    if (name === \"react/jsx-runtime\") return JsxRuntime;\n    if (name === \"@langchain/langgraph-sdk/react\") return { useStream };\n    if (name === \"@langchain/langgraph-sdk/react-ui\") {\n      return {\n        useStreamContext,\n        LoadExternalComponent: () => {\n          throw new Error(\"Nesting LoadExternalComponent is not supported\");\n        },\n      };\n    }\n\n    if (\n      window[REQUIRE_EXTRA_SYMBOL] != null &&\n      typeof window[REQUIRE_EXTRA_SYMBOL] === \"object\" &&\n      name in window[REQUIRE_EXTRA_SYMBOL]\n    ) {\n      return window[REQUIRE_EXTRA_SYMBOL][name];\n    }\n\n    throw new Error(`Unknown module...: ${name}`);\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,90 @@
+import { UIMessage } from "./types.cjs";
+import { UseStream } from "../react/types.cjs";
+import { useStream } from "../react/stream.cjs";
+import * as React from "react";
+import * as JsxRuntime from "react/jsx-runtime";
+
+//#region src/react-ui/client.d.ts
+declare const UseStreamContext: React.Context<{
+  stream: UseStream<Record<string, unknown>, {
+    ConfigurableType?: Record<string, unknown> | undefined;
+    InterruptType?: unknown;
+    CustomEventType?: unknown;
+    UpdateType?: unknown;
+  }>;
+  meta: unknown;
+}>;
+type BagTemplate = {
+  ConfigurableType?: Record<string, unknown>;
+  InterruptType?: unknown;
+  CustomEventType?: unknown;
+  UpdateType?: unknown;
+  MetaType?: unknown;
+};
+type GetMetaType<Bag extends BagTemplate> = Bag extends {
+  MetaType: unknown;
+} ? Bag["MetaType"] : unknown;
+interface UseStreamContext<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> extends UseStream<StateType, Bag> {
+  meta?: GetMetaType<Bag>;
+}
+declare function useStreamContext<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends {
+  ConfigurableType?: Record<string, unknown>;
+  InterruptType?: unknown;
+  CustomEventType?: unknown;
+  UpdateType?: unknown;
+  MetaType?: unknown;
+} = BagTemplate>(): UseStreamContext<StateType, Bag>;
+interface ComponentTarget {
+  comp: React.FunctionComponent | React.ComponentClass;
+  target: HTMLElement;
+}
+declare class ComponentStore {
+  private cache;
+  private boundCache;
+  private callbacks;
+  respond(shadowRootId: string, comp: React.FunctionComponent | React.ComponentClass, targetElement: HTMLElement): void;
+  getBoundStore(shadowRootId: string): {
+    subscribe: (onStoreChange: () => void) => () => void;
+    getSnapshot: () => ComponentTarget | undefined;
+  };
+}
+declare const EXT_STORE_SYMBOL: unique symbol;
+declare const REQUIRE_SYMBOL: unique symbol;
+declare const REQUIRE_EXTRA_SYMBOL: unique symbol;
+interface LoadExternalComponentProps extends Pick<React.HTMLAttributes<HTMLDivElement>, "style" | "className"> {
+  /** Stream of the assistant */
+  stream: ReturnType<typeof useStream>;
+  /** Namespace of UI components. Defaults to assistant ID. */
+  namespace?: string;
+  /** UI message to be rendered */
+  message: UIMessage;
+  /** Additional context to be passed to the child component */
+  meta?: unknown;
+  /** Fallback to be rendered when the component is loading */
+  fallback?: React.ReactNode | Record<string, React.ReactNode>;
+  /**
+   * Map of components that can be rendered directly without fetching the UI code
+   * from the server.
+   */
+  components?: Record<string, React.FunctionComponent | React.ComponentClass>;
+}
+declare function LoadExternalComponent({
+  stream,
+  namespace,
+  message,
+  meta,
+  fallback,
+  components,
+  ...props
+}: LoadExternalComponentProps): JsxRuntime.JSX.Element;
+declare global {
+  interface Window {
+    [EXT_STORE_SYMBOL]: ComponentStore;
+    [REQUIRE_SYMBOL]: (name: string) => unknown;
+    [REQUIRE_EXTRA_SYMBOL]: Record<string, unknown>;
+  }
+}
+declare function experimental_loadShare(name: string, module: unknown): void;
+//#endregion
+export { LoadExternalComponent, experimental_loadShare, useStreamContext };
+//# sourceMappingURL=client.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.cts","names":["React","JsxRuntime","UIMessage","useStream","UseStream","UseStreamContext","Record","Context","BagTemplate","GetMetaType","Bag","StateType","useStreamContext","ComponentTarget","FunctionComponent","ComponentClass","HTMLElement","ComponentStore","EXT_STORE_SYMBOL","REQUIRE_SYMBOL","REQUIRE_EXTRA_SYMBOL","LoadExternalComponentProps","HTMLDivElement","HTMLAttributes","ReturnType","ReactNode","Pick","LoadExternalComponent","stream","namespace","message","meta","fallback","components","JSX","Element","_0","sideEffect","experimental_loadShare","bootstrapUiContext"],"sources":["../../src/react-ui/client.d.ts"],"sourcesContent":["import * as React from \"react\";\nimport * as JsxRuntime from \"react/jsx-runtime\";\nimport type { UIMessage } from \"./types.js\";\nimport { useStream } from \"../react/index.js\";\nimport type { UseStream } from \"../react/types.js\";\ndeclare const UseStreamContext: React.Context<{\n    stream: UseStream<Record<string, unknown>, {\n        ConfigurableType?: Record<string, unknown> | undefined;\n        InterruptType?: unknown;\n        CustomEventType?: unknown;\n        UpdateType?: unknown;\n    }>;\n    meta: unknown;\n}>;\ntype BagTemplate = {\n    ConfigurableType?: Record<string, unknown>;\n    InterruptType?: unknown;\n    CustomEventType?: unknown;\n    UpdateType?: unknown;\n    MetaType?: unknown;\n};\ntype GetMetaType<Bag extends BagTemplate> = Bag extends {\n    MetaType: unknown;\n} ? Bag[\"MetaType\"] : unknown;\ninterface UseStreamContext<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends BagTemplate = BagTemplate> extends UseStream<StateType, Bag> {\n    meta?: GetMetaType<Bag>;\n}\nexport declare function useStreamContext<StateType extends Record<string, unknown> = Record<string, unknown>, Bag extends {\n    ConfigurableType?: Record<string, unknown>;\n    InterruptType?: unknown;\n    CustomEventType?: unknown;\n    UpdateType?: unknown;\n    MetaType?: unknown;\n} = BagTemplate>(): UseStreamContext<StateType, Bag>;\ninterface ComponentTarget {\n    comp: React.FunctionComponent | React.ComponentClass;\n    target: HTMLElement;\n}\ndeclare class ComponentStore {\n    private cache;\n    private boundCache;\n    private callbacks;\n    respond(shadowRootId: string, comp: React.FunctionComponent | React.ComponentClass, targetElement: HTMLElement): void;\n    getBoundStore(shadowRootId: string): {\n        subscribe: (onStoreChange: () => void) => () => void;\n        getSnapshot: () => ComponentTarget | undefined;\n    };\n}\ndeclare const EXT_STORE_SYMBOL: unique symbol;\ndeclare const REQUIRE_SYMBOL: unique symbol;\ndeclare const REQUIRE_EXTRA_SYMBOL: unique symbol;\ninterface LoadExternalComponentProps extends Pick<React.HTMLAttributes<HTMLDivElement>, \"style\" | \"className\"> {\n    /** Stream of the assistant */\n    stream: ReturnType<typeof useStream>;\n    /** Namespace of UI components. Defaults to assistant ID. */\n    namespace?: string;\n    /** UI message to be rendered */\n    message: UIMessage;\n    /** Additional context to be passed to the child component */\n    meta?: unknown;\n    /** Fallback to be rendered when the component is loading */\n    fallback?: React.ReactNode | Record<string, React.ReactNode>;\n    /**\n     * Map of components that can be rendered directly without fetching the UI code\n     * from the server.\n     */\n    components?: Record<string, React.FunctionComponent | React.ComponentClass>;\n}\nexport declare function LoadExternalComponent({ stream, namespace, message, meta, fallback, components, ...props }: LoadExternalComponentProps): JsxRuntime.JSX.Element;\ndeclare global {\n    interface Window {\n        [EXT_STORE_SYMBOL]: ComponentStore;\n        [REQUIRE_SYMBOL]: (name: string) => unknown;\n        [REQUIRE_EXTRA_SYMBOL]: Record<string, unknown>;\n    }\n}\nexport declare function experimental_loadShare(name: string, module: unknown): void;\nexport declare function bootstrapUiContext(): void;\nexport {};\n"],"mappings":"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"}