@langgraph-js/sdk 1.6.2 → 1.6.3

package/dist/tool/ToolUI.d.ts

@@ -8,5 +8,7 @@ export declare class ToolRenderData<D> {
     get input(): any;
     get output(): string;
     getJSONOutput(): any;
+    /** 如果解析失败，则返回 null */
+    getJSONOutputSafe(): any;
     response(data: D): void;
 }

package/dist/tool/ToolUI.js

@@ -25,6 +25,15 @@ export class ToolRenderData {
     getJSONOutput() {
         return JSON.parse(this.output);
     }
+    /** 如果解析失败，则返回 null */
+    getJSONOutputSafe() {
+        try {
+            return JSON.parse(this.output);
+        }
+        catch (e) {
+            return null;
+        }
+    }
     response(data) {
         this.client.doneFEToolWaiting(this.message.id, JSON.stringify(data));
     }

package/dist/tool/createTool.d.ts

@@ -13,6 +13,8 @@ export interface UnionTool<Args extends ZodRawShape, Child extends Object = Obje
     callbackMessage?: (result: CallToolResult) => Message[];
     render?: <D>(tool: ToolRenderData<D>) => Child;
     onlyRender?: boolean;
+    /** 只允许指定的 agent 使用该工具，如果未指定，则所有 agent 都可以使用 */
+    allowAgent?: string[];
 }
 export type ToolCallback<Args extends ZodRawShape> = (args: z.objectOutputType<Args, ZodTypeAny>, context?: any) => CallToolResult | Promise<CallToolResult>;
 export type CallToolResult = string | {
@@ -24,7 +26,9 @@ export declare const createTool: <Args extends ZodRawShape>(tool: UnionTool<Args
 /** 提供一种兼容 copilotkit 的定义方式，简化定义形式
  * 来自 copilotkit 的 frontend action
  */
-export declare const createFETool: <const T extends Parameter[], Args extends ZodRawShape>(tool: Action<T>) => UnionTool<Args>;
+export declare const createFETool: <const T extends Parameter[], Args extends ZodRawShape>(tool: Action<T> & {
+    allowAgent?: string[];
+}) => UnionTool<Args>;
 export declare const createJSONDefineTool: <Args extends ZodRawShape>(tool: UnionTool<Args>) => {
     name: string;
     description: string;
@@ -49,6 +53,7 @@ export declare const createMCPTool: <Args extends ZodRawShape>(tool: UnionTool<A
     isError: boolean;
 }>))[];
 export declare const createToolUI: <Args extends Parameter[] | [] = [], Child extends Object = {}>(tool: Action<Args> & {
+    allowAgent?: string[];
     render?: (tool: ToolRenderData<any>) => Child;
     onlyRender?: boolean;
 }) => {
@@ -62,4 +67,6 @@ export declare const createToolUI: <Args extends Parameter[] | [] = [], Child ex
     execute: ToolCallback<z.ZodRawShape>;
     /** 工具执行成功后触发的附加消息 */
     callbackMessage?: (result: CallToolResult) => Message[];
+    /** 只允许指定的 agent 使用该工具，如果未指定，则所有 agent 都可以使用 */
+    allowAgent?: string[];
 };

package/dist/tool/createTool.js

@@ -15,6 +15,7 @@ export const createFETool = (tool) => {
         parameters: convertJsonSchemaToZodRawShape(actionParametersToJsonSchema(tool.parameters || [])),
         returnDirect: tool.returnDirect,
         callbackMessage: tool.callbackMessage,
+        allowAgent: tool.allowAgent,
         async execute(args, context) {
             var _a;
             try {

package/package.json

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

package/src/tool/ToolUI.ts

@@ -27,6 +27,14 @@ export class ToolRenderData<D> {
     getJSONOutput() {
         return JSON.parse(this.output);
     }
+    /** 如果解析失败，则返回 null */
+    getJSONOutputSafe() {
+        try {
+            return JSON.parse(this.output);
+        } catch (e) {
+            return null;
+        }
+    }
     response(data: D) {
         this.client.doneFEToolWaiting(this.message.id!, JSON.stringify(data));
     }

package/src/tool/createTool.ts

@@ -16,6 +16,8 @@ export interface UnionTool<Args extends ZodRawShape, Child extends Object = Obje
     callbackMessage?: (result: CallToolResult) => Message[];
     render?: <D>(tool: ToolRenderData<D>) => Child;
     onlyRender?: boolean;
+    /** 只允许指定的 agent 使用该工具，如果未指定，则所有 agent 都可以使用 */
+    allowAgent?: string[];
 }
 export type ToolCallback<Args extends ZodRawShape> = (args: z.objectOutputType<Args, ZodTypeAny>, context?: any) => CallToolResult | Promise<CallToolResult>;
 
@@ -29,13 +31,18 @@ export const createTool = <Args extends ZodRawShape>(tool: UnionTool<Args>) => {
 /** 提供一种兼容 copilotkit 的定义方式，简化定义形式
  * 来自 copilotkit 的 frontend action
  */
-export const createFETool = <const T extends Parameter[], Args extends ZodRawShape>(tool: Action<T>): UnionTool<Args> => {
+export const createFETool = <const T extends Parameter[], Args extends ZodRawShape>(
+    tool: Action<T> & {
+        allowAgent?: string[];
+    }
+): UnionTool<Args> => {
     return {
         name: tool.name,
         description: tool.description || "",
         parameters: convertJsonSchemaToZodRawShape(actionParametersToJsonSchema(tool.parameters || [])) as any,
         returnDirect: tool.returnDirect,
         callbackMessage: tool.callbackMessage,
+        allowAgent: tool.allowAgent,
         async execute(args, context) {
             try {
                 const result = await tool.handler?.(args, context);
@@ -80,7 +87,13 @@ export const createMCPTool = <Args extends ZodRawShape>(tool: UnionTool<Args>) =
     ];
 };
 
-export const createToolUI = <Args extends Parameter[] | [] = [], Child extends Object = {}>(tool: Action<Args> & { render?: (tool: ToolRenderData<any>) => Child; onlyRender?: boolean }) => {
+export const createToolUI = <Args extends Parameter[] | [] = [], Child extends Object = {}>(
+    tool: Action<Args> & {
+        allowAgent?: string[];
+        render?: (tool: ToolRenderData<any>) => Child;
+        onlyRender?: boolean;
+    }
+) => {
     return {
         ...createFETool(tool),
         render: tool.render,