@blade-hq/agent-react 2610.0.0-beta.70 → 2610.0.0-beta.72

package/dist/embed/entry.d.ts

@@ -18,6 +18,7 @@ declare function getChat(element: Element | null): Promise<AgentSession>;
 declare const BladeAgent: {
     BladeClient: typeof agentClient.BladeClient;
     BladeApiError: typeof agentClient.BladeApiError;
+    isEntryGoneError: typeof agentClient.isEntryGoneError;
     PollingBackoff: typeof agentClient.PollingBackoff;
     EMPTY_PLATFORM_ENDPOINTS: agentClient.PlatformEndpoints;
     loadPlatformEndpoints: typeof agentClient.loadPlatformEndpoints;
@@ -55,6 +56,7 @@ declare const BladeAgent: {
     ChatGroupsResource: typeof agentClient.ChatGroupsResource;
     PluginsResource: typeof agentClient.PluginsResource;
     hasChatRunEvent: typeof agentClient.hasChatRunEvent;
+    inferToolStatus: typeof agentClient.inferToolStatus;
     buildMessageContent: typeof agentClient.buildMessageContent;
     chatErrorForDisplay: typeof agentClient.chatErrorForDisplay;
     contentPreview: typeof agentClient.contentPreview;

package/dist/{highlighted-body-B3W2YXNL-IASCZDV2.js → highlighted-body-B3W2YXNL-YF4GVJGP.js}

@@ -3,7 +3,7 @@ import {
   Ks,
   Qe,
   R
-} from "./chunk-MAAMCOAU.js";
+} from "./chunk-IA6J2NTB.js";
 import "./chunk-G3PMV62Z.js";
 
 // ../../node_modules/.pnpm/streamdown@2.3.0_react-dom@19.2.4_react@19.2.4__react@19.2.4/node_modules/streamdown/dist/highlighted-body-B3W2YXNL.js
@@ -25,4 +25,4 @@ var L = ({ code: s, language: t, raw: e, className: n, ...d$1 }) => {
 export {
   L as HighlightedCodeBlockBody
 };
-//# sourceMappingURL=highlighted-body-B3W2YXNL-IASCZDV2.js.map
+//# sourceMappingURL=highlighted-body-B3W2YXNL-YF4GVJGP.js.map

package/dist/hooks/use-turn-navigation.d.ts

@@ -0,0 +1,117 @@
+import { type ChatMessage, type SessionTurnIndexItem, type TurnProjection } from "@blade-hq/agent-client";
+/** 高亮用的类名。样式在 agent-react 的 style.css 与内置 Web 的 app.css 各有一份。 */
+export declare const TURN_NAV_HIGHLIGHT_CLASS = "blade-turn-nav-flash";
+/**
+ * 消息导航的数据源：宿主把"目录从哪来""定位怎么发"接给共享时序。
+ *
+ * SDK 的 AgentChat 用 `AgentSession.loadTurnIndex` / `locateEntry`；内置 Web 用
+ * 自己的 store。没有会话目录的宿主（例如分享页）只传 `locateEntry` 与兜底条目。
+ */
+/** 刻度轨的一条：稳定 entry id + 标题。内置 Web 的同名类型形状一致。 */
+export interface TurnNavItem {
+    id: string;
+    title: string;
+}
+export interface TurnNavigationSource {
+    /** 目录来源；不传就不请求目录，导航条目只由 `fallbackItems` 兜底。 */
+    loadTurnIndex?: () => Promise<SessionTurnIndexItem[]>;
+    /** 定位：服务端返回"从这条发言到最新"的窗口并整窗替换。成功返回 true。 */
+    locateEntry: (entryId: string) => Promise<boolean>;
+    /**
+     * 取消在途定位。每次新的选择都会先调它每次新的选择都会先调它：用户改点一条**已加载**的发言时不发定位请求，
+     * 前一次在途的定位却已经发出去了——不取消的话它晚回来照样换窗口，把用户刚选中的
+     * 那一段换掉。
+     */
+    cancelPendingLocate?: () => void;
+    /**
+     * 目录刷新信号：会话里最新的用户发言变了（新发言、乐观发言被服务端确认）。
+     *
+     * 只认**最新一条**发言：往上翻页会补进更早的发言，用"窗口里全部发言"当信号的话，
+     * 正在进行的定位会被自己触发的刷新作废——翻页成功了却不滚动，要再点一次。
+     */
+    reloadKey?: number | string | null;
+    /**
+     * timeline 被**外部**整体重写（rewind / checkout / 修复重载）时变化。与 `reloadKey`
+     * 的区别是语义：`reloadKey` 变化只是「可能变了」，刷新期间先照旧显示；这里变化一定是
+     * 旧目录作废，旧条目必须立刻丢掉——它们的 entry id 可能已经不在 timeline 上了。
+     *
+     * 必须只由外部改写推进：定位自己换窗口同样会推进"窗口世代"，拿它当信号会把正在进行的
+     * 那次定位当场作废（点了没反应，要再点一次）。内置 Web 用 store 的
+     * `historyRewriteRevision`，SDK 用会话的 `rewind` 事件。
+     */
+    rewriteKey?: number | string | null;
+    /**
+     * 目录拿不到时的兜底条目。
+     *
+     * 分享页的历史本来就是整份加载的：它没有会话目录接口，导航条目直接由已加载的
+     * 发言推出来。这只覆盖"整份都在窗口里"的场景，长会话不能拿它代替目录。
+     */
+    fallbackItems?: TurnNavItem[];
+}
+/** 共享时序还要知道"怎么在宿主自己的列表里找到那一行"。 */
+export interface TurnNavigationOptions extends TurnNavigationSource {
+    /** 当前会话；变了就丢弃在途的定位结果、目录和高亮。 */
+    sessionId?: string | null;
+    /** 已加载窗口里该发言的行；不在当前列表里返回 null。 */
+    getLoadedEntryElement: (entryId: string) => HTMLElement | null;
+    /**
+     * 这条发言在不在已加载窗口里（哪怕它的行因为虚拟列表还没挂出来）。
+     *
+     * 没有它就只能拿"DOM 里有没有这一行"当"加载没加载"：长会话里滚出挂载范围的旧发言
+     * 会被当成窗口外，白白发一次定位请求（分享页更糟——那里根本没有定位接口）。不传则
+     * 退回只看 DOM。
+     */
+    isEntryLoaded?: (entryId: string) => boolean;
+    /**
+     * 已加载但还没进 DOM 的行（虚拟列表）——让宿主先把目标挂出来，下一帧
+     * `getLoadedEntryElement` 就能查到。宿主没有虚拟列表时不用传。
+     */
+    revealEntry?: (entryId: string) => void;
+    /**
+     * 开始定位前的一次性钩子：宿主在这里放弃自己的滚动控制（新轮置顶动画、
+     * 「跟随到底」），否则它们会继续写 `scrollTop`，把视口从目标行上拽走。
+     */
+    beforeSeek?: (entryId: string) => void;
+}
+/**
+ * 目录刷新信号：窗口里**最后一条**用户发言的稳定 id。
+ *
+ * 与内置 Web 的 `latestUserSpeechEntryId`（message-list-blocks.ts）同一判据、同一
+ * 名称，输入不同：那边拿渲染好的消息，这边拿投影轮。两边都只认"最新一条"，因为
+ * 往前翻页补进的更早发言不改变目录的结尾，用"窗口里全部发言"当信号会把正在进行的
+ * 定位判成过期。
+ *
+ * AskUserQuestion 的回答在消息列表里也渲染成用户发言，所以带回答标记的轮同样算一条。
+ */
+export declare function latestUserSpeechEntryId(turns: TurnProjection[]): string | null;
+/**
+ * 从已加载的消息推出轨道条目：给没有目录接口的宿主（分享页、静态会话）兜底。
+ *
+ * 判据与内置 Web 的 `MessageList` 一致：根循环里渲染成用户发言的消息、排除内部提示，
+ * 标题按服务端目录同一口径截断。**不能**拿它代替长会话的目录——窗口里没有更早的发言。
+ */
+export declare function turnNavItemsFromMessages(messages: ChatMessage[]): TurnNavItem[];
+export interface TurnNavigationResult {
+    /** 当前会话的用户发言目录。 */
+    items: TurnNavItem[];
+    /** 正在请求定位的那条发言；请求结束就清空。 */
+    loadingEntryId: string | null;
+    /** 上一条定位失败的提示；点下一条时清空。 */
+    error: string | null;
+    /** 定位失败的那条发言：重试就是再点它一次。 */
+    failedEntryId: string | null;
+    /** 最后一条被定位（或正在定位）的发言，用来给刻度轨选中态。 */
+    activeEntryId: string | null;
+    selectEntry: (entryId: string) => void;
+}
+/**
+ * 用户发言的跨页定位：滚动、加载状态、高亮三件事的唯一实现，内置 Web 与 SDK
+ * 共用同一份时序。
+ *
+ * 点已加载的发言：不请求任何东西，直接滚动 + 高亮。点窗口外的发言：发一次定位请求
+ * （服务端返回"从它到最新"的窗口），等 React 提交、目标行挂出来再滚动 + 高亮；
+ * 请求失败或行始终没出现就报一句可重试的提示，**不动滚动位置**。
+ *
+ * 会话切换、历史被整体重写、或用户点了下一条时，在途结果一律丢弃。
+ */
+export declare function useTurnNavigation({ sessionId, getLoadedEntryElement, isEntryLoaded, locateEntry, cancelPendingLocate, loadTurnIndex, fallbackItems, revealEntry, beforeSeek, reloadKey, rewriteKey, }: TurnNavigationOptions): TurnNavigationResult;

package/dist/index.d.ts

@@ -9,9 +9,13 @@ export { useMessagePin } from "./hooks/use-message-pin";
 export type { UseMessagePinOptions } from "./hooks/use-message-pin";
 export { useTypewriterReveal } from "./hooks/use-typewriter-reveal";
 export type { UseTypewriterRevealResult } from "./hooks/use-typewriter-reveal";
+export { latestUserSpeechEntryId, TURN_NAV_HIGHLIGHT_CLASS, turnNavItemsFromMessages, useTurnNavigation, } from "./hooks/use-turn-navigation";
+export type { TurnNavigationOptions, TurnNavigationResult, TurnNavigationSource, } from "./hooks/use-turn-navigation";
+export { TurnNavRail } from "./components/TurnNavRail";
+export type { TurnNavRailProps } from "./components/TurnNavRail";
 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 { AssistantTextRendererProps, AskUserQuestionRendererProps, ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, FollowupInteractionEvent, PlanUpdateRendererProps, UserMessageRendererProps, } from "./components/ChatView";
 export { ConnectorPanel } from "./components/ConnectorPanel";
 export type { ConnectorPanelProps } from "./components/ConnectorPanel";
 export { PluginConnectorList } from "./components/PluginConnectorList";
@@ -55,6 +59,7 @@ export { ContextCard, ContextGroupCard } from "./components/ContextCard";
 export type { ContextCardProps, ContextGroupCardProps } from "./components/ContextCard";
 export { collectMemoryRefs, MemoryRefsHint } from "./components/AssistantTurnBlock";
 export { ToolUiCardView } from "./components/ToolUiCardView";
+export type { AskUserQuestionData } from "./components/AskUserQuestionBlock";
 export { McpAppCard } from "./components/McpAppCard";
 export type { McpAppMessage } from "./components/McpAppCard";
 export { SessionMemoryToggle } from "./components/SessionMemoryToggle";