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

package/dist/components/SessionPluginIcon.d.ts

@@ -0,0 +1,30 @@
+import type { BladeClient, SessionPlugin } from "@blade-hq/agent-client";
+export interface SessionPluginIconProps {
+    client: BladeClient;
+    /**
+     * 会话内已准备的包。传 `null` 时改用账号级目录图标（`/api/plugins/{name}/icon`），
+     * 这样首页这种还没有会话的地方也能显示包内图标。
+     */
+    sessionId: string | null;
+    plugin: Pick<SessionPlugin, "name" | "icon">;
+    /** 边长，默认 20。 */
+    size?: number;
+    /**
+     * 外框形状：`rounded`（默认，面板列表里的小方角）或 `circle`（触发器上的头像堆叠）。
+     * 默认值不动，避免改到列表与第三方接入方的观感。
+     */
+    shape?: "rounded" | "circle";
+    className?: string;
+}
+export interface SessionPluginLabelProps {
+    plugin: Pick<SessionPlugin, "name" | "display_name">;
+}
+/**
+ * Business name for a plugin, falling back to the technical ID.
+ *
+ * The ID stays authoritative for paths, authorization, caching and calls; this
+ * helper only decides what a user reads. Keep it shared — one place decides.
+ */
+export declare function sessionPluginLabel(plugin: Pick<SessionPlugin, "name" | "display_name">): string;
+/** Package-local plugin icon, with a stable generic placeholder. */
+export declare function SessionPluginIcon({ client, sessionId, plugin, size, shape, className }: SessionPluginIconProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionPluginSelector.d.ts

@@ -0,0 +1,10 @@
+import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client";
+export interface SessionPluginSelectorProps {
+    client: BladeClient;
+    sessionId: string;
+    className?: string;
+    side?: "top" | "bottom";
+    onChange?: (plugin: SessionPluginActivation) => void;
+}
+/** Shared selector for AgentChat and the built-in Web; no external query provider required. */
+export declare function SessionPluginSelector(props: SessionPluginSelectorProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionQueuePanel.d.ts

@@ -0,0 +1,74 @@
+import { type QueuedMessage, type SessionQueueSnapshot } from "@blade-hq/agent-client";
+import { type JSX } from "react";
+export interface SessionQueuePanelProps {
+    snapshot: SessionQueueSnapshot;
+    /** 当前是否有可接收补充的运行任务（决定「立刻发送」是否可用） */
+    canDeliver: boolean;
+    /** 正在等服务端确认的条目 id：禁用该条目的操作，避免重复提交 */
+    pendingItemId?: string | null;
+    /** 冲突/失败提示，例如「该消息已开始执行」；展示在面板顶部 */
+    notice?: string | null;
+    onResume: () => void;
+    onCancel: (item: QueuedMessage) => void;
+    onEdit: (item: QueuedMessage, content: string) => boolean | undefined | Promise<boolean>;
+    onRequeue?: (content: string) => Promise<boolean>;
+    onMove: (item: QueuedMessage, delta: -1 | 1) => void;
+    onReorder: (orderedIds: string[]) => void;
+    onDeliver: (item: QueuedMessage) => void;
+    /**
+     * 队列内容与外层留白的宽度类，要和下面输入框用同一个值。
+     *
+     * 队列卡片是"比输入框窄一圈、露在它上方"的形态，所以这里的宽度必须跟着
+     * 输入框走：输入框宽度由调用方决定（内置 Web 默认 max-w-3xl，软件工厂用
+     * `max-w-[748px]!` 覆盖，SDK 侧是 max-w-[748px]）。写死一个值的话，两种
+     * 布局里总有一种对不齐——之前写死 max-w-[748px] 且外层 px-4，而输入框
+     * 外层是 px-5，软件工厂恰好都是 748 看着还行，普通聊天里输入框是 768，
+     * 队列连缩进一起窄了 22px。
+     */
+    contentWidthClassName?: string;
+    /** 根节点附加类。宿主用它在根上重设 `--blade-chat-queue-gutter`（或别的变量）。 */
+    rootClassName?: string;
+    /**
+     * 面板占位状态变化时回调（true = 正在占位）。
+     *
+     * 面板有本地 `editing` 状态：用户编辑到一半、那条等待消息被服务端拿走后，
+     * 面板仍要留在原地保住没保存的正文（见 `detachedEdit`）。这时 `items` 是空的，
+     * 光凭 snapshot 判不出面板还在，宿主就会把输入框上两角恢复成圆角、接缝上露出
+     * 尖角。让面板自己上报，宿主不必也无法复刻这个判据。
+     */
+    onVisibleChange?: (visible: boolean) => void;
+    /**
+     * 面板是否真的紧贴下面的输入框。
+     *
+     * 中间夹着别的内容时（MCP 暂存内容、内置 Web 的 `composerBanner`）两者并不
+     * 相接，这时面板下两角也要圆起来——直角是"被下面的输入框接住"的表示，露出
+     * 直角却下面空着一块，看起来像被削掉一角。
+     *
+     * 不传时读 context（见 `QueuePanelAdjacencyContext`）：面板通常由宿主创建、
+     * 挂进 `ChatSurface`，而"中间有没有内容"是 `ChatSurface` 内部的 state，
+     * 宿主拿不到。内置 Web 自己管布局，直接把值传进来即可。
+     */
+    mergesWithInputBelow?: boolean;
+}
+/**
+ * 队列面板此刻会不会占位。
+ *
+ * 输入框要据此把自己的上两角改成直角：队列贴在它上方、而且比它窄一圈，
+ * 输入框上角若还是 22px 圆弧，那两段弧会从队列两侧露出来，形成两个尖角。
+ *
+ * 抽成一个函数而不是两边各判一次，是为了让"面板可见"和"输入框顶角改直角"
+ * 永远同步——这正是仓库里反复出现的"改了一个入口漏了另一个"。
+ * 传入的 `editing` 是面板自己的本地编辑态，默认 false。
+ */
+export declare function isQueuePanelVisible(snapshot: Pick<SessionQueueSnapshot, "items" | "paused">, notice: string | null | undefined, editing?: boolean): boolean;
+/**
+ * 会话消息队列面板：输入框上方的「待执行 · N」区域。
+ *
+ * 一行一条：左边三条横向的拖动手柄、中间单行截断的正文、右边 hover 才出现的操作
+ * （立刻发送 / 编辑 / 删除）。顺序靠拖动整行调整，手柄上也能用 Alt+↑/↓ 调（键盘
+ * 可达性不能因为去掉上下箭头按钮就没了）。
+ *
+ * 纯展示组件，不持有会话状态；能否编辑/删除/补充全部用 agent-client 的判定函数，
+ * 不在本包重写一份。拖动与键盘调整最终都由调用方提交完整的 pending id 顺序。
+ */
+export declare function SessionQueuePanel({ snapshot, canDeliver, pendingItemId, notice, onResume, onCancel, onEdit, onRequeue, onMove, onReorder, onDeliver, contentWidthClassName, rootClassName, onVisibleChange, mergesWithInputBelow: mergesWithInputBelowProp, }: SessionQueuePanelProps): JSX.Element | null;

package/dist/components/ToolCallBlock.d.ts

@@ -1,5 +1,6 @@
 import type { AskUserAnswerData, ToolCallInfo } from "@blade-hq/agent-client";
 import { type ReactNode } from "react";
+import type { ChatViewClassNames, ChatViewRenderers } from "./ChatSurface";
 /** 接入方自定义渲染器：返回 null 时回落到默认渲染。 */
 export type ToolCallRenderer = (info: ToolCallInfo) => ReactNode | null;
 interface Props {
@@ -8,7 +9,11 @@ interface Props {
     answered?: boolean;
     answerData?: AskUserAnswerData;
     sessionStatus?: string;
-    renderer?: ToolCallRenderer;
+    isActiveQuestion?: boolean;
+    /** 各可见区块的 className 落点；键与元素上的 `blade-chat-*` 锚点一一对应。 */
+    classNames?: ChatViewClassNames;
+    /** 区块级渲染器；返回 null 走默认渲染。 */
+    renderers?: ChatViewRenderers;
 }
 /**
  * 判断提问卡片该等待作答还是展示成已作答，只认工具状态。
@@ -19,10 +24,11 @@ interface Props {
  * 会同时把已经回答过的旧提问重新变成可作答（历史加载不会带回 answerData），
  * 而且会盖住投影层的错误——这个 bug 就是这么藏住的。
  */
-export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fallbackAnswered, }: {
+export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fallbackAnswered, fallbackAwaiting, }: {
     toolStatus: ToolCallInfo["status"];
     hasAnswerData: boolean;
     fallbackAnswered?: boolean;
+    fallbackAwaiting?: boolean;
 }): {
     awaitingAnswer: boolean;
     answered: boolean;
@@ -31,5 +37,5 @@ export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fal
  * 极简工具调用块：状态 + 展示名一行，点开后是参数/结果的 <pre> 折叠展示。
  * AskUserQuestion 特殊处理为提问选项卡片。
  */
-export declare function ToolCallBlock({ toolCall, onAnswer, answered, answerData, sessionStatus, renderer, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ToolCallBlock({ toolCall, onAnswer, answered, answerData, sessionStatus, isActiveQuestion, classNames, renderers, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ToolUiCardView.d.ts

@@ -0,0 +1,9 @@
+import { type ToolUiCard } from "@blade-hq/agent-client";
+/**
+ * MCP Apps 使用 SDK/Web 共享的 AppBridge；恢复只消费留档，不重读资源。
+ * 普通资源卡片仍使用 agent-client 的共享内容判定。
+ */
+export declare function ToolUiCardView({ card, sessionId }: {
+    card: ToolUiCard;
+    sessionId?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/TurnNavRail.d.ts

@@ -0,0 +1,23 @@
+import type { TurnNavItem } from "../hooks/use-turn-navigation";
+export interface TurnNavRailProps {
+    /** 当前会话全部用户发言的目录；少于两条时不渲染（一条没有导航的意义）。 */
+    items: TurnNavItem[];
+    /** 正在高亮的那条发言（视口所在轮，或刚定位到的目标）。 */
+    activeTurnId: string | null;
+    /** 正在请求定位的目标；null 表示没有在途定位。 */
+    loadingTurnId?: string | null;
+    /** 定位失败提示。 */
+    error?: string | null;
+    /** 定位失败的那条发言；重试按钮就再点它一次。 */
+    failedTurnId?: string | null;
+    /** 点击/重试某条发言。 */
+    onSelectTurn: (entryId: string) => void;
+}
+/**
+ * 用户发言的刻度轨：右侧一列刻度，悬停/聚焦展开目录列表。
+ *
+ * 只负责显示和点击，请求、滚动与高亮全在 `useTurnNavigation` 里——内置 Web 那份
+ * rail（apps/web 的 TurnNavRail.tsx）有同样的语义，样式与交互各自实现。
+ * 类名走 `blade-turn-nav-*`：宿主没装 Tailwind 时 style.css 提供等效样式。
+ */
+export declare function TurnNavRail({ items, activeTurnId, loadingTurnId, error, failedTurnId, onSelectTurn, }: TurnNavRailProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/UserMessageBubble.d.ts

@@ -1,4 +1,5 @@
 import type { ChatMessage } from "@blade-hq/agent-client";
+import type { ChatViewClassNames, ChatViewRenderers } from "./ChatSurface";
 export type UserChatMessage = ChatMessage & {
     role: "user";
 };
@@ -9,10 +10,13 @@ export declare function isUserMessage(message: ChatMessage): message is UserChat
 export declare function isErrorMessage(message: ChatMessage): message is ErrorChatMessage;
 interface UserMessageProps {
     message: UserChatMessage;
-    className?: string;
+    /** 各可见区块的 className 落点；键与元素上的 `blade-chat-*` 锚点一一对应。 */
+    classNames?: ChatViewClassNames;
+    /** 区块级渲染器；userMessage 只替换气泡本身，行与附件仍由 SDK 渲染。 */
+    renderers?: ChatViewRenderers;
 }
-/** 用户消息气泡：文本 + 图片/文件附件展示（不含第一方的预览弹窗与 what-if 徽章）。 */
-export declare function UserMessageBubble({ message, className }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
+/** 用户消息气泡：文本、canonical 引用消息与图片/文件附件。 */
+export declare function UserMessageBubble({ message, classNames, renderers }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
 /** 错误消息：居中红色提示条。 */
 export declare function ErrorMessageBlock({ message, className, }: {
     message: ErrorChatMessage;

package/dist/components/WhatIfUserBubble.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedWhatIfPrompt } from "../lib/whatif-prompt";
+export interface WhatIfUserBubbleProps {
+    parsed: ParsedWhatIfPrompt;
+    onQuoteClick?: (stepNumber: number) => void;
+}
+/** SDK 与内置 Web 共用的 canonical 引用消息渲染。 */
+export declare function WhatIfUserBubble({ parsed, onQuoteClick }: WhatIfUserBubbleProps): import("react/jsx-runtime").JSX.Element;

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/blade-chat-element.d.ts

@@ -18,9 +18,10 @@ export declare class BladeChatElement extends HTMLElement {
     connectedCallback(): void;
     /**
      * 自定义样式口子：<blade-chat> 的直接 <style> 子元素会被拷入 Shadow DOM，
-     * 排在内置样式之后（同优先级时后者胜）。配合内置的 .blade-chat-* 类名
-     * 与 CSS 变量（--primary / --background 等，页面直接对 blade-chat 元素
-     * 设置即可穿透），无需构建工具即可深度定制。
+     * 排在内置样式之后（同优先级时后者胜）。配合内置的 .blade-chat-* 类名、
+     * ::part()（每个可见区块都带与锚点同名的 part，如
+     * blade-chat::part(user-bubble)）与 CSS 变量（--primary / --background 等，
+     * 页面直接对 blade-chat 元素设置即可穿透），无需构建工具即可深度定制。
      */
     private adoptUserStyles;
     disconnectedCallback(): void;

package/dist/embed/entry.d.ts

@@ -18,19 +18,47 @@ 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;
+    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;
+    inferToolStatus: typeof agentClient.inferToolStatus;
     buildMessageContent: typeof agentClient.buildMessageContent;
+    chatErrorForDisplay: typeof agentClient.chatErrorForDisplay;
     contentPreview: typeof agentClient.contentPreview;
     extractTextAttachments: typeof agentClient.extractTextAttachments;
     getFileParts: typeof agentClient.getFileParts;
@@ -40,7 +68,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 +112,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 +132,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-YF4GVJGP.js}

@@ -3,7 +3,8 @@ import {
   Ks,
   Qe,
   R
-} from "./chunk-ZXXLY4RM.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
 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-YF4GVJGP.js.map

package/dist/{highlighted-body-B3W2YXNL-YD7FAP6V.js.map → highlighted-body-B3W2YXNL-YF4GVJGP.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;
+};