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

package/dist/components/connector-panel-types.d.ts

@@ -0,0 +1,37 @@
+import type { PluginConnectorItem } from "./plugin-connector";
+/**
+ * 首页选中的一个待选插件。
+ *
+ * 带上展示名和图标是为了两件事：后续的配置弹窗与失败提示能一直用业务名（只传技术
+ * ID 的话，用户在面板里看到「示例登录」、在弹窗标题里看到 `demo-login`，等于要他认
+ * 两遍），以及不用打开面板就能在触发器上看到自己选了什么。
+ *
+ * 技术 ID 仍是路径、授权、缓存与调用的权威。
+ */
+export interface PluginConnectorSelection {
+    name: string;
+    displayName: string | null;
+    icon: string | null;
+    iconSource: PluginConnectorItem["iconSource"];
+}
+/** 面板一行 → 待选条目。 */
+export declare function selectionFromItem(item: PluginConnectorItem): PluginConnectorSelection;
+/** 触发器上最多直接显示几个插件头像，其余折成数量。 */
+export declare const TRIGGER_ICON_LIMIT = 3;
+/** 触发器上的头像堆叠内容：前三个 + 折起来的数量。 */
+export interface TriggerSummary {
+    /** 前 TRIGGER_ICON_LIMIT 个选中项，**不管有没有图标 token**。 */
+    visible: Array<Pick<PluginConnectorSelection, "name" | "displayName" | "icon" | "iconSource">>;
+    /** 超出 TRIGGER_ICON_LIMIT 的数量；0 表示不显示 `+N`。 */
+    overflow: number;
+    /** 已选/已启用的总数，用于无障碍标签与提示。 */
+    total: number;
+}
+/**
+ * 把一份插件列表折成触发器上的头像堆叠。
+ *
+ * 前三项都占位，**不管有没有图标 token**：没有图标的用显示名首字起头的圆形占位，
+ * 「选了哪个」照样看得见。早先的实现把无图标的项从图标位里剔掉、还把它们算进
+ * `overflow`，于是选中一个没有图标的插件时触发器毫无变化——选择在入口上不可见。
+ */
+export declare function triggerSummary(items: Array<Pick<PluginConnectorSelection, "name" | "displayName" | "icon" | "iconSource">>): TriggerSummary;

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

@@ -1,7 +1,17 @@
 import type { ToolCallInfo } from "@blade-hq/agent-client";
 export type ToolTone = "emerald" | "blue" | "amber" | "red";
+/**
+ * 技能入口文件的所在目录就是技能名（`.agent/skills/<技能名>/SKILL.md`）。
+ * 只显示 "SKILL.md" 用户看不出读的是哪个技能。
+ *
+ * 改这里必须同步 apps/web/src/agent/components/chat/display-utils.ts 的同名函数。
+ */
+export declare function getSkillNameFromFilePath(filePath: string | null | undefined): string | null;
 /** 归一化工具名：去掉命名空间前缀并映射到别名表（如 "fork:Agent" → "Agent"）。 */
 export declare function formatToolName(name: string): string;
+export declare function extractToolFilePath(toolCall: ToolCallInfo): string | null;
+/** 从文件类工具参数中提取全部可定位的文件路径（按出现顺序去重）。 */
+export declare function extractToolFilePaths(toolCall: ToolCallInfo): string[];
 /**
  * 返回工具调用的中文展示标签：优先取参数里的 description，
  * 其次取后端下发的 display_name / 系统工具中文名。

package/dist/components/plugin-config-draft.d.ts

@@ -0,0 +1,13 @@
+import type { SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client";
+export type ConfigPath = (string | number)[];
+export type ConfigValues = Record<string, unknown>;
+export declare function createConfigDraft(config: SessionPluginConfigState): {
+    values: ConfigValues;
+    retained: Map<string, string>;
+};
+/** Array edits address the original indices because the API applies sets before removals. */
+export declare function originalConfigPath(path: ConfigPath, removed: Set<string>): ConfigPath;
+export declare function configDraftOperations(initial: ConfigValues, values: ConfigValues, retained: Map<string, string>, removed: Set<string>): {
+    set: SessionPluginConfigSet[];
+    remove: string[];
+};

package/dist/components/plugin-config-schema.d.ts

