@blade-hq/agent-client 1.2.1-beta.9 → 2608.0.1

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

@@ -16,7 +16,11 @@ export interface SessionRuntime {
     countFiles(sessionId: string, dirPath?: string): Promise<number>;
     downloadFile(sessionId: string, filePath: string, downloadName?: string): Promise<void>;
     attachAppCli(sessionId: string, definition: AppCliDefinition): Promise<AppCliAttachment>;
-    onDispose(session: AgentSession): void;
+    /**
+     * 归还一份持有。返回 true 表示这是最后一份、实例可以真正释放；
+     * 返回 false 表示还有别的持有者，实例必须继续工作。
+     */
+    onDispose(session: AgentSession): boolean;
 }
 export interface AttachAppOptions {
     /** 可选；只需要页面上下文时无需提供 CLI。 */
@@ -123,7 +127,10 @@ export declare class AgentSession {
     countFiles(dirPath?: string): Promise<number>;
     /** 在浏览器中下载一个工作区文件。 */
     downloadFile(filePath: string, downloadName?: string): Promise<void>;
-    /** 释放订阅与监听器。之后该实例不再接收任何事件。 */
+    /**
+     * 归还一份持有。同一个会话被多处 connect 时按引用计数释放：只有最后
+     * 一份归还才真正断开订阅与监听器，之前的归还不影响仍在使用的一方。
+     */
     dispose(): void;
     get isDisposed(): boolean;
     /** @internal 连接状态变化（同 client 下所有会话共享一条连接）。 */

package/dist/session/hub.d.ts

@@ -9,6 +9,8 @@ export declare class SessionHub {
     private readonly client;
     private readonly sessions;
     private readonly bootstrapPending;
+    /** 每个会话当前有多少方持有（connect 一次 +1，dispose 一次 -1）。 */
+    private readonly holdCounts;
     private connection;
     private readonly connectionListeners;
     private bound;
@@ -18,7 +20,13 @@ export declare class SessionHub {
     getConnection(): ConnectionStatus;
     /** 订阅连接状态变化。 */
     onConnectionChange(listener: (status: ConnectionStatus) => void): () => void;
-    /** 取得（或复用）一个会话的 AgentSession，并完成历史加载 + 房间订阅。 */
+    /**
+     * 取得（或复用）一个会话的 AgentSession，并完成历史加载 + 房间订阅。
+     *
+     * 每次调用都算一份持有，调用方用完必须 `dispose()` 归还。复用同一实例时
+     * 只有最后一份归还才退订房间——否则 StrictMode 双跑、路由抖动这类"连两次
+     * 只释放一次"的场景会把仍在用的会话退订掉，之后所有 turn/chat 事件静默丢失。
+     */
     connect(sessionId: string): Promise<AgentSession>;
     /** 已有实例则返回，不触发网络请求。 */
     peek(sessionId: string): AgentSession | undefined;
@@ -35,6 +43,15 @@ export declare class SessionHub {
      */
     _handleSocketReplaced(): void;
     private runtimeFor;
+    /** 记一份持有。 */
+    private hold;
+    /**
+     * 归还一份持有；还剩别的持有者时返回 false，让 AgentSession 保持可用。
+     * 归零才退订房间并从路由表移除。
+     */
+    private release;
+    /** 不管还有几方持有都立即释放（启动失败、切换身份）。 */
+    private forceRelease;
     private ensureConnected;
     private setConnection;
     /** 事件带 session_id 时精确路由；缺省时按当前唯一活跃会话兜底。 */

package/dist/shared/projection/helpers.d.ts

@@ -26,6 +26,15 @@ export declare function sourceLoopFor(loopId: string, loopDescriptions: Map<stri
     loop_name: string;
     description: string;
 } | null;
+/**
+ * Shared by the streaming and history channels — both must decide "is this
+ * follow-up showable" identically. Returns null when there is nothing to show.
+ */
+export declare function normalizePostChatFollowup(data: Record<string, unknown>, assistantEntryId: string): {
+    assistant_entry_id: string;
+    recaption: string;
+    suggestions: string[];
+} | null;
 export declare function normalizeChildPause(pausePayload: Record<string, unknown>): {
     pauseToolData: Record<string, unknown>;
     childLoopName: string;

package/package.json

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