@blade-hq/agent-react 2612.0.0-beta.0 → 2612.0.0-beta.2

package/dist/chat/customization.d.ts

@@ -0,0 +1,214 @@
+import { type ComponentType, type ReactNode } from "react";
+import type { ChatMessage, MessageContent, ToolCallInfo } from "@blade-hq/agent-client/internal";
+import type { ContentBlock } from "@blade-hq/agent-client/internal";
+import type { AskUserAnswerData, AskUserQuestionData } from "./AskUserQuestionBlock";
+import type { PlanUpdateData } from "../components/PlanUpdateBlock";
+import type { ChatSendExtras } from "./runtime/actions";
+import type { ErrorChatMessage, UserChatMessage } from "./UserMessageBubble";
+export type ChatViewClassNames = Partial<{
+    root: string;
+    viewerBanner: string;
+    messageListRoot: string;
+    messageListViewport: string;
+    messageListContent: string;
+    messageListInner: string;
+    emptyState: string;
+    userMessage: string;
+    errorMessage: string;
+    assistantTurn: string;
+    assistantText: string;
+    toolCall: string;
+    chatInputRoot: string;
+    chatInputInner: string;
+    /**
+     * 队列面板根节点。软件工厂把输入框根节点的左右内边距改成了 px-10! / px-2!，
+     * 面板必须跟着同一个值，否则两者相接的那条缝上会一边宽一边窄。在这里重设
+     * `--blade-chat-queue-gutter` 即可（面板默认值对应 px-5）。
+     */
+    queuePanelRoot: string;
+    skillStatusBarRoot: string;
+    skillStatusBarInner: string;
+}>;
+/** 输入框提交时的附加项（模型、推理档位、知识库等由富输入给出）。 */
+export interface ChatSendOptions extends Pick<ChatSendExtras, "thinkingOverride" | "reasoningLevel" | "kbIds" | "queueWhenRunning"> {
+    /** 附件实际上传到的会话（首页新建会话时由输入框给出）。 */
+    targetSessionId?: string;
+    /** 本条消息用的模型；null 表示沿用会话已保存的模型。 */
+    model?: string | null;
+}
+/**
+ * 输入框（Composer）的 props 契约：聊天面板传给输入框的全部内容。
+ * 轻输入（SDK 默认）只用其中一部分；富输入（`@blade-hq/agent-react/rich-input`）用全部。
+ * 自定义实现只需取用其中关心的字段，其余忽略即可。
+ */
+export interface ComposerProps {
+    /** 当前会话；轻输入据此接住 `AgentSession.insertText` / `attach`。 */
+    sessionId?: string;
+    onSend: (message: MessageContent, options?: ChatSendOptions) => boolean | Promise<boolean>;
+    onStop: () => void | Promise<void>;
+    isStreaming: boolean;
+    /** 宿主是否渲染了队列面板；没有面板时不给"运行中提交"入口。 */
+    queueWhileRunning?: boolean;
+    isCompacting?: boolean;
+    isStopping?: boolean;
+    mode?: "planning" | "executing";
+    onToggleMode?: () => void;
+    renderAttachments?: () => ReactNode;
+    onBeforeSend?: (content: MessageContent) => MessageContent | Promise<MessageContent>;
+    onCommand?: (commandId: string) => void | Promise<void>;
+    canCreateBoardTask?: boolean;
+    canShareSession?: boolean;
+    /** 输入框顶部的任务进度面板（与输入框共用边框）。 */
+    planPanel?: ReactNode;
+    /** 内层最大宽度的 Tailwind 类，默认 `max-w-3xl`。 */
+    maxWidthClassName?: string;
+    /** 上方紧贴着队列面板时置 true：上两角改成直角。 */
+    mergesWithPanelAbove?: boolean;
+    className?: string;
+    innerClassName?: string;
+    SkillStatusBarComponent?: ComponentType<SkillStatusBarComponentProps>;
+    skillStatusBarClassName?: string;
+    skillStatusBarInnerClassName?: string;
+    onResyncSkills?: () => void;
+    isResyncingSkills?: boolean;
+    onOpenSkills?: () => void;
+    inputLabel?: string;
+    placeholderText?: string;
+    onDoubleEscape?: (anchorRect: DOMRect | null) => void;
+    composerHint?: ReactNode;
+    statusBarAddon?: ReactNode;
+    slotBelowActions?: ReactNode;
+    initialDraft?: string;
+    initialDraftKey?: string;
+    /** 精简附加控件（精简渲染模式）。 */
+    lite?: boolean;
+}
+export interface ChatViewComponents {
+    EmptyState?: ComponentType;
+    UserMessage?: ComponentType<{
+        message: UserChatMessage;
+        className?: string;
+    }>;
+    ErrorMessage?: ComponentType<{
+        message: ErrorChatMessage;
+        className?: string;
+    }>;
+    AssistantTurn?: ComponentType<AssistantTurnComponentProps>;
+    ToolCall?: ComponentType<ToolCallComponentProps>;
+    SkillStatusBar?: ComponentType<SkillStatusBarComponentProps>;
+    /** 自定义输入框；不传时使用默认的 ChatInput。 */
+    Composer?: ComponentType<ComposerProps>;
+}
+/** 工具调用渲染器：返回 null 走默认渲染。 */
+export type ToolCallRenderer = (info: ToolCallInfo) => ReactNode | null;
+/** 用户消息渲染器：`message` 是投影层给出的用户消息。 */
+export interface UserMessageRendererProps {
+    message: ChatMessage;
+}
+/** 助手正文渲染器：`compact` 为真时正文在执行过程里，字号更小。 */
+export interface AssistantTextRendererProps {
+    message: ChatMessage;
+    streaming: boolean;
+    compact: boolean;
+    sessionId?: string;
+}
+/** 提问卡渲染器：字段与 `AskUserQuestionBlock` 的 props 一致。 */
+export interface AskUserQuestionRendererProps {
+    data: AskUserQuestionData;
+    answered: boolean;
+    toolCallId: string;
+    sessionStatus: string;
+    answerData?: AskUserAnswerData;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+}
+/** 计划面板渲染器：`plan` 是最近一次成功的 update_plan 解析结果。 */
+export interface PlanUpdateRendererProps {
+    plan: PlanUpdateData;
+    running: boolean;
+    sessionId?: string;
+}
+/**
+ * 区块级渲染器：每个都返回 `ReactNode`，返回 `null` 走默认渲染。`tool` 按工具名替换工具卡的展开详情。
+ */
+export interface ChatViewRenderers {
+    /** 按工具名替换展开后的详情（内置 Web 的专用工具渲染器用它）。 */
+    tool?: Record<string, ComponentType<ToolRendererProps>>;
+    /** 自定义工具调用渲染；返回 null 走默认渲染。 */
+    toolCall?: ToolCallRenderer;
+    /** 自定义用户消息渲染；返回 null 走默认渲染。 */
+    userMessage?: (props: UserMessageRendererProps) => ReactNode | null;
+    /** 自定义助手正文渲染；返回 null 走默认渲染。 */
+    assistantText?: (props: AssistantTextRendererProps) => ReactNode | null;
+    /** 自定义提问卡渲染；返回 null 走默认渲染。 */
+    askUserQuestion?: (props: AskUserQuestionRendererProps) => ReactNode | null;
+    /** 自定义计划面板渲染；返回 null 走默认渲染。 */
+    planUpdate?: (props: PlanUpdateRendererProps) => ReactNode | null;
+}
+export interface ChatViewCustomization {
+    classNames?: ChatViewClassNames;
+    components?: ChatViewComponents;
+    renderers?: ChatViewRenderers;
+}
+export interface AssistantTurnComponentProps {
+    turnKey: string;
+    sessionId: string;
+    messages: ChatMessage[];
+    isStreaming?: boolean;
+    /** 打字机式显示节流下思考过程自己的追平状态，跟 isStreaming 不是一回事。 */
+    isReasoningRevealing?: boolean;
+    isLastTurn?: boolean;
+    askAnswers?: Record<string, AskUserAnswerData>;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+    sessionStatus?: string;
+    level?: 1 | 2;
+    forceExpanded?: boolean;
+    customization?: ChatViewCustomization;
+}
+export interface ToolCallComponentProps {
+    toolCall: ToolCallInfo;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+    answered?: boolean;
+    answerData?: AskUserAnswerData;
+    sessionId?: string;
+    sessionStatus?: string;
+    level?: 1 | 2;
+    turnBlocks?: ContentBlock[];
+    reasoning?: string;
+    customization?: ChatViewCustomization;
+}
+export interface ToolRendererProps {
+    toolCall: ToolCallInfo;
+    sessionId?: string;
+}
+export interface SkillStatusBarComponentProps {
+    sessionId: string;
+    onResync?: () => void;
+    isResyncing?: boolean;
+    vertical?: boolean;
+    className?: string;
+    innerClassName?: string;
+    /** 打开技能页；只作用于「已安装 N 个技能」这一条。 */
+    onOpenSkills?: () => void;
+}
+export declare function renderOptionalComponent<TProps extends object>(Component: ComponentType<TProps> | undefined, props: TProps): ReactNode;
+/** 聊天面板的定制（classNames / components / renderers），叶子组件不用逐层透传。 */
+export declare const ChatCustomizationProvider: import("react").Provider<ChatViewCustomization | undefined>;
+export declare function useChatCustomization(): ChatViewCustomization | undefined;
+/** 聊天区的自定义区域。 */
+export interface ChatViewSlots {
+    /** 消息列表上方的自定义区域。 */
+    header?: ReactNode;
+    /** 无消息时的空状态。 */
+    emptyState?: ReactNode;
+    /** 输入框下方的自定义区域。 */
+    footer?: ReactNode;
+}
+/** 智能体模式与纯 LLM 模式共用的外观属性。 */
+export interface ChatPresentationProps {
+    classNames?: ChatViewClassNames;
+    renderers?: ChatViewRenderers;
+    slots?: ChatViewSlots;
+    placeholder?: string;
+    /** 配色主题，默认浅色。宿主已经在祖先元素上写了 data-theme 时不用传。 */
+    theme?: "light" | "dark";
+}

