@springbrand/chat-client 0.1.3-alpha.24 → 0.1.3-alpha.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/chat-client",
-  "version": "0.1.3-alpha.24",
+  "version": "0.1.3-alpha.26",
   "type": "module",
   "files": [
     "src",

package/src/use-universal-agent-chat.ts

@@ -178,6 +178,8 @@ type SharedChatConnectionOptions = {
   onMessage?: (message: MessageEvent) => void;
   inboxAgent?: string;
   sessionAgent?: string;
+  /** Skip history loading when the caller has just created this Chat. */
+  skipInitialMessages?: boolean;
   /** Host projection used only until the selected Session sends its first state. */
   initialTurnActive?: boolean;
 };
@@ -192,6 +194,7 @@ type UniversalAgentChatContextValue = {
   chatId: string;
   connection: ChatConnectionOptions;
   agent: SessionAgentConnection;
+  chatAgent: SessionAgentConnection;
 };
 
 const UniversalAgentChatContext = createContext<UniversalAgentChatContextValue | null>(null);
@@ -222,9 +225,13 @@ export function UniversalAgentChatProvider({
       name: chatId,
     }],
   });
+  const chatAgent = useMemo(
+    () => createSafeUIMessageAgentConnection(agent),
+    [agent],
+  );
   const value = useMemo(
-    () => ({ chatId, connection, agent }),
-    [agent, chatId, connection],
+    () => ({ chatId, connection, agent, chatAgent }),
+    [agent, chatAgent, chatId, connection],
   );
   return createElement(
     UniversalAgentChatContext.Provider,
@@ -365,7 +372,7 @@ export function useUniversalAgentChat(): ChatRuntime {
   if (!context) {
     throw new Error("useUniversalAgentChat must be used within UniversalAgentChatProvider");
   }
-  const { chatId, connection, agent } = context;
+  const { chatId, connection, agent, chatAgent } = context;
   const [optimisticMessages, setOptimisticMessages] =
     useState<ChatMessage[]>([]);
   const [optimisticQueued, setOptimisticQueued] =
@@ -374,11 +381,6 @@ export function useUniversalAgentChat(): ChatRuntime {
   const [canRetry, setCanRetry] = useState(false);
   const failedDispatchRef = useRef<FailedDispatch | undefined>(undefined);
   const activeSubmissionIdRef = useRef<string | undefined>(undefined);
-  const chatAgent = useMemo(
-    () => createSafeUIMessageAgentConnection(agent),
-    [agent],
-  );
-
   // 轮询→推送:这条 chat 连接连的是 UniversalAgent facet,`agent.state` 即 facet 的
   // AgentState 广播(useAgent 内部 useState,收到 cf_agent_state 即 re-render)。待批项
   // 随它推来 —— 审批读侧复用这条已开的连接,不另开第二条 WebSocket。三态(原则 VII):
@@ -402,8 +404,9 @@ export function useUniversalAgentChat(): ChatRuntime {
     connectionError: sdkConnectionError,
   } = useAgentChat<RuntimeState, ChatMessage>({
     agent: chatAgent,
-    getInitialMessages: ({ url }) =>
-      loadInitialMessages(url, connection.credentials),
+    getInitialMessages: connection.skipInitialMessages
+      ? null
+      : ({ url }) => loadInitialMessages(url, connection.credentials),
     ...(connection.credentials === undefined
       ? {}
       : { credentials: connection.credentials }),