@langgraph-js/sdk 2.0.0 → 2.0.1

package/dist/LangGraphClient.d.ts

@@ -68,7 +68,7 @@ export interface LangGraphClientConfig {
     timeoutMs?: number;
     defaultHeaders?: Record<string, string | null | undefined>;
     /** 自定义客户端实现，如果不提供则使用官方 Client */
-    client: ILangGraphClient;
+    client: ILangGraphClient<any, any>;
 }
 export interface LangGraphEvents {
     /** 流开始事件 */
@@ -113,6 +113,11 @@ export declare class LangGraphClient<TStateType = unknown, TUpdateType = TStateT
     private currentAssistant;
     private currentThread;
     tools: ToolManager;
+    availableAssistants: Assistant[];
+    graphState: any;
+    currentRun?: {
+        run_id: string;
+    };
     stopController: AbortController | null;
     /** 用于存储 subAgent 状态数据的键 */
     subAgentsKey: string;
@@ -135,7 +140,7 @@ export declare class LangGraphClient<TStateType = unknown, TUpdateType = TStateT
     };
     /** 代理 threads 属性到内部 client */
     get threads(): {
-        create<ValuesType = TStateType>(payload?: {
+        create(payload?: {
             metadata?: import("@langchain/langgraph-sdk").Metadata;
             threadId?: string;
             ifExists?: import("@langchain/langgraph-sdk").OnConflictBehavior;
@@ -143,20 +148,22 @@ export declare class LangGraphClient<TStateType = unknown, TUpdateType = TStateT
             supersteps?: Array<{
                 updates: Array<{
                     values: unknown;
-                    command?: Command;
+                    command? /** 值更新事件 */: Command;
                     asNode: string;
                 }>;
             }>;
-        }): Promise<Thread<ValuesType>>;
-        search<ValuesType = TStateType>(query?: {
-            metadata?: import("@langchain/langgraph-sdk").Metadata;
+        }): Promise<Thread<TStateType>>;
+        search(query?: {
+            metadata
+            /** Thread 创建事件 */
+            ? /** Thread 创建事件 */: import("@langchain/langgraph-sdk").Metadata;
             limit?: number;
             offset?: number;
             status?: import("@langchain/langgraph-sdk").ThreadStatus;
             sortBy?: import("./types.js").ThreadSortBy;
             sortOrder?: import("./types.js").SortOrder;
-        }): Promise<Thread<ValuesType>[]>;
-        get<ValuesType = TStateType>(threadId: string): Promise<Thread<ValuesType>>;
+        }): Promise<Thread<TStateType>[]>;
+        get(threadId: string): Promise<Thread<TStateType>>;
         delete(threadId: string): Promise<void>;
     };
     /** 代理 runs 属性到内部 client */
@@ -166,31 +173,7 @@ export declare class LangGraphClient<TStateType = unknown, TUpdateType = TStateT
             offset?: number;
             status?: import("./types.js").RunStatus;
         }): Promise<import("@langchain/langgraph-sdk").Run[]>;
