@blade-hq/agent-react 2608.0.5-beta.0 → 2608.0.5-beta.1

package/dist/components/LlmAdvancedSettings.d.ts

@@ -1,40 +0,0 @@
-/** 纯 LLM 模式的高级设置：让用户自己改模型服务地址。 */
-export interface LlmAdvancedSettings {
-    /** 允许改模型服务地址，默认允许。 */
-    baseURL?: boolean;
-    /** 允许改模型名，默认允许。 */
-    model?: boolean;
-    /**
-     * 允许在界面上填密钥，默认**不允许**。
-     * 打开意味着密钥存在浏览器里，只适合受控内网、演示，或密钥本身就属于当前用户的场景。
-     */
-    apiKey?: boolean;
-    /** 覆盖值存哪：`local` 记住用户的选择（默认），`memory` 只在本次会话有效。 */
-    storage?: "local" | "memory";
-    /** localStorage 的键，默认按组件拿到的 baseURL 生成。 */
-    storageKey?: string;
-}
-export interface LlmOverride {
-    baseURL?: string;
-    model?: string;
-    apiKey?: string;
-}
-export declare function normalizeAdvanced(value: boolean | LlmAdvancedSettings | undefined): Required<Pick<LlmAdvancedSettings, "baseURL" | "model" | "apiKey" | "storage">> | null;
-export declare function readOverride(settings: boolean | LlmAdvancedSettings | undefined, baseURL: string): LlmOverride;
-declare function writeOverride(settings: boolean | LlmAdvancedSettings | undefined, baseURL: string, override: LlmOverride): void;
-interface Props {
-    settings: boolean | LlmAdvancedSettings;
-    /** 组件拿到的默认值，用来做占位提示与"恢复默认" */
-    defaults: {
-        baseURL: string;
-        model: string;
-    };
-    override: LlmOverride;
-    onChange: (next: LlmOverride) => void;
-}
-/**
- * 输入框上方的一行「高级设置」：默认收起，展开后可以改模型服务地址与模型。
- * 只有调用方显式打开才渲染——不传 advanced 时这里一个节点都不会出现。
- */
-export declare function LlmAdvancedSettingsBar({ settings, defaults, override, onChange }: Props): import("react/jsx-runtime").JSX.Element | null;
-export { writeOverride };

package/dist/components/LlmChat.d.ts