@@ -0,0 +1,6 @@
+import type { SessionPluginConfigState } from "@blade-hq/agent-client";
+export type JsonSchema = Record<string, unknown>;
+export declare function pointerOf(parts: (string | number)[]): string;
+export declare function pointerParts(pointer: string): string[];
+export declare function formSupport(schema: JsonSchema | null): string | null;
+export declare function configIsEditable(state: SessionPluginConfigState): boolean;

package/dist/components/plugin-connector.d.ts

@@ -0,0 +1,40 @@
+import type { PluginCatalogEntry, SessionPlugin, SessionPluginConfigSummary } from "@blade-hq/agent-client";
+/**
+ * 连接器面板里的一行插件。
+ *
+ * 展示字段（名称、图标）和启用状态分开表达：目录接口在没有会话时也能给出名称与
+ * 图标，而「这次会话是否启用」只有会话接口知道。首页候选行恒为 `active: false`，
+ * 因为它只是待选，不代表已经激活。
+ */
+export interface PluginConnectorItem {
+    name: string;
+    display_name: string | null;
+    /** 图标 token；null 时显示统一占位，不隐藏整行。 */
+    icon: string | null;
+    /** 图标从哪个接口取：账号级目录，还是会话内已准备的包。 */
+    iconSource: "account" | "session";
+    installed: boolean | null;
+    /** 会话里已提交的选择；首页候选恒为 false。 */
+    active: boolean;
+    status: string;
+    reason?: string | null;
+    config?: SessionPluginConfigSummary;
+    projected: boolean;
+}
+/** 首页候选：只有账号级目录，没有会话状态。 */
+export declare function catalogToConnectorItems(catalog: PluginCatalogEntry[]): PluginConnectorItem[];
+/**
+ * 会话列表叠加账号目录。
+ *
+ * 目录可用时展示字段以目录为准（包可能还没准备，会话列表拿不到名称和图标），
+ * 目录不可用时退回会话行自己的字段，这样已选插件仍然可以取消。
+ */
+export declare function mergeConnectorItems(sessionPlugins: SessionPlugin[], catalog: PluginCatalogEntry[] | null): PluginConnectorItem[];
+/**
+ * 一行的配置说明文案；权威状态来自配置接口。
+ *
+ * `unchecked` 刻意没有文案：列表没有读过用户的 Home，说任何话都是噪音，
+ * 入口是开关本身。
+ */
+/** 按名称和显示名做本地过滤；空查询返回全部。 */
+export declare function filterConnectorItems(items: PluginConnectorItem[], query: string): PluginConnectorItem[];

package/dist/components/queue-panel-adjacency.d.ts

@@ -0,0 +1 @@
+export declare const QueuePanelAdjacencyContext: import("react").Context<boolean | null>;

package/dist/components/use-session-plugin-activation.d.ts