-        stream<TStreamMode extends import("@langchain/langgraph-sdk").StreamMode | import("@langchain/langgraph-sdk").StreamMode[] = import("@langchain/langgraph-sdk").StreamMode, TSubgraphs extends boolean = false>(threadId: null, assistantId: string, payload?: {
-            input?: Record<string, unknown> | null;
-            metadata?: import("@langchain/langgraph-sdk").Metadata;
-            config?: import("@langchain/langgraph-sdk").Config;
-            checkpointId?: string;
-            checkpoint?: Omit<import("@langchain/langgraph-sdk").Checkpoint, "thread_id">;
-            checkpointDuring?: boolean;
-            interruptBefore?: "*" | string[];
-            interruptAfter?: "*" | string[];
-            signal?: AbortController["signal"];
-            webhook?: string;
-            onDisconnect?: import("./types.js").DisconnectMode;
-            afterSeconds?: number;
-            ifNotExists?: "create" | "reject";
-            command?: Command;
-            onRunCreated?: (params: {
-                run_id: string;
-                thread_id?: string;
-            }) => void;
-            streamMode?: TStreamMode | undefined;
-            streamSubgraphs?: TSubgraphs | undefined;
-            streamResumable?: boolean;
-            feedbackKeys?: string[];
-        } | undefined): import("./types.js").TypedAsyncGenerator<TStreamMode, TSubgraphs, TStateType, TUpdateType, unknown>;
-        stream<TStreamMode extends import("@langchain/langgraph-sdk").StreamMode | import("@langchain/langgraph-sdk").StreamMode[] = import("@langchain/langgraph-sdk").StreamMode, TSubgraphs extends boolean = false>(threadId: string, assistantId: string, payload?: {
+        stream<TSubgraphs extends boolean = false>(threadId: string, assistantId: string, payload?: {
             input?: Record<string, unknown> | null;
             metadata?: import("@langchain/langgraph-sdk").Metadata;
             config?: import("@langchain/langgraph-sdk").Config;
@@ -211,12 +194,12 @@ export declare class LangGraphClient<TStateType = unknown, TUpdateType = TStateT
                 run_id: string;
                 thread_id?: string;
             }) => void;
-            streamMode?: TStreamMode | undefined;
+            streamMode?: import("@langchain/langgraph-sdk").StreamMode[];
             streamSubgraphs?: TSubgraphs | undefined;
             streamResumable?: boolean;
             feedbackKeys?: string[];
-        } | undefined): import("./types.js").TypedAsyncGenerator<TStreamMode, TSubgraphs, TStateType, TUpdateType, unknown>;
-        joinStream(threadId: string | undefined | null, runId: string, options?: {
+        } | undefined): import("./types.js").TypedAsyncGenerator<TSubgraphs, TStateType, TUpdateType>;
+        joinStream(threadId: string, runId: string, options?: {
             signal?: AbortSignal;
             cancelOnDisconnect?: boolean;
             lastEventId?: string;
@@ -228,7 +211,6 @@ export declare class LangGraphClient<TStateType = unknown, TUpdateType = TStateT
         }>;
         cancel(threadId: string, runId: string, wait?: boolean, action?: import("./types.js").CancelAction): Promise<void>;
     };
-    availableAssistants: Assistant[];
     private listAssistants;
     /**
      * @zh 初始化 Assistant。
@@ -272,10 +254,6 @@ export declare class LangGraphClient<TStateType = unknown, TUpdateType = TStateT
     };
     /** 前端工具人机交互时，锁住面板 */
     isFELocking(messages: RenderMessage[]): boolean | undefined;
-    graphState: any;
-    currentRun?: {
-        run_id: string;
-    };
     /**
      * @zh 取消当前的 Run。
      * @en Cancels the current Run.

package/dist/LangGraphClient.js

@@ -11,11 +11,11 @@ export class LangGraphClient extends EventEmitter {
         this.currentAssistant = null;
         this.currentThread = null;
         this.tools = new ToolManager();
+        this.availableAssistants = [];
+        this.graphState = {};
         this.stopController = null;
         /** 用于存储 subAgent 状态数据的键 */
         this.subAgentsKey = "task_store";
-        this.availableAssistants = [];
-        this.graphState = {};
         /** 当前子图位置，但是依赖 stream，不太适合稳定使用*/
         this.graphPosition = "";
         this.extraParams = {};

package/dist/client/LanggraphServer.d.ts

@@ -1,2 +1,3 @@
+import { LangGraphClientConfig } from "../LangGraphClient.js";
 import { ILangGraphClient } from "../types.js";
-export declare const createLangGraphServerClient: () => Promise<ILangGraphClient>;
+export declare const createLangGraphServerClient: (config: LangGraphClientConfig) => Promise<ILangGraphClient>;

package/dist/client/LanggraphServer.js

