@vegintech/langchain-react-agent 0.0.20 → 0.0.22

package/dist/index.d.mts

@@ -2,8 +2,9 @@ import * as react from "react";
 import React$1, { ReactNode } from "react";
 import { ThoughtChainItemProps } from "@ant-design/x";
 import { Components } from "streamdown";
+import * as _langchain_langgraph_sdk_react0 from "@langchain/langgraph-sdk/react";
 import { BaseNode, InsertPosition, NodeRender, SenderProps, SkillType, SlotConfigType } from "@ant-design/x/es/sender/interface.ts";
-import { Message, Thread } from "@langchain/langgraph-sdk";
+import { Message } from "@langchain/langgraph-sdk";
 
 //#region src/types.d.ts
 /** ToolCard 组件 Props */
@@ -165,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>;
@@ -246,7 +251,19 @@ interface AgentChatRef {
   clearInput: () => void;
   /** 聚焦输入框 */
   focusInput: () => void;
-  createThread: () => Promise<Thread>;
+  /**
+   * LangGraph Stream 实例
+   * 提供对底层流式连接的完整访问，包括：
+   * - messages: 当前消息列表
+   * - values: Agent 状态值
+   * - isLoading: 是否正在加载
+   * - submit: 提交消息
+   * - stop: 停止流
+   * - interrupt: 中断事件
+   * - client: LangGraph 客户端（可通过 client.threads.create() 创建新线程）
+   * 等完整功能
+   */
+  stream: ReturnType<typeof _langchain_langgraph_sdk_react0.useStream> | null;
 }
 /** Streamdown 安全过滤配置 */
 interface StreamdownSecurityConfig {

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]);
 	/**
 	* 检查批次是否完成并提交结果
 	*/
@@ -1377,9 +1378,9 @@ const AgentChat = forwardRef(({ apiUrl, assistantId, headers, threadId, onThread
 	useImperativeHandle(ref, () => ({
 		input: chatInputRef.current,
 		setSkill: (skill) => chatInputRef.current?.setSkill?.(skill),
-		createThread: () => stream.client.threads.create(),
 		clearInput: () => chatInputRef.current?.clear?.(),
-		focusInput: () => chatInputRef.current?.focus?.()
+		focusInput: () => chatInputRef.current?.focus?.(),
+		stream
 	}));
 	useEffect(() => {
 		if (stream.values && onAgentStateChange) onAgentStateChange(stream.values);

package/package.json

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