@springbrand/chat-client 0.1.3-alpha.18 → 0.1.3-alpha.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/chat-client",
-  "version": "0.1.3-alpha.18",
+  "version": "0.1.3-alpha.20",
   "type": "module",
   "files": [
     "src",
@@ -25,7 +25,7 @@
     "@types/react-dom": "^19.2.3",
     "react-dom": "^19.2.7",
     "typescript": "^7.0.2",
-    "@springbrand/agent-runtime": "0.2.0-alpha.25"
+    "@springbrand/agent-runtime": "0.2.0-alpha.27"
   },
   "scripts": {
     "typecheck": "tsc --noEmit"

package/src/index.ts

@@ -2,6 +2,7 @@ export {
   UniversalAgentChatProvider,
   useUniversalAgentChat,
   type AgentToolRun,
+  type ChatConnectionStatus,
   type ChatConnectionOptions,
   type ChatRuntime,
 } from "./use-universal-agent-chat";

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

@@ -13,10 +13,12 @@ import {
 import { nanoid } from "nanoid";
 import type { ChatStatus, FileUIPart, UIMessage } from "ai";
 import type { AgentToolRunState } from "agents";
+import type { AgentConnectionError } from "agents/client";
 import { MessageType } from "agents/chat";
 import { getAgentMessages, useAgentChat } from "agents/chat/react";
 import { useAgent, useAgentToolEvents } from "agents/react";
 import {
+  type ApprovalDecision,
   type MessageDelivery,
   type MessageDispatchReceipt,
   type RequestedCapability,
@@ -34,6 +36,11 @@ type ChatMessageMetadata = Record<string, unknown> & {
   turnStatus?: string;
 };
 type ChatMessage = UIMessage<ChatMessageMetadata>;
+export type ChatConnectionStatus =
+  | "connecting"
+  | "connected"
+  | "rejected"
+  | "error";
 type FailedDispatch = {
   message: ChatMessage;
   delivery: MessageDelivery;
@@ -96,6 +103,8 @@ type ChatTurn = {
 export interface ChatRuntime {
   messages: ChatMessage[];
   status: ChatStatus;
+  connectionStatus: ChatConnectionStatus;
+  connectionError: AgentConnectionError | undefined;
   runtimeLoad: ChatRuntimeLoadState | undefined;
   isStreaming: boolean;
   error: string | Error | undefined;
@@ -127,6 +136,10 @@ export interface ChatRuntime {
     toolCallId: string,
     response: unknown,
   ) => Promise<boolean>;
+  decideApproval: (
+    executionId: string,
+    decision: ApprovalDecision,
+  ) => Promise<{ ok: boolean }>;
   /**
    * 读取该 Session facet 当前真正装配出来的 Runtime。
    *
@@ -136,6 +149,10 @@ export interface ChatRuntime {
    * 装配未就绪还是连接断了，收敛成 `undefined` 会让调试面板无从显示原因。
    */
   getRuntimeAssembly: () => Promise<RuntimeAssemblyView>;
+  getRuntimeBinding: <Binding = unknown>() => Promise<Binding>;
+  readChatMetadata: <Metadata = unknown>() => Promise<Metadata>;
+  renameChat: <Metadata = unknown>(title: string) => Promise<Metadata>;
+  rebindRuntime: <Input = unknown, Result = unknown>(input: Input) => Promise<Result>;
   updateConfig: <Change = unknown>(
     command: unknown,
   ) => Promise<RuntimeConfigUpdateResult<Change>>;
@@ -379,7 +396,7 @@ export function useUniversalAgentChat(): ChatRuntime {
     isServerStreaming,
     isRecovering: sdkIsRecovering,
     isToolContinuation,
-    connectionError,
+    connectionError: sdkConnectionError,
   } = useAgentChat<RuntimeState, ChatMessage>({
     agent: chatAgent,
     getInitialMessages: ({ url }) =>
@@ -412,7 +429,11 @@ export function useUniversalAgentChat(): ChatRuntime {
     ? "ready"
     : sdkStatus;
   const sdkError = stoppedByUser || hasTerminalMessage ? undefined : error;
-  const runtimeError = dispatchError ?? sdkError ?? connectionError ?? undefined;
+  const connectionError = sdkConnectionError ?? undefined;
+  const connectionStatus: ChatConnectionStatus = connectionError
+    ? connectionError.code === 1008 ? "rejected" : "error"
+    : agent.identified ? "connected" : "connecting";
+  const runtimeError = dispatchError ?? sdkError ?? connectionError;
   const runtimeErrorMessage = runtimeError instanceof Error
     ? runtimeError.message
     : runtimeError;
@@ -751,6 +772,7 @@ export function useUniversalAgentChat(): ChatRuntime {
           type: MessageType.CF_AGENT_CHAT_REQUEST_CANCEL,
           id: requestId,
         }));
+        return;
       }
       const result = submissionId
         ? await agentRef.current.call<{ ok: boolean }>(
@@ -798,6 +820,14 @@ export function useUniversalAgentChat(): ChatRuntime {
       return false;
     }
   }, []);
+  const decideApproval = useCallback(
+    (executionId: string, decision: ApprovalDecision) =>
+      agentRef.current.call<{ ok: boolean }>(
+        "decideApproval",
+        [executionId, decision],
+      ),
+    [],
+  );
 
   // 只读控制面：Runtime 尚未装配时由 Agent 侧 `ensureRuntimeReady` 负责等待，
   // 这里不缓存结果 —— 换模型、加技能或 reload 之后调用方要拿到的是新装配。
@@ -805,6 +835,24 @@ export function useUniversalAgentChat(): ChatRuntime {
     () => agentRef.current.call<RuntimeAssemblyView>("getRuntimeAssembly", []),
     [],
   );
+  const getRuntimeBinding = useCallback(
+    <Binding,>() => agentRef.current.call<Binding>("getRuntimeBinding", []),
+    [],
+  );
+  const readChatMetadata = useCallback(
+    <Metadata,>() => agentRef.current.call<Metadata>("readChatMetadata", []),
+    [],
+  );
+  const renameChat = useCallback(
+    <Metadata,>(title: string) =>
+      agentRef.current.call<Metadata>("renameChat", [title]),
+    [],
+  );
+  const rebindRuntime = useCallback(
+    <Input, Result,>(input: Input) =>
+      agentRef.current.call<Result>("rebindRuntime", [input]),
+    [],
+  );
   const updateConfig = useCallback(
     <Change,>(command: unknown) =>
       agentRef.current.call<RuntimeConfigUpdateResult<Change>>(
@@ -823,11 +871,18 @@ export function useUniversalAgentChat(): ChatRuntime {
 
   return {
     respondToolInteraction,
+    decideApproval,
     getRuntimeAssembly,
+    getRuntimeBinding,
+    readChatMetadata,
+    renameChat,
+    rebindRuntime,
     updateConfig,
     reloadRuntime,
     messages: visibleMessages,
     status,
+    connectionStatus,
+    connectionError,
     runtimeLoad: facetState?.runtimeLoad,
     isStreaming,
     error: presentationError,