package/dist/chat/display-utils.d.ts

@@ -0,0 +1,48 @@
+import type { ChatMessage, ToolCallInfo } from "@blade-hq/agent-client/internal";
+/** 工具调用的状态语气。用语义命名而不是颜色名——颜色由设计令牌决定，见仓库根 DESIGN.md。 */
+export type ToolTone = "done" | "running" | "awaiting" | "failed";
+export interface ToolSummaryTag {
+    key: string;
+    label: string;
+    /** file = 产出了文件，action = 执行了一个动作。决定 chip 是否带文件图标。 */
+    tone: "file" | "action";
+}
+export declare function getToolDescription(toolCall: ToolCallInfo): string | null;
+/**
+ * 技能入口文件的所在目录就是技能名（`.agent/skills/<技能名>/SKILL.md`）。
+ * 只显示 "SKILL.md" 用户看不出读的是哪个技能。
+ *
+ * 改这里必须同步 packages/agent-react/src/components/display-utils.ts 的同名函数。
+ */
+export declare function getSkillNameFromFilePath(filePath: string | null | undefined): string | null;
+/** 文件的展示名：技能入口文件显示技能名，其余显示文件名。 */
+export declare function formatToolFileName(filePath: string): string;
+export declare function formatToolName(name: string): string;
+/**
+ * Returns a context-aware Chinese display label for a tool call.
+ * All system tools now have a `description` argument — use it as primary label.
+ */
+export declare function getToolDisplayLabel(toolCall: ToolCallInfo): string;
+export declare function getToolTone(status?: ToolCallInfo["status"]): ToolTone;
+export declare function getToolStatusLabel(status?: ToolCallInfo["status"]): string;
+export declare function extractToolFilePath(toolCall: ToolCallInfo): string | null;
+/** 从文件类工具参数中提取全部可定位的文件路径（按出现顺序去重）。 */
+export declare function extractToolFilePaths(toolCall: ToolCallInfo): string[];
+export declare function getToolOutputTag(toolCall: ToolCallInfo): ToolSummaryTag | null;
+export declare function isSuccessfulToolCall(toolCall: ToolCallInfo): boolean;
+export declare function countSuccessfulToolCalls(toolCalls: ToolCallInfo[]): number;
+export declare function countPendingToolCalls(toolCalls: ToolCallInfo[]): number;
+export declare function formatToolCallCount(count: number): string;
+export declare function summarizeToolCalls(toolCalls: ToolCallInfo[]): ToolSummaryTag[];
+export declare function hasNaturalLanguageText(message: ChatMessage): boolean;
+export declare function findAnchorMessageIndex(messages: ChatMessage[]): number;
+export declare function getCollapsedTurnSegments(messages: ChatMessage[]): {
+    anchorIndex: number;
+    summaryMessages: ChatMessage[];
+    visibleMessages: ChatMessage[];
+};
+export declare function getLatestPendingToolName(toolCalls: ToolCallInfo[]): string | null;
+export declare function getFinishTaskTitle(toolCalls: ToolCallInfo[]): string | null;
+export declare function getTextContentSegments(messages: ChatMessage[]): string[];
+export declare function getLastTextSegment(messages: ChatMessage[]): string;
+export declare function countMessageLines(message: ChatMessage): number;