@@ -1,4 +1,4 @@
-export const createLangGraphServerClient = async () => {
+export const createLangGraphServerClient = async (config) => {
     const { Client } = await import("@langchain/langgraph-sdk");
-    return new Client();
+    return new Client(config);
 };

package/dist/types.d.ts

@@ -8,7 +8,7 @@ export type MultitaskStrategy = "reject" | "interrupt" | "rollback" | "enqueue";
 export type DisconnectMode = "cancel" | "continue";
 export type OnCompletionBehavior = "complete" | "continue";
 export type CancelAction = "interrupt" | "rollback";
-export type TypedAsyncGenerator<TStreamMode extends StreamMode | StreamMode[] = [], TSubgraphs extends boolean = false, TStateType = unknown, TUpdateType = TStateType, TCustomType = unknown> = AsyncGenerator<{
+export type TypedAsyncGenerator<TStateType = unknown, TUpdateType = TStateType, TCustomType = unknown> = AsyncGenerator<{
     values: ValuesStreamEvent<TStateType>;
     updates: UpdatesStreamEvent<TUpdateType>;
     custom: CustomStreamEvent<TCustomType>;
@@ -16,7 +16,7 @@ export type TypedAsyncGenerator<TStreamMode extends StreamMode | StreamMode[] =
     messages: MessagesStreamEvent;
     "messages-tuple": MessagesTupleStreamEvent;
     events: EventsStreamEvent;
-}[TStreamMode extends StreamMode[] ? TStreamMode[number] : TStreamMode] | ErrorStreamEvent | MetadataStreamEvent | FeedbackStreamEvent>;
+}[StreamMode] | ErrorStreamEvent | MetadataStreamEvent | FeedbackStreamEvent>;
 /**
  * 兼容 LangGraph SDK 的接口定义，方便进行无侵入式的扩展
  */
@@ -35,7 +35,7 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
         }): Promise<AssistantGraph>;
     };
     threads: {
-        create<ValuesType = TStateType>(payload?: {
+        create(payload?: {
             metadata?: Metadata;
             threadId?: string;
             ifExists?: OnConflictBehavior;
@@ -47,16 +47,16 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
                     asNode: string;
                 }>;
             }>;
-        }): Promise<Thread<ValuesType>>;
-        search<ValuesType = TStateType>(query?: {
+        }): Promise<Thread<TStateType>>;
+        search(query?: {
             metadata?: Metadata;
             limit?: number;
             offset?: number;
             status?: ThreadStatus;
             sortBy?: ThreadSortBy;
             sortOrder?: SortOrder;
-        }): Promise<Thread<ValuesType>[]>;
-        get<ValuesType = TStateType>(threadId: string): Promise<Thread<ValuesType>>;
+        }): Promise<Thread<TStateType>[]>;
+        get(threadId: string): Promise<Thread<TStateType>>;
         delete(threadId: string): Promise<void>;
     };
     runs: {
@@ -65,31 +65,7 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
             offset?: number;
             status?: RunStatus;
         }): Promise<Run[]>;
