@blade-hq/agent-client 2610.0.0-beta.30 → 2610.0.0-beta.32

package/dist/schemas/context.d.ts

@@ -29,6 +29,21 @@ export interface ContextDisplayState {
     detail: string;
     isRemoved: boolean;
 }
+export interface ContextGroupDisplayState {
+    title: string;
+    summary: string;
+    count: number;
+}
 export declare function contextProjectionData(fields: ContextProjectionFields): ContextProjectionData | null;
 /** The single status-to-display mapping used by both React chat surfaces. */
 export declare function getContextDisplayState(context: ContextProjectionData): ContextDisplayState;
+/**
+ * 把一段渲染序列里连续的 Context 归成组。
+ *
+ * 入参是序列里每一项的 context kind，非 Context 项传 null；返回每一段连续
+ * Context 的下标数组。纯下标运算，不认识任何 UI 类型，所以调试日志、Lite 视图
+ * 和 SDK 卡片可以共用同一份分组判定，各自只管排版。
+ */
+export declare function groupAdjacentContextRuns(kinds: readonly (string | null)[]): readonly (readonly number[])[];
+/** 折叠行的文案。展开后才逐条显示各自的标题与状态。 */
+export declare function getContextGroupDisplayState(contexts: readonly ContextProjectionData[]): ContextGroupDisplayState;

package/dist/schemas/message-utils.d.ts

@@ -5,7 +5,9 @@ export declare function normalizeMessageContent(content: unknown): MessageConten
 export declare function getTextContent(content: MessageContent): string;
 export declare function isSystemReminderText(text: string): boolean;
 export declare function isLegacyForkContextText(text: string): boolean;
