@assistant-ui/react-langchain 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentbaseAI Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/convertMessages.d.ts

@@ -0,0 +1,4 @@
+import type { useExternalMessageConverter } from "@assistant-ui/core/react";
+import type { LangChainBaseMessage } from "./types.js";
+export declare const convertLangChainBaseMessage: useExternalMessageConverter.Callback<LangChainBaseMessage>;
+//# sourceMappingURL=convertMessages.d.ts.map

package/dist/convertMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertMessages.d.ts","sourceRoot":"","sources":["../src/convertMessages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAE5E,OAAO,KAAK,EAAE,oBAAoB,EAAyB,mBAAgB;AAyD3E,eAAO,MAAM,2BAA2B,EAAE,2BAA2B,CAAC,QAAQ,CAC5E,oBAAoB,CA0ErB,CAAC"}

package/dist/convertMessages.js

@@ -0,0 +1,115 @@
+"use client";
+const getMessageType = (message) => {
+    if (typeof message._getType === "function")
+        return message._getType();
+    if ("type" in message)
+        return message.type;
+    throw new Error("Cannot determine message type");
+};
+const contentToParts = (content) => {
+    if (typeof content === "string")
+        return [{ type: "text", text: content }];
+    const parts = content;
+    return parts
+        .map((part) => {
+        const type = part.type;
+        switch (type) {
+            case "text":
+            case "text_delta":
+                return { type: "text", text: part.text };
+            case "image_url":
+                if (typeof part.image_url === "string") {
+                    return { type: "image", image: part.image_url };
+                }
+                return { type: "image", image: part.image_url.url };
+            case "thinking":
+                return { type: "reasoning", text: part.thinking };
+            case "reasoning":
+                return {
+                    type: "reasoning",
+                    text: part.summary.map((s) => s.text).join("\n\n\n"),
+                };
+            case "tool_use":
+            case "input_json_delta":
+                return null;
+            default:
+                return null;
+        }
+    })
+        .filter((p) => p !== null);
+};
+const getCustomMetadata = (additionalKwargs) => additionalKwargs?.metadata ?? {};
+const getStringContent = (content) => {
+    if (typeof content === "string")
+        return content;
+    const parts = content;
+    return parts
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("");
+};
+export const convertLangChainBaseMessage = (message) => {
+    const type = getMessageType(message);
+    switch (type) {
+        case "system":
+            return {
+                role: "system",
+                id: message.id,
+                content: [{ type: "text", text: getStringContent(message.content) }],
+                metadata: {
+                    custom: getCustomMetadata(message.additional_kwargs),
+                },
+            };
+        case "human":
+            return {
+                role: "user",
+                id: message.id,
+                content: contentToParts(message.content),
+                metadata: {
+                    custom: getCustomMetadata(message.additional_kwargs),
+                },
+            };
+        case "ai": {
+            const toolCallParts = message.tool_calls?.map((tc) => ({
+                type: "tool-call",
+                toolCallId: tc.id,
+                toolName: tc.name,
+                args: tc.args,
+                argsText: JSON.stringify(tc.args),
+            })) ?? [];
+            const assistantStatus = typeof message.status === "object" ? message.status : undefined;
+            return {
+                role: "assistant",
+                id: message.id,
+                content: [...contentToParts(message.content), ...toolCallParts],
+                metadata: {
+                    custom: getCustomMetadata(message.additional_kwargs),
+                },
+                ...(assistantStatus && { status: assistantStatus }),
+            };
+        }
+        case "tool":
+            return {
+                role: "tool",
+                toolName: message.name ?? "",
+                toolCallId: message.tool_call_id ?? "",
+                result: message.content,
+                artifact: message.artifact,
+                isError: message.status === "error",
+            };
+        default:
+            return {
+                role: "system",
+                id: message.id,
+                content: [
+                    {
+                        type: "text",
+                        text: typeof message.content === "string"
+                            ? message.content
+                            : JSON.stringify(message.content),
+                    },
+                ],
+            };
+    }
+};
+//# sourceMappingURL=convertMessages.js.map