-        stream<TStreamMode extends StreamMode | StreamMode[] = StreamMode, TSubgraphs extends boolean = false>(threadId: null, assistantId: string, payload?: {
-            input?: Record<string, unknown> | null;
-            metadata?: Metadata;
-            config?: Config;
-            checkpointId?: string;
-            checkpoint?: Omit<Checkpoint, "thread_id">;
-            checkpointDuring?: boolean;
-            interruptBefore?: "*" | string[];
-            interruptAfter?: "*" | string[];
-            signal?: AbortController["signal"];
-            webhook?: string;
-            onDisconnect?: DisconnectMode;
-            afterSeconds?: number;
-            ifNotExists?: "create" | "reject";
-            command?: Command;
-            onRunCreated?: (params: {
-                run_id: string;
-                thread_id?: string;
-            }) => void;
-            streamMode?: TStreamMode;
-            streamSubgraphs?: TSubgraphs;
-            streamResumable?: boolean;
-            feedbackKeys?: string[];
-        }): TypedAsyncGenerator<TStreamMode, TSubgraphs, TStateType, TUpdateType>;
-        stream<TStreamMode extends StreamMode | StreamMode[] = StreamMode, TSubgraphs extends boolean = false>(threadId: string, assistantId: string, payload?: {
+        stream<TSubgraphs extends boolean = false>(threadId: string, assistantId: string, payload?: {
             input?: Record<string, unknown> | null;
             metadata?: Metadata;
             config?: Config;
@@ -110,12 +86,12 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
                 run_id: string;
                 thread_id?: string;
             }) => void;
-            streamMode?: TStreamMode;
+            streamMode?: StreamMode[];
             streamSubgraphs?: TSubgraphs;
             streamResumable?: boolean;
             feedbackKeys?: string[];
-        }): TypedAsyncGenerator<TStreamMode, TSubgraphs, TStateType, TUpdateType>;
-        joinStream(threadId: string | undefined | null, runId: string, options?: {
+        }): TypedAsyncGenerator<TSubgraphs, TStateType, TUpdateType>;
+        joinStream(threadId: string, runId: string, options?: {
             signal?: AbortSignal;
             cancelOnDisconnect?: boolean;
             lastEventId?: string;

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

@@ -25,7 +25,7 @@ export declare const getHistoryContent: (thread: Thread) => string | any[];
  * @zh 创建一个用于聊天界面的状态管理器 (store)。
  * @en Creates a state manager (store) for the chat interface.
  */
-export declare const createChatStore: (initClientName: string, config: LangGraphClientConfig, context?: {
+export declare const createChatStore: (initClientName: string, config: Partial<LangGraphClientConfig>, context?: {
     showHistory?: boolean;
     showGraph?: boolean;
     onInit?: (client: LangGraphClient) => void;

package/dist/ui-store/createChatStore.js

@@ -106,7 +106,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
         var _a, _b;
         const newClient = new LangGraphClient({
             ...config,
-            client: (_a = config.client) !== null && _a !== void 0 ? _a : (await createLangGraphServerClient()),
+            client: (_a = config.client) !== null && _a !== void 0 ? _a : (await createLangGraphServerClient(config)),
         });
         await newClient.initAssistant(currentAgent.get());
         currentAgent.set(newClient.getCurrentAssistant().graph_id);

package/package.json

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

package/src/LangGraphClient.ts

@@ -68,7 +68,7 @@ export interface LangGraphClientConfig {
     timeoutMs?: number;
     defaultHeaders?: Record<string, string | null | undefined>;
     /** 自定义客户端实现，如果不提供则使用官方 Client */
-    client: ILangGraphClient;
+    client: ILangGraphClient<any, any>;
 }
 
 // 定义事件数据类型
@@ -96,6 +96,9 @@ export class LangGraphClient<TStateType = unknown, TUpdateType = TStateType> ext
     private currentAssistant: Assistant | null = null;
     private currentThread: Thread<TStateType> | null = null;
     tools: ToolManager = new ToolManager();
+    availableAssistants: Assistant[] = [];
+    graphState: any = {};
+    currentRun?: { run_id: string };
     stopController: AbortController | null = null;
     /** 用于存储 subAgent 状态数据的键 */
     subAgentsKey = "task_store";
@@ -122,7 +125,6 @@ export class LangGraphClient<TStateType = unknown, TUpdateType = TStateType> ext
     get runs() {
         return this.client.runs;
     }
-    availableAssistants: Assistant[] = [];
     private listAssistants() {
         return this.assistants.search({
             metadata: null,
@@ -272,8 +274,7 @@ export class LangGraphClient<TStateType = unknown, TUpdateType = TStateType> ext
         const tool = this.tools.getTool(lastMessage?.name!);
         return tool && tool.render && lastMessage?.type === "tool" && !lastMessage?.additional_kwargs?.done;
     }
-    graphState: any = {};
-    currentRun?: { run_id: string };
+
     /**
      * @zh 取消当前的 Run。
      * @en Cancels the current Run.

package/src/client/LanggraphServer.ts

@@ -1,6 +1,7 @@
+import { LangGraphClientConfig } from "../LangGraphClient.js";
 import { ILangGraphClient } from "../types.js";
 
-export const createLangGraphServerClient = async (): Promise<ILangGraphClient> => {
+export const createLangGraphServerClient = async (config: LangGraphClientConfig): Promise<ILangGraphClient> => {
     const { Client } = await import("@langchain/langgraph-sdk");
-    return new Client() as unknown as ILangGraphClient;
+    return new Client(config) as unknown as ILangGraphClient;
 };

package/src/types.ts

@@ -34,13 +34,7 @@ export type OnCompletionBehavior = "complete" | "continue";
 export type CancelAction = "interrupt" | "rollback";
 
 // 流式异步生成器类型
-export type TypedAsyncGenerator<
-    TStreamMode extends StreamMode | StreamMode[] = [],
-    TSubgraphs extends boolean = false,
-    TStateType = unknown,
-    TUpdateType = TStateType,
-    TCustomType = unknown,
-> = AsyncGenerator<
+export type TypedAsyncGenerator<TStateType = unknown, TUpdateType = TStateType, TCustomType = unknown> = AsyncGenerator<
     | {
           values: ValuesStreamEvent<TStateType>;
           updates: UpdatesStreamEvent<TUpdateType>;
@@ -49,7 +43,7 @@ export type TypedAsyncGenerator<
           messages: MessagesStreamEvent;
           "messages-tuple": MessagesTupleStreamEvent;
           events: EventsStreamEvent;
-      }[TStreamMode extends StreamMode[] ? TStreamMode[number] : TStreamMode]
+      }[StreamMode]
     | ErrorStreamEvent
     | MetadataStreamEvent
     | FeedbackStreamEvent
@@ -64,7 +58,7 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
         getGraph(assistantId: string, options?: { xray?: boolean | number }): Promise<AssistantGraph>;
     };
     threads: {
-        create<ValuesType = TStateType>(payload?: {
+        create(payload?: {
             metadata?: Metadata;
             threadId?: string;
             ifExists?: OnConflictBehavior;
@@ -76,16 +70,9 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
                     asNode: string;
                 }>;
             }>;
-        }): Promise<Thread<ValuesType>>;
-        search<ValuesType = TStateType>(query?: {
-            metadata?: Metadata;
-            limit?: number;
-            offset?: number;
-            status?: ThreadStatus;
-            sortBy?: ThreadSortBy;
-            sortOrder?: SortOrder;
-        }): Promise<Thread<ValuesType>[]>;
-        get<ValuesType = TStateType>(threadId: string): Promise<Thread<ValuesType>>;
+        }): Promise<Thread<TStateType>>;
+        search(query?: { metadata?: Metadata; limit?: number; offset?: number; status?: ThreadStatus; sortBy?: ThreadSortBy; sortOrder?: SortOrder }): Promise<Thread<TStateType>[]>;
+        get(threadId: string): Promise<Thread<TStateType>>;
         delete(threadId: string): Promise<void>;
     };
     runs: {
@@ -97,32 +84,8 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
                 status?: RunStatus;
             }
         ): Promise<Run[]>;
-        stream<TStreamMode extends StreamMode | StreamMode[] = StreamMode, TSubgraphs extends boolean = false>(
-            threadId: null,
-            assistantId: string,
-            payload?: {
-                input?: Record<string, unknown> | null;
-                metadata?: Metadata;
-                config?: Config;
-                checkpointId?: string;
-                checkpoint?: Omit<Checkpoint, "thread_id">;
-                checkpointDuring?: boolean;
-                interruptBefore?: "*" | string[];
-                interruptAfter?: "*" | string[];
-                signal?: AbortController["signal"];
-                webhook?: string;
-                onDisconnect?: DisconnectMode;
-                afterSeconds?: number;
-                ifNotExists?: "create" | "reject";
-                command?: Command;
-                onRunCreated?: (params: { run_id: string; thread_id?: string }) => void;
-                streamMode?: TStreamMode;
-                streamSubgraphs?: TSubgraphs;
-                streamResumable?: boolean;
-                feedbackKeys?: string[];
-            }
-        ): TypedAsyncGenerator<TStreamMode, TSubgraphs, TStateType, TUpdateType>;
-        stream<TStreamMode extends StreamMode | StreamMode[] = StreamMode, TSubgraphs extends boolean = false>(
+
+        stream<TSubgraphs extends boolean = false>(
             threadId: string,
             assistantId: string,
             payload?: {
@@ -143,14 +106,14 @@ export interface ILangGraphClient<TStateType = unknown, TUpdateType = TStateType
                 ifNotExists?: "create" | "reject";
                 command?: Command;
                 onRunCreated?: (params: { run_id: string; thread_id?: string }) => void;
-                streamMode?: TStreamMode;
+                streamMode?: StreamMode[];
                 streamSubgraphs?: TSubgraphs;
                 streamResumable?: boolean;
                 feedbackKeys?: string[];
             }
-        ): TypedAsyncGenerator<TStreamMode, TSubgraphs, TStateType, TUpdateType>;
+        ): TypedAsyncGenerator<TSubgraphs, TStateType, TUpdateType>;
         joinStream(
-            threadId: string | undefined | null,
+            threadId: string,
             runId: string,
             options?:
                 | {

package/src/ui-store/createChatStore.ts

@@ -66,7 +66,7 @@ export const getHistoryContent = (thread: Thread) => {
  */
 export const createChatStore = (
     initClientName: string,
-    config: LangGraphClientConfig,
+    config: Partial<LangGraphClientConfig>,
     context: {
         showHistory?: boolean;
         showGraph?: boolean;
@@ -113,7 +113,7 @@ export const createChatStore = (
     async function initClient() {
         const newClient = new LangGraphClient({
             ...config,
-            client: config.client ?? (await createLangGraphServerClient()),
+            client: config.client ?? (await createLangGraphServerClient(config as LangGraphClientConfig)),
         });
         await newClient.initAssistant(currentAgent.get());
         currentAgent.set(newClient.getCurrentAssistant()!.graph_id);