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

package/dist/chat/scroll-anchor.d.ts

@@ -0,0 +1,46 @@
+export declare const ENTRY_SCROLL_MARGIN_PX = 24;
+export declare function calculateStickyAwareMargin(statusHeight?: number, statusBottomGap?: number): number;
+export declare function normalizeScrollEntryKey(value: string | null | undefined): string | null;
+export declare function calculateAnchoredScrollTop({ scrollTop, containerTop, targetTop, margin, }: {
+    scrollTop: number;
+    containerTop: number;
+    targetTop: number;
+    margin?: number;
+}): number;
+export declare function calculateTrailingSpacerHeight({ targetScrollTop, scrollHeight, clientHeight, currentScrollTop, }: {
+    targetScrollTop: number;
+    scrollHeight: number;
+    clientHeight: number;
+    /** 当前滚动位置：空白不能收到把它挤出可滚动范围，否则浏览器会把页面拽回去。 */
+    currentScrollTop?: number;
+}): number;
+/** 交还跟随时允许的位置误差：顶置落位有取整误差，太严格会漏掉正常情况。 */
+export declare const PIN_HANDOVER_TOLERANCE_PX = 24;
+/**
+ * 尾部空白收完时是否把“跟随到底”交还给滚动库。
+ * 只有用户还停在顶置位置（或更靠下）才交还；他自己往上翻去看前文时不打扰。
+ */
+export declare function shouldHandOverToFollow({ currentScrollTop, targetScrollTop, tolerance, }: {
+    currentScrollTop: number;
+    targetScrollTop: number;
+    tolerance?: number;
+}): boolean;
+export declare const NEW_TURN_SCROLL_DURATION_MS = 320;
+/** 距离小于这个像素数时看不出动画，直接落位。 */
+export declare const NEW_TURN_SCROLL_MIN_DISTANCE_PX = 8;
+/** 距离超过这么多屏时直接跳过去：长距离滚动动画只会让人更晕。 */
+export declare const NEW_TURN_SCROLL_MAX_SCREENS = 3;
+/** 滚动位置偏离动画写入值超过这么多像素，就认定是用户在自己滚。 */
+export declare const MANUAL_SCROLL_TOLERANCE_PX = 2;
+export declare function shouldAnimateNewTurnScroll({ fromScrollTop, targetScrollTop, clientHeight, prefersReducedMotion, }: {
+    fromScrollTop: number;
+    targetScrollTop: number;
+    clientHeight: number;
+    prefersReducedMotion?: boolean;
+}): boolean;
+export declare function calculateAnimatedScrollTop({ fromScrollTop, targetScrollTop, elapsedMs, durationMs, }: {
+    fromScrollTop: number;
+    targetScrollTop: number;
+    elapsedMs: number;
+    durationMs?: number;
+}): number;