package/dist/convertMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertMessages.js","sourceRoot":"","sources":["../src/convertMessages.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAMb,MAAM,cAAc,GAAG,CAAC,OAA6B,EAAU,EAAE;IAC/D,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IACtE,IAAI,MAAM,IAAI,OAAO;QACnB,OAAQ,OAAmC,CAAC,IAAc,CAAC;IAC7D,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAE,EAAE;IAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,OAA2C,CAAC;IAC1D,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM,CAAC;YACZ,KAAK,YAAY;gBACf,OAAO,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACpD,KAAK,WAAW;gBACd,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;oBACvC,OAAO,EAAE,IAAI,EAAE,OAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC3D,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,OAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YAC/D,KAAK,UAAU;gBACb,OAAO,EAAE,IAAI,EAAE,WAAoB,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7D,KAAK,WAAW;gBACd,OAAO;oBACL,IAAI,EAAE,WAAoB;oBAC1B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;iBACrD,CAAC;YACJ,KAAK,UAAU,CAAC;YAChB,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC;YACd;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,gBAAqD,EAC5B,EAAE,CAC1B,gBAAgB,EAAE,QAAoC,IAAI,EAAE,CAAC;AAEhE,MAAM,gBAAgB,GAAG,CAAC,OAAgB,EAAU,EAAE;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,MAAM,KAAK,GAAG,OAA2C,CAAC;IAC1D,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SACrE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAEpC,CAAC,OAAO,EAAE,EAAE;IACd,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAErC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpE,QAAQ,EAAE;oBACR,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,iBAAiB,CAAC;iBACrD;aACF,CAAC;QAEJ,KAAK,OAAO;YACV,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC;gBACxC,QAAQ,EAAE;oBACR,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,iBAAiB,CAAC;iBACrD;aACF,CAAC;QAEJ,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,aAAa,GACjB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC/B,IAAI,EAAE,WAAoB;gBAC1B,UAAU,EAAE,EAAE,CAAC,EAAE;gBACjB,QAAQ,EAAE,EAAE,CAAC,IAAI;gBACjB,IAAI,EAAE,EAAE,CAAC,IAA0B;gBACnC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEZ,MAAM,eAAe,GACnB,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAElE,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,OAAO,EAAE,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,aAAa,CAAC;gBAC/D,QAAQ,EAAE;oBACR,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,iBAAiB,CAAC;iBACrD;gBACD,GAAG,CAAC,eAAe,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;aACpD,CAAC;QACJ,CAAC;QAED,KAAK,MAAM;YACT,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;gBAC5B,UAAU,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;gBACtC,MAAM,EAAE,OAAO,CAAC,OAAO;gBACvB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,OAAO;aACpC,CAAC;QAEJ;YACE,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;4BACjC,CAAC,CAAC,OAAO,CAAC,OAAO;4BACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;qBACtC;iBACF;aACF,CAAC;IACN,CAAC;AACH,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { useStreamRuntime, useLangChainInterruptState, useLangChainSubmit, } from "./useStreamRuntime.js";
+export type { UseStreamRuntimeOptions } from "./useStreamRuntime.js";
+export { convertLangChainBaseMessage } from "./convertMessages.js";
+export type { LangChainBaseMessage, LangChainContentBlock, LangChainToolCall, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,GACnB,8BAA2B;AAC5B,YAAY,EAAE,uBAAuB,EAAE,8BAA2B;AAElE,OAAO,EAAE,2BAA2B,EAAE,6BAA0B;AAEhE,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAClB,mBAAgB"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { useStreamRuntime, useLangChainInterruptState, useLangChainSubmit, } from "./useStreamRuntime.js";
+export { convertLangChainBaseMessage } from "./convertMessages.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,GACnB,8BAA2B;AAG5B,OAAO,EAAE,2BAA2B,EAAE,6BAA0B"}

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+import type { MessageStatus } from "@assistant-ui/core";
+/** Known content block types from @langchain/core messages. */
+export type LangChainContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "text_delta";
+    text: string;
+} | {
+    type: "image_url";
+    image_url: string | {
+        url: string;
+    };
+} | {
+    type: "thinking";
+    thinking: string;
+} | {
+    type: "reasoning";
+    summary: Array<{
+        type: "summary_text";
+        text: string;
+    }>;
+} | {
+    type: "tool_use" | "input_json_delta";
+};
+export type LangChainToolCall = {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+};
+/**
+ * Minimal duck-typed interface for BaseMessage class instances returned by
+ * `useStream`. Used internally by the message converter.
+ *
+ * Uses `unknown` for `content` to remain compatible with
+ * `@langchain/core`'s `MessageContent` union.
+ */
+export type LangChainBaseMessage = {
+    _getType: () => string;
+    content: unknown;
+    id?: string | undefined;
+    name?: string | undefined;
+    additional_kwargs?: Record<string, unknown> | undefined;
+    /** Present on AIMessage */
+    tool_calls?: readonly LangChainToolCall[] | undefined;
+    /** Present on ToolMessage */
+    tool_call_id?: string | undefined;
+    /** Completion status (AIMessage) or outcome status (ToolMessage) */
+    status?: MessageStatus | "success" | "error" | undefined;
+    /** Present on ToolMessage */
+    artifact?: unknown;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,GACD;IAAE,IAAI,EAAE,UAAU,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,2BAA2B;IAC3B,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACtD,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oEAAoE;IACpE,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACzD,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/useStreamRuntime.d.ts

@@ -0,0 +1,51 @@
+import type { AttachmentAdapter, FeedbackAdapter, SpeechSynthesisAdapter } from "@assistant-ui/core";
+import type { AssistantCloud } from "assistant-cloud";
+import { type UseStreamOptions } from "@langchain/react";
+export type UseStreamRuntimeOptions = UseStreamOptions & {
+    cloud?: AssistantCloud | undefined;
+    adapters?: {
+        attachments?: AttachmentAdapter | undefined;
+        speech?: SpeechSynthesisAdapter | undefined;
+        feedback?: FeedbackAdapter | undefined;
+    } | undefined;
+    /** The key in the LangGraph state that contains messages. Defaults to "messages". */
+    messagesKey?: string | undefined;
+};
+/**
+ * Creates an assistant-ui runtime backed by LangChain's `useStream` hook.
+ * Accepts the same options as `useStream` from `@langchain/react`, plus
+ * `cloud` and `adapters`.
+ *
+ * @example
+ * ```tsx
+ * import { useStreamRuntime } from "@assistant-ui/react-langchain";
+ * import { AssistantRuntimeProvider, Thread } from "@assistant-ui/react";
+ *
+ * function App() {
+ *   const runtime = useStreamRuntime({
+ *     assistantId: "agent",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   return (
+ *     <AssistantRuntimeProvider runtime={runtime}>
+ *       <Thread />
+ *     </AssistantRuntimeProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare const useStreamRuntime: ({ cloud, ...options }: UseStreamRuntimeOptions) => import("@assistant-ui/core").AssistantRuntime;
+/**
+ * Read the current LangGraph interrupt state from the runtime extras.
+ */
+export declare const useLangChainInterruptState: () => {
+    value?: unknown;
+} | undefined;
+/**
+ * Returns a function to submit raw state updates to the LangGraph agent,
+ * bypassing the normal message flow. Useful for sending interrupt resume
+ * commands.
+ */
+export declare const useLangChainSubmit: () => (values: Record<string, unknown> | null | undefined, options?: Record<string, unknown>) => Promise<void>;
+//# sourceMappingURL=useStreamRuntime.d.ts.map

package/dist/useStreamRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamRuntime.d.ts","sourceRoot":"","sources":["../src/useStreamRuntime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA4BpE,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG;IACvD,KAAK,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EACL;QACE,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;QAC5C,MAAM,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;QAC5C,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;KACxC,GACD,SAAS,CAAC;IACd,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAoKF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,gBAAgB,GAAI,uBAG9B,uBAAuB,kDAYzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;YA/OhB,OAAO;aAqP7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,SAG3B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAMpC,CAAC"}

package/dist/useStreamRuntime.js

@@ -0,0 +1,196 @@
+"use client";
+import { useMemo, useRef, useState } from "react";
+import { useCloudThreadListAdapter, useExternalStoreRuntime, useExternalMessageConverter, useRemoteThreadListRuntime, useToolInvocations, } from "@assistant-ui/core/react";
+import { useAui, useAuiState } from "@assistant-ui/store";
+import { useStream } from "@langchain/react";
+import { convertLangChainBaseMessage } from "./convertMessages.js";
+const symbolLangChainRuntimeExtras = Symbol("langchain-runtime-extras");
+const asLangChainRuntimeExtras = (extras) => {
+    if (typeof extras !== "object" ||
+        extras == null ||
+        !(symbolLangChainRuntimeExtras in extras))
+        throw new Error("This method can only be called when you are using useStreamRuntime");
+    return extras;
+};
+const getMessageContent = (msg) => {
+    const allContent = [
+        ...msg.content,
+        ...(msg.attachments?.flatMap((a) => a.content) ?? []),
+    ];
+    const hasNonText = allContent.some((part) => part.type === "file" || part.type === "image");
+    const hasText = allContent.some((part) => part.type === "text");
+    if (hasNonText && !hasText) {
+        allContent.unshift({ type: "text", text: " " });
+    }
+    const content = allContent.map((part) => {
+        const type = part.type;
+        switch (type) {
+            case "text":
+                return { type: "text", text: part.text };
+            case "image":
+                return { type: "image_url", image_url: { url: part.image } };
+            case "file":
+                return {
+                    type: "file",
+                    data: part.data,
+                    mime_type: part.mimeType,
+                    metadata: { filename: part.filename ?? "file" },
+                    source_type: "base64",
+                };
+            case "tool-call":
+                throw new Error("Tool call appends are not supported.");
+            default: {
+                const _exhaustiveCheck = type;
+                throw new Error(`Unsupported append message part type: ${_exhaustiveCheck}`);
+            }
+        }
+    });
+    if (content.length === 1 && content[0]?.type === "text") {
+        return content[0].text ?? "";
+    }
+    return content;
+};
+const useStreamThreadRuntime = ({ adapters, messagesKey = "messages", ...streamOptions }) => {
+    const externalId = useAuiState((s) => s.threadListItem.externalId);
+    const stream = useStream({
+        ...streamOptions,
+        threadId: externalId,
+    });
+    const [toolStatuses, setToolStatuses] = useState({});
+    const hasExecutingTools = Object.values(toolStatuses).some((s) => s?.type === "executing");
+    const effectiveIsRunning = stream.isLoading || hasExecutingTools;
+    const threadMessages = useExternalMessageConverter({
+        callback: convertLangChainBaseMessage,
+        messages: stream.messages,
+        isRunning: effectiveIsRunning,
+    });
+    const [runtimeRef] = useState(() => ({
+        get current() {
+            return runtime;
+        },
+    }));
+    const streamRef = useRef(stream);
+    streamRef.current = stream;
+    const toolInvocations = useToolInvocations({
+        state: {
+            messages: threadMessages,
+            isRunning: effectiveIsRunning,
+        },
+        getTools: () => runtimeRef.current.thread.getModelContext().tools,
+        onResult: (command) => {
+            if (command.type === "add-tool-result") {
+                void streamRef.current.submit({
+                    [messagesKey]: [
+                        {
+                            type: "tool",
+                            name: command.toolName,
+                            tool_call_id: command.toolCallId,
+                            content: JSON.stringify(command.result),
+                            status: command.isError ? "error" : "success",
+                        },
+                    ],
+                }, {});
+            }
+        },
+        setToolStatuses,
+    });
+    const extras = useMemo(() => ({
+        [symbolLangChainRuntimeExtras]: true,
+        interrupt: stream.interrupt,
+        interrupts: stream.interrupts,
+        submit: stream.submit,
+    }), [stream.interrupt, stream.interrupts, stream.submit]);
+    const runtime = useExternalStoreRuntime({
+        isRunning: effectiveIsRunning,
+        messages: threadMessages,
+        adapters,
+        extras,
+        onNew: async (msg) => {
+            await toolInvocations.abort();
+            const content = getMessageContent(msg);
+            await stream.submit({
+                [messagesKey]: [{ type: "human", content }],
+            });
+        },
+        onAddToolResult: async ({ toolCallId, toolName, result, isError, artifact, }) => {
+            await stream.submit({
+                [messagesKey]: [
+                    {
+                        type: "tool",
+                        name: toolName,
+                        tool_call_id: toolCallId,
+                        content: JSON.stringify(result),
+                        ...(artifact !== undefined && { artifact }),
+                        status: isError ? "error" : "success",
+                    },
+                ],
+            });
+        },
+        onCancel: async () => {
+            await stream.stop();
+            await toolInvocations.abort();
+        },
+    });
+    return runtime;
+};
+/**
+ * Creates an assistant-ui runtime backed by LangChain's `useStream` hook.
+ * Accepts the same options as `useStream` from `@langchain/react`, plus
+ * `cloud` and `adapters`.
+ *
+ * @example
+ * ```tsx
+ * import { useStreamRuntime } from "@assistant-ui/react-langchain";
+ * import { AssistantRuntimeProvider, Thread } from "@assistant-ui/react";
+ *
+ * function App() {
+ *   const runtime = useStreamRuntime({
+ *     assistantId: "agent",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   return (
+ *     <AssistantRuntimeProvider runtime={runtime}>
+ *       <Thread />
+ *     </AssistantRuntimeProvider>
+ *   );
+ * }
+ * ```
+ */
+export const useStreamRuntime = ({ cloud, ...options }) => {
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const cloudAdapter = useCloudThreadListAdapter({ cloud });
+    return useRemoteThreadListRuntime({
+        runtimeHook: function RuntimeHook() {
+            return useStreamThreadRuntime(optionsRef.current);
+        },
+        adapter: cloudAdapter,
+        allowNesting: true,
+    });
+};
+/**
+ * Read the current LangGraph interrupt state from the runtime extras.
+ */
+export const useLangChainInterruptState = () => {
+    return useAuiState((s) => {
+        const extras = s.thread.extras;
+        if (!extras)
+            return undefined;
+        return asLangChainRuntimeExtras(extras).interrupt;
+    });
+};
+/**
+ * Returns a function to submit raw state updates to the LangGraph agent,
+ * bypassing the normal message flow. Useful for sending interrupt resume
+ * commands.
+ */
+export const useLangChainSubmit = () => {
+    const aui = useAui();
+    return (values, options) => {
+        const extras = aui.thread().getState().extras;
+        const { submit } = asLangChainRuntimeExtras(extras);
+        return submit(values, options);
+    };
+};
+//# sourceMappingURL=useStreamRuntime.js.map

package/dist/useStreamRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamRuntime.js","sourceRoot":"","sources":["../src/useStreamRuntime.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAOlD,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAyB,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EAAE,2BAA2B,EAAE,6BAA0B;AAEhE,MAAM,4BAA4B,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAYxE,MAAM,wBAAwB,GAAG,CAAC,MAAe,EAA0B,EAAE;IAC3E,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,IAAI,IAAI;QACd,CAAC,CAAC,4BAA4B,IAAI,MAAM,CAAC;QAEzC,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,OAAO,MAAgC,CAAC;AAC1C,CAAC,CAAC;AAeF,MAAM,iBAAiB,GAAG,CAAC,GAAkB,EAAE,EAAE;IAC/C,MAAM,UAAU,GAAG;QACjB,GAAG,GAAG,CAAC,OAAO;QACd,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;KACtD,CAAC;IAEF,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CACxD,CAAC;IACF,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAChE,IAAI,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,OAAO,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YACpD,KAAK,OAAO;gBACV,OAAO,EAAE,IAAI,EAAE,WAAoB,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACxE,KAAK,MAAM;gBACT,OAAO;oBACL,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,SAAS,EAAE,IAAI,CAAC,QAAQ;oBACxB,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM,EAAE;oBAC/C,WAAW,EAAE,QAAiB;iBAC/B,CAAC;YACJ,KAAK,WAAW;gBACd,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC1D,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,gBAAgB,GACpB,IAAI,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,yCAAyC,gBAAgB,EAAE,CAC5D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QACxD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,EAC9B,QAAQ,EACR,WAAW,GAAG,UAAU,EACxB,GAAG,aAAa,EACuB,EAAE,EAAE;IAC3C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAEzD,CAAC;IAET,MAAM,MAAM,GAAG,SAAS,CAAC;QACvB,GAAG,aAAa;QAChB,QAAQ,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAE9C,EAAE,CAAC,CAAC;IACN,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CACxD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,WAAW,CAC/B,CAAC;IACF,MAAM,kBAAkB,GAAG,MAAM,CAAC,SAAS,IAAI,iBAAiB,CAAC;IAEjE,MAAM,cAAc,GAAG,2BAA2B,CAAC;QACjD,QAAQ,EAAE,2BAA2B;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAkC;QACnD,SAAS,EAAE,kBAAkB;KAC9B,CAAC,CAAC;IAEH,MAAM,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACnC,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,MAAM,eAAe,GAAG,kBAAkB,CAAC;QACzC,KAAK,EAAE;YACL,QAAQ,EAAE,cAAc;YACxB,SAAS,EAAE,kBAAkB;SAC9B;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,KAAK;QACjE,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;YACpB,IAAI,OAAO,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACvC,KAAK,SAAS,CAAC,OAAO,CAAC,MAAM,CAC3B;oBACE,CAAC,WAAW,CAAC,EAAE;wBACb;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,OAAO,CAAC,QAAQ;4BACtB,YAAY,EAAE,OAAO,CAAC,UAAU;4BAChC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;4BACvC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;yBAC9C;qBACF;iBACF,EACD,EAAE,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QACD,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,OAAO,CACpB,GAA2B,EAAE,CAAC,CAAC;QAC7B,CAAC,4BAA4B,CAAC,EAAE,IAAI;QACpC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,EACF,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CACrD,CAAC;IAEF,MAAM,OAAO,GAAG,uBAAuB,CAAC;QACtC,SAAS,EAAE,kBAAkB;QAC7B,QAAQ,EAAE,cAAc;QACxB,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACnB,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,MAAM,CAAC,MAAM,CAAC;gBAClB,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QACD,eAAe,EAAE,KAAK,EAAE,EACtB,UAAU,EACV,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE,EAAE;YACH,MAAM,MAAM,CAAC,MAAM,CAAC;gBAClB,CAAC,WAAW,CAAC,EAAE;oBACb;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ;wBACd,YAAY,EAAE,UAAU;wBACxB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;wBAC/B,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;wBAC3C,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;qBACtC;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,KAAK,EACL,GAAG,OAAO,EACc,EAAE,EAAE;IAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,YAAY,GAAG,yBAAyB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,OAAO,0BAA0B,CAAC;QAChC,WAAW,EAAE,SAAS,WAAW;YAC/B,OAAO,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,YAAY;QACrB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,EAAE;IAC7C,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/B,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,OAAO,CACL,MAAkD,EAClD,OAAiC,EACjC,EAAE;QACF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;QAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@assistant-ui/react-langchain",
+  "version": "0.0.1",
+  "description": "LangChain useStream adapter for assistant-ui",
+  "keywords": [
+    "langchain",
+    "langgraph",
+    "assistant-ui",
+    "react",
+    "ai",
+    "chat",
+    "agents"
+  ],
+  "author": "AgentbaseAI Inc.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@assistant-ui/core": "^0.1.13",
+    "@assistant-ui/store": "^0.2.6",
+    "assistant-cloud": "*",
+    "assistant-stream": "^0.3.10"
+  },
+  "peerDependencies": {
+    "@langchain/react": "^0.3.3",
+    "@types/react": "*",
+    "react": "^18 || ^19"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@langchain/core": "^1.1.39",
+    "@langchain/langgraph-sdk": "^1.8.8",
+    "@langchain/react": "^0.3.3",
+    "@types/react": "^19.2.14",
+    "react": "^19.2.5",
+    "@assistant-ui/x-buildutils": "0.0.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "homepage": "https://www.assistant-ui.com/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/assistant-ui/assistant-ui.git",
+    "directory": "packages/react-langchain"
+  },
+  "bugs": {
+    "url": "https://github.com/assistant-ui/assistant-ui/issues"
+  },
+  "scripts": {
+    "build": "aui-build"
+  }
+}

