@assistant-ui/react-langchain 0.0.6 → 0.0.8

package/README.md

@@ -1,17 +1,10 @@
-## `@assistant-ui/react-langchain`
+# `@assistant-ui/react-langchain`
 
-Adapter that wraps [`useStream`](https://docs.langchain.com/oss/javascript/langgraph-sdk/react-stream) from `@langchain/react` and exposes it as an assistant-ui runtime, with hooks for reading interrupts, submitting raw state updates, and reading arbitrary LangGraph custom state keys.
+Adapter that wraps [`useStream`](https://docs.langchain.com/oss/javascript/langgraph-sdk/react-stream) from `@langchain/react` and exposes it as an assistant-ui runtime. Bridges LangChain's `useStream` to an `AssistantRuntime` with hooks for interrupts, raw state submission, and reading custom LangGraph state keys.
 
-> assistant-ui also ships [`@assistant-ui/react-langgraph`](https://www.npmjs.com/package/@assistant-ui/react-langgraph), which integrates with `@langchain/langgraph-sdk` directly and has a broader feature set (subgraph events, UI messages, message metadata, cancellation). The two packages are independent adapters targeting different upstream libraries — pick whichever matches your upstream choice. See the [comparison](https://www.assistant-ui.com/docs/runtimes/langchain/comparison).
+## When to use this
 
-## Features
-
-- Bridges LangChain's `useStream` to an assistant-ui `AssistantRuntime`
-- Tool invocations flow through assistant-ui's `useToolInvocations`
-- `useLangChainInterruptState` — read the current LangGraph interrupt
-- `useLangChainSubmit` — submit raw state updates (e.g. resume commands)
-- `useLangChainState<T>(key)` — read custom state keys like `todos` / `files` reactively
-- Optional assistant-cloud thread persistence
+assistant-ui also ships `@assistant-ui/react-langgraph`, which integrates with `@langchain/langgraph-sdk` directly and has a broader feature set (subgraph events, UI messages, message metadata, cancellation). The two packages are independent adapters targeting different upstream libraries; pick whichever matches the SDK you already use.
 
 ## Installation
 
@@ -21,13 +14,12 @@ npm install @assistant-ui/react @assistant-ui/react-langchain @langchain/react
 
 ## Usage
 
-### Basic setup
-
 ```tsx
 import { useStreamRuntime } from "@assistant-ui/react-langchain";
-import { AssistantRuntimeProvider, Thread } from "@assistant-ui/react";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { Thread } from "@/components/assistant-ui/thread";
 
-function App() {
+export function App() {
   const runtime = useStreamRuntime({
     assistantId: "agent",
     apiUrl: "http://localhost:2024",
@@ -41,71 +33,6 @@ function App() {
 }
 ```
 
-`useStreamRuntime` accepts every option `useStream` from `@langchain/react` does, plus:
-
-- `cloud` — an `AssistantCloud` instance for persisting threads
-- `adapters` — `{ attachments, speech, feedback }`
-- `messagesKey` — the state key that holds messages (default `"messages"`)
-
-### Reading custom state keys
-
-LangGraph agents often expose structured state beyond messages (plans, todos, scratch files, generative-UI artifacts). Read them directly with `useLangChainState` — mirrors `useStream().values[key]` upstream and updates when the stream emits new state.
-
-```tsx
-import { useLangChainState } from "@assistant-ui/react-langchain";
-
-type Todo = { id: string; title: string; done: boolean };
-
-function TodoList() {
-  const todos = useLangChainState<Todo[]>("todos", []);
-
-  return (
-    <ul>
-      {todos.map((t) => (
-        <li key={t.id}>{t.title}</li>
-      ))}
-    </ul>
-  );
-}
-```
-
-Signatures:
+`useStreamRuntime` accepts every option `@langchain/react`'s `useStream` does, plus `cloud` for thread persistence, an `adapters` bag, and a `messagesKey` override.
 
-```ts
-useLangChainState<T>(key: string): T | undefined;
-useLangChainState<T>(key: string, defaultValue: T): T;
-```
-
-### Interrupts
-
-```tsx
-import {
-  useLangChainInterruptState,
-  useLangChainSubmit,
-} from "@assistant-ui/react-langchain";
-import { Command } from "@langchain/langgraph-sdk";
-
-function InterruptPrompt() {
-  const interrupt = useLangChainInterruptState();
-  const submit = useLangChainSubmit();
-
-  if (!interrupt) return null;
-
-  return (
-    <div>
-      <pre>{JSON.stringify(interrupt.value, null, 2)}</pre>
-      <button onClick={() => submit(null, { command: new Command({ resume: "yes" }) })}>
-        Approve
-      </button>
-    </div>
-  );
-}
-```
-
-### Message conversion
-
-The adapter ships `convertLangChainBaseMessage` for cases where you want to reuse the internal converter directly (e.g. when building a custom `ExternalStoreAdapter`).
-
-```ts
-import { convertLangChainBaseMessage } from "@assistant-ui/react-langchain";
-```
+Full reference for `useLangChainState`, `useLangChainInterruptState`, `useLangChainSubmit`, and `convertLangChainBaseMessage` at [assistant-ui.com/docs/runtimes/langchain](https://www.assistant-ui.com/docs/runtimes/langchain).

package/dist/convertMessages.d.ts

@@ -1,4 +1,9 @@
-import type { useExternalMessageConverter } from "@assistant-ui/core/react";
-import type { LangChainBaseMessage } from "./types.js";
-export declare const convertLangChainBaseMessage: useExternalMessageConverter.Callback<LangChainBaseMessage>;
+import { LangChainBaseMessage } from "./types.js";
+import { useExternalMessageConverter } from "@assistant-ui/core/react";
+
+//#region src/convertMessages.d.ts
+declare const getMessageType: (message: LangChainBaseMessage) => string;
+declare const convertLangChainBaseMessage: useExternalMessageConverter.Callback<LangChainBaseMessage>;
+//#endregion
+export { convertLangChainBaseMessage, getMessageType };
 //# sourceMappingURL=convertMessages.d.ts.map

package/dist/convertMessages.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"convertMessages.d.ts","names":[],"sources":["../src/convertMessages.ts"],"mappings":";;;;cAMa,cAAA,GAAkB,OAA6B,EAApB,oBAAoB;AAAA,cAuD/C,2BAAA,EAA6B,2BAAA,CAA4B,QAAQ,CAC5E,oBAAA"}

package/dist/convertMessages.js

@@ -1,115 +1,103 @@
 "use client";
+//#region src/convertMessages.ts
 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");
+	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);
+	if (typeof content === "string") return [{
+		type: "text",
+		text: content
+	}];
+	return content.map((part) => {
+		switch (part.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("");
+	if (typeof content === "string") return content;
+	return content.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),
-                    },
-                ],
-            };
-    }
+const convertLangChainBaseMessage = (message) => {
+	switch (getMessageType(message)) {
+		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 : void 0;
+			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)
+			}]
+		};
+	}
 };