package/dist/chat/tool-renderers/BashRenderer.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRendererProps } from "./registry";
+export declare function BashRenderer({ toolCall }: ToolRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/tool-renderers/FileEditRenderer.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRendererProps } from "./registry";
+export declare function FileEditRenderer({ toolCall }: ToolRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/tool-renderers/FileReadRenderer.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRendererProps } from "./registry";
+export declare function FileReadRenderer({ toolCall }: ToolRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/tool-renderers/KbSearchRenderer.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRendererProps } from "./registry";
+export declare function KbSearchRenderer({ toolCall }: ToolRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/tool-renderers/SearchRenderer.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRendererProps } from "./registry";
+export declare function SearchRenderer({ toolCall }: ToolRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/tool-renderers/SubmitResultRenderer.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRendererProps } from "./registry";
+export declare function SubmitResultRenderer({ toolCall }: ToolRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/tool-renderers/kb-search-result.d.ts

@@ -0,0 +1,19 @@
+/** kb_search 工具结果里的一条命中（与后端 `KnowledgeHit.to_payload` 对齐）。 */
+export interface KbSearchHit {
+    n: number;
+    kbName: string;
+    title: string;
+    path: string;
+    page: number | null;
+    heading: string | null;
+    text: string;
+    previewUrl: string | null;
+}
+export interface KbSearchResult {
+    summary: string | null;
+    query: string | null;
+    hits: KbSearchHit[];
+}
+export declare function parseKbSearchResult(result: unknown): KbSearchResult | null;
+/** 折叠时的标题：「🔍 在《X》检索到 N 条」。结果没回来或出错时退回工具名。 */
+export declare function formatKbSearchLabel(result: unknown): string | null;

package/dist/chat/tool-renderers/registry.d.ts

@@ -0,0 +1,5 @@
+import type { ComponentType } from "react";
+import type { ToolRendererProps } from "../customization";
+export type { ToolRendererProps };
+type ToolRenderer = ComponentType<ToolRendererProps>;
+export declare function getRenderer(toolName: string): ToolRenderer | null;

package/dist/chat/tool-renderers/shared.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 从工具结果中提取纯文本。如果 result 是多模态 list 则提取 text parts；
+ * 如果是 string 则原样返回。
+ */
+export declare function getResultText(result: unknown): string | null;
+/**
+ * 从工具结果提取图片资源及尺寸，供鉴权加载与预留布局使用。
+ */
+export declare function getResultImages(result: unknown): {
+    url: string;
+    width?: number;
+    height?: number;
+}[];
+export declare function parseJsonValue(value?: string | null): unknown;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function getStringValue(data: Record<string, unknown> | null, key: string): string | null;
+export declare function getNumberValue(data: Record<string, unknown> | null, key: string): number | null;
+export declare function getBooleanValue(data: Record<string, unknown> | null, key: string): boolean;
+export declare function extractErrorMessage(value?: unknown): string | null;
+export declare function getFileName(filePath?: string | null): string;
+export declare function getCodeLanguage(filePath?: string | null): string | null;
+export declare function formatBytes(size?: number | null): string | null;
+interface CodePreviewProps {
+    content: string;
+    filePath?: string | null;
+    emptyLabel?: string;
+    className?: string;
+}
+export declare function CodePreview({ content, filePath, emptyLabel, className, }: CodePreviewProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/chat/tool-renderers/write-preview-scroll.d.ts

@@ -0,0 +1,5 @@
+import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
+type ScrollContainer = Pick<HTMLElement, "scrollHeight" | "scrollTop">;
+export declare function shouldFollowWritePreview(toolName: string, status: ToolCallInfo["status"]): boolean;
+export declare function scrollWritePreviewToLatest(preview: ScrollContainer): void;
+export {};

package/dist/chat-OCLOVB3H.css

@@ -0,0 +1,175 @@
+/*
+ * 聊天组件共用的非 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));
+  --tw-prose-links: hsl(var(--primary));
+  --tw-prose-bold: hsl(var(--foreground));
+  --tw-prose-code: hsl(var(--primary));
+  --tw-prose-pre-bg: hsl(var(--muted));
+  --tw-prose-pre-code: hsl(var(--foreground));
+  --tw-prose-quotes: hsl(var(--muted-foreground));
+  --tw-prose-counters: hsl(var(--muted-foreground));
+  --tw-prose-bullets: hsl(var(--muted-foreground));
+}
+
+[data-theme="light"] .prose pre {
+  background: hsl(var(--muted));
+}
+
+[data-theme="light"] .prose code:not(pre code) {
+  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;
+}
+.chat-prose > p:first-child,
+.chat-prose > ul:first-child,
+.chat-prose > ol:first-child {
+  margin-top: 0;
+}
+.chat-prose > p:last-child,
+.chat-prose > ul:last-child,
+.chat-prose > ol:last-child {
+  margin-bottom: 0;
+}
+.chat-prose ul,
+.chat-prose ol {
+  margin-top: 0.4em;
+  margin-bottom: 0.4em;
+  padding-left: 1.4em;
+}
+.chat-prose li {
+  margin-top: 0.2em;
+  margin-bottom: 0.2em;
+}
+.chat-prose li p {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.chat-prose ul ul,
+.chat-prose ol ol,
+.chat-prose ul ol,
+.chat-prose ol ul {
+  margin-top: 0.2em;
+  margin-bottom: 0.2em;
+}
+.chat-prose h1 {
+  font-size: 1.4em;
+  margin: 1em 0 0.5em;
+}
+.chat-prose h2 {
+  font-size: 1.2em;
+  margin: 1em 0 0.45em;
+}
+.chat-prose h3,
+.chat-prose h4 {
+  font-size: 1.05em;
+  margin: 0.9em 0 0.4em;
+}
+.chat-prose blockquote {
+  margin-top: 0.6em;
+  margin-bottom: 0.6em;
+}
+.chat-prose hr {
+  margin-top: 1.2em;
+  margin-bottom: 1.2em;
+}
+
+/* 未闭合的加粗/斜体/行内代码，在闭合符真正到达前先按最终标签
+ * 渲染、只用透明度标出"待确认"——内容和标签结构全程不变，闭合符到达后
+ * 这条规则自然不再匹配，恢复完全不透明，DOM 节点没有被替换过。这个属性
+ * 只由 MarkdownRenderer 引擎自己产出，不区分调用方用的是哪套 prose 外壳
+ * （`.chat-prose`/`.prose`/`.lite-chat-markdown`/无外壳），不按外壳类名
+ * 逐个补，直接全局生效。 */
+[data-markdown-pending="true"] {
+  opacity: 0.6;
+}
+
+/* 宽表格（多列或者有超长不可断行内容）要横向自己滚，不能把聊天区撑宽。
+ * 原来 streamdown 的表格外壳自带 overflow-x-auto，新引擎换成
+ * `.blade-chat-table-wrapper` 这个 class，但那只是引擎自己 SDK 包
+ * （`@blade-hq/agent-react`）样式表里的 scoped 规则，挂在
+ * `.blade-chat-markdown` 之下——内置 Web 这边套的是 `.chat-prose`/
+ * `.prose`/`.lite-chat-markdown` 这几套外壳，从来没有 `.blade-chat-markdown`，
+ * 那条规则永远匹配不上，得在这里再补一条不依赖外壳类名的全局规则。 */
+.blade-chat-table-wrapper {
+  max-width: 100%;
+  min-width: 0;
+  overflow-x: auto;
+}
+
+/* Message entrance animation */
+@keyframes msg-in {
+  from {
+    opacity: 0;
+    transform: translateY(5px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.msg-animate {
+  animation: msg-in 0.15s ease-out forwards;
+}
+
+/* Running-state sweep, borrowed from deepseek-harness's ReasoningRow. */
+.status-sweep::after {
+  content: "";
+  position: absolute;
+  inset-block: 0;
+  left: 0;
+  width: 260px;
+  background: linear-gradient(
+    90deg,
+    transparent,
+    hsl(var(--primary) / 0.08) 50%,
+    transparent
+  );
+  animation: status-sweep 2.6s ease-out infinite;
+  pointer-events: none;
+  z-index: 0;
+}
+
+@keyframes status-sweep {
+  0% { transform: translateX(-100%); }
+  90%, 100% { transform: translateX(500%); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .status-sweep::after {
+    animation: none;
+  }
+}
+
+/* 流式等待的扫光文字（ai-elements/shimmer.tsx） */
+@keyframes blade-shimmer-sweep {
+  from {
+    background-position: 100% center;
+  }
+  to {
+    background-position: 0% center;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  @keyframes blade-shimmer-sweep {
+    from {
+      background-position: 0% center;
+    }
+    to {
+      background-position: 0% center;
+    }
+  }
+}

package/dist/chat.css

@@ -0,0 +1,175 @@
+/*
+ * 聊天组件共用的非 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));
+  --tw-prose-links: hsl(var(--primary));
+  --tw-prose-bold: hsl(var(--foreground));
+  --tw-prose-code: hsl(var(--primary));
+  --tw-prose-pre-bg: hsl(var(--muted));
+  --tw-prose-pre-code: hsl(var(--foreground));
+  --tw-prose-quotes: hsl(var(--muted-foreground));
+  --tw-prose-counters: hsl(var(--muted-foreground));
+  --tw-prose-bullets: hsl(var(--muted-foreground));
+}
+
+[data-theme="light"] .prose pre {
+  background: hsl(var(--muted));
+}
+
+[data-theme="light"] .prose code:not(pre code) {
+  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;
+}
+.chat-prose > p:first-child,
+.chat-prose > ul:first-child,
+.chat-prose > ol:first-child {
+  margin-top: 0;
+}
+.chat-prose > p:last-child,
+.chat-prose > ul:last-child,
+.chat-prose > ol:last-child {
+  margin-bottom: 0;
+}
+.chat-prose ul,
+.chat-prose ol {
+  margin-top: 0.4em;
+  margin-bottom: 0.4em;
+  padding-left: 1.4em;
+}
+.chat-prose li {
+  margin-top: 0.2em;
+  margin-bottom: 0.2em;
+}
+.chat-prose li p {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.chat-prose ul ul,
+.chat-prose ol ol,
+.chat-prose ul ol,
+.chat-prose ol ul {
+  margin-top: 0.2em;
+  margin-bottom: 0.2em;
+}
+.chat-prose h1 {
+  font-size: 1.4em;
+  margin: 1em 0 0.5em;
+}
+.chat-prose h2 {
+  font-size: 1.2em;
+  margin: 1em 0 0.45em;
+}
+.chat-prose h3,
+.chat-prose h4 {
+  font-size: 1.05em;
+  margin: 0.9em 0 0.4em;
+}
+.chat-prose blockquote {
+  margin-top: 0.6em;
+  margin-bottom: 0.6em;
+}
+.chat-prose hr {
+  margin-top: 1.2em;
+  margin-bottom: 1.2em;
+}
+
+/* 未闭合的加粗/斜体/行内代码，在闭合符真正到达前先按最终标签
+ * 渲染、只用透明度标出"待确认"——内容和标签结构全程不变，闭合符到达后
+ * 这条规则自然不再匹配，恢复完全不透明，DOM 节点没有被替换过。这个属性
+ * 只由 MarkdownRenderer 引擎自己产出，不区分调用方用的是哪套 prose 外壳
+ * （`.chat-prose`/`.prose`/`.lite-chat-markdown`/无外壳），不按外壳类名
+ * 逐个补，直接全局生效。 */
+[data-markdown-pending="true"] {
+  opacity: 0.6;
+}
+
+/* 宽表格（多列或者有超长不可断行内容）要横向自己滚，不能把聊天区撑宽。
+ * 原来 streamdown 的表格外壳自带 overflow-x-auto，新引擎换成
+ * `.blade-chat-table-wrapper` 这个 class，但那只是引擎自己 SDK 包
+ * （`@blade-hq/agent-react`）样式表里的 scoped 规则，挂在
+ * `.blade-chat-markdown` 之下——内置 Web 这边套的是 `.chat-prose`/
+ * `.prose`/`.lite-chat-markdown` 这几套外壳，从来没有 `.blade-chat-markdown`，
+ * 那条规则永远匹配不上，得在这里再补一条不依赖外壳类名的全局规则。 */
+.blade-chat-table-wrapper {
+  max-width: 100%;
+  min-width: 0;
+  overflow-x: auto;
+}
+
+/* Message entrance animation */
+@keyframes msg-in {
+  from {
+    opacity: 0;
+    transform: translateY(5px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.msg-animate {
+  animation: msg-in 0.15s ease-out forwards;
+}
+
+/* Running-state sweep, borrowed from deepseek-harness's ReasoningRow. */
+.status-sweep::after {
+  content: "";
+  position: absolute;
+  inset-block: 0;
+  left: 0;
+  width: 260px;
+  background: linear-gradient(
+    90deg,
+    transparent,
+    hsl(var(--primary) / 0.08) 50%,
+    transparent
+  );
+  animation: status-sweep 2.6s ease-out infinite;
+  pointer-events: none;
+  z-index: 0;
+}
+
+@keyframes status-sweep {
+  0% { transform: translateX(-100%); }
+  90%, 100% { transform: translateX(500%); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .status-sweep::after {
+    animation: none;
+  }
+}
+
+/* 流式等待的扫光文字（ai-elements/shimmer.tsx） */
+@keyframes blade-shimmer-sweep {
+  from {
+    background-position: 100% center;
+  }
+  to {
+    background-position: 0% center;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  @keyframes blade-shimmer-sweep {
+    from {
+      background-position: 0% center;
+    }
+    to {
+      background-position: 0% center;
+    }
+  }
+}