@blade-hq/agent-react 2610.0.0-beta.48 → 2610.0.0-beta.49

package/README.md

@@ -389,3 +389,7 @@ blade-chat { --primary: 262 83% 58%; height: 640px; }
 本包自有声明：`BladeProvider`、`BladeProviderProps`、`useBladeClient`、`useAgentSession`、`UseAgentSessionOptions`、`UseAgentSessionResult`、`useMessagePin`、`UseMessagePinOptions`、`useReplay`、`UseReplayResult`、`ReplayMismatch`、`ReplayBar`、`ReplayBarProps`、`ReplayMismatchPrompt`、`ReplayMismatchPromptProps`、`ChatView`、`ChatViewProps`、`ChatViewClassNames`、`ChatViewRenderers`、`ChatViewSlots`、`FollowupInteractionEvent`、`ToolCallRenderer`、`CurrentPlanPanel`、`PlanUpdateBlock`、`PlanUpdateData`、`PlanUpdateDisplayState`、`PlanStepStatus`、`getPlanUpdateDisplayState`、`isPlanUpdateTool`、`parsePlanUpdate`、`pickCurrentPlanStep`、`PLAN_AUTO_COLLAPSE_MS`、`MarkdownContent`、`MarkdownContentProps`、`parseWhatIfPrompt`、`ParsedWhatIfPrompt`、`WhatIfQuote`、`WhatIfUserBubble`、`WhatIfUserBubbleProps`。
 
 `PollingBackoff` 从 agent-client 重导出，供自定义只读轮询计算退避时间；它不发送或重放请求。用法见 [agent-client 轮询说明](../agent-client/README.md#只读轮询退避)。
+
+### 会话插件
+
+默认 `AgentChat` / 智能体模式 `ChatView` 自带会话插件选择器，展开时查询 BH，选择按当前会话保存。准备失败会保留勾选并提供重试。独立嵌入可使用 `<SessionPluginSelector client={client} sessionId={id} />`；`sessionPluginControls` 可覆盖默认控件。组件参数类型为 `SessionPluginSelectorProps`。

package/dist/components/AgentChat.d.ts

@@ -14,7 +14,7 @@ export interface AgentChatProps extends ChatPresentationProps {
     onSessionReady?: (session: AgentSession) => void;
     /** 智能体下发给宿主页面的指令处理器（action → handler）。 */
     commands?: Record<string, (data: unknown) => void>;
-    /** 会话插件状态与激活控件；由宿主注入以复用共享会话 API。 */
+    /** 覆盖默认会话插件选择器。 */
     sessionPluginControls?: (sessionId: string) => ReactNode;
 }
 /**

package/dist/components/SessionPluginSelector.d.ts

@@ -0,0 +1,10 @@
+import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client";
+export interface SessionPluginSelectorProps {
+    client: BladeClient;
+    sessionId: string;
+    className?: string;
+    side?: "top" | "bottom";
+    onChange?: (plugin: SessionPluginActivation) => void;
+}
+/** Shared selector for AgentChat and the built-in Web; no external query provider required. */
+export declare function SessionPluginSelector(props: SessionPluginSelectorProps): import("react/jsx-runtime").JSX.Element;

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export type { UseMessagePinOptions } from "./hooks/use-message-pin";
 export type { ChatCompletionTool, LlmChatOptions, LlmToolCall, UseLlmChatResult, } from "./hooks/use-llm-chat";
 export { ChatView } from "./components/ChatView";
 export type { ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, FollowupInteractionEvent, } from "./components/ChatView";
+export { SessionPluginSelector } from "./components/SessionPluginSelector";
+export type { SessionPluginSelectorProps } from "./components/SessionPluginSelector";
 export { AgentChat } from "./components/AgentChat";
 export type { AgentChatProps } from "./components/AgentChat";
 export { LlmChat } from "./components/LlmChat";