@blade-hq/agent-react 2608.0.6 → 2608.0.7-beta.0

package/dist/hooks/use-llm-chat.d.ts

@@ -0,0 +1,57 @@
+import type { ChatMessage } from "@blade-hq/agent-client";
+/** OpenAI 标准的工具声明，原样发给模型服务。 */
+export interface ChatCompletionTool {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+export interface LlmToolCall {
+    id: string;
+    name: string;
+    /** 模型生成的 JSON 字符串，是不可信输入，用之前自己校验。 */
+    arguments: string;
+}
+export interface LlmChatOptions {
+    /** OpenAI 兼容根地址，如 `/api/llm`（自己后端的透传路径）或 `http://host:30000/v1`。 */
+    baseURL: string;
+    model: string;
+    /**
+     * 直连模型服务时才需要。默认形态是让 `baseURL` 指向自己的后端，由后端补密钥转发，
+     * 浏览器不持有密钥。
+     */
+    apiKey?: string;
+    headers?: Record<string, string>;
+    /** 系统提示词，合成到消息最前面。 */
+    system?: string;
+    /** 每次带上最近多少轮，默认 12。越长越贵，也越容易超上下文。 */
+    historyTurns?: number;
+    temperature?: number;
+    /** 透传给模型服务的额外字段。 */
+    extraBody?: Record<string, unknown>;
+    tools?: ChatCompletionTool[];
+    /** 执行模型请求的工具，返回值会被序列化后回喂给模型。 */
+    onToolCall?: (call: LlmToolCall) => Promise<unknown>;
+    /** 工具最多来回几轮，默认 4，防止模型绕圈烧 token。 */
+    maxToolRounds?: number;
+    fetchImpl?: typeof fetch;
+}
+export interface UseLlmChatResult {
+    messages: ChatMessage[];
+    isStreaming: boolean;
+    /** 出错原因；下一次发送会清掉。 */
+    error: string | null;
+    send: (text: string) => Promise<boolean>;
+    stop: () => void;
+    reset: () => void;
+}
+/**
+ * 纯 LLM 对话的状态机，协议就是 **OpenAI Chat Completions**——任何兼容实现都能直接接，
+ * 不需要为这个组件专门写后端。
+ *
+ * 工具调用走 OpenAI 标准的多轮流程：模型返回 tool_calls → 调 onToolCall 执行 →
+ * 结果作为 role:"tool" 消息回喂 → 再请求一次。
+ */
+export declare function useLlmChat(options: LlmChatOptions): UseLlmChatResult;

package/dist/hooks/use-replay.d.ts

@@ -0,0 +1,50 @@
+import type { AgentSession, ReplaySpeed } from "@blade-hq/agent-client";
+/** 回放中用户说的话和录制内容对不上，需要当场决定往哪走。 */
+export interface ReplayMismatch {
+    /** 用户这次实际发出的内容。 */
+    actualMessage: string;
+    /** 源会话里录制的下一句。 */
+    expectedMessage: string;
+    /** keep_replay：按录制内容继续；continue_replay：从这里转为真实运行。 */
+    resolve: (decision: "keep_replay" | "continue_replay") => void;
+}
+export interface UseReplayResult {
+    /** 当前会话是不是正在回放（转自主运行后为 false）。 */
+    isReplay: boolean;
+    /** 当前播放倍速，非回放会话固定为 1。 */
+    speed: ReplaySpeed;
+    setSpeed: (speed: ReplaySpeed) => Promise<void>;
+    /** 退出回放，之后的对话交给真实模型运行。 */
+    exitToAutonomous: () => Promise<void>;
+    /** 待决策的输入冲突；处理完自动清空。 */
+    mismatch: ReplayMismatch | null;
+    /** 能不能改回放（改回放是 owner 专属）。只读身份下仍然显示"在回放"，但不能操作。 */
+    canControl: boolean;
+    /** 当前会话能否作为回放来源（并行子智能体等场景不支持）。 */
+    canReplay: boolean;
+    /** canReplay 为 false 时的原因，可直接展示。 */
+    unsupportedReason: string | null;
+    /** 从当前会话派生一个回放会话，返回新会话 id。 */
+    startReplay: (speed?: ReplaySpeed) => Promise<string>;
+    isStarting: boolean;
+    /** 最近一次回放操作失败的原因。 */
+    error: Error | null;
+}
+/**
+ * 会话回放（演示 / 彩排模式）。
+ *
+ * 回放会话不会自动播放：用户照常发消息，只要这句和源会话录制的下一句意图一致，
+ * 服务端就按倍速重放当时的回复和工具调用，完全不调用模型；对不上就抛出
+ * `mismatch` 交给界面决定。
+ *
+ * 同一个 hook 覆盖两种身份——传入的会话既可能是回放会话（isReplay / setSpeed /
+ * exitToAutonomous / mismatch），也可能是准备被回放的源会话（canReplay /
+ * startReplay）。
+ *
+ * 回放状态本身住在 `SessionState.replay` 里（非 React 宿主直接订阅它即可），
+ * 这里只做 React 绑定：订阅快照 + 接管冲突 + 拉一次 preview。
+ *
+ * **注册即接管**：底层的 `replayMismatch` 只交给最先注册的处理器。调用本 hook
+ * 就意味着由它接管冲突；不调用则维持 SDK 默认行为——直接转为真实运行。
+ */
+export declare function useReplay(session: AgentSession | null): UseReplayResult;

package/dist/index.d.ts

@@ -2,9 +2,22 @@ export { BladeProvider, useBladeClient } from "./context";
 export type { BladeProviderProps } from "./context";
 export { useAgentSession } from "./hooks/use-agent-session";
 export type { UseAgentSessionOptions, UseAgentSessionResult } from "./hooks/use-agent-session";
+export { useReplay } from "./hooks/use-replay";
+export type { ReplayMismatch, UseReplayResult } from "./hooks/use-replay";
+export { useLlmChat } from "./hooks/use-llm-chat";
+export type { ChatCompletionTool, LlmChatOptions, LlmToolCall, UseLlmChatResult, } from "./hooks/use-llm-chat";
 export { ChatView } from "./components/ChatView";
-export type { ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, } from "./components/ChatView";
+export type { ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, FollowupInteractionEvent, } from "./components/ChatView";
+export { AgentChat } from "./components/AgentChat";
+export type { AgentChatProps } from "./components/AgentChat";
+export { LlmChat } from "./components/LlmChat";
+export type { LlmChatHandle, LlmChatProps } from "./components/LlmChat";
+export type { LlmAdvancedSettings, LlmOverride } from "./components/LlmAdvancedSettings";
 export { MarkdownContent } from "./components/MarkdownContent";
 export type { MarkdownContentProps } from "./components/MarkdownContent";
+export { ReplayBar } from "./components/ReplayBar";
+export type { ReplayBarProps } from "./components/ReplayBar";
+export { ReplayMismatchPrompt } from "./components/ReplayMismatchPrompt";
+export type { ReplayMismatchPromptProps } from "./components/ReplayMismatchPrompt";
 export type { ToolCallRenderer } from "./components/ToolCallBlock";
 export * from "@blade-hq/agent-client";