package/dist/{components/PostChatFollowupBlock.d.ts → chat/followup-interaction.d.ts}

@@ -1,4 +1,5 @@
-import type { FinalArtifact, PostChatFollowup, ResultFeedback as SavedResultFeedback, ResultFeedbackReason } from "@blade-hq/agent-client";
+import type { FinalArtifact, ResultFeedbackReason } from "@blade-hq/agent-client/internal";
+/** 跟进建议、成果与结果评分的交互事件（宿主用来做埋点；SDK 不绑定任何分析厂商）。 */
 export type FollowupInteractionEvent = {
     type: "suggestions_shown";
     sessionId?: string;
@@ -45,19 +46,6 @@ export type FollowupInteractionEvent = {
     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, className, suggestionClassName, }: {
-    followup: PostChatFollowup;
-    sessionId?: string;
-    onSuggestion?: (value: string) => void;
-    isViewer?: boolean;
-    onInteraction?: (event: FollowupInteractionEvent) => void;
-    savedFeedback?: SavedResultFeedback;
-    onFeedbackSaved?: (feedback: SavedResultFeedback) => void;
-    /** 追加到跟进区根节点的类（`ChatViewClassNames.followup`）。 */
-    className?: string;
-    /** 追加到每个「下一步」建议按钮的类（`ChatViewClassNames.followupAction`）。 */
-    suggestionClassName?: string;
-}): import("react/jsx-runtime").JSX.Element | null;
+export declare const FollowupInteractionProvider: import("react").Provider<((event: FollowupInteractionEvent) => void) | undefined>;
+/** 发出交互事件；宿主回调抛错不影响用户的点击或下载。 */
+export declare function useFollowupInteraction(): (event: FollowupInteractionEvent) => void;

