@vegintech/langchain-react-agent 0.0.21 → 0.0.23

package/dist/index.d.mts

@@ -166,25 +166,29 @@ interface ToolRenderProps<TArgs = Record<string, unknown>> {
   status: ToolExecutionStatus;
   error?: string;
 }
-/** 工具基础属性 */
-interface ToolBase<TArgs = Record<string, unknown>> {
+/** 前端工具：需要完整的工具定义（用于前端执行） */
+interface FrontendTool<TArgs = Record<string, unknown>> {
+  /** 工具类型 */
+  type: "frontend";
+  /** 工具名称 */
   name: string;
+  /** 工具描述 */
   description: string;
+  /** 参数 JSON Schema */
   parameters: ToolParameterSchema;
+  /** 前端工具执行函数 */
+  execute: (args: TArgs) => Promise<unknown> | unknown;
   /** 渲染函数：可选，用于在消息列表中展示工具调用过程/结果 */
   render?: (props: ToolRenderProps<TArgs>) => ReactNode;
 }
-/** 前端工具：必须有 execute */
-interface FrontendTool<TArgs = Record<string, unknown>> extends ToolBase<TArgs> {
-  /** 前端工具必须有 execute */
-  type: "frontend";
-  execute: (args: TArgs) => Promise<unknown> | unknown;
-}
-/** 后端工具：不能有 execute */
-interface BackendTool<TArgs = Record<string, unknown>> extends ToolBase<TArgs> {
-  /** 后端工具由 Agent 执行 */
+/** 后端工具：仅用于展示，只需要 name 和 render */
+interface BackendTool<TArgs = Record<string, unknown>> {
+  /** 工具类型 */
   type: "backend";
-  execute?: never;
+  /** 工具名称（用于匹配后端定义的工具） */
+  name: string;
+  /** 渲染函数：用于在消息列表中展示工具调用过程/结果 */
+  render: (props: ToolRenderProps<TArgs>) => ReactNode;
 }
 /** 工具定义联合类型 */
 type ToolDefinition<TArgs = Record<string, unknown>> = FrontendTool<TArgs> | BackendTool<TArgs>;

package/dist/index.mjs

@@ -991,15 +991,16 @@ function useToolExecution({ tools, toolCalls, isLoading = false, onExecutionChan
 	const executedCallsRef = useRef(/* @__PURE__ */ new Set());
 	const executingCallsRef = useRef(/* @__PURE__ */ new Set());
 	const pendingNotifiedRef = useRef(/* @__PURE__ */ new Set());
-	const initializedRef = useRef(false);
+	const notifiedCompletedRef = useRef(/* @__PURE__ */ new Set());
 	const batchCallIdsRef = useRef(/* @__PURE__ */ new Set());
 	const batchResultsRef = useRef(/* @__PURE__ */ new Map());
 	const isProcessingRef = useRef(false);
 	const batchSubmittedRef = useRef(false);
 	useEffect(() => {
-		if (initializedRef.current || !completedToolResults || completedToolResults.size === 0) return;
-		initializedRef.current = true;
+		if (!completedToolResults || completedToolResults.size === 0) return;
 		completedToolResults.forEach((result, callId) => {
+			if (notifiedCompletedRef.current.has(callId)) return;
+			notifiedCompletedRef.current.add(callId);
 			executedCallsRef.current.add(callId);
 			const call = toolCalls.find((c) => c.id === callId);
 			if (call) onExecutionChange?.({
@@ -1010,7 +1011,7 @@ function useToolExecution({ tools, toolCalls, isLoading = false, onExecutionChan
 				result
 			});
 		});
-	}, [completedToolResults]);
+	}, [completedToolResults, toolCalls]);
 	/**
 	* 检查批次是否完成并提交结果
 	*/
@@ -1408,12 +1409,15 @@ const AgentChat = forwardRef(({ apiUrl, assistantId, headers, threadId, onThread
 			return next;
 		});
 	}, []);
+	const frontendTools = useMemo(() => {
+		return tools?.filter(isFrontendTool) || [];
+	}, [tools]);
 	const submitToStream = useCallback(async (submitMessages) => {
 		await stream.submit({
 			...agentState,
 			messages: submitMessages,
 			agentkit: {
-				actions: tools,
+				actions: frontendTools,
 				context: contexts
 			}
 		}, {
@@ -1430,7 +1434,7 @@ const AgentChat = forwardRef(({ apiUrl, assistantId, headers, threadId, onThread
 		});
 	}, [
 		stream,
-		tools,
+		frontendTools,
 		contexts,
 		agentState
 	]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vegintech/langchain-react-agent",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "LangChain Agent UI component library for React",
   "license": "MIT",
   "files": [