@langgraph-js/sdk 1.8.0 → 1.9.0

package/dist/LangGraphClient.js

@@ -384,7 +384,7 @@ export class LangGraphClient extends Client {
                     ...this.extraParams,
                     ...(extraParams || {}),
                     messages: messagesToSend,
-                    fe_tools: this.tools.toJSON(this.currentAssistant.graph_id),
+                    fe_tools: await this.tools.toJSON(this.currentAssistant.graph_id),
                 },
                 streamMode: ["messages", "values"],
                 streamSubgraphs: true,

package/dist/ToolManager.d.ts

@@ -52,7 +52,7 @@ export declare class ToolManager {
      * @zh 将所有工具转换为 JSON 定义格式。
      * @en Converts all tools to JSON definition format.
      */
-    toJSON(graphId: string, remote?: boolean): {
+    toJSON(graphId: string, remote?: boolean): Promise<{
         name: string;
         description: string;
         parameters: import("zod-to-json-schema").JsonSchema7Type & {
@@ -61,7 +61,7 @@ export declare class ToolManager {
                 [key: string]: import("zod-to-json-schema").JsonSchema7Type;
             } | undefined;
         };
-    }[];
+    }[]>;
     /**
      * @zh 标记指定 ID 的工具等待已完成，并传递结果。
      * @en Marks the tool waiting with the specified ID as completed and passes the result.

package/dist/ToolManager.js

@@ -77,7 +77,7 @@ export class ToolManager {
      * @zh 将所有工具转换为 JSON 定义格式。
      * @en Converts all tools to JSON definition format.
      */
-    toJSON(graphId, remote = true) {
+    async toJSON(graphId, remote = true) {
         return Array.from(this.tools.values())
             .filter((i) => (remote ? !i.onlyRender : true))
             .filter((i) => !i.allowGraph || i.allowGraph.includes(graphId))

package/dist/tool/createTool.d.ts

@@ -2,7 +2,7 @@ import { z, ZodRawShape, ZodTypeAny } from "zod";
 import { Action, Parameter } from "./copilotkit-actions.js";
 import { Message } from "@langchain/langgraph-sdk";
 import { ToolRenderData } from "./ToolUI.js";
-export interface UnionTool<Args extends ZodRawShape, Child extends Object = Object, D = any> {
+export interface UnionTool<Args extends ZodRawShape, Child extends Object = Object, ResponseType = any> {
     name: string;
     description: string;
     parameters: Args;
@@ -11,8 +11,8 @@ export interface UnionTool<Args extends ZodRawShape, Child extends Object = Obje
     execute?: ToolCallback<Args>;
     /** 工具执行成功后触发的附加消息 */
     callbackMessage?: (result: CallToolResult) => Message[];
-    handler?: (args: z.objectOutputType<Args, ZodTypeAny>, context?: any) => D | Promise<D>;
-    render?: (tool: ToolRenderData<z.objectOutputType<Args, ZodTypeAny>, D>) => Child;
+    handler?: (args: z.objectOutputType<Args, ZodTypeAny>, context?: any) => ResponseType | Promise<ResponseType>;
+    render?: (tool: ToolRenderData<z.objectOutputType<Args, ZodTypeAny>, ResponseType>) => Child;
     onlyRender?: boolean;
     /** 只允许指定的 agent 使用该工具，如果未指定，则所有 agent 都可以使用 */
     allowAgent?: string[];

package/dist/tool/createTool.js

@@ -9,9 +9,8 @@ export const createTool = (tool) => {
  * create Type Safe Tool with zod and UI Render Feature
  */
 export const createUITool = (tool) => {
-    return {
-        ...tool,
-        async execute(args, context) {
+    const execute = tool.execute ||
+        (async (args, context) => {
             var _a;
             try {
                 const result = await ((_a = tool.handler) === null || _a === void 0 ? void 0 : _a.call(tool, args, context));
@@ -23,7 +22,10 @@ export const createUITool = (tool) => {
             catch (error) {
                 return [{ type: "text", text: `Error: ${error}` }];
             }
-        },
+        });
+    return {
+        ...tool,
+        execute,
     };
 };
 /**

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

@@ -1,5 +1,6 @@
 import { LangGraphClient, LangGraphClientConfig, RenderMessage, SendMessageOptions } from "../LangGraphClient.js";
 import { AssistantGraph, Message, Thread } from "@langchain/langgraph-sdk";
+import { UnionTool } from "../tool/createTool.js";
 /**
  * @zh 格式化日期对象为时间字符串。
  * @en Formats a Date object into a time string.
@@ -45,8 +46,10 @@ export declare const createChatStore: (initClientName: string, config: LangGraph
         showGraph: import("nanostores").PreinitializedWritableAtom<boolean> & object;
         graphVisualize: import("nanostores").PreinitializedWritableAtom<AssistantGraph | null> & object;
         currentNodeName: import("nanostores").PreinitializedWritableAtom<string> & object;
+        tools: import("nanostores").PreinitializedWritableAtom<UnionTool<any, Object, any>[]> & object;
     };
     mutations: {
+        setTools(new_tools: UnionTool<any>[]): void;
         isFELocking(): boolean | undefined;
         initClient: () => Promise<LangGraphClient>;
         sendMessage: (message?: Message[], extraData?: SendMessageOptions) => Promise<void>;

package/dist/ui-store/createChatStore.js

@@ -75,6 +75,14 @@ export const createChatStore = (initClientName, config, context = {}) => {
     const currentAgent = atom(initClientName);
     const currentChatId = atom(null);
     const currentNodeName = atom("__start__");
+    const tools = atom([]);
+    const refreshTools = async () => {
+        const c = client.get();
+        if (!c)
+            return;
+        c.tools.clearTools();
+        c.tools.bindTools(tools.get());
+    };
     // 显示 langgraph 可视化图
     const showGraph = atom((_b = context.showGraph) !== null && _b !== void 0 ? _b : false);
     const graphVisualize = atom(null);
@@ -213,8 +221,13 @@ export const createChatStore = (initClientName, config, context = {}) => {
             showGraph,
             graphVisualize,
             currentNodeName,
+            tools,
         },
         mutations: {
+            setTools(new_tools) {
+                tools.set(new_tools);
+                refreshTools();
+            },
             isFELocking() {
                 var _a;
                 return (_a = client.get()) === null || _a === void 0 ? void 0 : _a.isFELocking(renderMessages.get());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langgraph-js/sdk",
-  "version": "1.8.0",
+  "version": "1.9.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

@@ -465,7 +465,7 @@ export class LangGraphClient extends Client {
                     ...this.extraParams,
                     ...(extraParams || {}),
                     messages: messagesToSend,
-                    fe_tools: this.tools.toJSON(this.currentAssistant.graph_id),
+                    fe_tools: await this.tools.toJSON(this.currentAssistant.graph_id),
                 },
                 streamMode: ["messages", "values"],
                 streamSubgraphs: true,

package/src/ToolManager.ts

@@ -10,7 +10,6 @@ export class ToolManager {
     private tools: Map<string, UnionTool<any>> = new Map();
     // === 专门为前端设计的异步触发结构
     private waitingMap: Map<string, (value: CallToolResult) => void> = new Map();
-
     /**
      * @zh 注册一个工具。
      * @en Registers a tool.
@@ -85,7 +84,7 @@ export class ToolManager {
      * @zh 将所有工具转换为 JSON 定义格式。
      * @en Converts all tools to JSON definition format.
      */
-    toJSON(graphId: string, remote = true) {
+    async toJSON(graphId: string, remote = true) {
         return Array.from(this.tools.values())
             .filter((i) => (remote ? !i.onlyRender : true))
             .filter((i) => !i.allowGraph || i.allowGraph.includes(graphId))

package/src/tool/createTool.ts

@@ -5,7 +5,7 @@ import { zodToJsonSchema } from "zod-to-json-schema";
 import { Message } from "@langchain/langgraph-sdk";
 import { ToolRenderData } from "./ToolUI.js";
 
-export interface UnionTool<Args extends ZodRawShape, Child extends Object = Object, D = any> {
+export interface UnionTool<Args extends ZodRawShape, Child extends Object = Object, ResponseType = any> {
     name: string;
     description: string;
     parameters: Args;
@@ -14,8 +14,8 @@ export interface UnionTool<Args extends ZodRawShape, Child extends Object = Obje
     execute?: ToolCallback<Args>;
     /** 工具执行成功后触发的附加消息 */
     callbackMessage?: (result: CallToolResult) => Message[];
-    handler?: (args: z.objectOutputType<Args, ZodTypeAny>, context?: any) => D | Promise<D>;
-    render?: (tool: ToolRenderData<z.objectOutputType<Args, ZodTypeAny>, D>) => Child;
+    handler?: (args: z.objectOutputType<Args, ZodTypeAny>, context?: any) => ResponseType | Promise<ResponseType>;
+    render?: (tool: ToolRenderData<z.objectOutputType<Args, ZodTypeAny>, ResponseType>) => Child;
     onlyRender?: boolean;
     /** 只允许指定的 agent 使用该工具，如果未指定，则所有 agent 都可以使用 */
     allowAgent?: string[];
@@ -35,9 +35,9 @@ export const createTool = <Args extends ZodRawShape>(tool: UnionTool<Args>) => {
  * create Type Safe Tool with zod and UI Render Feature
  */
 export const createUITool = <Args extends ZodRawShape, Child extends Object = {}>(tool: UnionTool<Args, Child>): UnionTool<Args, Child> => {
-    return {
-        ...tool,
-        async execute(args, context) {
+    const execute =
+        tool.execute ||
+        (async (args, context) => {
             try {
                 const result = await tool.handler?.(args, context);
                 if (typeof result === "string") {
@@ -47,7 +47,10 @@ export const createUITool = <Args extends ZodRawShape, Child extends Object = {}
             } catch (error) {
                 return [{ type: "text", text: `Error: ${error}` }];
             }
-        },
+        });
+    return {
+        ...tool,
+        execute,
     };
 };
 

package/src/ui-store/createChatStore.ts

@@ -3,6 +3,7 @@ import { LangGraphClient, LangGraphClientConfig, RenderMessage, SendMessageOptio
 import { AssistantGraph, Message, Thread } from "@langchain/langgraph-sdk";
 import { rafDebounce } from "./rafDebounce.js";
 import { ToolRenderData } from "../tool/ToolUI.js";
+import { UnionTool } from "../tool/createTool.js";
 
 /**
  * @zh 格式化日期对象为时间字符串。
@@ -82,6 +83,14 @@ export const createChatStore = (
     const currentChatId = atom<string | null>(null);
     const currentNodeName = atom<string>("__start__");
 
+    const tools = atom<UnionTool<any>[]>([]);
+    const refreshTools = async () => {
+        const c = client.get();
+        if (!c) return;
+        c.tools.clearTools();
+        c.tools.bindTools(tools.get());
+    };
+
     // 显示 langgraph 可视化图
     const showGraph = atom<boolean>(context.showGraph ?? false);
     const graphVisualize = atom<AssistantGraph | null>(null);
@@ -221,8 +230,13 @@ export const createChatStore = (
             showGraph,
             graphVisualize,
             currentNodeName,
+            tools,
         },
         mutations: {
+            setTools(new_tools: UnionTool<any>[]) {
+                tools.set(new_tools);
+                refreshTools();
+            },
             isFELocking() {
                 return client.get()?.isFELocking(renderMessages.get());
             },