package/dist/chat/index.d.ts

@@ -0,0 +1,100 @@
+export { AgentLoopBlock } from "./AgentLoopBlock";
+export { AskUserQuestionBlock, parseAskUserQuestion, parseAskUserQuestionError } from "./AskUserQuestionBlock";
+export type { AskUserQuestionData, AskUserQuestionError, AskUserAnswerData } from "./AskUserQuestionBlock";
+export { defaultTurnDisplayMode, resolveTurnDisplayMode, formatExecutionDuration, getExecutionDurationMs, AssistantTurnBlock, collectMemoryRefs, MemoryRefsHint } from "./AssistantTurnBlock";
+export type { TurnDisplayMode } from "./AssistantTurnBlock";
+export { AttachmentPreviewDialog } from "./AttachmentPreviewDialog";
+export { nextQueuedOrder, ChatPanel } from "./ChatPanel";
+export type { ChatPanelProps } from "./ChatPanel";
+export { CompactionCard } from "./CompactionCard";
+export { ConnectionBanner } from "./ConnectionBanner";
+export { CurrentPlanPanelContent, CurrentPlanPanel } from "./CurrentPlanPanel";
+export { collectDeliveredFiles, DeliveryCard, FileDeliveryCards } from "./FileDeliveryCards";
+export { FinalArtifactCards } from "./FinalArtifactCards";
+export { ImageLightbox } from "./ImageLightbox";
+export { LightComposer } from "./LightComposer";
+export { buildLiteRows, LiteMessageList } from "./LiteMessageList";
+export { MessageActions } from "./MessageActions";
+export { MessageContextPills } from "./MessageContextPills";
+export { MessageFileAttachmentList } from "./MessageFileAttachmentList";
+export { MessageList } from "./MessageList";
+export type { MessageListProps } from "./MessageList";
+export { PostChatFollowupBlock } from "./PostChatFollowupBlock";
+export { RenderErrorBoundary } from "./RenderErrorBoundary";
+export { HistoricalResultFeedback, ResultFeedback } from "./ResultFeedback";
+export { SessionReplayBar } from "./SessionReplayBar";
+export { TextAttachmentPills } from "./TextAttachmentPills";
+export { getFilePreviewName, ToolFilePreviewAction, ToolPreviewAction, resolveAskQuestionState, ToolCallBlock } from "./ToolCallBlock";
+export { ToolUiCard } from "./ToolUiCard";
+export { TurnNavRail } from "./TurnNavRail";
+export type { TurnNavItem } from "./TurnNavRail";
+export { isUserMessage, isErrorMessage, USER_MESSAGE_MARKDOWN_CLASS, UserMessageBubble, ErrorMessageBlock } from "./UserMessageBubble";
+export type { UserChatMessage, ErrorChatMessage } from "./UserMessageBubble";
+export { WorkflowRunBlock } from "./WorkflowRunBlock";
+export { useReasoning, Reasoning, ReasoningTrigger, ReasoningContent, ThinkingBadge } from "./ai-elements/reasoning";
+export type { ReasoningProps, ReasoningTriggerProps, ReasoningContentProps, ThinkingBadgeProps } from "./ai-elements/reasoning";
+export { Shimmer } from "./ai-elements/shimmer";
+export type { TextShimmerProps } from "./ai-elements/shimmer";
+export { collectTurnMessages, getPersistentAskUserQuestions, toolCallAnswered } from "./assistant-turn-questions";
+export { CardContext, useCardContext } from "./card/CardContext";
+export type { CardContextValue } from "./card/CardContext";
+export { chatTone } from "./chat-theme";
+export type { ChatTone } from "./chat-theme";
+export { renderOptionalComponent, ChatCustomizationProvider, useChatCustomization } from "./customization";
+export type { ChatViewClassNames, ChatSendOptions, ComposerProps, ChatViewComponents, ToolCallRenderer, UserMessageRendererProps, AssistantTextRendererProps, AskUserQuestionRendererProps, PlanUpdateRendererProps, ChatViewRenderers, ChatViewCustomization, AssistantTurnComponentProps, ToolCallComponentProps, ToolRendererProps, SkillStatusBarComponentProps, ChatViewSlots, ChatPresentationProps } from "./customization";
+export { getToolDescription, getSkillNameFromFilePath, formatToolFileName, formatToolName, getToolDisplayLabel, getToolTone, getToolStatusLabel, extractToolFilePath, extractToolFilePaths, getToolOutputTag, isSuccessfulToolCall, countSuccessfulToolCalls, countPendingToolCalls, formatToolCallCount, summarizeToolCalls, hasNaturalLanguageText, findAnchorMessageIndex, getCollapsedTurnSegments, getLatestPendingToolName, getFinishTaskTitle, getTextContentSegments, getLastTextSegment, countMessageLines } from "./display-utils";
+export type { ToolTone, ToolSummaryTag } from "./display-utils";
+export { FollowupInteractionProvider, useFollowupInteraction } from "./followup-interaction";
+export type { FollowupInteractionEvent } from "./followup-interaction";
+export { buildCitationsFromToolCalls } from "./lib/citations";
+export type { CitationEntry } from "./lib/citations";
+export { SUPPORTED_LANGUAGES, normalizeCodeLanguage, getCodeLanguageFromFilename } from "./lib/code-language";
+export type { SupportedCodeLanguage } from "./lib/code-language";
+export { LOOPBACK_HOSTS, isLoopbackUrl, openInSessionSandboxBrowser, rewriteForSandboxBrowser } from "./lib/loopback";
+export { resolveSessionMarkdownAssetUrl } from "./lib/markdown-asset-url";
+export { isImageFilename, isTextFilename, dispatchPreview } from "./lib/preview-dispatch";
+export type { PreviewKind, PreviewDescriptor } from "./lib/preview-dispatch";
+export { isUiMeta, resolveBrowserResourceUri } from "./lib/ui-meta";
+export type { UiMeta } from "./lib/ui-meta";
+export { useAsyncValue } from "./lib/use-async-value";
+export { ExternalAnchor } from "./markdown/ExternalAnchor";
+export { resolveCollapsedContent, collapseInlineToolCalls, injectCitationRefs, MarkdownContent, normalizeAdjacentUrlFormatting } from "./markdown/MarkdownContent";
+export type { MarkdownContentProps } from "./markdown/MarkdownContent";
+export { findCodeRanges, stripSystemReminders } from "./markdown/text";
+export { RECENT_RESIDENT_TURNS, shouldAppendPendingAssistantTurn, buildMessageListBlocks, getRenderBlockPersistentId, startIndexOfLastNCompleteTurns, findStablePrefixEnd, latestUserSpeechEntryId, buildMessageListBlockIndexes, NAV_AT_BOTTOM_EPSILON_PX, selectActiveTurnAtViewportPosition, snapshotMessageListRenderPlan } from "./message-list-blocks";
+export type { AssistantTurnRenderBlock, RenderBlock, VisibleTurnRect } from "./message-list-blocks";
+export { PlanSummaryCard } from "./plan/PlanSummaryCard";
+export { extractLatestPlanMessages, extractPlanMessagesForTurn } from "./plan/extract-plan-messages";
+export { parsePlanMessages } from "./plan/parse-plan-messages";
+export { parsePlanTree, applyPlanStatusesById, parsePlanTreeResult } from "./plan/parse-plan-tree";
+export type { PlanStatusMap } from "./plan/parse-plan-tree";
+export type { SkillInfo, SkillCatalogItem, PlanNode, Phase, PlanData } from "./plan/types";
+export { findLatestReasoningMessageIndex } from "./reasoning-visibility";
+export { buildPendingAskUserAnswer, sendToSession } from "./runtime/actions";
+export type { ChatSendExtras } from "./runtime/actions";
+export { composerChannels, useComposerChannels } from "./runtime/composer-channels";
+export type { PendingContextSignal, DraftAppendSignal, SendRequestSignal, ComposerChannelsState, ComposerChannels } from "./runtime/composer-channels";
+export { ChatEnvironmentProvider, useChatEnvironment, useHighlightedCode, useChatSessionDetail, useHideTodo, useChatRenderMode, notifyChat, useComposerBridge, useChatVirtualizer } from "./runtime/environment";
+export type { ChatRenderMode, ChatVirtualItem, ChatVirtualizer, ChatVirtualizerOptions, UseChatVirtualizer, ChatCodeProps, DeveloperMessageListProps, ChatEnvironment } from "./runtime/environment";
+export { SessionSourceProvider, useSessionSource, useSingleSessionSource, useSessionHandle, useSessionState, useIsSessionHistoryLoading, usePlanRevealRevision, CurrentChatSessionProvider, useCurrentChatSessionId } from "./runtime/session-source";
+export type { SessionSource } from "./runtime/session-source";
+export { useChatActions } from "./runtime/use-chat-actions";
+export { useSessionReplay } from "./runtime/use-session-replay";
+export type { UseSessionReplayResult } from "./runtime/use-session-replay";
+export { ENTRY_SCROLL_MARGIN_PX, calculateStickyAwareMargin, normalizeScrollEntryKey, calculateAnchoredScrollTop, calculateTrailingSpacerHeight, PIN_HANDOVER_TOLERANCE_PX, shouldHandOverToFollow, NEW_TURN_SCROLL_DURATION_MS, NEW_TURN_SCROLL_MIN_DISTANCE_PX, NEW_TURN_SCROLL_MAX_SCREENS, MANUAL_SCROLL_TOLERANCE_PX, shouldAnimateNewTurnScroll, calculateAnimatedScrollTop } from "./scroll-anchor";
+export { BashRenderer } from "./tool-renderers/BashRenderer";
+export { FileEditRenderer } from "./tool-renderers/FileEditRenderer";
+export { FileReadRenderer } from "./tool-renderers/FileReadRenderer";
+export { KbSearchRenderer } from "./tool-renderers/KbSearchRenderer";
+export { SearchRenderer } from "./tool-renderers/SearchRenderer";
+export { SubmitResultRenderer } from "./tool-renderers/SubmitResultRenderer";
+export { parseKbSearchResult, formatKbSearchLabel } from "./tool-renderers/kb-search-result";
+export type { KbSearchHit, KbSearchResult } from "./tool-renderers/kb-search-result";
+export { getRenderer } from "./tool-renderers/registry";
+export { getResultText, getResultImages, parseJsonValue, isPlainObject, getStringValue, getNumberValue, getBooleanValue, extractErrorMessage, getFileName, getCodeLanguage, formatBytes, CodePreview } from "./tool-renderers/shared";
+export { shouldFollowWritePreview, scrollWritePreviewToLatest } from "./tool-renderers/write-preview-scroll";
+export { skillDisplayName } from "./lib/skill-name";
+export { type ConnectorComputerSectionProps, type InputConnection, type InputDataState, type InputKnowledgeBase, type InputModelCatalog, type InputModelOption, type InputModelPreferences, type InputSessionSkill, type InputSkillStats, type RichInputServices, parseModelReasoningLevels, RichInputServicesProvider, useRichInputServices, } from "./runtime/input-services";
+export { backgroundTaskDismissals, useDismissedBackgroundTasks } from "./runtime/background-task-dismissals";
+export { visibleSkillIds, visibleSkills } from "./lib/skill-visibility";
+export { resetInputCaches } from "./runtime/input-cache-reset";

