@blade-hq/agent-react 2610.0.0-beta.32 → 2610.0.0-beta.34

package/README.md

@@ -74,6 +74,26 @@ await session?.send("你好")
 - 必须覆盖连接窗口内事件时，用 `onSessionConnected` 在历史加载和房间订阅开始前完成订阅，并返回取消订阅函数。
 - 同一 `sessionId` 的多次调用复用同一 `AgentSession` 实例（引用计数）；卸载后延迟释放，路由抖动不会断连。
 
+## SessionMemoryToggle
+
+把当前会话是否使用记忆放进宿主自己的会话设置面板：
+
+```tsx
+const [memoryEnabled, setMemoryEnabled] = useState(session.memory_enabled !== false)
+
+<SessionMemoryToggle
+  sessionId={session.id}
+  enabled={memoryEnabled}
+  onSaved={(_sessionId, enabled) => setMemoryEnabled(enabled)}
+  onError={(error) => toast.error(String(error))}
+/>
+```
+
+组件默认使用 `BladeProvider` 的 client；已有独立 client 装配层的宿主也可以显式传
+`client={client}`。同一 client、同一会话的多个开关共享保存锁，即使切换会话或同时存在多个
+设置入口，也不会并发提交相互覆盖。服务端确认后的权威值通过 `onSaved` 返回。
+全部属性见 `SessionMemoryToggleProps`。
+
 ## useReplay
 
 会话回放（演示 / 彩排）：拿一个已经聊完的会话当素材，重现当时的回复和工具调用，

package/dist/components/ChatInput.d.ts

@@ -3,16 +3,19 @@ interface Props {
     value: string;
     onValueChange: (value: string) => void;
     onSend: (text: string) => boolean | Promise<boolean>;
+    /** Optional direct insertion path used while another response streams. */
+    onAppend?: (text: string) => void;
     onStop: () => void;
     isStreaming: boolean;
     isStopping?: boolean;
     placeholder?: string;
     className?: string;
+    queueKey?: string;
 }
 /**
  * 轻量聊天输入框：textarea（Enter 发送 / Shift+Enter 换行）+ 发送/停止按钮。
  * 不含第一方版本的富文本编辑、@ 补全、技能菜单、语音输入与模型选择。
  * 内容受控，session.attach() / insertText() 通过 ChatView 注入到这里。
  */
-export declare function ChatInput({ value, onValueChange, onSend, onStop, isStreaming, isStopping, placeholder, className, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ChatInput({ value, onValueChange, onSend, onAppend, onStop, isStreaming, isStopping, placeholder, className, queueKey, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatSurface.d.ts

@@ -45,6 +45,7 @@ interface ChatSurfaceProps extends ChatPresentationProps {
     onInputChange: (value: string) => void;
     onSuggestion?: (value: string) => void;
     onSend: (text: string) => Promise<boolean>;
+    onAppend?: (text: string) => void;
     onStop: () => void;
     sessionStatus?: string;
     askAnswers?: Record<string, AskUserAnswerData>;
@@ -68,5 +69,5 @@ interface ChatSurfaceProps extends ChatPresentationProps {
  * 这里的 DOM 结构受 tests/chat-view-compat.test.tsx 的快照保护——接入方拿
  * .blade-chat-* 类名写了自己的样式，结构一动他们的页面就歪。
  */
-export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, postChatFollowup, isStreaming, isStopping, inputText, onInputChange, onSuggestion, onSend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, beforeInput, showPlanUpdates, planRevealRevision, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, postChatFollowup, isStreaming, isStopping, inputText, onInputChange, onSuggestion, onSend, onAppend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, beforeInput, showPlanUpdates, planRevealRevision, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/SessionMemoryToggle.d.ts

@@ -0,0 +1,19 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+export interface SessionMemoryToggleProps {
+    sessionId: string;
+    enabled: boolean;
+    /** 不在 BladeProvider 内使用时显式传入，与宿主现有 BladeClient 复用连接和鉴权。 */
+    client?: BladeClient;
+    disabled?: boolean;
+    label?: string;
+    className?: string;
+    labelClassName?: string;
+    inputClassName?: string;
+    onSaved?: (sessionId: string, enabled: boolean) => void;
+    onError?: (error: unknown) => void;
+}
+/**
+ * 当前会话记忆开关。同一 client + sessionId 的所有实例共享保存锁，避免多个聊天入口
+ * 或会话切换时发出乱序更新；服务端成功后才通过 onSaved 交还权威值。
+ */
+export declare function SessionMemoryToggle({ sessionId, enabled, client: clientProp, disabled, label, className, labelClassName, inputClassName, onSaved, onError, }: SessionMemoryToggleProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/display-utils.d.ts

@@ -10,6 +10,8 @@ export declare function getSkillNameFromFilePath(filePath: string | null | undef
 /** 归一化工具名：去掉命名空间前缀并映射到别名表（如 "fork:Agent" → "Agent"）。 */
 export declare function formatToolName(name: string): string;
 export declare function extractToolFilePath(toolCall: ToolCallInfo): string | null;
+/** 从文件类工具参数中提取全部可定位的文件路径（按出现顺序去重）。 */
+export declare function extractToolFilePaths(toolCall: ToolCallInfo): string[];
 /**
  * 返回工具调用的中文展示标签：优先取参数里的 description，
  * 其次取后端下发的 display_name / 系统工具中文名。

package/dist/context.d.ts

@@ -11,3 +11,4 @@ export interface BladeProviderProps {
 export declare function BladeProvider({ client, children }: BladeProviderProps): import("react/jsx-runtime").JSX.Element;
 /** 读取当前 BladeProvider 提供的 client。不在 Provider 内使用时抛错。 */
 export declare function useBladeClient(): BladeClient;
+export declare function useOptionalBladeClient(): BladeClient | null;

package/dist/index.d.ts

@@ -32,6 +32,8 @@ export type { PlanStepStatus, PlanUpdateData, PlanUpdateDisplayState, } from "./
 export { ContextCard, ContextGroupCard } from "./components/ContextCard";
 export type { ContextCardProps, ContextGroupCardProps } from "./components/ContextCard";
 export { collectMemoryRefs, MemoryRefsHint } from "./components/AssistantTurnBlock";
+export { SessionMemoryToggle } from "./components/SessionMemoryToggle";
+export type { SessionMemoryToggleProps } from "./components/SessionMemoryToggle";
 export { isAgentComputerCommand, isAgentComputerToolCall, classifyAgentComputerLaunchOutcome, } from "./lib/agent-computer-command";
 export type { AgentComputerLaunchOutcome } from "./lib/agent-computer-command";
 export * from "@blade-hq/agent-client";