@blade-hq/agent-react 2612.0.0-beta.28 → 2612.0.0-beta.29

package/dist/chat/AgentLoopBlock.d.ts

@@ -5,9 +5,7 @@ interface Props {
     sessionId: string;
     reasoning?: string;
     hideAskUserQuestions?: boolean;
-    /** 初始展开(工作流步骤卡默认摊开,老 #1841 体验);等待回答仍强制展开。 */
     defaultExpanded?: boolean;
-    /** 自定义卡头描述渲染(工作流用它把 {{ref}} 画成引用胶囊)。 */
     renderDescription?: (description: string) => ReactNode;
 }
 export declare function AgentLoopBlock({ toolCall, sessionId, reasoning, hideAskUserQuestions, defaultExpanded, renderDescription, }: Props): import("react/jsx-runtime").JSX.Element;

package/dist/chat/AssistantTurnBlock.d.ts

@@ -7,14 +7,6 @@ interface Props {
     sessionId: string;
     messages: ChatMessage[];
     isStreaming?: boolean;
-    /**
-     * 打字机式显示节流下，"正文还没播完"跟"思考过程本身有没有说完"是两条
-     * 独立时间线——正文通常比思考过程晚播完很久。"正在思考"/"已思考" 这个
-     * 标签只该看思考过程自己有没有播完，不能被 isStreaming（含正文节流）
-     * 拖着一起等正文播完才翻，否则会出现"正文都在吐字好几秒了，还显示正在
-     * 思考"这种跟视觉进度对不上的观感。不传时按旧行为处理（等价于思考过程
-     * 跟 isStreaming 同步）。
-     */
     isReasoningRevealing?: boolean;
     isLastTurn?: boolean;
     askAnswers?: Record<string, AskUserAnswerData>;

package/dist/chat/AttachmentPreviewDialog.d.ts

@@ -19,7 +19,6 @@ interface Props {
      * token 靠 query 字符串携带，因此也不需要再挂 Authorization header。
      */
     url: string | null;
-    /** text-like 视为"可文本预览"；其他只显示下载按钮。 */
     mode: "markdown" | "text" | "default";
 }
 export declare function AttachmentPreviewDialog({ open, onOpenChange, filename, url, mode }: Props): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/CurrentPlanPanel.d.ts

@@ -1,11 +1,8 @@
 import type { ChatMessage } from "@blade-hq/agent-client/internal";
 export declare function CurrentPlanPanelContent({ messages, running, autoReveal, sessionId, hideTodo, }: {
     messages: ChatMessage[];
-    /** 会话是否还在执行；停止或加载历史时进度里的步骤不再转圈。 */
     running?: boolean;
-    /** 仅当前这次消息变更来自实时成功的 update_plan 时为 true。 */
     autoReveal?: boolean;
-    /** Key the plan block by session so switching sessions resets its local UI state. */
     sessionId?: string;
     hideTodo?: boolean;
 }): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/FileDeliveryCards.d.ts

@@ -5,15 +5,11 @@ export declare function collectDeliveredFiles(toolCalls: ToolCallInfo[], session
     name: string;
 }>;
 export declare function DeliveryCard({ path, name, sessionId, description, displayName, compact, onOpen, onDownloadStarted, onDownloadSucceeded, }: {
-    /** 文件路径：工作目录下的相对路径，或容器内的绝对路径。 */
     path: string;
     name: string;
     sessionId: string;
-    /** 副标题；不传时按扩展名显示「Markdown · AI 生成」这类默认说明。 */
     description?: string;
-    /** 卡片可读名称；下载文件名仍使用 name。 */
     displayName?: string;
-    /** 会话总结使用正文 MEDIA 卡片的紧凑样式。 */
     compact?: boolean;
     onOpen?: () => void;
     onDownloadStarted?: () => void;

package/dist/chat/FinalArtifactCards.d.ts

@@ -3,6 +3,5 @@ import type { FinalArtifact } from "@blade-hq/agent-client/internal";
 export declare function FinalArtifactCards({ artifacts, sessionId, assistantEntryId, }: {
     artifacts: FinalArtifact[];
     sessionId: string;
-    /** 所属回复；交互事件（`onFollowupInteraction`）用它指明是哪一轮的成果。 */
     assistantEntryId: string;
 }): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/LiteMessageList.d.ts

@@ -10,9 +10,7 @@ type TextRow = {
     text: string;
     entryIds: string[];
     failed?: boolean;
-    /** 本轮（含子智能体循环）真实检索到的引用证据，只有 assistant 文本行才有——
-     * 跟 AssistantTurnBlock.tsx 的 turnToolCalls/citations 同一套算法，不然轻量
-     * 模式下 插件引用的 [n] 角标只能停在纯文本，点不开、也 hover 不出来源。 */
+    sending?: boolean;
     citations?: Record<number, CitationEntry>;
 };
 type MemoryRefsRow = {

package/dist/chat/MessageFileAttachmentList.d.ts

@@ -2,11 +2,6 @@ import type { FileContentPart } from "@blade-hq/agent-client/internal";
 interface MessageFileAttachmentListProps {
     files: FileContentPart[];
     className?: string;
-    /**
-     * R6：点击 pill 时的预览回调。不传时 pill 保持纯展示（向后兼容，Home /
-     * ChatDev 等复用点零改动）。调用方自己决定 URL 来源 + 渲染什么（lightbox /
-     * FilePreviewDialog / 下载等）。
-     */
     onPreview?: (file: FileContentPart) => void;
 }
 export declare function MessageFileAttachmentList({ files, className, onPreview, }: MessageFileAttachmentListProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/SessionReplayBar.d.ts

@@ -7,6 +7,5 @@
 export declare function SessionReplayBar({ sessionId, className, onExit, }: {
     sessionId: string;
     className?: string;
-    /** 宿主自己接管了「输入对不上录制内容」的处理时传入：退出要先了结那次待定的决定。 */
     onExit?: () => void;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/chat/TextAttachmentPills.d.ts

@@ -1,9 +1,6 @@
 import type { ParsedTextAttachment } from "@blade-hq/agent-client/internal";
 interface TextAttachmentPillsProps {
     attachments: ParsedTextAttachment[];
-    /**
-     * R6：点击 pill 时的预览回调。不传时保持纯展示（向后兼容）。
-     */
     onPreview?: (attachment: ParsedTextAttachment) => void;
 }
 export declare function TextAttachmentPills({ attachments, onPreview }: TextAttachmentPillsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/TurnNavRail.d.ts

@@ -6,11 +6,8 @@ interface TurnNavRailProps {
     items: TurnNavItem[];
     activeTurnId: string | null;
     onSelectTurn: (turnId: string) => void;
-    /** 正在请求定位的目标；null / 不传表示没有在途定位（开发者列表不传）。 */
     loadingTurnId?: string | null;
-    /** 定位失败提示。 */
     error?: string | null;
-    /** 定位失败的那条发言；重试按钮就再点它一次。 */
     failedTurnId?: string | null;
 }
 export declare function TurnNavRail({ items, activeTurnId, onSelectTurn, loadingTurnId, error, failedTurnId, }: TurnNavRailProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/WorkflowRunBlock.d.ts

@@ -1,7 +1,6 @@
 import type { WorkflowRunEntry } from "@blade-hq/agent-client";
 import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
 interface Props {
-    /** 触发这次运行的 workflow:run 工具调用。 */
     toolCall: ToolCallInfo;
     sessionId: string;
 }
@@ -10,7 +9,6 @@ type StepGroup = {
     desc: string;
     stepId: string;
     stepKind: string;
-    /** 落史的终态(刷新重建时有);实时运行中没有,由运行状态推断。 */
     status?: string;
     logs: string[];
 };

package/dist/chat/ai-elements/shimmer.d.ts

@@ -6,10 +6,6 @@ export interface TextShimmerProps {
     duration?: number;
     spread?: number;
 }
-/**
- * 流式等待时的扫光文字。动画是纯 CSS（`blade-shimmer-sweep`，定义在 chat.css），
- * 不引入动画库。
- */
 declare const ShimmerComponent: ({ children, as: Component, className, duration, spread, }: TextShimmerProps) => import("react/jsx-runtime").JSX.Element;
 export declare const Shimmer: import("react").MemoExoticComponent<typeof ShimmerComponent>;
 export {};

package/dist/chat/message-list-blocks.d.ts

@@ -78,7 +78,6 @@ export declare function selectActiveTurnAtViewportPosition({ visibleTurns, conta
     containerBottom: number;
     fallbackTurnId: string | null;
     currentTurnId?: string | null;
-    /** 滚动容器已到底。 */
     atBottom?: boolean;
 }): string | null;
 /** 测试双通道最终渲染计划时忽略仅影响布局的 wrapper。 */

package/dist/chat/runtime/actions.d.ts

@@ -15,8 +15,7 @@ export interface ChatSendExtras {
     whatif?: SendOptions["whatif"];
     replayDecision?: SendOptions["replayDecision"];
     /**
-     * 声明「会话在跑就把这条消息放进等待队列」。只有渲染了队列面板、能展示等待消息的宿主才该传：
-     * 没有面板时排队等于消息凭空消失。
+     * 默认发送引导消息；显式为 true 时，等待当前运行结束后处理。
      */
     queueWhenRunning?: boolean;
 }

package/dist/chat/runtime/background-task-dismissals.d.ts

@@ -3,7 +3,6 @@ export declare const backgroundTaskDismissals: {
     getState: () => Dismissed;
     subscribe(listener: () => void): () => void;
     dismiss(sessionId: string, taskId: string): void;
-    /** 换身份：清空。 */
     reset(): void;
 };
 export declare function useDismissedBackgroundTasks(sessionId: string): string[];

package/dist/chat/runtime/composer-channels.d.ts

@@ -38,11 +38,8 @@ export declare const composerChannels: {
     clearSendRequests(sessionId: string): void;
     setModelDraft(sessionId: string, model: string): void;
     clearModelDraft(sessionId: string): void;
-    /** 回退到某一步后，把那一步的用户原话放回输入框（null 清除）。 */
     setRewindDraft(sessionId: string, text: string | null): void;
-    /** 会话被关闭 / 删除：清掉它还没被取走的信号。 */
     clearSession(sessionId: string): void;
-    /** 换身份：清空全部通道。 */
     reset(): void;
 };
 export type ComposerChannels = typeof composerChannels;

package/dist/chat/runtime/input-cache-reset.d.ts

@@ -1,8 +1,3 @@
-/**
- * 换身份（登出、换账号、换后端）时清掉富输入按 client 缓存的数据（技能菜单、模型目录等），
- * 新身份不会看到上一个身份的清单。富输入的缓存在这里登记清理函数；宿主在身份变化时调用
- * `resetInputCaches`。放在 internal 入口，宿主调用它不必引入富输入。
- */
 import type { BladeClient } from "@blade-hq/agent-client";
 export declare function onInputCachesReset(client: BladeClient, reset: () => void): () => void;
 export declare function resetInputCaches(client: BladeClient): void;

package/dist/chat/runtime/session-source.d.ts

@@ -1,8 +1,3 @@
-/**
- * 聊天组件读会话状态的来源。组件只认 `AgentSession`，不关心实例由谁持有：
- * 内置 Web 用自己的会话登记表（含静态会话、保留区），SDK 的 ChatView / `<blade-chat>` / 插件
- * 用 `useAgentSession` 持有的那一个实例（`createSingleSessionSource`）。
- */
 import { type AgentSession, type SessionState } from "@blade-hq/agent-client/internal";
 import { type ReactNode } from "react";
 export interface SessionSource {

package/dist/chat/runtime/use-chat-actions.d.ts

@@ -1,7 +1,3 @@
-/**
- * 聊天面板的动作与交互态：发送（等待回答时自动当作作答）、停止（带「停止中」）、等待消息队列命令
- * （冲突提示与进行中的条目）。全部直接作用在会话实例上。
- */
 import type { MessageContent } from "@blade-hq/agent-client/internal";
 import { type ChatSendExtras } from "./actions";
 export declare function useChatActions(sessionId: string): {

package/dist/{chat-OCLOVB3H.css → chat-IHPRU35X.css}

@@ -1,9 +1,3 @@
-/*
- * 聊天组件共用的非 Tailwind 规则（Markdown 排版、入场动画、扫光）。内置 Web 与插件经 agent/style.css
- * 引入这一份；<blade-chat> 与 npm 样式由 scripts/gen-embed-styles.mjs 放进 blade-chat-overrides 层。
- * 只写聊天组件自己用到的规则，页面级补丁不放这里。
- */
-
 [data-theme="light"] .prose-invert {
   --tw-prose-body: hsl(var(--foreground));
   --tw-prose-headings: hsl(var(--foreground));
@@ -25,9 +19,7 @@
   color: hsl(var(--primary));
 }
 
-/* --- chat markdown density: 收紧块间距，避免松散 ---------------- */
-/* typography 插件默认 p/li/heading 外边距偏大（1.25em/0.5em），聊天里读起来太松。
-   plain 选择器特异性高于插件的 :where()，可直接覆盖。 */
+
 .chat-prose p {
   margin-top: 0.5em;
   margin-bottom: 0.5em;
@@ -85,12 +77,7 @@
   margin-bottom: 1.2em;
 }
 
-/* 未闭合的加粗/斜体/行内代码，在闭合符真正到达前先按最终标签
- * 渲染、只用透明度标出"待确认"——内容和标签结构全程不变，闭合符到达后
- * 这条规则自然不再匹配，恢复完全不透明，DOM 节点没有被替换过。这个属性
- * 只由 MarkdownRenderer 引擎自己产出，不区分调用方用的是哪套 prose 外壳
- * （`.chat-prose`/`.prose`/`.lite-chat-markdown`/无外壳），不按外壳类名
- * 逐个补，直接全局生效。 */
+
 [data-markdown-pending="true"] {
   opacity: 0.6;
 }
@@ -108,7 +95,7 @@
   overflow-x: auto;
 }
 
-/* Message entrance animation */
+
 @keyframes msg-in {
   from {
     opacity: 0;
@@ -124,7 +111,7 @@
   animation: msg-in 0.15s ease-out forwards;
 }
 
-/* Running-state sweep, borrowed from deepseek-harness's ReasoningRow. */
+
 .status-sweep::after {
   content: "";
   position: absolute;
@@ -153,7 +140,7 @@
   }
 }
 
-/* 流式等待的扫光文字（ai-elements/shimmer.tsx） */
+
 @keyframes blade-shimmer-sweep {
   from {
     background-position: 100% center;

package/dist/chat.css

@@ -1,9 +1,3 @@
-/*
- * 聊天组件共用的非 Tailwind 规则（Markdown 排版、入场动画、扫光）。内置 Web 与插件经 agent/style.css
- * 引入这一份；<blade-chat> 与 npm 样式由 scripts/gen-embed-styles.mjs 放进 blade-chat-overrides 层。
- * 只写聊天组件自己用到的规则，页面级补丁不放这里。
- */
-
 [data-theme="light"] .prose-invert {
   --tw-prose-body: hsl(var(--foreground));
   --tw-prose-headings: hsl(var(--foreground));
@@ -25,9 +19,7 @@
   color: hsl(var(--primary));
 }
 
-/* --- chat markdown density: 收紧块间距，避免松散 ---------------- */
-/* typography 插件默认 p/li/heading 外边距偏大（1.25em/0.5em），聊天里读起来太松。
-   plain 选择器特异性高于插件的 :where()，可直接覆盖。 */
+
 .chat-prose p {
   margin-top: 0.5em;
   margin-bottom: 0.5em;
@@ -85,12 +77,7 @@
   margin-bottom: 1.2em;
 }
 
-/* 未闭合的加粗/斜体/行内代码，在闭合符真正到达前先按最终标签
- * 渲染、只用透明度标出"待确认"——内容和标签结构全程不变，闭合符到达后
- * 这条规则自然不再匹配，恢复完全不透明，DOM 节点没有被替换过。这个属性
- * 只由 MarkdownRenderer 引擎自己产出，不区分调用方用的是哪套 prose 外壳
- * （`.chat-prose`/`.prose`/`.lite-chat-markdown`/无外壳），不按外壳类名
- * 逐个补，直接全局生效。 */
+
 [data-markdown-pending="true"] {
   opacity: 0.6;
 }
@@ -108,7 +95,7 @@
   overflow-x: auto;
 }
 
-/* Message entrance animation */
+
 @keyframes msg-in {
   from {
     opacity: 0;
@@ -124,7 +111,7 @@
   animation: msg-in 0.15s ease-out forwards;
 }
 
-/* Running-state sweep, borrowed from deepseek-harness's ReasoningRow. */
+
 .status-sweep::after {
   content: "";
   position: absolute;
@@ -153,7 +140,7 @@
   }
 }
 
-/* 流式等待的扫光文字（ai-elements/shimmer.tsx） */
+
 @keyframes blade-shimmer-sweep {
   from {
     background-position: 100% center;