package/dist/chat/lib/citations.d.ts

@@ -0,0 +1,30 @@
+import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
+/** 一条可点击引用的完整证据：从 kb_search 工具结果的 hit 原样带过来。 */
+export interface CitationEntry {
+    n: number;
+    kbName: string;
+    title: string;
+    path: string;
+    page: number | null;
+    heading: string | null;
+    text: string;
+    previewUrl: string | null;
+}
+/**
+ * 从一轮里的工具调用抽取可引用证据。规则：
+ * - 只认成功完成的 kb_search 调用（其余工具、失败/进行中的调用都不构成可引用证据）。
+ * - 汇总本轮全部 kb_search 调用的命中，不只看最后一次。后端（见
+ *   `knowledge_base.py build_search_tool_output` 的 `start_index`、
+ *   `EngineSkillMixin.allocate_kb_citation_range`）保证本轮内多次 kb_search
+ *   调用的编号连续递增、不重叠、不归零，所以回答里的每个 `[n]` 在这一轮里
+ *   本该全局唯一，直接汇总即可，不用再靠"只用最后一次"去猜模型引用的是哪次。
+ * - 但前端不信任协议 100% 不出错：万一后端真出现同一个编号在不同调用间指向
+ *   不同证据的异常情况，这里依然按"冲突就剔除"处理——发现冲突直接从返回的
+ *   map 里删掉这个编号，而不是用后来者覆盖前者，避免一旦协议出岔子就退回到
+ *   "看起来能点、点开却是错的文档"这个原始 bug。正常情况下这段防御代码不会
+ *   被触发。
+ *
+ * 返回的 map 只包含真的有证据支撑、且没有歧义的编号——`[n]` 是否可点全靠这个
+ * map 里有没有对应的 key，不额外维护一个"允许列表"，避免两处状态不同步。
+ */
+export declare function buildCitationsFromToolCalls(toolCalls: ToolCallInfo[] | null | undefined): Record<number, CitationEntry>;