@@ -1,29 +0,0 @@
-import { type LlmChatOptions } from "../hooks/use-llm-chat";
-import { type ChatPresentationProps } from "./ChatSurface";
-import { type LlmAdvancedSettings, type LlmOverride } from "./LlmAdvancedSettings";
-/** 纯 LLM 模式的操作句柄，对应智能体模式的 session.insertText() / send()。 */
-export interface LlmChatHandle {
-    /** 把文本放进输入框交给用户确认，不直接发出去。 */
-    insertText: (text: string) => void;
-    send: (text: string) => Promise<boolean>;
-    /** 清空这段对话。 */
-    reset: () => void;
-}
-export interface LlmChatProps extends LlmChatOptions, ChatPresentationProps {
-    /** 拿到操作句柄：业务界面把选中的数据塞进输入框，或直接发一句。 */
-    onReady?: (handle: LlmChatHandle) => void;
-    /**
-     * 打开输入框上方的「高级设置」，让用户自己改模型服务地址（默认还能改模型名）。
-     * 不传就一个节点都不渲染。传 `true` 用默认配置，或用对象细调。
-     */
-    advanced?: boolean | LlmAdvancedSettings;
-    /** 用户改了覆盖值时回调，方便宿主自己也记一份。 */
-    onOverrideChange?: (override: LlmOverride) => void;
-}
-/**
- * 纯 LLM 模式的聊天界面：不建会话、不连实时通道、也不要求登录 Blade，
- * 只按 **OpenAI Chat Completions** 标准协议跟模型服务一问一答。
- *
- * 默认形态是把 `baseURL` 指向自己后端的透传路径，由后端补密钥再转发，浏览器不持有密钥。
- */
-export declare function LlmChat({ classNames, renderers, slots, placeholder, theme, onReady, advanced, onOverrideChange, ...options }: LlmChatProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/PostChatFollowupBlock.d.ts

@@ -1,59 +0,0 @@
-import type { FinalArtifact, PostChatFollowup, ResultFeedback as SavedResultFeedback, ResultFeedbackReason } from "@blade-hq/agent-client";
-export type FollowupInteractionEvent = {
-    type: "suggestions_shown";
-    sessionId?: string;
-    assistantEntryId: string;
-    count: number;
-} | {
-    type: "suggestion_adopted";
-    sessionId?: string;
-    assistantEntryId: string;
-    suggestionIndex: number;
-} | {
-    type: "artifact_shown";
-    sessionId?: string;
-    assistantEntryId: string;
-    artifactIndex: number;
-    artifactKind: FinalArtifact["kind"];
-} | {
-    type: "artifact_opened";
-    sessionId?: string;
-    assistantEntryId: string;
-    artifactIndex: number;
-    artifactKind: FinalArtifact["kind"];
-} | {
-    type: "artifact_download_started";
-    sessionId?: string;
-    assistantEntryId: string;
-    artifactIndex: number;
-    artifactKind: "file";
-} | {
-    type: "artifact_download_succeeded";
-    sessionId?: string;
-    assistantEntryId: string;
-    artifactIndex: number;
-    artifactKind: "file";
-} | {
-    type: "result_feedback_shown";
-    sessionId?: string;
-    assistantEntryId: string;
-} | {
-    type: "result_feedback_submitted";
-    sessionId?: string;
-    assistantEntryId: string;
-    helpful: boolean;
-    reason: ResultFeedbackReason | null;
-    updatedAt: string;
-};
-export declare function HistoricalResultFeedback({ feedback }: {
-    feedback: SavedResultFeedback;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function PostChatFollowupBlock({ followup, sessionId, onSuggestion, isViewer, onInteraction, savedFeedback, onFeedbackSaved, }: {
-    followup: PostChatFollowup;
-    sessionId?: string;
-    onSuggestion?: (value: string) => void;
-    isViewer?: boolean;
-    onInteraction?: (event: FollowupInteractionEvent) => void;
-    savedFeedback?: SavedResultFeedback;
-    onFeedbackSaved?: (feedback: SavedResultFeedback) => void;
-}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/ReplayBar.d.ts

@@ -1,13 +0,0 @@
-import type { ReplaySpeed } from "@blade-hq/agent-client";
-export interface ReplayBarProps {
-    /** 非回放会话传 false 时整条不渲染。 */
-    isReplay: boolean;
-    speed: ReplaySpeed;
-    onSpeedChange: (speed: ReplaySpeed) => void;
-    onExit: () => void;
-    /** 传 useReplay().canControl。只读身份下仍然显示"在回放"，但操作按钮禁用。 */
-    canControl?: boolean;
-    className?: string;
-}
-/** 回放会话的顶部状态条：说明当前在回放、切换倍速、随时退出回放。 */
-export declare function ReplayBar({ isReplay, speed, onSpeedChange, onExit, canControl, className, }: ReplayBarProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/ReplayMismatchPrompt.d.ts

@@ -1,8 +0,0 @@
-import type { ReplayMismatch } from "../hooks/use-replay";
-export interface ReplayMismatchPromptProps {
-    /** 来自 useReplay().mismatch；为 null 时不渲染。 */
-    mismatch: ReplayMismatch | null;
-    className?: string;
-}
-/** 回放中输入和录制内容对不上时的选择卡：按录制继续，还是从这里真跑。 */
-export declare function ReplayMismatchPrompt({ mismatch, className }: ReplayMismatchPromptProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,57 +0,0 @@
-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

@@ -1,50 +0,0 @@
-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;