@langgraph-js/sdk 3.2.0 → 3.3.0

package/dist/LangGraphClient.d.ts

@@ -169,7 +169,9 @@ export declare class LangGraphClient<TStateType = unknown> extends EventEmitter<
      * @zh 初始化 Assistant。
      * @en Initializes the Assistant.
      */
-    initAssistant(agentName?: string): Promise<void>;
+    initAssistant(agentName?: string, config?: {
+        fallbackToAvailableAssistants?: boolean;
+    }): Promise<Assistant | undefined>;
     /**
      * @zh 创建一个新的 Thread。
      * @en Creates a new Thread.

package/dist/LangGraphClient.js

@@ -46,7 +46,7 @@ export class LangGraphClient extends EventEmitter {
      * @zh 初始化 Assistant。
      * @en Initializes the Assistant.
      */
-    async initAssistant(agentName) {
+    async initAssistant(agentName, config = {}) {
         try {
             const assistants = await this.listAssistants();
             this.availableAssistants = assistants;
@@ -54,11 +54,16 @@ export class LangGraphClient extends EventEmitter {
                 if (agentName) {
                     this.currentAssistant = assistants.find((assistant) => assistant.graph_id === agentName) || null;
                     if (!this.currentAssistant) {
+                        if (config.fallbackToAvailableAssistants) {
+                            this.currentAssistant = this.availableAssistants[0];
+                            return this.currentAssistant;
+                        }
                         throw new Error("Agent not found: " + agentName);
                     }
                 }
                 else {
                     this.currentAssistant = assistants[0];
+                    return this.currentAssistant;
                 }
             }
             else {
@@ -240,7 +245,7 @@ export class LangGraphClient extends EventEmitter {
                     messages: messagesToSend,
                     fe_tools: await this.tools.toJSON(this.currentAssistant.graph_id),
                 },
-                streamMode: ["messages", "values"],
+                streamMode: ["messages", "values", "updates"],
                 streamSubgraphs: true,
                 command,
             });

package/dist/react/ChatContext.d.ts

@@ -61,6 +61,7 @@ interface ChatProviderProps {
     withCredentials?: boolean;
     showHistory?: boolean;
     showGraph?: boolean;
+    fallbackToAvailableAssistants?: boolean;
     onInitError?: (error: any, currentAgent: string) => void;
 }
 export declare const ChatProvider: React.FC<ChatProviderProps>;

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, onInitError, }) => {
+export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://localhost:8123", defaultHeaders, withCredentials = false, showHistory = false, showGraph = false, fallbackToAvailableAssistants = false, onInitError, }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
     const stableHeaders = useMemo(() => defaultHeaders || {}, [defaultHeaders]);
     // 使用 useRef 保存 onInitError 的最新引用
@@ -34,8 +34,9 @@ export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://loc
         }, {
             showHistory,
             showGraph,
+            fallbackToAvailableAssistants,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, showHistory, showGraph]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, showHistory, showGraph, fallbackToAvailableAssistants]);
     const unionStore = useUnionStore(store, useStore);
     // 使用 ref 标记是否已初始化
     const initializedRef = useRef(false);

package/dist/tool/createTool.d.ts