package/dist/chat/lib/code-language.d.ts

@@ -0,0 +1,5 @@
+/** 代码块语言名 / 文件扩展名到高亮语言的映射（高亮本身由宿主注入，见 runtime/environment）。 */
+export declare const SUPPORTED_LANGUAGES: readonly ["python", "javascript", "typescript", "tsx", "jsx", "yaml", "markdown", "bash", "json", "go", "rust", "css", "html"];
+export type SupportedCodeLanguage = (typeof SUPPORTED_LANGUAGES)[number];
+export declare function normalizeCodeLanguage(language?: string | null): SupportedCodeLanguage | null;
+export declare function getCodeLanguageFromFilename(filePath?: string | null): SupportedCodeLanguage | null;

package/dist/chat/lib/loopback.d.ts

@@ -0,0 +1,8 @@
+/** 本机地址（沙盒里的服务在浏览器看来是 localhost）。 */
+export declare const LOOPBACK_HOSTS: ReadonlySet<string>;
+export declare function isLoopbackUrl(rawUrl: string): boolean;
+export declare function rewriteForSandboxBrowser(rawUrl: string): string;
+/** 在会话的沙盒浏览器里新开一个标签打开本机地址（沙盒里的服务只有沙盒浏览器访问得到）。 */
+export declare function openInSessionSandboxBrowser(client: {
+    json: (method: "POST", path: string, body: unknown) => Promise<unknown>;
+}, sessionId: string, url: string): Promise<void>;