-export declare function isHiddenInternalMessage(message: Pick<ChatMessage, "role" | "content">): boolean;
+export declare function isHiddenInternalMessage(message: Pick<ChatMessage, "role" | "content">, options?: {
+    includeLegacyForkContext?: boolean;
+}): boolean;
 export declare function buildMessageContent(text: string, attachments: Array<{
     kind: "file";
     name: string;

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

@@ -76,11 +76,13 @@ export declare class AgentSession {
     private patchFlushCancel;
     private joined;
     private joinPending;
+    private subscriptionQueue;
     private replayQueue;
     private pendingReplayMessage;
     private pendingReplayMode;
     private pendingReplayKbIds;
     private recentChatEndAt;
+    private subscriptionReplaySource;
     private disposed;
     private getAppContext;
     private sendPending;
@@ -152,6 +154,8 @@ export declare class AgentSession {
     _rejoinAfterReconnect(): Promise<void>;
     /** @internal 首次连接：加载历史 + 加入房间。 */
     _bootstrap(): Promise<void>;
+    /** 订阅生命周期串行执行；一次失败只由自己的调用方观察，不截断后续重连。 */
+    private enqueueSubscription;
     /** 改回放是 owner 专属（服务端 PATCH 走 _get_owned_session）。 */
     private get canControlReplay();
     /** 拉一次会话详情，填回放状态和只读身份；失败按非回放会话处理，不挡启动。 */
@@ -169,7 +173,7 @@ export declare class AgentSession {
     /** @internal */
     _handleTurnEnd(turn: TurnProjection): void;
     /** @internal 历史回放通道（event_format: raw）。 */
-    _handleTurnEvents(events: RawEvent[]): void;
+    _handleTurnEvents(events: RawEvent[], replayed?: boolean): void;
     /** @internal */
     _handleChatStart(): void;
     /** @internal */
@@ -215,6 +219,8 @@ export declare class AgentSession {
     private dispatchCommand;
     private notifySandboxOom;
     private syncTurnsFromHistory;
+    /** 首次订阅前的 REST 历史建立语义事件基线，随后同一工具的订阅回放不再投递。 */
+    private seedToolCallDeliveryBaseline;
     /**
      * 把历史里的指令补投给宿主页面。
      *

package/dist/session/events.d.ts

@@ -23,6 +23,8 @@ export interface AgentSessionEvents {
     toolResult: {
         toolCall: ToolCallInfo;
         turn: TurnProjection;
+        /** 实时到达，或首次连接/断线重连时由服务端回放。 */
+        source: "live" | "bootstrap_replay" | "reconnect_replay";
     };
     /** 一轮回复结束。status: completed / paused / interrupted / failed。 */
     chatEnd: {

package/dist/session/hub.d.ts

@@ -1,6 +1,13 @@
 import type { BladeClient } from "../blade-client";
 import { AgentSession } from "./agent-session";
 import type { ConnectionStatus } from "./state";
+export interface SessionConnectOptions {
+    /**
+     * 在会话进入事件路由后、历史加载与房间订阅开始前同步执行。
+     * 适合安装不能漏掉 bootstrap 回放事件的监听器。
+     */
+    setup?: (session: AgentSession) => void;
+}
 /**
  * 每个 BladeClient 一个：管理一条 Socket.IO 连接，按 session_id 把事件
  * 路由给各 AgentSession 实例。多会话共享连接、状态互不干扰。
@@ -27,7 +34,7 @@ export declare class SessionHub {
      * 只有最后一份归还才退订房间——否则 StrictMode 双跑、路由抖动这类"连两次
      * 只释放一次"的场景会把仍在用的会话退订掉，之后所有 turn/chat 事件静默丢失。
      */
-    connect(sessionId: string): Promise<AgentSession>;
+    connect(sessionId: string, options?: SessionConnectOptions): Promise<AgentSession>;
     /** 已有实例则返回，不触发网络请求。 */
     peek(sessionId: string): AgentSession | undefined;
     /** 手动重连（例如登录态变化后）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blade-hq/agent-client",
-  "version": "2610.0.0-beta.30",
+  "version": "2610.0.0-beta.32",
   "description": "Blade Agent 框架无关客户端：会话实时状态机、REST 通道、弹窗登录、页面协作。浏览器与 Node.js 通用。",
   "repository": {
     "type": "git",

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 158 个公开声明。
+共 162 个公开声明。
 
 ## `acceptedPostChatFollowupCompletesLatestRun` (function)
 
@@ -89,7 +89,7 @@ sessionUpdated: { intent?: string; status?: SessionStatus; model?: string | null
 taskListUpdated: { tasks: unknown[]; }
 toolCall: { toolCall: ToolCallInfo; turn: TurnProjection; }
 toolPreview: { toolCallId: string; type: "resource-html" | "resource-uri"; content: string; title: string; }
-toolResult: { toolCall: ToolCallInfo; turn: TurnProjection; }
+toolResult: { toolCall: ToolCallInfo; turn: TurnProjection; source: "live" | "bootstrap_replay" | "reconnect_replay"; }
 workspaceChanged: { filePath?: string; }
 ```
 
@@ -394,6 +394,14 @@ summary: string
 title: string
 ```
 
+## `ContextGroupDisplayState` (interface)
+
+```ts
+count: number
+summary: string
+title: string
+```
+
 ## `contextProjectionData` (function)
 
 ```ts
@@ -567,6 +575,12 @@ target: string
 getContextDisplayState: (context: ContextProjectionData) => ContextDisplayState
 ```
 
+## `getContextGroupDisplayState` (function)
+
+```ts
+getContextGroupDisplayState: (contexts: readonly ContextProjectionData[]) => ContextGroupDisplayState
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -621,6 +635,12 @@ export type GlobalSearchResultItem =
   | GlobalSearchFileResult
 ```
 
+## `groupAdjacentContextRuns` (function)
+
+```ts
+groupAdjacentContextRuns: (kinds: readonly (string | null)[]) => readonly (readonly number[])[]
+```
+
 ## `groupMessagesByLoop` (function)
 
 ```ts
@@ -672,7 +692,7 @@ isCommandEnvelope: (value: unknown) => value is CommandEnvelope
 ## `isHiddenInternalMessage` (function)
 
 ```ts
-isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boolean
+isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">, options?: { includeLegacyForkContext?: boolean; }) => boolean
 ```
 
 ## `isInboundEnvelope` (function)
@@ -1078,6 +1098,12 @@ memoryEnabled: boolean | undefined
 model: string | undefined
 ```
 
+## `SessionConnectOptions` (interface)
+
+```ts
+setup: ((session: AgentSession) => void) | undefined
+```
+
 ## `SessionContextStats` (interface)
 
 ```ts
@@ -1148,7 +1174,7 @@ tools_tokens: number | null | undefined
 ## `SessionHub` (class)
 
 ```ts
-connect: (sessionId: string) => Promise<AgentSession>
+connect: (sessionId: string, options?: SessionConnectOptions) => Promise<AgentSession>
 disconnect: () => void
 disposeAll: () => void
 getConnection: () => ConnectionStatus