package/src/convertMessages.ts

@@ -0,0 +1,137 @@
+"use client";
+
+import type { useExternalMessageConverter } from "@assistant-ui/core/react";
+import type { ReadonlyJSONObject } from "assistant-stream/utils";
+import type { LangChainBaseMessage, LangChainContentBlock } from "./types";
+
+const getMessageType = (message: LangChainBaseMessage): string => {
+  if (typeof message._getType === "function") return message._getType();
+  if ("type" in message)
+    return (message as Record<string, unknown>).type as string;
+  throw new Error("Cannot determine message type");
+};
+
+const contentToParts = (content: unknown) => {
+  if (typeof content === "string")
+    return [{ type: "text" as const, text: content }];
+
+  const parts = content as readonly LangChainContentBlock[];
+  return parts
+    .map((part) => {
+      const type = part.type;
+      switch (type) {
+        case "text":
+        case "text_delta":
+          return { type: "text" as const, text: part.text };
+        case "image_url":
+          if (typeof part.image_url === "string") {
+            return { type: "image" as const, image: part.image_url };
+          }
+          return { type: "image" as const, image: part.image_url.url };
+        case "thinking":
+          return { type: "reasoning" as const, text: part.thinking };
+        case "reasoning":
+          return {
+            type: "reasoning" as const,
+            text: part.summary.map((s) => s.text).join("\n\n\n"),
+          };
+        case "tool_use":
+        case "input_json_delta":
+          return null;
+        default:
+          return null;
+      }
+    })
+    .filter((p) => p !== null);
+};
+
+const getCustomMetadata = (
+  additionalKwargs: Record<string, unknown> | undefined,
+): Record<string, unknown> =>
+  (additionalKwargs?.metadata as Record<string, unknown>) ?? {};
+
+const getStringContent = (content: unknown): string => {
+  if (typeof content === "string") return content;
+  const parts = content as readonly LangChainContentBlock[];
+  return parts
+    .filter((c): c is { type: "text"; text: string } => c.type === "text")
+    .map((c) => c.text)
+    .join("");
+};
+
+export const convertLangChainBaseMessage: useExternalMessageConverter.Callback<
+  LangChainBaseMessage
+> = (message) => {
+  const type = getMessageType(message);
+
+  switch (type) {
+    case "system":
+      return {
+        role: "system",
+        id: message.id,
+        content: [{ type: "text", text: getStringContent(message.content) }],
+        metadata: {
+          custom: getCustomMetadata(message.additional_kwargs),
+        },
+      };
+
+    case "human":
+      return {
+        role: "user",
+        id: message.id,
+        content: contentToParts(message.content),
+        metadata: {
+          custom: getCustomMetadata(message.additional_kwargs),
+        },
+      };
+
+    case "ai": {
+      const toolCallParts =
+        message.tool_calls?.map((tc) => ({
+          type: "tool-call" as const,
+          toolCallId: tc.id,
+          toolName: tc.name,
+          args: tc.args as ReadonlyJSONObject,
+          argsText: JSON.stringify(tc.args),
+        })) ?? [];
+
+      const assistantStatus =
+        typeof message.status === "object" ? message.status : undefined;
+
+      return {
+        role: "assistant",
+        id: message.id,
+        content: [...contentToParts(message.content), ...toolCallParts],
+        metadata: {
+          custom: getCustomMetadata(message.additional_kwargs),
+        },
+        ...(assistantStatus && { status: assistantStatus }),
+      };
+    }
+
+    case "tool":
+      return {
+        role: "tool",
+        toolName: message.name ?? "",
+        toolCallId: message.tool_call_id ?? "",
+        result: message.content,
+        artifact: message.artifact,
+        isError: message.status === "error",
+      };
+
+    default:
+      return {
+        role: "system",
+        id: message.id,
+        content: [
+          {
+            type: "text",
+            text:
+              typeof message.content === "string"
+                ? message.content
+                : JSON.stringify(message.content),
+          },
+        ],
+      };
+  }
+};