package/dist/chat/lib/markdown-asset-url.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 把 Markdown 里的相对图片地址解析成会话工作区文件地址：有所在文件时相对它，聊天消息相对工作区根目录。
+ * `buildAuthedUrl` 给地址补上鉴权（BladeClient.buildAuthedUrl）。
+ */
+export declare function resolveSessionMarkdownAssetUrl(rawSrc: string, sessionId: string | null | undefined, baseFilePath: string | undefined, buildAuthedUrl: (path: string) => string): string;

package/dist/chat/lib/preview-dispatch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 按文件扩展名决定预览渲染方式（R6）。
+ *
+ * 为什么按扩展名不按 MIME：当前消息 schema 里 FileContentPart / TextAttachment
+ * 都只存 `name` + `uploadedPath`，没有 mime_type（见 design.md §3.6）。
+ * 改 schema 面太大，扩展名在实际数据里足够稳定（前端上传时就是文件名）。
+ *
+ * 动图（.gif/.webp/.apng/.avif）归为 image，因为浏览器 `<img>` 原生播放。
+ * video 类扩展名本期不覆盖（见 design.md §3.6 决策："只动图，不视频"）。
+ */
+export type PreviewKind = "image" | "text" | "default";
+export interface PreviewDescriptor {
+    kind: PreviewKind;
+    filename: string;
+    url: string;
+}
+/**
+ * 判断扩展名能不能用 `<img>` 预览（含动图）。
+ * 独立导出是为了让调用方可以在不走完整 dispatchPreview 的场景（如 UserMessageBubble
+ * 已经在 render 时把图片渲染成 <img>，不需要再走 kind 分派）直接查一次。
+ */
+export declare function isImageFilename(filename: string): boolean;
+export declare function isTextFilename(filename: string): boolean;
+export declare function dispatchPreview(filename: string, url: string): PreviewDescriptor;

package/dist/chat/lib/skill-name.d.ts

@@ -0,0 +1,9 @@
+type SkillDisplayTarget = {
+    skill_id?: string | null;
+    display_name?: string | null;
+    skillId?: string | null;
+    displayName?: string | null;
+};
+/** 技能的展示名：有业务名用业务名，否则用技能 id。 */
+export declare function skillDisplayName(skill: SkillDisplayTarget): string;
+export {};

package/dist/chat/lib/skill-visibility.d.ts

@@ -0,0 +1,8 @@
+import type { ChatRenderMode as RenderMode } from "../runtime/environment";
+export declare function visibleSkills<T extends {
+    builtin?: boolean;
+}>(skills: T[], mode: RenderMode): T[];
+export declare function visibleSkillIds(ids: readonly string[], catalog: readonly {
+    skill_id: string;
+    builtin?: boolean;
+}[] | undefined, mode: RenderMode): string[];

package/dist/chat/lib/ui-meta.d.ts

@@ -0,0 +1,5 @@
+import { type ToolUiCard } from "@blade-hq/agent-client/internal";
+export type UiMeta = ToolUiCard;
+export declare const isUiMeta: (value: unknown) => value is UiMeta;
+/** 工具界面给的本机地址换成当前页面的主机名（沙盒端口经同一主机访问）。 */
+export declare function resolveBrowserResourceUri(value: string, browserHostname?: string): string;

package/dist/chat/lib/use-async-value.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 按 key 异步取一个值（聊天组件里零星的文件读取用，不引入请求缓存库）。
+ * key 变化或卸载时中止在途请求；过期结果不写回。
+ */
+export declare function useAsyncValue<T>(key: string | null, load: (signal: AbortSignal) => Promise<T>): {
+    data: T | undefined;
+    error: Error | null;
+};

