@assistant-ui/react-langgraph 0.7.10 → 0.7.11

package/dist/useLangGraphRuntime.js

@@ -62,7 +62,7 @@ var getMessageContent = (msg) => {
   }
   return content;
 };
-var symbolLangGraphRuntimeExtras = Symbol("langgraph-runtime-extras");
+var symbolLangGraphRuntimeExtras = /* @__PURE__ */ Symbol("langgraph-runtime-extras");
 var asLangGraphRuntimeExtras = (extras) => {
   if (typeof extras !== "object" || extras == null || !(symbolLangGraphRuntimeExtras in extras))
     throw new Error(

package/dist/useLangGraphRuntime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useLangGraphRuntime.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  LangChainMessage,\n  LangChainToolCall,\n  OnCustomEventCallback,\n  OnErrorEventCallback,\n  OnInfoEventCallback,\n  OnMetadataEventCallback,\n} from \"./types\";\nimport {\n  AssistantCloud,\n  unstable_useCloudThreadListAdapter,\n  unstable_useRemoteThreadListRuntime,\n  useAssistantApi,\n  useAssistantState,\n  useExternalMessageConverter,\n  useExternalStoreRuntime,\n} from \"@assistant-ui/react\";\nimport { convertLangChainMessages } from \"./convertLangChainMessages\";\nimport {\n  LangGraphCommand,\n  LangGraphInterruptState,\n  LangGraphSendMessageConfig,\n  LangGraphStreamCallback,\n  useLangGraphMessages,\n} from \"./useLangGraphMessages\";\nimport { AttachmentAdapter } from \"@assistant-ui/react\";\nimport { AppendMessage } from \"@assistant-ui/react\";\nimport { FeedbackAdapter } from \"@assistant-ui/react\";\nimport { SpeechSynthesisAdapter } from \"@assistant-ui/react\";\nimport { appendLangChainChunk } from \"./appendLangChainChunk\";\n\nconst getPendingToolCalls = (messages: LangChainMessage[]) => {\n  const pendingToolCalls = new Map<string, LangChainToolCall>();\n  for (const message of messages) {\n    if (message.type === \"ai\") {\n      for (const toolCall of message.tool_calls ?? []) {\n        pendingToolCalls.set(toolCall.id, toolCall);\n      }\n    }\n    if (message.type === \"tool\") {\n      pendingToolCalls.delete(message.tool_call_id);\n    }\n  }\n\n  return [...pendingToolCalls.values()];\n};\n\nconst getMessageContent = (msg: AppendMessage) => {\n  const allContent = [\n    ...msg.content,\n    ...(msg.attachments?.flatMap((a) => a.content) ?? []),\n  ];\n  const content = allContent.map((part) => {\n    const type = part.type;\n    switch (type) {\n      case \"text\":\n        return { type: \"text\" as const, text: part.text };\n      case \"image\":\n        return { type: \"image_url\" as const, image_url: { url: part.image } };\n      case \"file\":\n        return {\n          type: \"file\" as const,\n          file: {\n            filename: part.filename ?? \"file\",\n            file_data: part.data,\n            mime_type: part.mimeType,\n          },\n        };\n\n      case \"tool-call\":\n        throw new Error(\"Tool call appends are not supported.\");\n\n      default:\n        const _exhaustiveCheck:\n          | \"reasoning\"\n          | \"source\"\n          | \"file\"\n          | \"audio\"\n          | \"data\" = type;\n        throw new Error(\n          `Unsupported append message part type: ${_exhaustiveCheck}`,\n        );\n    }\n  });\n\n  if (content.length === 1 && content[0]?.type === \"text\") {\n    return content[0].text ?? \"\";\n  }\n\n  return content;\n};\n\nconst symbolLangGraphRuntimeExtras = Symbol(\"langgraph-runtime-extras\");\ntype LangGraphRuntimeExtras = {\n  [symbolLangGraphRuntimeExtras]: true;\n  send: (\n    messages: LangChainMessage[],\n    config: LangGraphSendMessageConfig,\n  ) => Promise<void>;\n  interrupt: LangGraphInterruptState | undefined;\n};\n\nconst asLangGraphRuntimeExtras = (extras: unknown): LangGraphRuntimeExtras => {\n  if (\n    typeof extras !== \"object\" ||\n    extras == null ||\n    !(symbolLangGraphRuntimeExtras in extras)\n  )\n    throw new Error(\n      \"This method can only be called when you are using useLangGraphRuntime\",\n    );\n\n  return extras as LangGraphRuntimeExtras;\n};\n\nexport const useLangGraphInterruptState = () => {\n  const interrupt = useAssistantState(({ thread }) => {\n    const extras = thread.extras;\n    if (!extras) return undefined;\n    return asLangGraphRuntimeExtras(extras).interrupt;\n  });\n  return interrupt;\n};\n\nexport const useLangGraphSend = () => {\n  const api = useAssistantApi();\n\n  return (messages: LangChainMessage[], config: LangGraphSendMessageConfig) => {\n    const extras = api.thread().getState().extras;\n    const { send } = asLangGraphRuntimeExtras(extras);\n    return send(messages, config);\n  };\n};\n\nexport const useLangGraphSendCommand = () => {\n  const send = useLangGraphSend();\n  return (command: LangGraphCommand) => send([], { command });\n};\n\ntype UseLangGraphRuntimeOptions = {\n  autoCancelPendingToolCalls?: boolean | undefined;\n  unstable_allowCancellation?: boolean | undefined;\n  stream: LangGraphStreamCallback<LangChainMessage>;\n  /**\n   * @deprecated This method has been renamed to `load`. Use `load` instead.\n   */\n  onSwitchToThread?: (threadId: string) => Promise<{\n    messages: LangChainMessage[];\n    interrupts?: LangGraphInterruptState[];\n  }>;\n  load?: (threadId: string) => Promise<{\n    messages: LangChainMessage[];\n    interrupts?: LangGraphInterruptState[];\n  }>;\n  create?: () => Promise<{\n    externalId: string;\n  }>;\n  delete?: (threadId: string) => Promise<void>;\n  adapters?:\n    | {\n        attachments?: AttachmentAdapter;\n        speech?: SpeechSynthesisAdapter;\n        feedback?: FeedbackAdapter;\n      }\n    | undefined;\n  eventHandlers?:\n    | {\n        /**\n         * Called when metadata is received from the LangGraph stream\n         */\n        onMetadata?: OnMetadataEventCallback;\n        /**\n         * Called when informational messages are received from the LangGraph stream\n         */\n        onInfo?: OnInfoEventCallback;\n        /**\n         * Called when errors occur during LangGraph stream processing\n         */\n        onError?: OnErrorEventCallback;\n        /**\n         * Called when custom events are received from the LangGraph stream\n         */\n        onCustomEvent?: OnCustomEventCallback;\n      }\n    | undefined;\n  cloud?: AssistantCloud | undefined;\n};\n\nconst useLangGraphRuntimeImpl = ({\n  autoCancelPendingToolCalls,\n  adapters: { attachments, feedback, speech } = {},\n  unstable_allowCancellation,\n  stream,\n  onSwitchToThread: _onSwitchToThread,\n  load = _onSwitchToThread,\n  eventHandlers,\n}: UseLangGraphRuntimeOptions) => {\n  const {\n    interrupt,\n    setInterrupt,\n    messages,\n    sendMessage,\n    cancel,\n    setMessages,\n  } = useLangGraphMessages({\n    appendMessage: appendLangChainChunk,\n    stream,\n    ...(eventHandlers && { eventHandlers }),\n  });\n\n  const [isRunning, setIsRunning] = useState(false);\n  const handleSendMessage = async (\n    messages: LangChainMessage[],\n    config: LangGraphSendMessageConfig,\n  ) => {\n    try {\n      setIsRunning(true);\n      await sendMessage(messages, config);\n    } catch (error) {\n      console.error(\"Error streaming messages:\", error);\n    } finally {\n      setIsRunning(false);\n    }\n  };\n\n  const threadMessages = useExternalMessageConverter({\n    callback: convertLangChainMessages,\n    messages,\n    isRunning,\n  });\n\n  const loadThread = useMemo(\n    () =>\n      !load\n        ? undefined\n        : async (externalId: string) => {\n            const { messages, interrupts } = await load(externalId);\n            setMessages(messages);\n            setInterrupt(interrupts?.[0]);\n          },\n    [load, setMessages, setInterrupt],\n  );\n\n  const runtime = useExternalStoreRuntime({\n    isRunning,\n    messages: threadMessages,\n    adapters: {\n      attachments,\n      feedback,\n      speech,\n    },\n    extras: {\n      [symbolLangGraphRuntimeExtras]: true,\n      interrupt,\n      send: handleSendMessage,\n    } satisfies LangGraphRuntimeExtras,\n    onNew: (msg) => {\n      const cancellations =\n        autoCancelPendingToolCalls !== false\n          ? getPendingToolCalls(messages).map(\n              (t) =>\n                ({\n                  type: \"tool\",\n                  name: t.name,\n                  tool_call_id: t.id,\n                  content: JSON.stringify({ cancelled: true }),\n                  status: \"error\",\n                }) satisfies LangChainMessage & { type: \"tool\" },\n            )\n          : [];\n\n      return handleSendMessage(\n        [\n          ...cancellations,\n          {\n            type: \"human\",\n            content: getMessageContent(msg),\n          },\n        ],\n        {\n          runConfig: msg.runConfig,\n        },\n      );\n    },\n    onAddToolResult: async ({\n      toolCallId,\n      toolName,\n      result,\n      isError,\n      artifact,\n    }) => {\n      // TODO parallel human in the loop calls\n      await handleSendMessage(\n        [\n          {\n            type: \"tool\",\n            name: toolName,\n            tool_call_id: toolCallId,\n            content: JSON.stringify(result),\n            artifact,\n            status: isError ? \"error\" : \"success\",\n          },\n        ],\n        // TODO reuse runconfig here!\n        {},\n      );\n    },\n    onCancel: unstable_allowCancellation\n      ? async () => {\n          cancel();\n        }\n      : undefined,\n  });\n\n  {\n    const loadingRef = useRef(false);\n    useEffect(() => {\n      if (!loadThread || loadingRef.current) return;\n\n      const externalId = runtime.threads.mainItem.getState().externalId;\n      if (externalId) {\n        loadingRef.current = true;\n        loadThread(externalId).finally(() => {\n          loadingRef.current = false;\n        });\n      }\n    }, [loadThread, runtime]);\n  }\n\n  return runtime;\n};\n\nexport const useLangGraphRuntime = ({\n  cloud,\n  create,\n  delete: deleteFn,\n  ...options\n}: UseLangGraphRuntimeOptions) => {\n  const api = useAssistantApi();\n  const cloudAdapter = unstable_useCloudThreadListAdapter({\n    cloud,\n    create: async () => {\n      if (create) {\n        return create();\n      }\n\n      if (api.threadListItem.source) {\n        return api.threadListItem().initialize();\n      }\n\n      throw new Error(\n        \"initialize function requires you to pass a create function to the useLangGraphRuntime hook\",\n      );\n    },\n    delete: deleteFn,\n  });\n  return unstable_useRemoteThreadListRuntime({\n    runtimeHook: function RuntimeHook() {\n      return useLangGraphRuntimeImpl(options);\n    },\n    adapter: cloudAdapter,\n    allowNesting: true,\n  });\n};\n"],"mappings":"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","names":["messages"]}
+{"version":3,"sources":["../src/useLangGraphRuntime.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  LangChainMessage,\n  LangChainToolCall,\n  OnCustomEventCallback,\n  OnErrorEventCallback,\n  OnInfoEventCallback,\n  OnMetadataEventCallback,\n} from \"./types\";\nimport {\n  AssistantCloud,\n  unstable_useCloudThreadListAdapter,\n  unstable_useRemoteThreadListRuntime,\n  useAssistantApi,\n  useAssistantState,\n  useExternalMessageConverter,\n  useExternalStoreRuntime,\n} from \"@assistant-ui/react\";\nimport { convertLangChainMessages } from \"./convertLangChainMessages\";\nimport {\n  LangGraphCommand,\n  LangGraphInterruptState,\n  LangGraphSendMessageConfig,\n  LangGraphStreamCallback,\n  useLangGraphMessages,\n} from \"./useLangGraphMessages\";\nimport { AttachmentAdapter } from \"@assistant-ui/react\";\nimport { AppendMessage } from \"@assistant-ui/react\";\nimport { FeedbackAdapter } from \"@assistant-ui/react\";\nimport { SpeechSynthesisAdapter } from \"@assistant-ui/react\";\nimport { appendLangChainChunk } from \"./appendLangChainChunk\";\n\nconst getPendingToolCalls = (messages: LangChainMessage[]) => {\n  const pendingToolCalls = new Map<string, LangChainToolCall>();\n  for (const message of messages) {\n    if (message.type === \"ai\") {\n      for (const toolCall of message.tool_calls ?? []) {\n        pendingToolCalls.set(toolCall.id, toolCall);\n      }\n    }\n    if (message.type === \"tool\") {\n      pendingToolCalls.delete(message.tool_call_id);\n    }\n  }\n\n  return [...pendingToolCalls.values()];\n};\n\nconst getMessageContent = (msg: AppendMessage) => {\n  const allContent = [\n    ...msg.content,\n    ...(msg.attachments?.flatMap((a) => a.content) ?? []),\n  ];\n  const content = allContent.map((part) => {\n    const type = part.type;\n    switch (type) {\n      case \"text\":\n        return { type: \"text\" as const, text: part.text };\n      case \"image\":\n        return { type: \"image_url\" as const, image_url: { url: part.image } };\n      case \"file\":\n        return {\n          type: \"file\" as const,\n          file: {\n            filename: part.filename ?? \"file\",\n            file_data: part.data,\n            mime_type: part.mimeType,\n          },\n        };\n\n      case \"tool-call\":\n        throw new Error(\"Tool call appends are not supported.\");\n\n      default:\n        const _exhaustiveCheck:\n          | \"reasoning\"\n          | \"source\"\n          | \"file\"\n          | \"audio\"\n          | \"data\" = type;\n        throw new Error(\n          `Unsupported append message part type: ${_exhaustiveCheck}`,\n        );\n    }\n  });\n\n  if (content.length === 1 && content[0]?.type === \"text\") {\n    return content[0].text ?? \"\";\n  }\n\n  return content;\n};\n\nconst symbolLangGraphRuntimeExtras = Symbol(\"langgraph-runtime-extras\");\ntype LangGraphRuntimeExtras = {\n  [symbolLangGraphRuntimeExtras]: true;\n  send: (\n    messages: LangChainMessage[],\n    config: LangGraphSendMessageConfig,\n  ) => Promise<void>;\n  interrupt: LangGraphInterruptState | undefined;\n};\n\nconst asLangGraphRuntimeExtras = (extras: unknown): LangGraphRuntimeExtras => {\n  if (\n    typeof extras !== \"object\" ||\n    extras == null ||\n    !(symbolLangGraphRuntimeExtras in extras)\n  )\n    throw new Error(\n      \"This method can only be called when you are using useLangGraphRuntime\",\n    );\n\n  return extras as LangGraphRuntimeExtras;\n};\n\nexport const useLangGraphInterruptState = () => {\n  const interrupt = useAssistantState(({ thread }) => {\n    const extras = thread.extras;\n    if (!extras) return undefined;\n    return asLangGraphRuntimeExtras(extras).interrupt;\n  });\n  return interrupt;\n};\n\nexport const useLangGraphSend = () => {\n  const api = useAssistantApi();\n\n  return (messages: LangChainMessage[], config: LangGraphSendMessageConfig) => {\n    const extras = api.thread().getState().extras;\n    const { send } = asLangGraphRuntimeExtras(extras);\n    return send(messages, config);\n  };\n};\n\nexport const useLangGraphSendCommand = () => {\n  const send = useLangGraphSend();\n  return (command: LangGraphCommand) => send([], { command });\n};\n\ntype UseLangGraphRuntimeOptions = {\n  autoCancelPendingToolCalls?: boolean | undefined;\n  unstable_allowCancellation?: boolean | undefined;\n  stream: LangGraphStreamCallback<LangChainMessage>;\n  /**\n   * @deprecated This method has been renamed to `load`. Use `load` instead.\n   */\n  onSwitchToThread?: (threadId: string) => Promise<{\n    messages: LangChainMessage[];\n    interrupts?: LangGraphInterruptState[];\n  }>;\n  load?: (threadId: string) => Promise<{\n    messages: LangChainMessage[];\n    interrupts?: LangGraphInterruptState[];\n  }>;\n  create?: () => Promise<{\n    externalId: string;\n  }>;\n  delete?: (threadId: string) => Promise<void>;\n  adapters?:\n    | {\n        attachments?: AttachmentAdapter;\n        speech?: SpeechSynthesisAdapter;\n        feedback?: FeedbackAdapter;\n      }\n    | undefined;\n  eventHandlers?:\n    | {\n        /**\n         * Called when metadata is received from the LangGraph stream\n         */\n        onMetadata?: OnMetadataEventCallback;\n        /**\n         * Called when informational messages are received from the LangGraph stream\n         */\n        onInfo?: OnInfoEventCallback;\n        /**\n         * Called when errors occur during LangGraph stream processing\n         */\n        onError?: OnErrorEventCallback;\n        /**\n         * Called when custom events are received from the LangGraph stream\n         */\n        onCustomEvent?: OnCustomEventCallback;\n      }\n    | undefined;\n  cloud?: AssistantCloud | undefined;\n};\n\nconst useLangGraphRuntimeImpl = ({\n  autoCancelPendingToolCalls,\n  adapters: { attachments, feedback, speech } = {},\n  unstable_allowCancellation,\n  stream,\n  onSwitchToThread: _onSwitchToThread,\n  load = _onSwitchToThread,\n  eventHandlers,\n}: UseLangGraphRuntimeOptions) => {\n  const {\n    interrupt,\n    setInterrupt,\n    messages,\n    sendMessage,\n    cancel,\n    setMessages,\n  } = useLangGraphMessages({\n    appendMessage: appendLangChainChunk,\n    stream,\n    ...(eventHandlers && { eventHandlers }),\n  });\n\n  const [isRunning, setIsRunning] = useState(false);\n  const handleSendMessage = async (\n    messages: LangChainMessage[],\n    config: LangGraphSendMessageConfig,\n  ) => {\n    try {\n      setIsRunning(true);\n      await sendMessage(messages, config);\n    } catch (error) {\n      console.error(\"Error streaming messages:\", error);\n    } finally {\n      setIsRunning(false);\n    }\n  };\n\n  const threadMessages = useExternalMessageConverter({\n    callback: convertLangChainMessages,\n    messages,\n    isRunning,\n  });\n\n  const loadThread = useMemo(\n    () =>\n      !load\n        ? undefined\n        : async (externalId: string) => {\n            const { messages, interrupts } = await load(externalId);\n            setMessages(messages);\n            setInterrupt(interrupts?.[0]);\n          },\n    [load, setMessages, setInterrupt],\n  );\n\n  const runtime = useExternalStoreRuntime({\n    isRunning,\n    messages: threadMessages,\n    adapters: {\n      attachments,\n      feedback,\n      speech,\n    },\n    extras: {\n      [symbolLangGraphRuntimeExtras]: true,\n      interrupt,\n      send: handleSendMessage,\n    } satisfies LangGraphRuntimeExtras,\n    onNew: (msg) => {\n      const cancellations =\n        autoCancelPendingToolCalls !== false\n          ? getPendingToolCalls(messages).map(\n              (t) =>\n                ({\n                  type: \"tool\",\n                  name: t.name,\n                  tool_call_id: t.id,\n                  content: JSON.stringify({ cancelled: true }),\n                  status: \"error\",\n                }) satisfies LangChainMessage & { type: \"tool\" },\n            )\n          : [];\n\n      return handleSendMessage(\n        [\n          ...cancellations,\n          {\n            type: \"human\",\n            content: getMessageContent(msg),\n          },\n        ],\n        {\n          runConfig: msg.runConfig,\n        },\n      );\n    },\n    onAddToolResult: async ({\n      toolCallId,\n      toolName,\n      result,\n      isError,\n      artifact,\n    }) => {\n      // TODO parallel human in the loop calls\n      await handleSendMessage(\n        [\n          {\n            type: \"tool\",\n            name: toolName,\n            tool_call_id: toolCallId,\n            content: JSON.stringify(result),\n            artifact,\n            status: isError ? \"error\" : \"success\",\n          },\n        ],\n        // TODO reuse runconfig here!\n        {},\n      );\n    },\n    onCancel: unstable_allowCancellation\n      ? async () => {\n          cancel();\n        }\n      : undefined,\n  });\n\n  {\n    const loadingRef = useRef(false);\n    useEffect(() => {\n      if (!loadThread || loadingRef.current) return;\n\n      const externalId = runtime.threads.mainItem.getState().externalId;\n      if (externalId) {\n        loadingRef.current = true;\n        loadThread(externalId).finally(() => {\n          loadingRef.current = false;\n        });\n      }\n    }, [loadThread, runtime]);\n  }\n\n  return runtime;\n};\n\nexport const useLangGraphRuntime = ({\n  cloud,\n  create,\n  delete: deleteFn,\n  ...options\n}: UseLangGraphRuntimeOptions) => {\n  const api = useAssistantApi();\n  const cloudAdapter = unstable_useCloudThreadListAdapter({\n    cloud,\n    create: async () => {\n      if (create) {\n        return create();\n      }\n\n      if (api.threadListItem.source) {\n        return api.threadListItem().initialize();\n      }\n\n      throw new Error(\n        \"initialize function requires you to pass a create function to the useLangGraphRuntime hook\",\n      );\n    },\n    delete: deleteFn,\n  });\n  return unstable_useRemoteThreadListRuntime({\n    runtimeHook: function RuntimeHook() {\n      return useLangGraphRuntimeImpl(options);\n    },\n    adapter: cloudAdapter,\n    allowNesting: true,\n  });\n};\n"],"mappings":"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","names":["messages"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react-langgraph",
-  "version": "0.7.10",
+  "version": "0.7.11",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -18,12 +18,12 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "assistant-stream": "^0.2.42",
+    "assistant-stream": "^0.2.44",
     "uuid": "^13.0.0",
     "zod": "^4.1.13"
   },
   "peerDependencies": {
-    "@assistant-ui/react": "^0.11.46",
+    "@assistant-ui/react": "^0.11.49",
     "@types/react": "*",
     "react": "^18 || ^19 || ^19.0.0-rc"
   },
@@ -39,10 +39,10 @@
     "@types/react": "^19.2.7",
     "@types/uuid": "^11.0.0",
     "jsdom": "^27.2.0",
-    "react": "19.2.0",
-    "tsx": "^4.20.6",
-    "vitest": "^4.0.14",
-    "@assistant-ui/react": "0.11.46",
+    "react": "19.2.1",
+    "tsx": "^4.21.0",
+    "vitest": "^4.0.15",
+    "@assistant-ui/react": "0.11.49",
     "@assistant-ui/x-buildutils": "0.0.1"
   },
   "publishConfig": {
@@ -59,7 +59,6 @@
   },
   "scripts": {
     "build": "tsx scripts/build.mts",
-    "lint": "eslint .",
     "test": "vitest run",
     "test:watch": "vitest"
   }

package/src/useLangGraphRuntime.test.tsx

@@ -6,7 +6,7 @@ import {
 } from "@assistant-ui/react";
 import { useLangGraphRuntime, useLangGraphSend } from "./useLangGraphRuntime";
 import { mockStreamCallbackFactory } from "./testUtils";
-import React, { ReactNode } from "react";
+import { ReactNode } from "react";
 
 const metadataEvent = {
   event: "metadata",