@blade-hq/agent-react 2610.0.0-beta.45 → 2610.0.0-beta.47

package/README.md

@@ -208,6 +208,9 @@ Blade。这时把 `ChatView` 切到 `mode="llm"`，或者直接用下层的 `Llm
 <ChatView mode="llm" llm={{ baseURL: "/api/llm", model }} />   // 切成纯 LLM
 <LlmChat baseURL="/api/llm" model={model} />                   // 或者直接用（LlmChatProps）
 <AgentChat sessionId={id} />                                   // 智能体那侧同样可以直接用（AgentChatProps）
+
+`AgentChat` 还支持 `sessionPluginControls(sessionId)` 插槽，宿主可复用
+`@blade-hq/agent-client` 的会话插件状态与激活控制。
 ```
 
 **协议就是 OpenAI 的**：`POST {baseURL}/chat/completions`，`stream: true`，读

package/dist/components/AgentChat.d.ts

@@ -1,4 +1,5 @@
 import type { AgentSession, CreateSessionRequest } from "@blade-hq/agent-client";
+import { type ReactNode } from "react";
 import { type ChatPresentationProps } from "./ChatSurface";
 import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 export interface AgentChatProps extends ChatPresentationProps {
@@ -13,6 +14,8 @@ export interface AgentChatProps extends ChatPresentationProps {
     onSessionReady?: (session: AgentSession) => void;
     /** 智能体下发给宿主页面的指令处理器（action → handler）。 */
     commands?: Record<string, (data: unknown) => void>;
+    /** 会话插件状态与激活控件；由宿主注入以复用共享会话 API。 */
+    sessionPluginControls?: (sessionId: string) => ReactNode;
 }
 /**
  * 智能体模式的聊天界面：连接（或新建）一个 Blade 会话，渲染消息流与输入框。

package/dist/hooks/use-message-pin.d.ts

@@ -1,6 +1,12 @@
 export interface UseMessagePinOptions {
     targetKey: string | null;
     pinTarget: boolean;
+    /**
+     * 省略时按旧行为处理（视为一直流式中，只靠 targetKey 变化释放）——
+     * useMessagePin 是导出的公开 hook，加这个字段前如果直接改成必填，
+     * 所有已经在调用这个 hook 的外部使用方都会编译不过。
+     */
+    isStreaming?: boolean;
     layoutKey?: string;
     getScrollElement: () => HTMLElement | null;
     getContentElement?: () => HTMLElement | null;
@@ -16,7 +22,7 @@ export interface UseMessagePinOptions {
  * 用户发言顶置的共享状态机。SDK 和内置轻量列表只提供 DOM/虚拟列表适配器，
  * 触发、调度、resize、手动接管和跟随交还的决策只在这里维护。
  */
-export declare function useMessagePin({ targetKey, pinTarget, layoutKey, getScrollElement, getContentElement, getTargetElement, getTargetScrollTop, getSpacerHeight, setSpacerHeight, stopAutoScroll, scrollToBottom, margin, }: UseMessagePinOptions): {
+export declare function useMessagePin({ targetKey, pinTarget, isStreaming, layoutKey, getScrollElement, getContentElement, getTargetElement, getTargetScrollTop, getSpacerHeight, setSpacerHeight, stopAutoScroll, scrollToBottom, margin, }: UseMessagePinOptions): {
     release: () => void;
     isActive: () => boolean;
 };

package/dist/index.js

@@ -617,6 +617,7 @@ var MANUAL_SCROLL_TOLERANCE_PX = 2;
 function useMessagePin({
   targetKey,
   pinTarget,
+  isStreaming = true,
   layoutKey,
   getScrollElement,
   getContentElement,
@@ -625,6 +626,10 @@ function useMessagePin({
   getSpacerHeight,
   setSpacerHeight,
   stopAutoScroll,
+  // 不再内部调用（见下面 reposition 里的说明），但这是公开的 SDK hook 参数，
+  // 删掉会让已经传这个 prop 的调用方在 TS 严格类型下编译不过——留着接口
+  // 不动，只是这里不再用它。
+  // biome-ignore lint/correctness/noUnusedVariables: 保留公开 API 形状
   scrollToBottom,
   margin = DEFAULT_MARGIN_PX
 }) {
@@ -674,7 +679,6 @@ function useMessagePin({
       scroll.scrollTop = targetScrollTop;
       if (nextSpacerHeight === 0 && previousSpacerHeight > 0) {
         pinActiveRef.current = false;
-        scrollToBottom();
       }
     },
     [
@@ -683,7 +687,6 @@ function useMessagePin({
       getTargetElement,
       getTargetScrollTop,
       margin,
-      scrollToBottom,
       stopAutoScroll
     ]
   );
@@ -709,7 +712,7 @@ function useMessagePin({
       return;
     }
     if (!pinTarget) {
-      if (pinActiveRef.current && appliedTargetKeyRef.current != null && appliedTargetKeyRef.current !== targetKey) {
+      if (pinActiveRef.current && appliedTargetKeyRef.current != null && (appliedTargetKeyRef.current !== targetKey || !isStreaming)) {
         release();
       }
       observedTargetKeyRef.current = targetKey;
@@ -730,7 +733,7 @@ function useMessagePin({
       retryTimeoutRef.current = null;
       scheduleReposition();
     }, 80);
-  }, [pinTarget, release, scheduleReposition, stopAutoScroll, targetKey]);
+  }, [isStreaming, pinTarget, release, scheduleReposition, stopAutoScroll, targetKey]);
   useEffect3(() => {
     if (layoutKey !== void 0) scheduleReposition();
   }, [layoutKey, scheduleReposition]);
@@ -4140,9 +4143,7 @@ function MessageList({
   });
   const userMessages = visibleRootMessages.filter((message) => isUserMessage(message));
   const latestUserMessage = userMessages.at(-1);
-  const latestPromptText = latestUserMessage ? (typeof latestUserMessage.content === "string" ? latestUserMessage.content : latestUserMessage.content.filter((part) => part.type === "text").map((part) => part.text).join("")).replace(/\s+/g, " ").trim() : "";
-  const latestPromptPreview = latestPromptText.length > 80 ? `${latestPromptText.slice(0, 80)}\u2026` : latestPromptText;
-  const shouldPinLatestUser = latestUserMessage != null && (latestUserMessage.entry_id == null || latestUserMessage.entry_id.startsWith("local-user-"));
+  const shouldPinLatestUser = latestUserMessage != null && (latestUserMessage.entry_id == null ? isStreaming : latestUserMessage.entry_id.startsWith("local-user-"));
   const renderBlocks = useMemo7(() => {
     const visible = messages.filter((message) => {
       if ((message.loop_name ?? "root") !== "root") return false;
@@ -4228,16 +4229,6 @@ function MessageList({
         children: [
           /* @__PURE__ */ jsx17(StickToBottom.Content, { className: "blade-chat-messages-scroll", children: /* @__PURE__ */ jsxs15("div", { className: "blade-chat-messages-content mx-auto max-w-[748px]", children: [
             historyPaging && (historyPaging.hasOlder || historyPaging.loading) ? /* @__PURE__ */ jsx17(LoadOlderSentinel, { ...historyPaging }) : null,
-            isStreaming && latestUserMessage && latestPromptPreview ? /* @__PURE__ */ jsx17(
-              "button",
-              {
-                type: "button",
-                className: "sticky top-0 z-20 mb-4 w-full truncate rounded-2xl border border-[hsl(var(--primary)/0.2)] bg-[hsl(var(--background)/0.92)] px-4 py-3 text-left text-sm font-medium shadow-sm backdrop-blur",
-                onClick: () => Array.from(document.querySelectorAll("[data-entry-id]")).find((el) => el.dataset.entryId === latestUserMessage.entry_id)?.scrollIntoView({ behavior: "smooth", block: "start" }),
-                "aria-label": "\u8DF3\u8F6C\u5230\u5F53\u524D\u63D0\u95EE",
-                children: latestPromptPreview
-              }
-            ) : null,
             /* @__PURE__ */ jsxs15("div", { className: "flex min-w-0 flex-col", children: [
               renderBlocks.length === 0 ? emptyState ?? /* @__PURE__ */ jsxs15("div", { className: "blade-chat-empty", children: [
                 /* @__PURE__ */ jsx17(MessageSquare, { size: 40, strokeWidth: 1.5 }),
@@ -4316,6 +4307,7 @@ function MessageList({
             {
               userMessageCount: userMessages.length,
               shouldPinLatestUser,
+              isStreaming,
               targetKey: latestUserMessage?.render_id ?? latestUserMessage?.entry_id ?? (latestUserMessage ? `user:${userMessages.length}` : null)
             },
             sessionId ?? "no-session"
@@ -4400,6 +4392,7 @@ function LoadOlderSentinel({
 function PinLatestUserMessage({
   userMessageCount,
   shouldPinLatestUser,
+  isStreaming,
   targetKey
 }) {
   const { contentRef, scrollRef, scrollToBottom, stopScroll } = useStickToBottomContext();
@@ -4425,6 +4418,7 @@ function PinLatestUserMessage({
   useMessagePin({
     targetKey,
     pinTarget: shouldPinLatestUser,
+    isStreaming,
     getScrollElement,
     getContentElement,
     getTargetElement,
@@ -4682,6 +4676,7 @@ function ChatSessionView({
   placeholder,
   theme,
   onFollowupInteraction,
+  sessionPluginControls,
   onUnauthorized
 }) {
   const client = useBladeClient();
@@ -4805,6 +4800,7 @@ ${content}`);
       placeholder,
       connection: state?.connection ?? "connecting",
       banner: /* @__PURE__ */ jsxs17(Fragment4, { children: [
+        resolvedSessionId && !isViewer && sessionPluginControls?.(resolvedSessionId),
         /* @__PURE__ */ jsx19(
           ReplayBar,
           {