package/dist/chat/markdown/ExternalAnchor.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentPropsWithRef } from "react";
+type AnchorProps = ComponentPropsWithRef<"a">;
+/** 链接一律新窗口打开并断开 opener，SDK 不接管站内跳转。
+ * 页内锚点（脚注引用/回链这类 `href="#fn-note"`）不能套"新窗口打开"这套
+ * 逻辑——新开一个标签页访问 `#片段` 只是把整篇文档重新打开一次，不是
+ * 滚动到页内位置，会破坏脚注的跳转体验。只有真正的外部链接才需要新窗口
+ * + 断开 opener。*/
+export declare function ExternalAnchor({ children, href, ...props }: AnchorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/chat/markdown/MarkdownContent.d.ts

@@ -0,0 +1,40 @@
+import { type MarkdownRendererProps } from "../../components/markdown";
+import { normalizeAdjacentUrlFormatting } from "./text";
+import type { CitationEntry } from "../lib/citations";
+export { normalizeAdjacentUrlFormatting };
+export declare function resolveCollapsedContent({ dataKeyAttribute, dataRawAttribute, children, }: {
+    dataKeyAttribute?: string;
+    dataRawAttribute?: string;
+    children?: unknown;
+}): string;
+export declare function collapseInlineToolCalls(children: string): string;
+/** `[n]` 形式的引用角标，只有在 `citations` 里能查到 n 对应的证据时才替换成可交互标签
+ * `<blade-citation-ref data-n="n">`；查不到就原样留作纯文本——不给用户一个点了却没有
+ * 来源的假角标。不改代码块/行内代码里的内容（跟 collapseInlineToolCalls 共用同一套
+ * 代码区间检测）。故意不吃 `[1](url)`（真链接）、`[1]:`（引用定义）。
+ *
+ * `[1][2]` 这种紧邻的引用式链接语法（`[text][ref]`）本该保护，但模型引用多条证据时
+ * 常见的写法恰好也是 `[1][2]`（两个编号紧挨着，各自代表一条证据）——不能用"后面
+ * 跟 [ 就一律跳过"这种一刀切规则，否则相邻引用里靠前那个永远变不成可点角标。这里
+ * 改成：只有当紧跟着的下一对方括号*不是*另一个真实存在的引用编号时，才当作引用式
+ * 链接的链接文本部分处理、不转换当前这个——两边都是真实证据时，两个都转换。 */
+export declare function injectCitationRefs(text: string, citations: Record<number, unknown> | null | undefined): string;
+export type MarkdownContentProps = MarkdownRendererProps & {
+    /** 当提供时，markdown 中相对路径的 <img> src 会解析为 session 工作区文件 URL */
+    sessionId?: string;
+    /** 文件预览传入工作区相对路径；聊天消息不传时仍按工作区根目录解析。 */
+    baseFilePath?: string;
+    /** 本轮里真实检索到的引用证据（见 `lib/citations.ts`）。提供时，文本里能对上号的
+     * `[n]` 会渲染成可 hover 预览/点击跳转原文的角标；查不到证据的 `[n]` 原样是纯文本。 */
+    citations?: Record<number, CitationEntry> | null;
+    /** 历史遗留 prop：streamdown 自己的代码块内置控件开关。`components.pre`/
+     * `components.code` 一旦被覆盖（这里始终覆盖），streamdown 对应的默认控件
+     * 本来就不会渲染，这个开关从未真正生效过——迁移后继续接受但不使用，
+     * 避免所有既有调用点都要跟着改。 */
+    controls?: boolean | {
+        table?: boolean;
+        code?: boolean;
+        mermaid?: boolean;
+    };
+};
+export declare function MarkdownContent({ allowedTags, baseFilePath, children, citations, components, controls: _controls, mode, sessionId, ...props }: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/markdown/text.d.ts

@@ -0,0 +1,11 @@
+/** 找出文本里已经闭合的代码区间（围栏代码块 + 行内代码），跟
+ * `heal-incomplete.ts` 里同名逻辑的用途一样——`stripSystemReminders` 在
+ * markdown 解析之前对原始文本操作，不感知代码块/行内代码，用户把
+ * `<system-reminder>` 当字面例子写在反引号里讨论、或者代码示例里恰好
+ * 出现完整的标记形状，都不应该被当成真的内部提醒删掉。 */
+/** 已经闭合的代码区间（围栏代码块 + 行内代码）：这些范围里的文字按字面处理，不做替换。 */
+export declare function findCodeRanges(text: string): Array<[number, number]>;
+/** 渲染前剥掉平台内部提醒（跳过代码区间：写在反引号里讨论的标记不算）。 */
+export declare function stripSystemReminders(text: string): string;
+/** Keep inline formatting markers from being consumed by URL autolinking. */
+export declare function normalizeAdjacentUrlFormatting(value: string): string;