@blade-hq/agent-client 2610.0.0-beta.6 → 2610.0.0-beta.8

package/dist/schemas/message.d.ts

@@ -70,6 +70,8 @@ export interface ChatMessage {
     duration_ms?: number;
     timestamp?: string;
     entry_id?: string;
+    /** Stable React key retained when an optimistic user message is confirmed. */
+    render_id?: string;
     parent_id?: string | null;
     loop_name?: string;
     /** Entry kind from backend -- present for non-message entries like mode changes. */

package/dist/schemas/projection.d.ts

@@ -59,6 +59,8 @@ export interface TurnProjection {
     context_window?: number;
     memory_refs?: MemoryRef[] | null;
     parent_fork_tool_call_id?: string | null;
+    /** Client-only stable identity for reconciling an optimistic user turn. */
+    client_render_id?: string | null;
     compaction_id?: string | null;
     summary_preview?: string | null;
     summary_full?: string | null;

package/dist/session/state.d.ts

@@ -55,6 +55,7 @@ export interface ReplaySnapshot {
 export declare function toReplaySnapshot(raw: ReplayState | null | undefined): ReplaySnapshot | null;
 export declare function createInitialSessionState(sessionId: string): SessionState;
 export declare function extractModeFromBlocks(blocks: ContentBlock[]): "planning" | "executing" | null;
+export declare function reconcileOptimisticUserTurns(currentTurns: TurnProjection[], incomingTurns: TurnProjection[]): TurnProjection[];
 /**
  * 用一份新的 turn 列表重建会话状态。
  * addErrorMessage 注入的 role==="error" 消息不在 turns 里，默认会被物化过程抹掉；

package/package.json

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

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 136 个公开声明。
+共 137 个公开声明。
 
 ## `acceptedPostChatFollowupCompletesLatestRun` (function)
 
@@ -270,6 +270,7 @@ loop_name: string | undefined
 memory_refs: MemoryRefInfo[] | undefined
 parent_id: string | null | undefined
 reasoning: string | undefined
+render_id: string | undefined
 role: "error" | "user" | "assistant" | "tool"
 status: "streaming" | "completed" | "paused" | "failed" | "interrupted" | undefined
 timestamp: string | undefined
@@ -785,6 +786,12 @@ payload: Record<string, unknown>
 type: string
 ```
 
+## `reconcileOptimisticUserTurns` (function)
+
+```ts
+reconcileOptimisticUserTurns: (currentTurns: TurnProjection[], incomingTurns: TurnProjection[]) => TurnProjection[]
+```
+
 ## `ReplayPreview` (interface)
 
 ```ts
@@ -1328,6 +1335,7 @@ archived_count: number | null | undefined
 archived_files: ArchivedFileInfo[] | null | undefined
 archived_tool_calls: ArchivedToolCallInfo[] | null | undefined
 blocks: ContentBlock[]
+client_render_id: string | null | undefined
 compaction_id: string | null | undefined
 context_window: number | undefined
 duration_ms: number | undefined