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

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/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/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";

package/dist/index.js

@@ -17,6 +17,9 @@ function useBladeClient() {
   }
   return client;
 }
+function useOptionalBladeClient() {
+  return useContext(BladeClientContext);
+}
 
 // src/hooks/use-agent-session.ts
 import { useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
@@ -2248,8 +2251,9 @@ function AgentLoopBlock({ toolCall }) {
             ChevronRight,
             {
               size: 14,
+              style: { transitionDuration: "260ms", transitionTimingFunction: "cubic-bezier(0.25, 0.1, 0.25, 1)" },
               className: cn(
-                "shrink-0 transition-transform duration-300",
+                "shrink-0 transition-transform",
                 expanded && "rotate-90"
               ),
               "aria-hidden": "true"
@@ -3294,8 +3298,9 @@ function AssistantTurnBlock({
                     ChevronRight,
                     {
                       size: 14,
+                      style: { transitionDuration: "260ms", transitionTimingFunction: "cubic-bezier(0.25, 0.1, 0.25, 1)" },
                       className: cn(
-                        "shrink-0 transition-transform duration-300",
+                        "shrink-0 transition-transform",
                         effectiveMode === "detail" && "rotate-90"
                       ),
                       "aria-hidden": "true"
@@ -5007,6 +5012,112 @@ function ContextGroupCard({ contexts, className }) {
   ] });
 }
 
+// src/components/SessionMemoryToggle.tsx
+import { useCallback as useCallback9, useEffect as useEffect14, useRef as useRef13, useState as useState17, useSyncExternalStore as useSyncExternalStore2 } from "react";
+import { jsx as jsx24, jsxs as jsxs20 } from "react/jsx-runtime";
+var saveStates = /* @__PURE__ */ new WeakMap();
+function getSaveState(client, sessionId) {
+  let clientStates = saveStates.get(client);
+  if (!clientStates) {
+    clientStates = /* @__PURE__ */ new Map();
+    saveStates.set(client, clientStates);
+  }
+  let state = clientStates.get(sessionId);
+  if (!state) {
+    state = { saving: false, listeners: /* @__PURE__ */ new Set() };
+    clientStates.set(sessionId, state);
+  }
+  return state;
+}
+function notify(state) {
+  for (const listener of state.listeners) listener();
+}
+function cleanupSaveState(client, sessionId, state) {
+  if (state.saving || state.listeners.size > 0) return;
+  const clientStates = saveStates.get(client);
+  if (clientStates?.get(sessionId) === state) clientStates.delete(sessionId);
+}
+function SessionMemoryToggle({
+  sessionId,
+  enabled,
+  client: clientProp,
+  disabled = false,
+  label = "\u5F53\u524D\u4F1A\u8BDD\u4F7F\u7528\u8BB0\u5FC6",
+  className,
+  labelClassName,
+  inputClassName,
+  onSaved,
+  onError
+}) {
+  const contextClient = useOptionalBladeClient();
+  const client = clientProp ?? contextClient;
+  if (!client) {
+    throw new Error("SessionMemoryToggle \u5FC5\u987B\u5728 <BladeProvider> \u5185\u4F7F\u7528\u6216\u663E\u5F0F\u4F20\u5165 client");
+  }
+  const saveState = getSaveState(client, sessionId);
+  const subscribe = useCallback9(
+    (listener) => {
+      saveState.listeners.add(listener);
+      return () => {
+        saveState.listeners.delete(listener);
+        cleanupSaveState(client, sessionId, saveState);
+      };
+    },
+    [client, saveState, sessionId]
+  );
+  const getSaving = useCallback9(() => saveState.saving, [saveState]);
+  const saving = useSyncExternalStore2(
+    subscribe,
+    getSaving,
+    getSaving
+  );
+  const [draftEnabled, setDraftEnabled] = useState17(enabled);
+  const activeSessionIdRef = useRef13(sessionId);
+  activeSessionIdRef.current = sessionId;
+  useEffect14(() => {
+    setDraftEnabled(enabled);
+  }, [enabled, sessionId]);
+  const update = useCallback9(
+    (nextEnabled) => {
+      const currentSaveState = getSaveState(client, sessionId);
+      if (currentSaveState.saving) return;
+      currentSaveState.saving = true;
+      notify(currentSaveState);
+      setDraftEnabled(nextEnabled);
+      void client.sessions.updateSessionMemory(sessionId, nextEnabled).then(
+        (updated) => {
+          if (activeSessionIdRef.current === sessionId) {
+            setDraftEnabled(updated.memory_enabled);
+          }
+          onSaved?.(sessionId, updated.memory_enabled);
+        },
+        (error) => {
+          if (activeSessionIdRef.current === sessionId) setDraftEnabled(enabled);
+          onError?.(error);
+        }
+      ).finally(() => {
+        currentSaveState.saving = false;
+        notify(currentSaveState);
+        cleanupSaveState(client, sessionId, currentSaveState);
+      });
+    },
+    [client, enabled, onError, onSaved, sessionId]
+  );
+  return /* @__PURE__ */ jsxs20("label", { className: cn("flex items-center justify-between", className), children: [
+    /* @__PURE__ */ jsx24("span", { className: labelClassName, children: label }),
+    /* @__PURE__ */ jsx24(
+      "input",
+      {
+        type: "checkbox",
+        checked: draftEnabled,
+        onChange: (event) => update(event.target.checked),
+        disabled: disabled || saving,
+        className: inputClassName
+      }
+    )
+  ] });
+}
+
 // src/lib/agent-computer-command.ts
 var COMPUTER_LAUNCH_COMMAND_PATTERN = /(?:^|[\n;&|(]\s*)computer\s+launch(?:\s|$)/;
 function isAgentComputerCommand(command) {
@@ -5065,6 +5176,7 @@ export {
   PlanUpdateBlock,
   ReplayBar,
   ReplayMismatchPrompt,
+  SessionMemoryToggle,
   WhatIfUserBubble,
   classifyAgentComputerLaunchOutcome,
   collectMemoryRefs,