@vegintech/langchain-react-agent 0.0.24 → 0.0.25

package/dist/index.d.mts

@@ -2,10 +2,28 @@ 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 { UseStreamOptions, useStream } from "@langchain/langgraph-sdk/react";
 import { BaseNode, InsertPosition, NodeRender, SenderProps, SkillType, SlotConfigType } from "@ant-design/x/es/sender/interface.ts";
 import { Message } from "@langchain/langgraph-sdk";
 
+//#region src/hooks/useAgentStream.d.ts
+type AgentStreamOptions = UseStreamOptions;
+type AgentStream = ReturnType<typeof useStream>;
+/**
+ * 包装 useStream hook，为 AgentChat 提供统一的 stream 实例创建方式
+ *
+ * @example
+ * ```tsx
+ * const stream = useAgentStream({
+ *   apiUrl: "http://localhost:2026",
+ *   assistantId: "demo",
+ * });
+ *
+ * <AgentChat stream={stream} />
+ * ```
+ */
+declare function useAgentStream(options: AgentStreamOptions): AgentStream;
+//#endregion
 //#region src/types.d.ts
 /** ToolCard 组件 Props */
 interface ToolCardProps extends Omit<ThoughtChainItemProps, "children"> {
@@ -220,22 +238,19 @@ interface InputConfig extends SenderCustomizationProps {
   placeholder?: string;
 }
 interface AgentChatProps {
-  apiUrl?: string;
-  assistantId: string;
-  threadId?: string;
-  headers?: Record<string, string | undefined | null>;
-  onThreadIdChange?: (threadId: string) => void;
+  /**
+   * Stream 实例
+   * 由外部通过 useAgentStream hook 创建并传入
+   */
+  stream: AgentStream;
   className?: string;
   tools?: ToolDefinition<any>[];
   contexts?: ContextItem[];
   messageConfig?: MessageConfig;
   inputConfig?: InputConfig;
-  onError?: (error: Error) => void;
   interruptConfig?: InterruptConfig;
   /** Agent 状态值 */
   agentState?: Record<string, unknown>;
-  /** Agent 状态变化回调 */
-  onAgentStateChange?: (state: Record<string, unknown>) => void;
   /** 是否显示调试面板，默认 false。仅在开发环境生效 */
   showDebug?: boolean;
   /** 欢迎组件，当消息列表为空且非加载状态时显示 */
@@ -251,19 +266,6 @@ interface AgentChatRef {
   clearInput: () => void;
   /** 聚焦输入框 */
   focusInput: () => void;
-  /**
-   * 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 {
@@ -309,4 +311,4 @@ interface MessageContentRendererProps {
 /** 消息内容渲染组件 - 支持字符串和多模态内容块 */
 declare const MessageContentRenderer: React$1.FC<MessageContentRendererProps>;
 //#endregion
-export { AgentChat, type AgentChatInputRef, type AgentChatProps, type AgentChatRef, type BackendTool, type ChatMessage, type ContextItem, type EmptyStateConfig, type FrontendTool, type InputConfig, type InterruptConfig, type InterruptEvent, type InterruptManagerProps, type InterruptRenderProps, type MessageConfig, type MessageContent, type MessageContentBlock, MessageContentRenderer, type MessageContentRendererProps, type MessageType, type SenderCustomizationProps, type SenderSlotConfig, type SenderSubmitParams, type ToolCallInput, ToolCard, type ToolCardProps, type ToolDefinition, type ToolExecutionRecord, type ToolExecutionStatus, type ToolParameterSchema, type ToolRenderProps };
+export { AgentChat, type AgentChatInputRef, type AgentChatProps, type AgentChatRef, type AgentStream, type AgentStreamOptions, type BackendTool, type ChatMessage, type ContextItem, type EmptyStateConfig, type FrontendTool, type InputConfig, type InterruptConfig, type InterruptEvent, type InterruptManagerProps, type InterruptRenderProps, type MessageConfig, type MessageContent, type MessageContentBlock, MessageContentRenderer, type MessageContentRendererProps, type MessageType, type SenderCustomizationProps, type SenderSlotConfig, type SenderSubmitParams, type ToolCallInput, ToolCard, type ToolCardProps, type ToolDefinition, type ToolExecutionRecord, type ToolExecutionStatus, type ToolParameterSchema, type ToolRenderProps, useAgentStream };

package/dist/index.mjs

@@ -1349,33 +1349,15 @@ function injectStyles() {
 //#endregion
 //#region src/components/AgentChat.tsx
 injectStyles();
-const AgentChat = forwardRef(({ apiUrl, assistantId, headers, threadId, onThreadIdChange, className = "", tools, contexts, messageConfig, inputConfig, onError, interruptConfig, agentState, onAgentStateChange, showDebug, welcome }, ref) => {
+const AgentChat = forwardRef(({ stream, className = "", tools, contexts, messageConfig, inputConfig, interruptConfig, agentState, showDebug, welcome }, ref) => {
 	const { onPreSend, ...chatInputConfig } = inputConfig || {};
 	const chatInputRef = useRef(null);
-	const stream = useStream({
-		apiUrl,
-		assistantId,
-		threadId,
-		onThreadId: (newThreadId) => {
-			onThreadIdChange?.(newThreadId);
-		},
-		defaultHeaders: headers,
-		messagesKey: "messages",
-		onError: (error) => {
-			const err = error instanceof Error ? error : new Error(String(error));
-			onError?.(err);
-		}
-	});
 	useImperativeHandle(ref, () => ({
 		input: chatInputRef.current,
 		setSkill: (skill) => chatInputRef.current?.setSkill?.(skill),
 		clearInput: () => chatInputRef.current?.clear?.(),
-		focusInput: () => chatInputRef.current?.focus?.(),
-		stream
+		focusInput: () => chatInputRef.current?.focus?.()
 	}));
-	useEffect(() => {
-		if (stream.values && onAgentStateChange) onAgentStateChange(stream.values);
-	}, [stream.values, onAgentStateChange]);
 	const { renderInterrupt: interruptRender } = useInterrupt({
 		interrupt: stream.interrupt,
 		config: interruptConfig,
@@ -1520,4 +1502,22 @@ const ToolCard = ({ children, style, ...rest }) => {
 	}), children] });
 };
 //#endregion
-export { AgentChat, MessageContentRenderer, ToolCard };
+//#region src/hooks/useAgentStream.ts
+/**
+* 包装 useStream hook，为 AgentChat 提供统一的 stream 实例创建方式
+*
+* @example
+* ```tsx
+* const stream = useAgentStream({
+*   apiUrl: "http://localhost:2026",
+*   assistantId: "demo",
+* });
+*
+* <AgentChat stream={stream} />
+* ```
+*/
+function useAgentStream(options) {
+	return useStream(options);
+}
+//#endregion
+export { AgentChat, MessageContentRenderer, ToolCard, useAgentStream };

package/package.json

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