@@ -0,0 +1,40 @@
+import type { BladeClient, SessionPluginActivation, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { ConfiguringPlugin } from "./PluginConnectorList";
+import { type PluginConnectorItem } from "./plugin-connector";
+export interface UseSessionPluginActivationResult {
+    items: PluginConnectorItem[];
+    loading: boolean;
+    /** 插件列表本身读不到（Hub 不可用等），已有选择仍然可取消。 */
+    listError: boolean;
+    /** 某次启用/停用/准备失败了。 */
+    mutationError: boolean;
+    /** 正在为哪些插件提交意图；对应的开关在转圈，但仍然可点（点是取消）。 */
+    inFlight: Record<string, true>;
+    busy: boolean;
+    configuring: ConfiguringPlugin | null;
+    reload: () => void;
+    toggle: (item: PluginConnectorItem, next: boolean) => void;
+    retry: (item: PluginConnectorItem) => void;
+    editConfig: (item: PluginConnectorItem) => void;
+    onConfigSaved: (state: SessionPluginConfigState) => void;
+    onConfigClose: () => void;
+}
+/**
+ * 会话内插件启用的唯一实现。
+ *
+ * 顺序是「先准备配置，再提交 activation」：缺配置时开关不落到已启用、立刻弹表单，
+ * 保存成功才提交；取消、校验失败、配置读取失败都不提交。绝不先持久化 active=true
+ * 再靠补偿关掉——那样用户下次刷新会看到一个从没被成功打开的插件。
+ *
+ * 停用仍然直接提交：在服务端它只是取消一条数据库选择，不准备包、不连 MCP。但如果
+ * 这次「启用」只是还在准备、压根没提交过 activation，取消就只是放弃本地意图。
+ *
+ * 所有异步响应都按 (lifetime, mutation) 校验：迟到的准备或激活结果不会把已经取消 /
+ * 已经切走会话的插件重新打开；反过来，旧响应发现服务端落库顺序与用户最新意图不同时，
+ * 会重新提交最新意图。
+ */
+export declare function useSessionPluginActivation({ client, sessionId, onChange, }: {
+    client: BladeClient;
+    sessionId: string;
+    onChange?: (plugin: SessionPluginActivation) => void;
+}): UseSessionPluginActivationResult;

package/dist/context.d.ts

@@ -11,3 +11,4 @@ export interface BladeProviderProps {
 export declare function BladeProvider({ client, children }: BladeProviderProps): import("react/jsx-runtime").JSX.Element;
 /** 读取当前 BladeProvider 提供的 client。不在 Provider 内使用时抛错。 */
 export declare function useBladeClient(): BladeClient;
+export declare function useOptionalBladeClient(): BladeClient | null;

package/dist/embed/entry.d.ts

@@ -18,19 +18,45 @@ declare function getChat(element: Element | null): Promise<AgentSession>;
 declare const BladeAgent: {
     BladeClient: typeof agentClient.BladeClient;
     BladeApiError: typeof agentClient.BladeApiError;
+    PollingBackoff: typeof agentClient.PollingBackoff;
+    EMPTY_PLATFORM_ENDPOINTS: agentClient.PlatformEndpoints;
+    loadPlatformEndpoints: typeof agentClient.loadPlatformEndpoints;
+    resolveServiceUrl: typeof agentClient.resolveServiceUrl;
     SDK_NAME: "agent-client";
     SDK_VERSION: string;
     AgentSession: typeof AgentSession;
     SessionHub: typeof agentClient.SessionHub;
+    isMcpAppData: typeof agentClient.isMcpAppData;
     SessionSetupError: typeof agentClient.SessionSetupError;
     createInitialSessionState: typeof agentClient.createInitialSessionState;
+    reconcileHistoricalUserTurns: typeof agentClient.reconcileHistoricalUserTurns;
     reconcileOptimisticUserTurns: typeof agentClient.reconcileOptimisticUserTurns;
     toReplaySnapshot: typeof agentClient.toReplaySnapshot;
+    EMPTY_SESSION_QUEUE: agentClient.SessionQueueSnapshot;
+    canCancelQueuedMessage: typeof agentClient.canCancelQueuedMessage;
+    canDeliverQueuedMessage: typeof agentClient.canDeliverQueuedMessage;
+    canEditQueuedMessage: typeof agentClient.canEditQueuedMessage;
+    isSessionQueueSnapshot: typeof agentClient.isSessionQueueSnapshot;
+    parseQueueAck: typeof agentClient.parseQueueAck;
+    queuePauseReasonLabel: typeof agentClient.queuePauseReasonLabel;
+    queuedMessageStatusLabel: typeof agentClient.queuedMessageStatusLabel;
+    shouldApplySnapshot: typeof agentClient.shouldApplySnapshot;
     connectEmbedded: typeof agentClient.connectEmbedded;
     isCommandEnvelope: typeof agentClient.isCommandEnvelope;
     isInboundEnvelope: typeof agentClient.isInboundEnvelope;
+    ComputersResource: typeof agentClient.ComputersResource;
+    canToggleComputer: typeof agentClient.canToggleComputer;
+    computerDaemonVersion: typeof agentClient.computerDaemonVersion;
+    computerOS: typeof agentClient.computerOS;
+    computerPlatformLabel: typeof agentClient.computerPlatformLabel;
+    computerState: typeof agentClient.computerState;
+    sortComputers: typeof agentClient.sortComputers;
     ModelsResource: typeof agentClient.ModelsResource;
+    ChatGroupsResource: typeof agentClient.ChatGroupsResource;
+    PluginsResource: typeof agentClient.PluginsResource;
+    hasChatRunEvent: typeof agentClient.hasChatRunEvent;
     buildMessageContent: typeof agentClient.buildMessageContent;
+    chatErrorForDisplay: typeof agentClient.chatErrorForDisplay;
     contentPreview: typeof agentClient.contentPreview;
     extractTextAttachments: typeof agentClient.extractTextAttachments;
     getFileParts: typeof agentClient.getFileParts;
@@ -40,7 +66,20 @@ declare const BladeAgent: {
     isHiddenInternalMessage: typeof agentClient.isHiddenInternalMessage;
     normalizeMessageContent: typeof agentClient.normalizeMessageContent;
     transformSlashCommand: typeof agentClient.transformSlashCommand;
+    contextProjectionData: typeof agentClient.contextProjectionData;
+    getContextDisplayState: typeof agentClient.getContextDisplayState;
+    getContextGroupDisplayState: typeof agentClient.getContextGroupDisplayState;
+    groupAdjacentContextRuns: typeof agentClient.groupAdjacentContextRuns;
     latestPostChatFollowup: typeof agentClient.latestPostChatFollowup;
+    buildToolUiCardKey: typeof agentClient.buildToolUiCardKey;
+    collectInlineToolUiCards: typeof agentClient.collectInlineToolUiCards;
+    collectPreviewToolUiCards: typeof agentClient.collectPreviewToolUiCards;
+    isAppDevToolUiCard: typeof agentClient.isAppDevToolUiCard;
+    isInternalStatusToolUiCard: typeof agentClient.isInternalStatusToolUiCard;
+    isToolUiCard: typeof agentClient.isToolUiCard;
+    resolveToolUiCardContent: typeof agentClient.resolveToolUiCardContent;
+    prependOlder: typeof agentClient.prependOlder;
+    replaceWindow: typeof agentClient.replaceWindow;
     DEFAULT_REPLAY_SPEED: agentClient.ReplaySpeed;
     SessionInfo: import("arktype/internal/variants/object.ts").ObjectType<{
         id: string;
@@ -71,7 +110,11 @@ declare const BladeAgent: {
         disable_tools?: string[] | undefined;
         runtime_type?: string | null | undefined;
         daemon_id?: string | null | undefined;
+        agent_runtime_id?: string | null | undefined;
         workspace_path?: string | null | undefined;
+        ba_version?: string | null | undefined;
+        sandbox_version?: string | null | undefined;
+        chat_group_id?: string | null | undefined;
         match?: unknown;
     }, {}>;
     SessionStatus: import("arktype/internal/variants/string.ts").StringType<"completed" | "created" | "failed" | "interrupted" | "running" | "waiting_for_input", {}>;
@@ -87,7 +130,10 @@ declare const BladeAgent: {
     }, {}>;
     TaskStatus: import("arktype/internal/variants/string.ts").StringType<"done" | "failed" | "in_progress" | "pending" | "skipped", {}>;
     acceptedPostChatFollowupCompletesLatestRun: typeof agentClient.acceptedPostChatFollowupCompletesLatestRun;
+    acknowledgeTurnEvents: typeof agentClient.acknowledgeTurnEvents;
     ClientProjectionBuilder: typeof agentClient.ClientProjectionBuilder;
+    AuthBusyReconnect: typeof agentClient.AuthBusyReconnect;
+    authBusyRetryDelayMs: typeof agentClient.authBusyRetryDelayMs;
     createSocket: typeof agentClient.createSocket;
     getChat: typeof getChat;
     BladeChatElement: typeof BladeChatElement;

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

@@ -3,7 +3,8 @@ import {
   Ks,
   Qe,
   R
-} from "./chunk-ZXXLY4RM.js";
+} from "./chunk-MAAMCOAU.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
 import { useContext, useState, useEffect } from "react";
@@ -24,4 +25,4 @@ var L = ({ code: s, language: t, raw: e, className: n, ...d$1 }) => {
 export {
   L as HighlightedCodeBlockBody
 };
-//# sourceMappingURL=highlighted-body-B3W2YXNL-YD7FAP6V.js.map
+//# sourceMappingURL=highlighted-body-B3W2YXNL-IASCZDV2.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../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"],"sourcesContent":["\"use client\";\nimport {k,d,c}from'./chunk-RLXIAIE6.js';import {useContext,useState,useEffect}from'react';import {jsx}from'react/jsx-runtime';var L=({code:s,language:t,raw:e,className:n,...d$1})=>{let{shikiTheme:l}=useContext(k),o=d(),[m,i]=useState(e);return useEffect(()=>{if(!o){i(e);return}let g=o.highlight({code:s,language:t,themes:l},p=>{i(p);});g&&i(g);},[s,t,l,o,e]),jsx(c,{className:n,language:t,result:m,...d$1})};export{L as HighlightedCodeBlockBody};"],"mappings":";;;;;;;;AACwC,SAAQ,YAAW,UAAS,iBAAc;AAAQ,SAAQ,WAAQ;AAAoB,IAAI,IAAE,CAAC,EAAC,MAAK,GAAE,UAAS,GAAE,KAAI,GAAE,WAAU,GAAE,GAAG,IAAG,MAAI;AAAC,MAAG,EAAC,YAAW,EAAC,IAAE,WAAW,CAAC,GAAE,IAAE,GAAE,GAAE,CAAC,GAAE,CAAC,IAAE,SAAS,CAAC;AAAE,SAAO,UAAU,MAAI;AAAC,QAAG,CAAC,GAAE;AAAC,QAAE,CAAC;AAAE;AAAA,IAAM;AAAC,QAAI,IAAE,EAAE,UAAU,EAAC,MAAK,GAAE,UAAS,GAAE,QAAO,EAAC,GAAE,OAAG;AAAC,QAAE,CAAC;AAAA,IAAE,CAAC;AAAE,SAAG,EAAE,CAAC;AAAA,EAAE,GAAE,CAAC,GAAE,GAAE,GAAE,GAAE,CAAC,CAAC,GAAE,IAAI,IAAE,EAAC,WAAU,GAAE,UAAS,GAAE,QAAO,GAAE,GAAG,IAAG,CAAC;AAAC;","names":[]}
+{"version":3,"sources":["../../../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"],"sourcesContent":["\"use client\";\nimport {k,d,c}from'./chunk-RLXIAIE6.js';import {useContext,useState,useEffect}from'react';import {jsx}from'react/jsx-runtime';var L=({code:s,language:t,raw:e,className:n,...d$1})=>{let{shikiTheme:l}=useContext(k),o=d(),[m,i]=useState(e);return useEffect(()=>{if(!o){i(e);return}let g=o.highlight({code:s,language:t,themes:l},p=>{i(p);});g&&i(g);},[s,t,l,o,e]),jsx(c,{className:n,language:t,result:m,...d$1})};export{L as HighlightedCodeBlockBody};"],"mappings":";;;;;;;;;AACwC,SAAQ,YAAW,UAAS,iBAAc;AAAQ,SAAQ,WAAQ;AAAoB,IAAI,IAAE,CAAC,EAAC,MAAK,GAAE,UAAS,GAAE,KAAI,GAAE,WAAU,GAAE,GAAG,IAAG,MAAI;AAAC,MAAG,EAAC,YAAW,EAAC,IAAE,WAAW,CAAC,GAAE,IAAE,GAAE,GAAE,CAAC,GAAE,CAAC,IAAE,SAAS,CAAC;AAAE,SAAO,UAAU,MAAI;AAAC,QAAG,CAAC,GAAE;AAAC,QAAE,CAAC;AAAE;AAAA,IAAM;AAAC,QAAI,IAAE,EAAE,UAAU,EAAC,MAAK,GAAE,UAAS,GAAE,QAAO,EAAC,GAAE,OAAG;AAAC,QAAE,CAAC;AAAA,IAAE,CAAC;AAAE,SAAG,EAAE,CAAC;AAAA,EAAE,GAAE,CAAC,GAAE,GAAE,GAAE,GAAE,CAAC,CAAC,GAAE,IAAI,IAAE,EAAC,WAAU,GAAE,UAAS,GAAE,QAAO,GAAE,GAAG,IAAG,CAAC;AAAC;","names":[]}

package/dist/hooks/use-agent-session.d.ts

@@ -4,6 +4,11 @@ export interface UseAgentSessionOptions {
     createOptions?: CreateSessionRequest;
     /** 自动创建出的 sessionId 通过此回调交还调用方持有（重挂载复用的依据）。 */
     onSessionCreated?: (sessionId: string) => void;
+    /**
+     * 会话进入实时事件路由后、历史加载与房间订阅开始前同步执行。
+     * 返回的清理函数会在切换会话或卸载时执行。
+     */
+    onSessionConnected?: (session: AgentSession) => () => void;
 }
 export interface UseAgentSessionResult {
     /** 连接/创建完成前为 null。 */

package/dist/hooks/use-message-pin.d.ts

@@ -0,0 +1,28 @@
+export interface UseMessagePinOptions {
+    targetKey: string | null;
+    pinTarget: boolean;
+    /**
+     * 省略时按旧行为处理（视为一直流式中，只靠 targetKey 变化释放）——
+     * useMessagePin 是导出的公开 hook，加这个字段前如果直接改成必填，
+     * 所有已经在调用这个 hook 的外部使用方都会编译不过。
+     */
+    isStreaming?: boolean;
+    layoutKey?: string;
+    getScrollElement: () => HTMLElement | null;
+    getContentElement?: () => HTMLElement | null;
+    getTargetElement: () => HTMLElement | null;
+    getTargetScrollTop?: (scroll: HTMLElement) => number | null;
+    getSpacerHeight: () => number;
+    setSpacerHeight: (height: number) => void;
+    stopAutoScroll: () => void;
+    scrollToBottom: () => void;
+    margin?: number;
+}
+/**
+ * 用户发言顶置的共享状态机。SDK 和内置轻量列表只提供 DOM/虚拟列表适配器，
+ * 触发、调度、resize、手动接管和跟随交还的决策只在这里维护。
+ */
+export declare function useMessagePin({ targetKey, pinTarget, isStreaming, layoutKey, getScrollElement, getContentElement, getTargetElement, getTargetScrollTop, getSpacerHeight, setSpacerHeight, stopAutoScroll, scrollToBottom, margin, }: UseMessagePinOptions): {
+    release: () => void;
+    isActive: () => boolean;
+};

package/dist/hooks/use-typewriter-reveal.d.ts

@@ -0,0 +1,32 @@
+export interface UseTypewriterRevealResult {
+    /** 当前应该渲染的文字——被截断到"已显示长度"，不是目标全文。 */
+    displayedText: string;
+    /** 缓冲池是否还没追平目标全文；跟 isStreaming 做 || 判断输入框状态用。 */
+    isRevealing: boolean;
+    /**
+     * 立即把 displayedText 设成当前目标全文、取消播放循环——用户主动点了
+     * 停止，或者这一路因为中断/出错结束时调用。到达的内容不能丢，只是不再
+     * 需要"看起来在打字"这个动画效果。
+     */
+    flushNow: () => void;
+}
+/**
+ * 打字机式显示节流：服务端到达速率天然不均匀（一次推 5 个字、一次推 20
+ * 个字），直接原样渲染会显得忽快忽慢。按估算到达速度、留一个很小的固定
+ * 滞后量匀速播放 targetText。
+ *
+ * 纯渲染层的本地播放状态，不触碰 AgentSession/chat-store 的任何内部状态——
+ * 调用方从各自现有的、没有改动过的数据里取 targetText，这里只负责"这一帧
+ * 该显示到第几个字"。
+ *
+ * @param targetText 当前已到达的完整（未截断）文本。
+ * @param isLive 是否是真正的实时直播（不是历史加载 / rewind / replay）——
+ *   非直播场景永远整段直接显示，这是"流式与历史必须产生相同结果"这条硬
+ *   规则唯一允许的例外，只在真正的实时直播里生效。
+ * @param resetKey 标识"这是哪一段正在增长的内容"（比如 turn_id 或者
+ *   `${turnId}:${blockIndex}`）——变化时说明换了一段全新的内容（比如上一个
+ *   block 已经交付完、轮到下一个 block 在长，或者切到了新的一轮），播放
+ *   状态要重新从头开始，不能带着上一段的进度继续，否则会出现"从上一段的
+ *   长度往下掉"这种回退闪烁。
+ */
+export declare function useTypewriterReveal(targetText: string, isLive: boolean, resetKey: string | null): UseTypewriterRevealResult;

package/dist/index.d.ts

@@ -5,19 +5,62 @@ export type { UseAgentSessionOptions, UseAgentSessionResult } from "./hooks/use-
 export { useReplay } from "./hooks/use-replay";
 export type { ReplayMismatch, UseReplayResult } from "./hooks/use-replay";
 export { useLlmChat } from "./hooks/use-llm-chat";
+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 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 { ConnectorPanel } from "./components/ConnectorPanel";
+export type { ConnectorPanelProps } from "./components/ConnectorPanel";
+export { PluginConnectorList } from "./components/PluginConnectorList";
+export type { ConfiguringPlugin, PluginConnectorListProps } from "./components/PluginConnectorList";
+export { useSessionPluginActivation } from "./components/use-session-plugin-activation";
+export type { UseSessionPluginActivationResult } from "./components/use-session-plugin-activation";
+export { catalogToConnectorItems, filterConnectorItems, mergeConnectorItems, } from "./components/plugin-connector";
+export type { PluginConnectorItem } from "./components/plugin-connector";
+export { selectionFromItem, triggerSummary, TRIGGER_ICON_LIMIT } from "./components/connector-panel-types";
+export type { PluginConnectorSelection, TriggerSummary, } from "./components/connector-panel-types";
+export { SessionPluginSelector } from "./components/SessionPluginSelector";
+export type { SessionPluginSelectorProps } from "./components/SessionPluginSelector";
+export { SessionPluginIcon, sessionPluginLabel } from "./components/SessionPluginIcon";
+export type { SessionPluginIconProps, SessionPluginLabelProps } from "./components/SessionPluginIcon";
+export { PluginTriggerStack } from "./components/PluginTriggerStack";
+export type { PluginTriggerStackProps } from "./components/PluginTriggerStack";
+export { SessionPluginConfigDialog } from "./components/SessionPluginConfigDialog";
+export type { SessionPluginConfigDialogProps } from "./components/SessionPluginConfigDialog";
+export { SessionPluginConfigForm } from "./components/SessionPluginConfigForm";
+export type { SessionPluginConfigDraft, SessionPluginConfigFormProps, } from "./components/SessionPluginConfigForm";
 export { AgentChat } from "./components/AgentChat";
 export type { AgentChatProps } from "./components/AgentChat";
 export { LlmChat } from "./components/LlmChat";
 export type { LlmChatHandle, LlmChatProps } from "./components/LlmChat";
 export type { LlmAdvancedSettings, LlmOverride } from "./components/LlmAdvancedSettings";
 export { MarkdownContent } from "./components/MarkdownContent";
+export { normalizeAdjacentUrlFormatting } from "./components/MarkdownContent";
 export type { MarkdownContentProps } from "./components/MarkdownContent";
+export { WhatIfUserBubble } from "./components/WhatIfUserBubble";
+export type { WhatIfUserBubbleProps } from "./components/WhatIfUserBubble";
+export { parseWhatIfPrompt } from "./lib/whatif-prompt";
+export type { ParsedWhatIfPrompt, WhatIfQuote } from "./lib/whatif-prompt";
 export { ReplayBar } from "./components/ReplayBar";
 export type { ReplayBarProps } from "./components/ReplayBar";
 export { ReplayMismatchPrompt } from "./components/ReplayMismatchPrompt";
 export type { ReplayMismatchPromptProps } from "./components/ReplayMismatchPrompt";
 export type { ToolCallRenderer } from "./components/ToolCallBlock";
+export { CurrentPlanPanel, getPlanUpdateDisplayState, isPlanUpdateTool, PLAN_AUTO_COLLAPSE_MS, parsePlanUpdate, pickCurrentPlanStep, PlanUpdateBlock, } from "./components/PlanUpdateBlock";
+export type { PlanStepStatus, PlanUpdateData, PlanUpdateDisplayState, } from "./components/PlanUpdateBlock";
+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 { McpAppCard } from "./components/McpAppCard";
+export type { McpAppMessage } from "./components/McpAppCard";
+export { SessionMemoryToggle } from "./components/SessionMemoryToggle";
+export type { SessionMemoryToggleProps } from "./components/SessionMemoryToggle";
+export { SessionQueuePanel, isQueuePanelVisible } from "./components/SessionQueuePanel";
+export type { SessionQueuePanelProps } from "./components/SessionQueuePanel";
+export { isAgentComputerCommand, isAgentComputerToolCall, classifyAgentComputerLaunchOutcome, } from "./lib/agent-computer-command";
+export type { AgentComputerLaunchOutcome } from "./lib/agent-computer-command";
 export * from "@blade-hq/agent-client";