@langgraph-js/sdk 4.3.4 → 4.3.6

package/dist/History.d.ts

@@ -43,7 +43,7 @@ export declare class History {
      * @zh 激活指定会话（懒加载创建 Client）
      * @en Activates the specified session (lazy load client)
      */
-    activateSession(sessionId: string): Promise<SessionInfo>;
+    activateSession(sessionId: string, mustResetStream?: boolean): Promise<SessionInfo>;
     /**
      * @zh 获取当前活跃的会话
      * @en Gets the current active session

package/dist/History.js

@@ -45,18 +45,18 @@ export class History {
      * @zh 激活指定会话（懒加载创建 Client）
      * @en Activates the specified session (lazy load client)
      */
-    async activateSession(sessionId) {
-        const session = this.sessions.get(sessionId);
-        if (!session) {
-            throw new Error(`Session ${sessionId} not found`);
-        }
+    async activateSession(sessionId, mustResetStream = false) {
+        const session = this.sessions.get(sessionId) || {
+            sessionId,
+            agentName: this.virtualClient.getCurrentAssistant()?.graph_id,
+        };
         // 懒加载：只在激活时创建 Client
         if (!session.client) {
             const client = new LangGraphClient(this.clientConfig);
             await client.initAssistant(session.agentName);
             // 只有在有 thread 的情况下才重置（恢复已有会话）
             // 新会话的 thread 会在发送第一条消息时自动创建
-            if (session.thread) {
+            if (session.thread || mustResetStream) {
                 await client.resetThread(session.agentName, sessionId);
             }
             session.client = client;

package/dist/LangGraphClient.js

@@ -390,7 +390,7 @@ export class LangGraphClient extends EventEmitter {
                     additional_kwargs: {},
                 };
                 // json 校验
-                return this.callFETool(toolMessage, tool.args);
+                return this.callFETool(toolMessage, tool.args).catch((e) => console.warn(e));
             });
             console.log("batch call tools", result.length);
             // 只有当卡住流程时，才改变状态为 interrupted

package/dist/react/ChatContext.d.ts

@@ -34,7 +34,7 @@ export declare const useChat: () => UnionStore<{
         initClient: () => Promise<import("../History.js").History>;
         getClient: () => import("../LangGraphClient.js").LangGraphClient<unknown> | null;
         getHistory: () => import("../History.js").History | null;
-        activateSession: (sessionId: string) => Promise<void>;
+        activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;
@@ -70,6 +70,7 @@ interface ChatProviderProps {
     apiUrl?: string;
     defaultHeaders?: Record<string, string>;
     withCredentials?: boolean;
+    fetch?: typeof fetch;
     showHistory?: boolean;
     showGraph?: boolean;
     fallbackToAvailableAssistants?: boolean;

package/dist/react/ChatContext.js

@@ -9,7 +9,7 @@ export const useChat = () => {
     }
     return context;
 };
-export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://localhost:8123", defaultHeaders, withCredentials = false, showHistory = false, showGraph = false, fallbackToAvailableAssistants = false, autoRestoreLastSession = false, onInitError, client, legacyMode = false, }) => {
+export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://localhost:8123", defaultHeaders, withCredentials = false, fetch, showHistory = false, showGraph = false, fallbackToAvailableAssistants = false, autoRestoreLastSession = false, onInitError, client, legacyMode = false, }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
     const stableHeaders = useMemo(() => defaultHeaders || {}, [defaultHeaders]);
     // 使用 useRef 保存 onInitError 的最新引用
@@ -18,12 +18,13 @@ export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://loc
         onInitErrorRef.current = onInitError;
     }, [onInitError]);
     const store = useMemo(() => {
+        const baseFetch = fetch || globalThis.fetch;
         const F = withCredentials
             ? (url, options) => {
                 options.credentials = "include";
-                return fetch(url, options);
+                return baseFetch(url, options);
             }
-            : fetch;
+            : baseFetch;
         const config = {
             apiUrl,
             defaultHeaders: stableHeaders,
@@ -42,7 +43,7 @@ export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://loc
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
     const unionStore = useUnionStore(store, useStore);
     // 使用 ref 标记是否已初始化
     const initializedRef = useRef(false);

package/dist/solid/ChatContext.d.ts

@@ -34,7 +34,7 @@ export declare const useChat: () => UnionStoreSolid<{
         initClient: () => Promise<import("../History.js").History>;
         getClient: () => import("../LangGraphClient.js").LangGraphClient<unknown> | null;
         getHistory: () => import("../History.js").History | null;
-        activateSession: (sessionId: string) => Promise<void>;
+        activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;
@@ -70,6 +70,7 @@ interface ChatProviderProps {
     apiUrl?: string;
     defaultHeaders?: Record<string, string>;
     withCredentials?: boolean;
+    fetch?: typeof fetch;
     showHistory?: boolean;
     showGraph?: boolean;
     fallbackToAvailableAssistants?: boolean;

package/dist/solid/ChatContext.js

@@ -26,12 +26,15 @@ export const ChatProvider = (props) => {
     // 使用 createMemo 稳定 defaultHeaders 的引用
     const stableHeaders = createMemo(() => props.defaultHeaders || {});
     // 使用 createMemo 创建 fetch 函数
-    const F = createMemo(() => props.withCredentials
-        ? (url, options) => {
-            options.credentials = "include";
-            return fetch(url, options);
-        }
-        : fetch);
+    const F = createMemo(() => {
+        const baseFetch = props.fetch || globalThis.fetch;
+        return props.withCredentials
+            ? (url, options) => {
+                options.credentials = "include";
+                return baseFetch(url, options);
+            }
+            : baseFetch;
+    });
     const store = createMemo(() => {
         const config = {
             apiUrl: props.apiUrl || "http://localhost:8123",

package/dist/ui-store/createChatStore.d.ts

@@ -50,7 +50,7 @@ export declare const createChatStore: (initClientName: string, config: Partial<L
         initClient: () => Promise<History>;
         getClient: () => LangGraphClient<unknown> | null;
         getHistory: () => History | null;
-        activateSession: (sessionId: string) => Promise<void>;
+        activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;

package/dist/ui-store/createChatStore.js

@@ -234,7 +234,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
         };
     }
     // ============ 会话激活逻辑 ============
-    async function activateSession(sessionId) {
+    async function activateSession(sessionId, mustResetStream = false) {
         const historyManager = history.get();
         if (!historyManager)
             return;
@@ -246,7 +246,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
             inChatError.set(null);
             interruptData.set(null);
             isInterrupted.set(false);
-            const session = await historyManager.activateSession(sessionId);
+            const session = await historyManager.activateSession(sessionId, mustResetStream);
             const activeClient = session.client;
             if (activeClient) {
                 cleanupCurrentClient = setupClientListeners(activeClient);
@@ -416,7 +416,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
             // 历史记录（兼容旧 API）
             addToHistory,
             createNewChat: createNewSession,
-            toHistoryChat: (thread) => activateSession(thread.thread_id),
+            toHistoryChat: (thread) => activateSession(thread.thread_id, true),
             async deleteHistoryChat(thread) {
                 const historyManager = history.get();
                 if (historyManager) {

package/dist/vue/ChatContext.d.ts

@@ -30,6 +30,7 @@ export interface ChatProviderProps {
     apiUrl?: string;
     defaultHeaders?: Record<string, string>;
     withCredentials?: boolean;
+    fetch?: typeof fetch;
     showHistory?: boolean;
     showGraph?: boolean;
     fallbackToAvailableAssistants?: boolean;
@@ -77,7 +78,7 @@ export declare const useChatProvider: (props: ChatProviderProps) => {
             initClient: () => Promise<import("../History.js").History>;
             getClient: () => import("../LangGraphClient.js").LangGraphClient<unknown> | null;
             getHistory: () => import("../History.js").History | null;
-            activateSession: (sessionId: string) => Promise<void>;
+            activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
             createNewSession: () => Promise<void>;
             refreshSessionList: () => Promise<void>;
             refreshHistoryList: () => Promise<void>;
@@ -129,6 +130,10 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
         type: PropType<boolean>;
         default: boolean;
     };
+    fetch: {
+        type: PropType<typeof fetch>;
+        default: undefined;
+    };
     showHistory: {
         type: PropType<boolean>;
         default: boolean;
@@ -164,6 +169,10 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
         type: PropType<boolean>;
         default: boolean;
     };
+    fetch: {
+        type: PropType<typeof fetch>;
+        default: undefined;
+    };
     showHistory: {
         type: PropType<boolean>;
         default: boolean;
@@ -187,6 +196,7 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
     showHistory: boolean;
     defaultAgent: string;
     withCredentials: boolean;
+    fetch: typeof fetch;
     autoRestoreLastSession: boolean;
     onInitError: (error: any, currentAgent: string) => void;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/ChatContext.js

@@ -32,12 +32,13 @@ export const useChat = () => {
  * @en Chat Provider Hook, used directly in setup
  */
 export const useChatProvider = (props) => {
+    const baseFetch = props.fetch || globalThis.fetch;
     const F = props.withCredentials
         ? (url, options) => {
             options.credentials = "include";
-            return fetch(url, options);
+            return baseFetch(url, options);
         }
-        : fetch;
+        : baseFetch;
     const store = createChatStore(props.defaultAgent || "", {
         apiUrl: props.apiUrl,
         defaultHeaders: props.defaultHeaders,
@@ -92,6 +93,10 @@ export const ChatProvider = defineComponent({
             type: Boolean,
             default: false,
         },
+        fetch: {
+            type: Function,
+            default: undefined,
+        },
         showHistory: {
             type: Boolean,
             default: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langgraph-js/sdk",
-  "version": "4.3.4",
+  "version": "4.3.6",
   "description": "The UI SDK for LangGraph - seamlessly integrate your AI agents with frontend interfaces",
   "main": "dist/index.js",
   "type": "module",

package/src/History.ts

@@ -78,11 +78,11 @@ export class History {
      * @zh 激活指定会话（懒加载创建 Client）
      * @en Activates the specified session (lazy load client)
      */
-    async activateSession(sessionId: string): Promise<SessionInfo> {
-        const session = this.sessions.get(sessionId);
-        if (!session) {
-            throw new Error(`Session ${sessionId} not found`);
-        }
+    async activateSession(sessionId: string, mustResetStream = false): Promise<SessionInfo> {
+        const session: SessionInfo = this.sessions.get(sessionId) || {
+            sessionId,
+            agentName: this.virtualClient.getCurrentAssistant()?.graph_id!,
+        };
 
         // 懒加载：只在激活时创建 Client
         if (!session.client) {
@@ -91,7 +91,7 @@ export class History {
 
             // 只有在有 thread 的情况下才重置（恢复已有会话）
             // 新会话的 thread 会在发送第一条消息时自动创建
-            if (session.thread) {
+            if (session.thread || mustResetStream) {
                 await client.resetThread(session.agentName, sessionId);
             }
 

package/src/LangGraphClient.ts

@@ -510,7 +510,7 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
                     additional_kwargs: {},
                 };
                 // json 校验
-                return this.callFETool(toolMessage, tool.args);
+                return this.callFETool(toolMessage, tool.args).catch((e) => console.warn(e));
             });
             console.log("batch call tools", result.length);
             // 只有当卡住流程时，才改变状态为 interrupted

package/src/react/ChatContext.ts

@@ -20,6 +20,7 @@ interface ChatProviderProps {
     apiUrl?: string;
     defaultHeaders?: Record<string, string>;
     withCredentials?: boolean;
+    fetch?: typeof fetch;
     showHistory?: boolean;
     showGraph?: boolean;
     fallbackToAvailableAssistants?: boolean;
@@ -36,6 +37,7 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     apiUrl = "http://localhost:8123",
     defaultHeaders,
     withCredentials = false,
+    fetch,
     showHistory = false,
     showGraph = false,
     fallbackToAvailableAssistants = false,
@@ -54,12 +56,13 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     }, [onInitError]);
 
     const store = useMemo(() => {
+        const baseFetch = fetch || globalThis.fetch;
         const F = withCredentials
             ? (url: string, options: RequestInit) => {
                   options.credentials = "include";
-                  return fetch(url, options);
+                  return baseFetch(url, options);
               }
-            : fetch;
+            : baseFetch;
 
         const config = {
             apiUrl,
@@ -78,7 +81,7 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
 
     const unionStore = useUnionStore(store, useStore);
 

package/src/solid/ChatContext.ts

@@ -20,6 +20,7 @@ interface ChatProviderProps {
     apiUrl?: string;
     defaultHeaders?: Record<string, string>;
     withCredentials?: boolean;
+    fetch?: typeof fetch;
     showHistory?: boolean;
     showGraph?: boolean;
     fallbackToAvailableAssistants?: boolean;
@@ -62,14 +63,15 @@ export const ChatProvider = (props: ChatProviderProps) => {
     const stableHeaders = createMemo(() => props.defaultHeaders || {});
 
     // 使用 createMemo 创建 fetch 函数
-    const F = createMemo(() =>
-        props.withCredentials
+    const F = createMemo(() => {
+        const baseFetch = props.fetch || globalThis.fetch;
+        return props.withCredentials
             ? (url: string, options: RequestInit) => {
                   options.credentials = "include";
-                  return fetch(url, options);
+                  return baseFetch(url, options);
               }
-            : fetch
-    );
+            : baseFetch;
+    });
 
     const store = createMemo(() => {
         const config = {

package/src/ui-store/createChatStore.ts

@@ -281,7 +281,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
 
     // ============ 会话激活逻辑 ============
 
-    async function activateSession(sessionId: string) {
+    async function activateSession(sessionId: string, mustResetStream = false) {
         const historyManager = history.get();
         if (!historyManager) return;
 
@@ -295,7 +295,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
             interruptData.set(null);
             isInterrupted.set(false);
 
-            const session = await historyManager.activateSession(sessionId);
+            const session = await historyManager.activateSession(sessionId, mustResetStream);
             const activeClient = session.client;
 
             if (activeClient) {
@@ -488,7 +488,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
             // 历史记录（兼容旧 API）
             addToHistory,
             createNewChat: createNewSession,
-            toHistoryChat: (thread: Thread<{ messages: Message[] }>) => activateSession(thread.thread_id),
+            toHistoryChat: (thread: Thread<{ messages: Message[] }>) => activateSession(thread.thread_id, true),
             async deleteHistoryChat(thread: Thread<{ messages: Message[] }>) {
                 const historyManager = history.get();
                 if (historyManager) {

package/src/vue/ChatContext.ts

@@ -52,6 +52,7 @@ export interface ChatProviderProps {
     apiUrl?: string;
     defaultHeaders?: Record<string, string>;
     withCredentials?: boolean;
+    fetch?: typeof fetch;
     showHistory?: boolean;
     showGraph?: boolean;
     fallbackToAvailableAssistants?: boolean;
@@ -67,12 +68,13 @@ export interface ChatProviderProps {
  * @en Chat Provider Hook, used directly in setup
  */
 export const useChatProvider = (props: ChatProviderProps) => {
+    const baseFetch = props.fetch || globalThis.fetch;
     const F = props.withCredentials
         ? (url: string, options: RequestInit) => {
               options.credentials = "include";
-              return fetch(url, options);
+              return baseFetch(url, options);
           }
-        : fetch;
+        : baseFetch;
 
     const store = createChatStore(
         props.defaultAgent || "",
@@ -137,6 +139,10 @@ export const ChatProvider = defineComponent({
             type: Boolean as PropType<boolean>,
             default: false,
         },
+        fetch: {
+            type: Function as PropType<typeof fetch>,
+            default: undefined,
+        },
         showHistory: {
             type: Boolean as PropType<boolean>,
             default: false,