package/src/index.ts

@@ -0,0 +1,14 @@
+export {
+  useStreamRuntime,
+  useLangChainInterruptState,
+  useLangChainSubmit,
+} from "./useStreamRuntime";
+export type { UseStreamRuntimeOptions } from "./useStreamRuntime";
+
+export { convertLangChainBaseMessage } from "./convertMessages";
+
+export type {
+  LangChainBaseMessage,
+  LangChainContentBlock,
+  LangChainToolCall,
+} from "./types";

package/src/types.ts

@@ -0,0 +1,42 @@
+import type { MessageStatus } from "@assistant-ui/core";
+
+/** Known content block types from @langchain/core messages. */
+export type LangChainContentBlock =
+  | { type: "text"; text: string }
+  | { type: "text_delta"; text: string }
+  | { type: "image_url"; image_url: string | { url: string } }
+  | { type: "thinking"; thinking: string }
+  | {
+      type: "reasoning";
+      summary: Array<{ type: "summary_text"; text: string }>;
+    }
+  | { type: "tool_use" | "input_json_delta" };
+
+export type LangChainToolCall = {
+  id: string;
+  name: string;
+  args: Record<string, unknown>;
+};
+
+/**
+ * Minimal duck-typed interface for BaseMessage class instances returned by
+ * `useStream`. Used internally by the message converter.
+ *
+ * Uses `unknown` for `content` to remain compatible with
+ * `@langchain/core`'s `MessageContent` union.
+ */
+export type LangChainBaseMessage = {
+  _getType: () => string;
+  content: unknown;
+  id?: string | undefined;
+  name?: string | undefined;
+  additional_kwargs?: Record<string, unknown> | undefined;
+  /** Present on AIMessage */
+  tool_calls?: readonly LangChainToolCall[] | undefined;
+  /** Present on ToolMessage */
+  tool_call_id?: string | undefined;
+  /** Completion status (AIMessage) or outcome status (ToolMessage) */
+  status?: MessageStatus | "success" | "error" | undefined;
+  /** Present on ToolMessage */
+  artifact?: unknown;
+};