+//#endregion
+export { convertLangChainBaseMessage, getMessageType };
+
 //# sourceMappingURL=convertMessages.js.map

package/dist/convertMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"convertMessages.js","sourceRoot":"","sources":["../src/convertMessages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"convertMessages.js","names":["parts"],"sources":["../src/convertMessages.ts"],"sourcesContent":["\"use client\";\n\nimport type { useExternalMessageConverter } from \"@assistant-ui/core/react\";\nimport type { ReadonlyJSONObject } from \"assistant-stream/utils\";\nimport type { LangChainBaseMessage, LangChainContentBlock } from \"./types\";\n\nexport const getMessageType = (message: LangChainBaseMessage): string => {\n  if (typeof message._getType === \"function\") return message._getType();\n  if (\"type\" in message)\n    return (message as Record<string, unknown>).type as string;\n  throw new Error(\"Cannot determine message type\");\n};\n\nconst contentToParts = (content: unknown) => {\n  if (typeof content === \"string\")\n    return [{ type: \"text\" as const, text: content }];\n\n  const parts = content as readonly LangChainContentBlock[];\n  return parts\n    .map((part) => {\n      const type = part.type;\n      switch (type) {\n        case \"text\":\n        case \"text_delta\":\n          return { type: \"text\" as const, text: part.text };\n        case \"image_url\":\n          if (typeof part.image_url === \"string\") {\n            return { type: \"image\" as const, image: part.image_url };\n          }\n          return { type: \"image\" as const, image: part.image_url.url };\n        case \"thinking\":\n          return { type: \"reasoning\" as const, text: part.thinking };\n        case \"reasoning\":\n          return {\n            type: \"reasoning\" as const,\n            text: part.summary.map((s) => s.text).join(\"\\n\\n\\n\"),\n          };\n        case \"tool_use\":\n        case \"input_json_delta\":\n          return null;\n        default:\n          return null;\n      }\n    })\n    .filter((p) => p !== null);\n};\n\nconst getCustomMetadata = (\n  additionalKwargs: Record<string, unknown> | undefined,\n): Record<string, unknown> =>\n  (additionalKwargs?.metadata as Record<string, unknown>) ?? {};\n\nconst getStringContent = (content: unknown): string => {\n  if (typeof content === \"string\") return content;\n  const parts = content as readonly LangChainContentBlock[];\n  return parts\n    .filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n    .map((c) => c.text)\n    .join(\"\");\n};\n\nexport const convertLangChainBaseMessage: useExternalMessageConverter.Callback<\n  LangChainBaseMessage\n> = (message) => {\n  const type = getMessageType(message);\n\n  switch (type) {\n    case \"system\":\n      return {\n        role: \"system\",\n        id: message.id,\n        content: [{ type: \"text\", text: getStringContent(message.content) }],\n        metadata: {\n          custom: getCustomMetadata(message.additional_kwargs),\n        },\n      };\n\n    case \"human\":\n      return {\n        role: \"user\",\n        id: message.id,\n        content: contentToParts(message.content),\n        metadata: {\n          custom: getCustomMetadata(message.additional_kwargs),\n        },\n      };\n\n    case \"ai\": {\n      const toolCallParts =\n        message.tool_calls?.map((tc) => ({\n          type: \"tool-call\" as const,\n          toolCallId: tc.id,\n          toolName: tc.name,\n          args: tc.args as ReadonlyJSONObject,\n          argsText: JSON.stringify(tc.args),\n        })) ?? [];\n\n      const assistantStatus =\n        typeof message.status === \"object\" ? message.status : undefined;\n\n      return {\n        role: \"assistant\",\n        id: message.id,\n        content: [...contentToParts(message.content), ...toolCallParts],\n        metadata: {\n          custom: getCustomMetadata(message.additional_kwargs),\n        },\n        ...(assistantStatus && { status: assistantStatus }),\n      };\n    }\n\n    case \"tool\":\n      return {\n        role: \"tool\",\n        toolName: message.name ?? \"\",\n        toolCallId: message.tool_call_id ?? \"\",\n        result: message.content,\n        artifact: message.artifact,\n        isError: message.status === \"error\",\n      };\n\n    default:\n      return {\n        role: \"system\",\n        id: message.id,\n        content: [\n          {\n            type: \"text\",\n            text:\n              typeof message.content === \"string\"\n                ? message.content\n                : JSON.stringify(message.content),\n          },\n        ],\n      };\n  }\n};\n"],"mappings":";;AAMA,MAAa,kBAAkB,YAA0C;CACvE,IAAI,OAAO,QAAQ,aAAa,YAAY,OAAO,QAAQ,SAAS;CACpE,IAAI,UAAU,SACZ,OAAQ,QAAoC;CAC9C,MAAM,IAAI,MAAM,+BAA+B;AACjD;AAEA,MAAM,kBAAkB,YAAqB;CAC3C,IAAI,OAAO,YAAY,UACrB,OAAO,CAAC;EAAE,MAAM;EAAiB,MAAM;CAAQ,CAAC;CAGlD,OAAOA,QACJ,KAAK,SAAS;EAEb,QADa,KAAK,MAClB;GACE,KAAK;GACL,KAAK,cACH,OAAO;IAAE,MAAM;IAAiB,MAAM,KAAK;GAAK;GAClD,KAAK;IACH,IAAI,OAAO,KAAK,cAAc,UAC5B,OAAO;KAAE,MAAM;KAAkB,OAAO,KAAK;IAAU;IAEzD,OAAO;KAAE,MAAM;KAAkB,OAAO,KAAK,UAAU;IAAI;GAC7D,KAAK,YACH,OAAO;IAAE,MAAM;IAAsB,MAAM,KAAK;GAAS;GAC3D,KAAK,aACH,OAAO;IACL,MAAM;IACN,MAAM,KAAK,QAAQ,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,QAAQ;GACrD;GACF,KAAK;GACL,KAAK,oBACH,OAAO;GACT,SACE,OAAO;EACX;CACF,CAAC,EACA,QAAQ,MAAM,MAAM,IAAI;AAC7B;AAEA,MAAM,qBACJ,qBAEC,kBAAkB,YAAwC,CAAC;AAE9D,MAAM,oBAAoB,YAA6B;CACrD,IAAI,OAAO,YAAY,UAAU,OAAO;CAExC,OAAOA,QACJ,QAAQ,MAA2C,EAAE,SAAS,MAAM,EACpE,KAAK,MAAM,EAAE,IAAI,EACjB,KAAK,EAAE;AACZ;AAEA,MAAa,+BAER,YAAY;CAGf,QAFa,eAAe,OAEjB,GAAX;EACE,KAAK,UACH,OAAO;GACL,MAAM;GACN,IAAI,QAAQ;GACZ,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,iBAAiB,QAAQ,OAAO;GAAE,CAAC;GACnE,UAAU,EACR,QAAQ,kBAAkB,QAAQ,iBAAiB,EACrD;EACF;EAEF,KAAK,SACH,OAAO;GACL,MAAM;GACN,IAAI,QAAQ;GACZ,SAAS,eAAe,QAAQ,OAAO;GACvC,UAAU,EACR,QAAQ,kBAAkB,QAAQ,iBAAiB,EACrD;EACF;EAEF,KAAK,MAAM;GACT,MAAM,gBACJ,QAAQ,YAAY,KAAK,QAAQ;IAC/B,MAAM;IACN,YAAY,GAAG;IACf,UAAU,GAAG;IACb,MAAM,GAAG;IACT,UAAU,KAAK,UAAU,GAAG,IAAI;GAClC,EAAE,KAAK,CAAC;GAEV,MAAM,kBACJ,OAAO,QAAQ,WAAW,WAAW,QAAQ,SAAS,KAAA;GAExD,OAAO;IACL,MAAM;IACN,IAAI,QAAQ;IACZ,SAAS,CAAC,GAAG,eAAe,QAAQ,OAAO,GAAG,GAAG,aAAa;IAC9D,UAAU,EACR,QAAQ,kBAAkB,QAAQ,iBAAiB,EACrD;IACA,GAAI,mBAAmB,EAAE,QAAQ,gBAAgB;GACnD;EACF;EAEA,KAAK,QACH,OAAO;GACL,MAAM;GACN,UAAU,QAAQ,QAAQ;GAC1B,YAAY,QAAQ,gBAAgB;GACpC,QAAQ,QAAQ;GAChB,UAAU,QAAQ;GAClB,SAAS,QAAQ,WAAW;EAC9B;EAEF,SACE,OAAO;GACL,MAAM;GACN,IAAI,QAAQ;GACZ,SAAS,CACP;IACE,MAAM;IACN,MACE,OAAO,QAAQ,YAAY,WACvB,QAAQ,UACR,KAAK,UAAU,QAAQ,OAAO;GACtC,CACF;EACF;CACJ;AACF"}

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-export { useStreamRuntime, useLangChainInterruptState, useLangChainState, 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
+import { LangChainBaseMessage, LangChainContentBlock, LangChainToolCall } from "./types.js";
+import { convertLangChainBaseMessage } from "./convertMessages.js";
+import { UseStreamRuntimeOptions, useLangChainInterruptState, useLangChainSend, useLangChainSendCommand, useLangChainState, useLangChainSubmit, useStreamRuntime } from "./useStreamRuntime.js";
+export { type LangChainBaseMessage, type LangChainContentBlock, type LangChainToolCall, type UseStreamRuntimeOptions, convertLangChainBaseMessage, useLangChainInterruptState, useLangChainSend, useLangChainSendCommand, useLangChainState, useLangChainSubmit, useStreamRuntime };

package/dist/index.js

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

package/dist/types.d.ts

@@ -1,32 +1,34 @@
-import type { MessageStatus } from "@assistant-ui/core";
+import { MessageStatus } from "@assistant-ui/core";
+
+//#region src/types.d.ts
 /** Known content block types from @langchain/core messages. */
-export type LangChainContentBlock = {
-    type: "text";
-    text: string;
+type LangChainContentBlock = {
+  type: "text";
+  text: string;
 } | {
-    type: "text_delta";
-    text: string;
+  type: "text_delta";
+  text: string;
 } | {
-    type: "image_url";
-    image_url: string | {
-        url: string;
-    };
+  type: "image_url";
+  image_url: string | {
+    url: string;
+  };
 } | {
-    type: "thinking";
-    thinking: string;
+  type: "thinking";
+  thinking: string;
 } | {
-    type: "reasoning";
-    summary: Array<{
-        type: "summary_text";
-        text: string;
-    }>;
+  type: "reasoning";
+  summary: Array<{
+    type: "summary_text";
+    text: string;
+  }>;
 } | {
-    type: "tool_use" | "input_json_delta";
+  type: "tool_use" | "input_json_delta";
 };
-export type LangChainToolCall = {
-    id: string;
-    name: string;
-    args: Record<string, unknown>;
+type LangChainToolCall = {
+  id: string;
+  name: string;
+  args: Record<string, unknown>;
 };
 /**
  * Minimal duck-typed interface for BaseMessage class instances returned by
@@ -35,19 +37,17 @@ export type LangChainToolCall = {
  * 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;
+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;
 };
+//#endregion
+export { LangChainBaseMessage, LangChainContentBlock, LangChainToolCall };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;KAGY,qBAAA;EACN,IAAA;EAAc,IAAA;AAAA;EACd,IAAA;EAAoB,IAAA;AAAA;EACpB,IAAA;EAAmB,SAAA;IAAsB,GAAA;EAAA;AAAA;EACzC,IAAA;EAAkB,QAAA;AAAA;EAElB,IAAA;EACA,OAAA,EAAS,KAAK;IAAG,IAAA;IAAsB,IAAA;EAAA;AAAA;EAEvC,IAAA;AAAA;AAAA,KAEM,iBAAA;EACV,EAAA;EACA,IAAA;EACA,IAAA,EAAM,MAAM;AAAA;;;;AAAA;AAUd;;;KAAY,oBAAA;EACV,QAAA;EACA,OAAA;EACA,EAAA;EACA,IAAA;EACA,iBAAA,GAAoB,MAAA,+BAHpB;EAKA,UAAA,YAAsB,iBAAA,gBAHtB;EAKA,YAAA,uBAJoB;EAMpB,MAAA,GAAS,aAAA,oCAJa;EAMtB,QAAA;AAAA"}

package/dist/types.js

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

package/dist/useStreamRuntime.d.ts

@@ -1,16 +1,39 @@
-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;
+import { LangChainBaseMessage } from "./types.js";
+import { UseStreamOptions } from "@langchain/react";
+import { AttachmentAdapter, FeedbackAdapter, RemoteThreadListAdapter, SpeechSynthesisAdapter } from "@assistant-ui/core";
+import { AssistantCloud } from "assistant-cloud";
+
+//#region src/useStreamRuntime.d.ts
+type LangChainRuntimeExtraOptions = {
+  cloud?: AssistantCloud | undefined;
+  adapters?: {
+    attachments?: AttachmentAdapter | undefined;
+    speech?: SpeechSynthesisAdapter | undefined;
+    feedback?: FeedbackAdapter | undefined;
+  } | undefined;
+  /**
+   * When the user sends a new message while previous tool calls are
+   * still pending, automatically submit `tool` messages that cancel
+   * them so the agent's tool-call accounting stays consistent.
+   * Defaults to `true`.
+   */
+  autoCancelPendingToolCalls?: boolean | undefined;
+  /**
+   * Routes the Cancel button's click to `useStream().stop()`. On by
+   * default. Pass `false` to disable the Cancel button.
+   */
+  unstable_allowCancellation?: boolean | undefined;
+  /**
+   * Custom `RemoteThreadListAdapter`. When provided, replaces the
+   * cloud-backed thread list adapter.
+   */
+  unstable_threadListAdapter?: RemoteThreadListAdapter | undefined; /** Custom thread-creation hook, forwarded to the cloud adapter. */
+  create?: (() => Promise<{
+    externalId: string | undefined;
+  }>) | undefined; /** Custom thread-deletion hook, forwarded to the cloud adapter. */
+  delete?: ((threadId: string) => Promise<void>) | undefined;
 };
+type UseStreamRuntimeOptions = UseStreamOptions extends infer O ? O extends UseStreamOptions ? O & LangChainRuntimeExtraOptions : never : never;
 /**
  * Creates an assistant-ui runtime backed by LangChain's `useStream` hook.
  * Accepts the same options as `useStream` from `@langchain/react`, plus
@@ -35,19 +58,33 @@ export type UseStreamRuntimeOptions = UseStreamOptions & {
  * }
  * ```
  */
-export declare const useStreamRuntime: ({ cloud, ...options }: UseStreamRuntimeOptions) => import("@assistant-ui/core").AssistantRuntime;
+declare const useStreamRuntime: (rawOptions: UseStreamRuntimeOptions) => import("@assistant-ui/core").AssistantRuntime;
 /**
  * Read the current LangGraph interrupt state from the runtime extras.
  */
-export declare const useLangChainInterruptState: () => {
-    value?: unknown;
+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>;
+declare const useLangChainSubmit: () => (values: Record<string, unknown> | null | undefined, options?: Record<string, unknown>) => Promise<void>;
+/**
+ * Submit a list of LangChain-shaped messages on the current thread.
+ * Parity helper for migrating from `useLangGraphSend`. Routes to
+ * `useStream().submit({ [messagesKey]: messages }, options)`.
+ */
+declare const useLangChainSend: () => (messages: readonly LangChainBaseMessage[], options?: Record<string, unknown>) => Promise<void>;
+/**
+ * Submit a `useStream` command (e.g. interrupt resume). Parity helper
+ * for migrating from `useLangGraphSendCommand`. Note that v1's command
+ * shape (`{ resume?, goto?, update? }`) differs from the legacy
+ * `{ resume: string }` form — to carry a payload, use the input or
+ * `stream.respond` instead.
+ */
+declare const useLangChainSendCommand: () => (command: Record<string, unknown>) => Promise<void>;
 /**
  * Read a custom LangGraph state key from the current thread. Mirrors
  * `useStream().values[key]` from `@langchain/react` and updates when the
@@ -59,6 +96,8 @@ export declare const useLangChainSubmit: () => (values: Record<string, unknown>
  * const files = useLangChainState<Record<string, string>>("files", {});
  * ```
  */
-export declare function useLangChainState<T>(key: string): T | undefined;
-export declare function useLangChainState<T>(key: string, defaultValue: T): T;
+declare function useLangChainState<T>(key: string): T | undefined;
+declare function useLangChainState<T>(key: string, defaultValue: T): T;
+//#endregion
+export { UseStreamRuntimeOptions, useLangChainInterruptState, useLangChainSend, useLangChainSendCommand, useLangChainState, useLangChainSubmit, useStreamRuntime };
 //# sourceMappingURL=useStreamRuntime.d.ts.map

package/dist/useStreamRuntime.d.ts.map

@@ -1 +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;AA6BpE,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;AA8KF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,gBAAgB,GAAI,uBAG9B,uBAAuB,kDAazB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;YA3PhB,OAAO;aAiQ7B,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;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;AACjE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"useStreamRuntime.d.ts","names":[],"sources":["../src/useStreamRuntime.ts"],"mappings":";;;;;;KAkDK,4BAAA;EACH,KAAA,GAAQ,cAAA;EACR,QAAA;IAEM,WAAA,GAAc,iBAAA;IACd,MAAA,GAAS,sBAAA;IACT,QAAA,GAAW,eAAA;EAAA;EADF;;;;;;EAUf,0BAAA;EAdA;;;;EAmBA,0BAAA;EAfM;;;;EAoBN,0BAAA,GAA6B,uBAAA,cAL7B;EAOA,MAAA,UAAgB,OAAA;IAAU,UAAA;EAAA,iBAAV;EAEhB,MAAA,KAAW,QAAA,aAAqB,OAAA;AAAA;AAAA,KAsBtB,uBAAA,GAA0B,gBAAA,mBAClC,CAAA,SAAU,gBAAA,GACR,CAAA,GAAI,4BAAA;;;AAxB+B;AAsBzC;;;;;;;;;;;;;;;;AAEsC;AA4OtC;;;;cAAa,gBAAA,GAAoB,UAAA,EAAY,uBAAuB,kCAAA,gBAAA;;;;cAgCvD,0BAAA;EAMZ,KAAA;AAAA;;;;AAOD;;cAAa,kBAAA,SAGT,MAAA,EAAQ,MAAA,sCACR,OAAA,GAAU,MAAA,sBAAuB,OAAA;;;;;;cAaxB,gBAAA,SAGT,QAAA,WAAmB,oBAAA,IACnB,OAAA,GAAU,MAAA,sBAAuB,OAAA;;;;;;AAjBA;AAarC;cAoBa,uBAAA,SAEH,OAAA,EAAS,MAAA,sBAAuB,OAAA;;;;;;;;;;;;iBAc1B,iBAAA,GAAA,CAAqB,GAAA,WAAc,CAAC;AAAA,iBACpC,iBAAA,GAAA,CAAqB,GAAA,UAAa,YAAA,EAAc,CAAA,GAAI,CAAC"}