@blade-hq/agent-react 1.2.1-beta.1 → 1.2.1-beta.10

package/README.md

@@ -90,15 +90,22 @@ await session?.send("你好")
 
 - 必须引入 `@blade-hq/agent-react/style.css`。组件自带 `.blade-chat-*` 前缀的自包含样式，宿主没装 Tailwind 也开箱可用；颜色走 CSS 变量，可整体换肤/暗色。
 - `renderers.toolCall` 返回 `null` 时回落到默认工具卡片。
+- **内边距按容器宽度伸缩**，嵌进窄侧栏（300–400px）时会自动收窄，不看浏览器视口。代价是聊天容器需要有确定宽度——放在 flex/grid 里被拉伸，或显式给宽度都可以；放进 `width: fit-content`、`inline-flex` 这类由内容决定宽度的父容器会塌缩。
 
 ## MarkdownContent
 
-单独渲染一段智能体消息 Markdown（含代码复制按钮、XSS 消毒，不支持 raw HTML）：
+单独渲染一段智能体消息 Markdown（含代码复制按钮、XSS 消毒；HTML 经 sanitize 白名单处理，不接受任意 raw HTML）：
 
 ```tsx
 <MarkdownContent content={markdownText} />
 ```
 
+传了 `sessionId` 才会把智能体产出文件的 `MEDIA:` 行折叠成下载卡片（下载要用它）。`ChatView` 内部已经传好，只有单独用 `MarkdownContent` 时需要自己给：
+
+```tsx
+<MarkdownContent sessionId={sessionId}>{markdownText}</MarkdownContent>
+```
+
 ## 选择模型
 
 SDK 的 ChatView / `<blade-chat>` 不内置模型选择器（默认用后端配置的模型）。指定模型有两种方式：

package/dist/components/AssistantTurnBlock.d.ts

@@ -7,10 +7,12 @@ interface Props {
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     sessionStatus?: string;
     toolCallRenderer?: ToolCallRenderer;
+    /** 传给 Markdown 渲染，用于把 MEDIA 行折叠成文件下载卡片。 */
+    sessionId?: string;
 }
 /**
  * 一轮助手回复：按消息顺序渲染 thinking 折叠块、正文 Markdown 与工具调用。
  * 相比第一方版本去掉了紧凑/详细模式切换、文件交付卡片与内联资源 iframe。
  */
-export declare function AssistantTurnBlock({ messages, isStreaming, askAnswers, onAnswer, sessionStatus, toolCallRenderer, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function AssistantTurnBlock({ messages, isStreaming, askAnswers, onAnswer, sessionStatus, toolCallRenderer, sessionId, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

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

package/dist/components/MessageList.d.ts

@@ -10,10 +10,12 @@ interface Props {
     toolCallRenderer?: ToolCallRenderer;
     emptyState?: ReactNode;
     className?: string;
+    /** 传给助手消息的 Markdown 渲染，用于把 MEDIA 行折叠成文件下载卡片。 */
+    sessionId?: string;
 }
 /**
  * 消息列表：use-stick-to-bottom 自动滚动 + 按轮次分组渲染。
  * 相比第一方版本去掉了轮次导航栏、吸顶状态条与规划摘要卡片。
  */
-export declare function MessageList({ messages, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, emptyState, className, }: 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 {};