package/src/useStreamRuntime.ts

@@ -0,0 +1,290 @@
+"use client";
+
+import { useMemo, useRef, useState } from "react";
+import type {
+  AppendMessage,
+  AttachmentAdapter,
+  FeedbackAdapter,
+  SpeechSynthesisAdapter,
+} from "@assistant-ui/core";
+import {
+  useCloudThreadListAdapter,
+  useExternalStoreRuntime,
+  useExternalMessageConverter,
+  useRemoteThreadListRuntime,
+  useToolInvocations,
+  type ToolExecutionStatus,
+} from "@assistant-ui/core/react";
+import { useAui, useAuiState } from "@assistant-ui/store";
+import type { AssistantCloud } from "assistant-cloud";
+import { useStream, type UseStreamOptions } from "@langchain/react";
+import type { LangChainBaseMessage } from "./types";
+import { convertLangChainBaseMessage } from "./convertMessages";
+
+const symbolLangChainRuntimeExtras = Symbol("langchain-runtime-extras");
+
+type LangChainRuntimeExtras = {
+  [symbolLangChainRuntimeExtras]: true;
+  interrupt: { value?: unknown } | undefined;
+  interrupts: readonly { value?: unknown }[];
+  submit: (
+    values: Record<string, unknown> | null | undefined,
+    options?: Record<string, unknown>,
+  ) => Promise<void>;
+};
+
+const asLangChainRuntimeExtras = (extras: unknown): LangChainRuntimeExtras => {
+  if (
+    typeof extras !== "object" ||
+    extras == null ||
+    !(symbolLangChainRuntimeExtras in extras)
+  )
+    throw new Error(
+      "This method can only be called when you are using useStreamRuntime",
+    );
+  return extras as LangChainRuntimeExtras;
+};
+
+export type UseStreamRuntimeOptions = UseStreamOptions & {
+  cloud?: AssistantCloud | undefined;
+  adapters?:
+    | {
+        attachments?: AttachmentAdapter | undefined;
+        speech?: SpeechSynthesisAdapter | undefined;
+        feedback?: FeedbackAdapter | undefined;
+      }
+    | undefined;
+  /** The key in the LangGraph state that contains messages. Defaults to "messages". */
+  messagesKey?: string | undefined;
+};
+
+const getMessageContent = (msg: AppendMessage) => {
+  const allContent = [
+    ...msg.content,
+    ...(msg.attachments?.flatMap((a) => a.content) ?? []),
+  ];
+
+  const hasNonText = allContent.some(
+    (part) => part.type === "file" || part.type === "image",
+  );
+  const hasText = allContent.some((part) => part.type === "text");
+  if (hasNonText && !hasText) {
+    allContent.unshift({ type: "text", text: " " });
+  }
+
+  const content = allContent.map((part) => {
+    const type = part.type;
+    switch (type) {
+      case "text":
+        return { type: "text" as const, text: part.text };
+      case "image":
+        return { type: "image_url" as const, image_url: { url: part.image } };
+      case "file":
+        return {
+          type: "file" as const,
+          data: part.data,
+          mime_type: part.mimeType,
+          metadata: { filename: part.filename ?? "file" },
+          source_type: "base64" as const,
+        };
+      case "tool-call":
+        throw new Error("Tool call appends are not supported.");
+      default: {
+        const _exhaustiveCheck: "reasoning" | "source" | "audio" | "data" =
+          type;
+        throw new Error(
+          `Unsupported append message part type: ${_exhaustiveCheck}`,
+        );
+      }
+    }
+  });
+
+  if (content.length === 1 && content[0]?.type === "text") {
+    return content[0].text ?? "";
+  }
+  return content;
+};
+
+const useStreamThreadRuntime = ({
+  adapters,
+  messagesKey = "messages",
+  ...streamOptions
+}: Omit<UseStreamRuntimeOptions, "cloud">) => {
+  const externalId = useAuiState((s) => s.threadListItem.externalId) as
+    | string
+    | null;
+
+  const stream = useStream({
+    ...streamOptions,
+    threadId: externalId,
+  });
+
+  const [toolStatuses, setToolStatuses] = useState<
+    Record<string, ToolExecutionStatus>
+  >({});
+  const hasExecutingTools = Object.values(toolStatuses).some(
+    (s) => s?.type === "executing",
+  );
+  const effectiveIsRunning = stream.isLoading || hasExecutingTools;
+
+  const threadMessages = useExternalMessageConverter({
+    callback: convertLangChainBaseMessage,
+    messages: stream.messages as LangChainBaseMessage[],
+    isRunning: effectiveIsRunning,
+  });
+
+  const [runtimeRef] = useState(() => ({
+    get current() {
+      return runtime;
+    },
+  }));
+
+  const streamRef = useRef(stream);
+  streamRef.current = stream;
+
+  const toolInvocations = useToolInvocations({
+    state: {
+      messages: threadMessages,
+      isRunning: effectiveIsRunning,
+    },
+    getTools: () => runtimeRef.current.thread.getModelContext().tools,
+    onResult: (command) => {
+      if (command.type === "add-tool-result") {
+        void streamRef.current.submit(
+          {
+            [messagesKey]: [
+              {
+                type: "tool",
+                name: command.toolName,
+                tool_call_id: command.toolCallId,
+                content: JSON.stringify(command.result),
+                status: command.isError ? "error" : "success",
+              },
+            ],
+          },
+          {},
+        );
+      }
+    },
+    setToolStatuses,
+  });
+
+  const extras = useMemo(
+    (): LangChainRuntimeExtras => ({
+      [symbolLangChainRuntimeExtras]: true,
+      interrupt: stream.interrupt,
+      interrupts: stream.interrupts,
+      submit: stream.submit,
+    }),
+    [stream.interrupt, stream.interrupts, stream.submit],
+  );
+
+  const runtime = useExternalStoreRuntime({
+    isRunning: effectiveIsRunning,
+    messages: threadMessages,
+    adapters,
+    extras,
+    onNew: async (msg) => {
+      await toolInvocations.abort();
+      const content = getMessageContent(msg);
+      await stream.submit({
+        [messagesKey]: [{ type: "human", content }],
+      });
+    },
+    onAddToolResult: async ({
+      toolCallId,
+      toolName,
+      result,
+      isError,
+      artifact,
+    }) => {
+      await stream.submit({
+        [messagesKey]: [
+          {
+            type: "tool",
+            name: toolName,
+            tool_call_id: toolCallId,
+            content: JSON.stringify(result),
+            ...(artifact !== undefined && { artifact }),
+            status: isError ? "error" : "success",
+          },
+        ],
+      });
+    },
+    onCancel: async () => {
+      await stream.stop();
+      await toolInvocations.abort();
+    },
+  });
+
+  return runtime;
+};
+
+/**
+ * Creates an assistant-ui runtime backed by LangChain's `useStream` hook.
+ * Accepts the same options as `useStream` from `@langchain/react`, plus
+ * `cloud` and `adapters`.
+ *
+ * @example
+ * ```tsx
+ * import { useStreamRuntime } from "@assistant-ui/react-langchain";
+ * import { AssistantRuntimeProvider, Thread } from "@assistant-ui/react";
+ *
+ * function App() {
+ *   const runtime = useStreamRuntime({
+ *     assistantId: "agent",
+ *     apiUrl: "http://localhost:2024",
+ *   });
+ *
+ *   return (
+ *     <AssistantRuntimeProvider runtime={runtime}>
+ *       <Thread />
+ *     </AssistantRuntimeProvider>
+ *   );
+ * }
+ * ```
+ */
+export const useStreamRuntime = ({
+  cloud,
+  ...options
+}: UseStreamRuntimeOptions) => {
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+
+  const cloudAdapter = useCloudThreadListAdapter({ cloud });
+  return useRemoteThreadListRuntime({
+    runtimeHook: function RuntimeHook() {
+      return useStreamThreadRuntime(optionsRef.current);
+    },
+    adapter: cloudAdapter,
+    allowNesting: true,
+  });
+};
+
+/**
+ * Read the current LangGraph interrupt state from the runtime extras.
+ */
+export const useLangChainInterruptState = () => {
+  return useAuiState((s) => {
+    const extras = s.thread.extras;
+    if (!extras) return undefined;
+    return asLangChainRuntimeExtras(extras).interrupt;
+  });
+};
+
+/**
+ * Returns a function to submit raw state updates to the LangGraph agent,
+ * bypassing the normal message flow. Useful for sending interrupt resume
+ * commands.
+ */
+export const useLangChainSubmit = () => {
+  const aui = useAui();
+  return (
+    values: Record<string, unknown> | null | undefined,
+    options?: Record<string, unknown>,
+  ) => {
+    const extras = aui.thread().getState().extras;
+    const { submit } = asLangChainRuntimeExtras(extras);
+    return submit(values, options);
+  };
+};