@@ -46,6 +46,98 @@ export declare const createJSONDefineTool: <Args extends ZodRawShape>(tool: Unio
     name: string;
     description: string;
     parameters: Args | ({
+        anyOf: import("zod-to-json-schema").JsonSchema7DateType[];
+    } & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | ({
+        type: "object" | "array";
+    } & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | ({
+        type: ("string" | "number" | "boolean" | "integer" | "null") | ("string" | "number" | "boolean" | "integer" | "null")[];
+    } & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | ({
+        anyOf: import("zod-to-json-schema").JsonSchema7Type[];
+    } & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | (import("zod-to-json-schema").JsonSchema7UndefinedType & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | (import("zod-to-json-schema").JsonSchema7AnyType & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | ({
+        anyOf: [import("zod-to-json-schema").JsonSchema7Type, import("zod-to-json-schema").JsonSchema7NullType];
+    } & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | ({
+        type: [string, "null"];
+    } & {
+        title?: string;
+        default?: any;
+        description?: string;
+        markdownDescription?: string;
+    } & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    }) | (import("zod-to-json-schema").JsonSchema7AllOfType & {
         title?: string;
         default?: any;
         description?: string;

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

@@ -28,6 +28,7 @@ export declare const getHistoryContent: (thread: Thread) => string | any[];
 export declare const createChatStore: (initClientName: string, config: Partial<LangGraphClientConfig>, context?: {
     showHistory?: boolean;
     showGraph?: boolean;
+    fallbackToAvailableAssistants?: boolean;
     onInit?: (client: LangGraphClient) => void;
 }) => {
     data: {

package/dist/ui-store/createChatStore.js

@@ -104,12 +104,12 @@ export const createChatStore = (initClientName, config, context = {}) => {
      * @en Initializes the LangGraph client.
      */
     async function initClient() {
-        var _a, _b;
+        var _a, _b, _c;
         const newClient = new LangGraphClient({
             ...config,
             client: (_a = config.client) !== null && _a !== void 0 ? _a : (await createLangGraphServerClient(config)),
         });
-        await newClient.initAssistant(currentAgent.get());
+        await newClient.initAssistant(currentAgent.get(), { fallbackToAvailableAssistants: (_b = context.fallbackToAvailableAssistants) !== null && _b !== void 0 ? _b : false });
         currentAgent.set(newClient.getCurrentAssistant().graph_id);
         // 不再需要创建，sendMessage 会自动创建
         // await newClient.createThread();
@@ -147,7 +147,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
             currentChatId.set(((_a = newClient.getCurrentThread()) === null || _a === void 0 ? void 0 : _a.thread_id) || null);
             updateUI(newClient);
         });
-        (_b = context.onInit) === null || _b === void 0 ? void 0 : _b.call(context, newClient);
+        (_c = context.onInit) === null || _c === void 0 ? void 0 : _c.call(context, newClient);
         newClient.graphState = {};
         client.set(newClient);
         if (showGraph.get())

package/dist/vue/ChatContext.d.ts

@@ -31,6 +31,7 @@ export interface ChatProviderProps {
     withCredentials?: boolean;
     showHistory?: boolean;
     showGraph?: boolean;
+    fallbackToAvailableAssistants?: boolean;
     onInitError?: (error: any, currentAgent: string) => void;
 }
 /**

package/dist/vue/ChatContext.js

@@ -48,6 +48,7 @@ export const useChatProvider = (props) => {
     }, {
         showHistory: props.showHistory,
         showGraph: props.showGraph,
+        fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
     });
     const unionStore = useUnionStoreVue(store, useStore);
     // 提供 store 给子组件

package/package.json

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

package/src/LangGraphClient.ts

@@ -137,7 +137,12 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
      * @zh 初始化 Assistant。
      * @en Initializes the Assistant.
      */
-    async initAssistant(agentName?: string) {
+    async initAssistant(
+        agentName?: string,
+        config: {
+            fallbackToAvailableAssistants?: boolean;
+        } = {}
+    ) {
         try {
             const assistants = await this.listAssistants();
             this.availableAssistants = assistants;
@@ -145,10 +150,15 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
                 if (agentName) {
                     this.currentAssistant = assistants.find((assistant: any) => assistant.graph_id === agentName) || null;
                     if (!this.currentAssistant) {
+                        if (config.fallbackToAvailableAssistants) {
+                            this.currentAssistant = this.availableAssistants[0];
+                            return this.currentAssistant;
+                        }
                         throw new Error("Agent not found: " + agentName);
                     }
                 } else {
                     this.currentAssistant = assistants[0];
+                    return this.currentAssistant;
                 }
             } else {
                 throw new Error("No assistants found");
@@ -336,7 +346,7 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
                     messages: messagesToSend,
                     fe_tools: await this.tools.toJSON(this.currentAssistant!.graph_id),
                 },
-                streamMode: ["messages", "values"],
+                streamMode: ["messages", "values", "updates"],
                 streamSubgraphs: true,
                 command,
             });

package/src/react/ChatContext.ts

@@ -21,6 +21,7 @@ interface ChatProviderProps {
     withCredentials?: boolean;
     showHistory?: boolean;
     showGraph?: boolean;
+    fallbackToAvailableAssistants?: boolean;
     onInitError?: (error: any, currentAgent: string) => void;
 }
 
@@ -32,6 +33,7 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     withCredentials = false,
     showHistory = false,
     showGraph = false,
+    fallbackToAvailableAssistants = false,
     onInitError,
 }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
@@ -64,9 +66,10 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
             {
                 showHistory,
                 showGraph,
+                fallbackToAvailableAssistants,
             }
         );
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, showHistory, showGraph]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, showHistory, showGraph, fallbackToAvailableAssistants]);
 
     const unionStore = useUnionStore(store, useStore);
 

package/src/ui-store/createChatStore.ts

@@ -71,6 +71,7 @@ export const createChatStore = (
     context: {
         showHistory?: boolean;
         showGraph?: boolean;
+        fallbackToAvailableAssistants?: boolean;
         onInit?: (client: LangGraphClient) => void;
     } = {}
 ) => {
@@ -116,7 +117,7 @@ export const createChatStore = (
             ...config,
             client: config.client ?? (await createLangGraphServerClient(config as LangGraphClientConfig)),
         });
-        await newClient.initAssistant(currentAgent.get());
+        await newClient.initAssistant(currentAgent.get(), { fallbackToAvailableAssistants: context.fallbackToAvailableAssistants ?? false });
         currentAgent.set(newClient.getCurrentAssistant()!.graph_id);
         // 不再需要创建，sendMessage 会自动创建
         // await newClient.createThread();

package/src/vue/ChatContext.ts

@@ -53,6 +53,7 @@ export interface ChatProviderProps {
     withCredentials?: boolean;
     showHistory?: boolean;
     showGraph?: boolean;
+    fallbackToAvailableAssistants?: boolean;
     onInitError?: (error: any, currentAgent: string) => void;
 }
 
@@ -81,6 +82,7 @@ export const useChatProvider = (props: ChatProviderProps) => {
         {
             showHistory: props.showHistory,
             showGraph: props.showGraph,
+            fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
         }
     );