@blade-hq/agent-react 2610.0.0-beta.1 → 2610.0.1-alpha.1

package/README.md

@@ -28,7 +28,6 @@ export function App() {
 
 - 不传 `sessionId` 自动创建新会话；未登录时 `ChatView` 自己渲染登录按钮（弹窗授权，见 agent-client 的 `client.auth.login()`）。
 - 同一 `BladeProvider` 下可以放多个 `ChatView`，各自独立会话、互不干扰。
-- 宿主只需要完成态消息时，可在 `BladeClient` 构造参数中传 `streamTokens: false`，不订阅逐 token 增量。
 
 ## BladeProvider
 
@@ -140,7 +139,6 @@ await replay.exitToAutonomous()                // 退出回放，之后真的运
   onSessionCreated={(id) => ...}       // 自动创建的会话 id 交还调用方
   onSessionReady={(session) => ...}    // 会话实例就绪（页面协作高级用法）
   commands={{ "map.highlight": (data) => map.highlight(data) }}  // 智能体 → 页面指令
-  onFollowupInteraction={(event) => analytics.capture(event.type, event)} // 厂商无关交互回调
   placeholder="输入消息..."
   classNames={{ root: "...", banner: "...", messages: "...", input: "..." }}  // ChatViewClassNames
   renderers={{ toolCall: (info) => <MyToolCard info={info} /> }}              // ChatViewRenderers
@@ -150,8 +148,6 @@ await replay.exitToAutonomous()                // 退出回放，之后真的运
 
 全部 props 见 `ChatViewProps`。样式说明：
 
-`onFollowupInteraction` 使用 `FollowupInteractionEvent`，覆盖下一步建议展示/采纳、成果展示/打开/下载以及结果评分。SDK 不内置 PostHog 等分析厂商；宿主回调抛错也不会中断用户点击或下载。
-
 - 必须引入一份样式，按宿主有没有 Tailwind 二选一：
   - **`style.full.css`**（默认选它）：布局兜底 + 编译好的 Tailwind 产物，自包含，宿主没装 Tailwind 也是完整视觉。
   - **`style.css`**：只有 `.blade-chat-*` 布局兜底。宿主自己装了 Tailwind、且 `content` 配了扫描 `node_modules/@blade-hq/agent-react` 时用它，可以少一份重复 CSS。选错不会报错，只是工具块、思考块内部会退化成没有布局的裸 HTML。
@@ -257,6 +253,8 @@ models.filter((m) => m.serviceModelId)
 <MarkdownContent content={markdownText} />
 ```
 
+传了 `sessionId` 才会把智能体产出文件的 `MEDIA:` 行折叠成下载卡片（下载要用它）。`ChatView` 内部已经传好，只有单独用 `MarkdownContent` 时需要自己给：
+
 ```tsx
 <MarkdownContent sessionId={sessionId}>{markdownText}</MarkdownContent>
 ```
@@ -304,4 +302,4 @@ blade-chat { --primary: 262 83% 58%; height: 640px; }
 
 为方便单包引入，本包 re-export 了 agent-client 的全部公开声明（`BladeClient`、`AgentSession`、`SessionState`、协议类型等），文档一律见 [agent-client 的 README](../agent-client/README.md)。完整签名见 [public-api.md](./public-api.md)。
 
-本包自有声明：`BladeProvider`、`BladeProviderProps`、`useBladeClient`、`useAgentSession`、`UseAgentSessionOptions`、`UseAgentSessionResult`、`useReplay`、`UseReplayResult`、`ReplayMismatch`、`ReplayBar`、`ReplayBarProps`、`ReplayMismatchPrompt`、`ReplayMismatchPromptProps`、`ChatView`、`ChatViewProps`、`ChatViewClassNames`、`ChatViewRenderers`、`ChatViewSlots`、`FollowupInteractionEvent`、`ToolCallRenderer`、`MarkdownContent`、`MarkdownContentProps`。
+本包自有声明：`BladeProvider`、`BladeProviderProps`、`useBladeClient`、`useAgentSession`、`UseAgentSessionOptions`、`UseAgentSessionResult`、`useReplay`、`UseReplayResult`、`ReplayMismatch`、`ReplayBar`、`ReplayBarProps`、`ReplayMismatchPrompt`、`ReplayMismatchPromptProps`、`ChatView`、`ChatViewProps`、`ChatViewClassNames`、`ChatViewRenderers`、`ChatViewSlots`、`ToolCallRenderer`、`MarkdownContent`、`MarkdownContentProps`。

package/dist/components/AgentChat.d.ts

@@ -1,9 +1,6 @@
 import type { AgentSession, CreateSessionRequest } from "@blade-hq/agent-client";
 import { type ChatPresentationProps } from "./ChatSurface";
-import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 export interface AgentChatProps extends ChatPresentationProps {
-    /** follow-up、成果和评分交互；SDK 不绑定任何分析厂商。 */
-    onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
     /** 连接既有会话；不传则按 createOptions 自动新建。 */
     sessionId?: string;
     createOptions?: CreateSessionRequest;

package/dist/components/AssistantTurnBlock.d.ts

@@ -7,7 +7,7 @@ interface Props {
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     sessionStatus?: string;
     toolCallRenderer?: ToolCallRenderer;
-    /** 会话 id；传给 Markdown 渲染的统一上下文。 */
+    /** 传给 Markdown 渲染，用于把 MEDIA 行折叠成文件下载卡片。 */
     sessionId?: string;
 }
 /**

package/dist/components/ChatSurface.d.ts

@@ -1,8 +1,6 @@
-import type { AskUserAnswerData, ChatMessage, ConnectionStatus, PostChatFollowup } from "@blade-hq/agent-client";
+import type { AskUserAnswerData, ChatMessage, ConnectionStatus } from "@blade-hq/agent-client";
 import type { ReactNode } from "react";
 import type { ToolCallRenderer } from "./ToolCallBlock";
-import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
-import type { ResultFeedback } from "@blade-hq/agent-client";
 export interface ChatViewClassNames {
     root?: string;
     banner?: string;
@@ -33,26 +31,19 @@ export interface ChatPresentationProps {
 /** 主题落到聊天根节点上：深色变量挂在 [data-theme="dark"] 上，由它继承给整棵子树。 */
 export declare function themeAttr(theme: ChatPresentationProps["theme"]): "dark" | undefined;
 interface ChatSurfaceProps extends ChatPresentationProps {
-    /** follow-up、成果和评分交互；SDK 不绑定任何分析厂商。 */
-    onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
     connection: ConnectionStatus;
     errorMessage: string | null;
     messages: ChatMessage[];
-    postChatFollowup?: PostChatFollowup | null;
     isStreaming: boolean;
     isStopping: boolean;
     inputText: string;
     onInputChange: (value: string) => void;
-    onSuggestion?: (value: string) => void;
     onSend: (text: string) => Promise<boolean>;
     onStop: () => void;
     sessionStatus?: string;
     askAnswers?: Record<string, AskUserAnswerData>;
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     sessionId?: string;
-    isViewer?: boolean;
-    resultFeedbackByEntry?: ReadonlyMap<string, ResultFeedback>;
-    onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
     /** 输入框上方的内部区域（纯 LLM 模式的高级设置用）。不传时不渲染任何节点。 */
     beforeInput?: ReactNode;
     /** 连接状态条下方的横幅（回放模式条用）。不传时不渲染任何节点。 */
@@ -64,5 +55,5 @@ interface ChatSurfaceProps extends ChatPresentationProps {
  * 这里的 DOM 结构受 tests/chat-view-compat.test.tsx 的快照保护——接入方拿
  * .blade-chat-* 类名写了自己的样式，结构一动他们的页面就歪。
  */
-export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, postChatFollowup, isStreaming, isStopping, inputText, onInputChange, onSuggestion, onSend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, beforeInput, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, isStreaming, isStopping, inputText, onInputChange, onSend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, beforeInput, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatView.d.ts

@@ -3,7 +3,6 @@ import { type LlmChatHandle } from "./LlmChat";
 import type { LlmAdvancedSettings, LlmOverride } from "./LlmAdvancedSettings";
 import type { LlmChatOptions } from "../hooks/use-llm-chat";
 export type { ChatViewClassNames, ChatViewRenderers, ChatViewSlots, } from "./ChatSurface";
-export type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 export interface ChatViewProps extends AgentChatProps {
     /** 挂哪个下层组件。默认 `agent`——不传就是接 Blade 智能体会话的原有行为。 */
     mode?: "agent" | "llm";

package/dist/components/FileCard.d.ts

@@ -0,0 +1,16 @@
+import { type ComponentPropsWithRef } from "react";
+import type { ExtraProps } from "streamdown";
+export type FileCardProps = ComponentPropsWithRef<"span"> & ExtraProps & {
+    "data-path"?: string;
+    "data-name"?: string;
+    dataPath?: string;
+    dataName?: string;
+    sessionId?: string;
+};
+/**
+ * 智能体产出文件的下载卡片（由 MEDIA 行折叠而来）。
+ *
+ * 整张卡片只有一个动作：下载。第一方界面点卡片是「在右侧预览」，那依赖 app 的 artifact
+ * 面板，SDK 里没有这块，所以不摆预览入口也不写预览文案——UI 不能承诺不存在的能力。
+ */
+export declare function FileCard({ node, "data-path": pathAttribute, "data-name": nameAttribute, dataPath, dataName, sessionId, children, className, ...props }: FileCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/MarkdownContent.d.ts

@@ -3,11 +3,14 @@ export interface MarkdownContentProps {
     className?: string;
     /** 流式渲染传 "streaming"，历史静态内容默认 "static"。 */
     mode?: "streaming" | "static";
-    /** 会话 id；保留给聊天组件统一透传上下文。 */
+    /**
+     * 会话 id。传了才会把 `MEDIA:` 行折叠成文件下载卡片——下载要用它。
+     * 不要给用户消息传：用户自己在输入框打一行 `MEDIA:` 不该被当成平台产物。
+     */
     sessionId?: string;
 }
 /**
- * SDK 版 Markdown 渲染：附带代码块复制按钮；相比第一方版本去掉了
- * mermaid、外链确认弹窗与文件预览。
+ * SDK 版 Markdown 渲染：附带代码块复制按钮、智能体产出文件的下载卡片；
+ * 相比第一方版本去掉了 mermaid、外链确认弹窗与文件预览。
  */
 export declare function MarkdownContent({ children, className, mode, sessionId }: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/MessageList.d.ts

@@ -1,11 +1,8 @@
-import type { AskUserAnswerData, ChatMessage, PostChatFollowup, ResultFeedback } from "@blade-hq/agent-client";
+import type { AskUserAnswerData, ChatMessage } from "@blade-hq/agent-client";
 import { type ReactNode } from "react";
-import { type FollowupInteractionEvent } from "./PostChatFollowupBlock";
 import type { ToolCallRenderer } from "./ToolCallBlock";
 interface Props {
     messages: ChatMessage[];
-    postChatFollowup?: PostChatFollowup | null;
-    onSuggestion?: (value: string) => void;
     isStreaming: boolean;
     sessionStatus?: string;
     askAnswers?: Record<string, AskUserAnswerData>;
@@ -13,16 +10,12 @@ interface Props {
     toolCallRenderer?: ToolCallRenderer;
     emptyState?: ReactNode;
     className?: string;
-    /** 会话 id；传给助手消息的统一上下文。 */
+    /** 传给助手消息的 Markdown 渲染，用于把 MEDIA 行折叠成文件下载卡片。 */
     sessionId?: string;
-    isViewer?: boolean;
-    onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
-    resultFeedbackByEntry?: ReadonlyMap<string, ResultFeedback>;
-    onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
 }
 /**
  * 消息列表：use-stick-to-bottom 自动滚动 + 按轮次分组渲染。
  * 相比第一方版本去掉了轮次导航栏、吸顶状态条与规划摘要卡片。
  */
-export declare function MessageList({ messages, postChatFollowup, onSuggestion, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, emptyState, className, sessionId, isViewer, onFollowupInteraction, resultFeedbackByEntry, onResultFeedbackSaved, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ messages, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, emptyState, className, sessionId, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/embed/entry.d.ts

@@ -39,7 +39,6 @@ declare const BladeAgent: {
     isHiddenInternalMessage: typeof agentClient.isHiddenInternalMessage;
     normalizeMessageContent: typeof agentClient.normalizeMessageContent;
     transformSlashCommand: typeof agentClient.transformSlashCommand;
-    latestPostChatFollowup: typeof agentClient.latestPostChatFollowup;
     DEFAULT_REPLAY_SPEED: agentClient.ReplaySpeed;
     SessionInfo: import("arktype/internal/variants/object.ts").ObjectType<{
         id: string;
@@ -85,7 +84,6 @@ declare const BladeAgent: {
         number: string;
     }, {}>;
     TaskStatus: import("arktype/internal/variants/string.ts").StringType<"done" | "failed" | "in_progress" | "pending" | "skipped", {}>;
-    acceptedPostChatFollowupCompletesLatestRun: typeof agentClient.acceptedPostChatFollowupCompletesLatestRun;
     ClientProjectionBuilder: typeof agentClient.ClientProjectionBuilder;
     createSocket: typeof agentClient.createSocket;
     getChat: typeof getChat;

package/dist/index.d.ts

@@ -7,7 +7,7 @@ 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, FollowupInteractionEvent, } from "./components/ChatView";
+export type { ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, } from "./components/ChatView";
 export { AgentChat } from "./components/AgentChat";
 export type { AgentChatProps } from "./components/AgentChat";
 export { LlmChat } from "./components/LlmChat";