@blade-hq/agent-client 2610.0.0-beta.4 → 2610.0.0-beta.40

package/dist/index.js

@@ -214,6 +214,11 @@ var AuthResource = class {
   }
 };
 
+// src/shared/type-guards.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/resources/headless.ts
 var HeadlessError = class extends Error {
   constructor(message, detail) {
@@ -352,8 +357,7 @@ var HeadlessResource = class {
       socket.on("system:error", onSystemError);
       socket.emit("session:subscribe", {
         session_id,
-        event_format: "raw",
-        stream_tokens: this.client.options.streamTokens !== false
+        event_format: "raw"
       });
       socket.emit(
         "chat:send",
@@ -395,9 +399,6 @@ function errorMessageFromResult(result) {
   }
   return null;
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function ensureSocketConnected(socket, timeoutMs, detail) {
   if (socket.connected) {
     return Promise.resolve();
@@ -425,6 +426,66 @@ function ensureSocketConnected(socket, timeoutMs, detail) {
   });
 }
 
+// src/resources/computers.ts
+function computerState(computer) {
+  if (computer.is_primary) return "primary";
+  if (computer.enabled) return "enabled";
+  return computer.online ? "idle" : "offline";
+}
+function computerOS(computer) {
+  const os = (computer.os ?? "").toLowerCase();
+  if (os.startsWith("darwin") || os.startsWith("mac")) return "macos";
+  if (os.startsWith("windows")) return "windows";
+  if (os.startsWith("linux")) return "linux";
+  return "unknown";
+}
+function computerPlatformLabel(computer) {
+  const os = (computer.os ?? "").trim();
+  const arch = (computer.arch ?? "").trim();
+  if (os && arch) return `${os}/${arch}`;
+  return os || arch || "";
+}
+function computerDaemonVersion(computer) {
+  return (computer.daemon_version ?? "").trim();
+}
+function canToggleComputer(computer) {
+  return !computer.is_primary;
+}
+function sortComputers(computers) {
+  return [...computers].sort((a, b) => {
+    const byCreated = (a.created_at ?? "").localeCompare(b.created_at ?? "");
+    if (byCreated !== 0) return byCreated;
+    return a.label.localeCompare(b.label);
+  });
+}
+var ComputersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * 列出当前用户的全部电脑，带上"在不在线"和"这次会话能不能用"。
+   * 服务端只查库，电脑离线时同样返回，所以拿得到"它离线了"这个结论。
+   */
+  list(sessionId) {
+    return this.client.json(
+      "GET",
+      `/api/sessions/${encodeURIComponent(sessionId)}/computers`
+    );
+  }
+  /**
+   * 启动或停止一台电脑。只改这次会话的可用范围，不会碰远程机器，
+   * 电脑离线时同样能登记，等它上线就直接可用。
+   */
+  setEnabled(sessionId, computer, enabled) {
+    return this.client.json(
+      "PUT",
+      `/api/sessions/${encodeURIComponent(sessionId)}/computers/${encodeURIComponent(computer)}/enabled`,
+      { enabled }
+    );
+  }
+};
+
 // src/resources/models.ts
 var ModelsResource = class {
   constructor(client) {
@@ -473,7 +534,10 @@ var SessionInfo = type({
   "disable_tools?": "string[]",
   "runtime_type?": "string | null",
   "daemon_id?": "string | null",
+  "agent_runtime_id?": "string | null",
   "workspace_path?": "string | null",
+  "ba_version?": "string | null",
+  "sandbox_version?": "string | null",
   "match?": "unknown"
 });
 
@@ -539,7 +603,7 @@ function upsertToolCall(state, toolCallId, toolName, displayName, args) {
     });
   }
 }
-function applyToolResult(state, toolCallId, result, status, durationMs, sourceLoop) {
+function applyToolResult(state, toolCallId, result, status, durationMs, ranInParallel, sourceLoop) {
   let toolName = "";
   let displayName = "";
   let finalResult = result;
@@ -551,6 +615,7 @@ function applyToolResult(state, toolCallId, result, status, durationMs, sourceLo
     }
     const update = { status, result: finalResult };
     if (durationMs != null) update.duration_ms = durationMs;
+    if (ranInParallel != null) update.ran_in_parallel = ranInParallel;
     state.toolCalls[i] = { ...tc, ...update };
     toolName = tc.tool_name;
     displayName = tc.display_name;
@@ -732,11 +797,17 @@ function buildCompactionTurn(sequence, compactionId, loopId, status, data) {
     summary_preview: summaryPreview,
     summary_full: summaryFull,
     archived_count: archivedCount,
+    archived_files: Array.isArray(data.archived_files) ? data.archived_files.filter(
+      (item) => typeof item === "object" && item !== null && !Array.isArray(item)
+    ) : null,
+    archived_tool_calls: Array.isArray(data.archived_tool_calls) ? data.archived_tool_calls.filter(
+      (item) => typeof item === "object" && item !== null && !Array.isArray(item)
+    ) : null,
     tokens_before: tokensBefore,
     tokens_after: tokensAfter,
     saved_ratio: savedRatio,
     trigger: asTrigger(data.trigger),
-    failure_reason: typeof data.reason === "string" && data.reason ? data.reason : null,
+    failure_reason: [data.failure_reason, data.fallback_reason, data.reason].find((value) => typeof value === "string" && value.length > 0) ?? null,
     fallback_applied: typeof data.fallback_applied === "boolean" ? data.fallback_applied : null
   };
 }
@@ -991,6 +1062,9 @@ function createTurnState(turnId, loopId, opts = {}) {
     toolCalls: [],
     usage: null,
     responseDone: false,
+    firstTokenMs: null,
+    streamDurationMs: null,
+    firstTokenDeliveryMs: null,
     memoryRefs: opts.memoryRefs ?? null,
     parentForkToolCallId: null
   };
@@ -1009,6 +1083,9 @@ function snapshot(state, sequence, status) {
     model: state.model,
     usage: state.usage ? { ...state.usage } : null,
     duration_ms: Math.max(0, Date.now() - state.startedAt),
+    first_token_ms: state.firstTokenMs,
+    stream_duration_ms: state.streamDurationMs,
+    first_token_delivery_ms: state.firstTokenDeliveryMs,
     started_at: new Date(state.startedAt).toISOString(),
     context_window: state.contextWindow,
     memory_refs: state.memoryRefs,
@@ -1023,10 +1100,130 @@ function toolStatusFromResult(result) {
   return inferToolStatus(text);
 }
 
+// src/schemas/context.ts
+var BUILTIN_CONTEXT_TITLES = {
+  "agent-instructions": "\u9879\u76EE\u8BF4\u660E",
+  "skill-catalog": "\u53EF\u7528\u80FD\u529B",
+  "runtime-context": "\u5F53\u524D\u5DE5\u4F5C\u73AF\u5883",
+  "workspace-context": "\u5F53\u524D\u5DE5\u4F5C\u533A\u73AF\u5883"
+};
+var BUILTIN_CONTEXT_DETAILS = {
+  "agent-instructions": "\u8FD9\u4E9B\u8BF4\u660E\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u7406\u89E3\u5F53\u524D\u9879\u76EE\u548C\u5DE5\u4F5C\u8981\u6C42\u3002",
+  "skill-catalog": "\u8FD9\u4E9B\u80FD\u529B\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u9009\u62E9\u5408\u9002\u7684\u65B9\u5F0F\u5B8C\u6210\u4EFB\u52A1\u3002",
+  "runtime-context": "\u8FD9\u4E9B\u4FE1\u606F\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u4E86\u89E3\u5F53\u524D\u6587\u4EF6\u5939\u548C\u8FD0\u884C\u6761\u4EF6\u3002",
+  "workspace-context": "\u8FD9\u4E9B\u4FE1\u606F\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u4E86\u89E3\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u3001\u6587\u4EF6\u548C\u8FD0\u884C\u73AF\u5883\u3002"
+};
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function contextProjectionData(fields) {
+  const contextKind = nonEmptyString(fields.context_kind);
+  const contextKey = nonEmptyString(fields.context_key);
+  const contextName = nonEmptyString(fields.context_name);
+  const contextRevision = nonEmptyString(fields.context_revision);
+  if (!contextKind || !contextKey || !contextName || !contextRevision || typeof fields.context_order !== "number" || !Number.isFinite(fields.context_order) || !fields.context_action) {
+    return null;
+  }
+  return {
+    context_kind: contextKind,
+    context_key: contextKey,
+    context_name: contextName,
+    context_order: fields.context_order,
+    context_action: fields.context_action,
+    context_revision: contextRevision,
+    display_title: nonEmptyString(fields.display_title),
+    display_summary: nonEmptyString(fields.display_summary),
+    sources: Array.isArray(fields.sources) ? fields.sources : []
+  };
+}
+function getContextDisplayState(context) {
+  const title = nonEmptyString(context.display_title) ?? BUILTIN_CONTEXT_TITLES[context.context_kind] ?? "\u5BF9\u8BDD\u80CC\u666F";
+  const isRemoved = context.context_action === "removed";
+  const summary = nonEmptyString(context.display_summary) ?? (isRemoved ? "\u5DF2\u505C\u6B62\u7528\u4E8E\u540E\u7EED\u5BF9\u8BDD" : context.context_action === "retained" ? "\u7EE7\u7EED\u7528\u4E8E\u540E\u7EED\u5BF9\u8BDD" : context.context_kind === "agent-instructions" ? "\u5DF2\u66F4\u65B0\u672C\u6B21\u5BF9\u8BDD\u4F7F\u7528\u7684\u9879\u76EE\u8BF4\u660E" : context.context_kind === "skill-catalog" ? "\u5DF2\u66F4\u65B0\u672C\u6B21\u53EF\u7528\u80FD\u529B" : context.context_kind === "runtime-context" ? "\u5DF2\u66F4\u65B0\u672C\u6B21\u5DE5\u4F5C\u73AF\u5883" : context.context_kind === "workspace-context" ? "\u5DF2\u66F4\u65B0\u672C\u6B21\u5DE5\u4F5C\u533A\u73AF\u5883" : "\u5DF2\u66F4\u65B0\u672C\u6B21\u5BF9\u8BDD\u80CC\u666F");
+  const detail = isRemoved ? `${title}\u5DF2\u4E0D\u518D\u7528\u4E8E\u540E\u7EED\u5BF9\u8BDD\u3002` : BUILTIN_CONTEXT_DETAILS[context.context_kind] ?? "\u8FD9\u4E9B\u4FE1\u606F\u4F1A\u5E2E\u52A9\u667A\u80FD\u4F53\u7406\u89E3\u5F53\u524D\u4EFB\u52A1\u3002";
+  return { title, summary, detail, isRemoved };
+}
+function groupAdjacentContextRuns(kinds) {
+  const runs = [];
+  let current = null;
+  kinds.forEach((kind, index) => {
+    if (kind === null) {
+      current = null;
+      return;
+    }
+    if (current === null) {
+      current = [];
+      runs.push(current);
+    }
+    current.push(index);
+  });
+  return runs;
+}
+function getContextGroupDisplayState(contexts) {
+  const count = contexts.length;
+  if (count === 1) {
+    const single = getContextDisplayState(contexts[0]);
+    return { title: single.title, summary: single.summary, count };
+  }
+  const removed = contexts.filter(
+    (context) => context.context_action === "removed"
+  ).length;
+  const updated = count - removed;
+  const parts = [];
+  if (updated > 0) parts.push(`${updated} \u9879\u5DF2\u66F4\u65B0`);
+  if (removed > 0) parts.push(`${removed} \u9879\u5DF2\u505C\u7528`);
+  return {
+    title: "\u5BF9\u8BDD\u80CC\u666F",
+    summary: parts.join(" \xB7 ") || `${count} \u9879`,
+    count
+  };
+}
+
+// src/shared/projection/context.ts
+function buildContextTurn(entry, sequence) {
+  if (entry.kind !== "context" || !isRecord(entry.source) || !isRecord(entry.data)) {
+    return null;
+  }
+  const display = isRecord(entry.data.display) ? entry.data.display : {};
+  const message = isRecord(entry.message) ? entry.message : {};
+  const context = contextProjectionData({
+    context_kind: typeof entry.source.kind === "string" ? entry.source.kind : null,
+    context_key: typeof entry.source.key === "string" ? entry.source.key : null,
+    context_name: typeof entry.data.contribution_name === "string" ? entry.data.contribution_name : null,
+    context_order: typeof entry.data.order === "number" ? entry.data.order : null,
+    context_action: entry.data.action === "published" || entry.data.action === "retained" || entry.data.action === "removed" ? entry.data.action : null,
+    context_revision: typeof entry.data.revision === "string" ? entry.data.revision : null,
+    display_title: typeof display.title === "string" ? display.title : null,
+    display_summary: typeof display.summary === "string" ? display.summary : null,
+    sources: Array.isArray(display.sources) ? display.sources.filter(isRecord) : []
+  });
+  if (!context) return null;
+  const turnId = typeof entry.id === "string" && entry.id ? entry.id : `context-${sequence}`;
+  return {
+    id: turnId,
+    sequence,
+    turn_id: turnId,
+    loop_id: typeof entry.loop_name === "string" && entry.loop_name ? entry.loop_name : "root",
+    kind: "context",
+    role: "system",
+    status: "completed",
+    blocks: [],
+    tool_calls: [],
+    model: null,
+    usage: null,
+    duration_ms: 0,
+    context_content: Object.hasOwn(message, "content") ? message.content : null,
+    ...context
+  };
+}
+
 // src/shared/projection/builder.ts
+function acknowledgeTurnEvents(acknowledge) {
+  acknowledge?.();
+}
 function hasChatRunEvent(events) {
   return events.some(
-    (event) => event.type !== "session:post_chat_followup" && !event.type.startsWith("compaction:")
+    (event) => event.type !== "llm:first_token:delivered" && event.type !== "session:post_chat_followup" && !event.type.startsWith("compaction:")
   );
 }
 function acceptedPostChatFollowupCompletesLatestRun(events, updates) {
@@ -1058,7 +1255,8 @@ function completedResponseText(content) {
   ).filter((part) => part.type === "text").map((part) => String(part.text ?? "")).join("");
 }
 function replaceTextContent(state, content) {
-  if (state.blocks.some((block) => block.type === "text")) return;
+  const currentContent = state.blocks.filter((block) => block.type === "text").map((block) => String(block.content ?? "")).join("");
+  if (currentContent === content) return;
   const replacement = { type: "text", content };
   const blocks = [];
   let inserted = false;
@@ -1078,10 +1276,36 @@ function replaceTextContent(state, content) {
   }
   state.blocks = blocks;
 }
+function applyResponseBlockOrder(state, value) {
+  if (!Array.isArray(value)) return false;
+  const ordered = [];
+  for (const item of value) {
+    if (typeof item !== "object" || item === null || Array.isArray(item)) continue;
+    const block = item;
+    if (block.type === "text" || block.type === "thinking") {
+      const content = String(block[block.type] ?? "");
+      if (content) ordered.push({ type: block.type, content });
+      continue;
+    }
+    if (block.type !== "tool_call") continue;
+    const toolCallId = String(block.id ?? "");
+    const toolBlock = state.blocks.find(
+      (candidate) => candidate.type === "tool_use" && candidate.tool_call_id === toolCallId
+    );
+    if (toolBlock) ordered.push(toolBlock);
+  }
+  if (ordered.length === 0 && value.length > 0) return false;
+  const unrelatedBlocks = state.blocks.filter(
+    (block) => block.type !== "text" && block.type !== "thinking" && block.type !== "tool_use"
+  );
+  state.blocks = [...ordered, ...unrelatedBlocks];
+  return true;
+}
 var ClientProjectionBuilder = class {
   activeTurns = /* @__PURE__ */ new Map();
   lastTurnIds = /* @__PURE__ */ new Map();
   latestTurns = /* @__PURE__ */ new Map();
+  turnsById = /* @__PURE__ */ new Map();
   loopDescriptions = /* @__PURE__ */ new Map();
   pendingChildPauses = /* @__PURE__ */ new Map();
   pendingMemoryRefs = /* @__PURE__ */ new Map();
@@ -1117,6 +1341,8 @@ var ClientProjectionBuilder = class {
         return this.onMemoryInject(loopId, payload);
       case "memory:inject:none":
         return null;
+      case "context:entry":
+        return this.onContextEntry(payload);
       case "loop:turn":
         return this.onLoopTurn(loopId, payload);
       case "mode:change":
@@ -1140,6 +1366,25 @@ var ClientProjectionBuilder = class {
     }
     if (event.type.startsWith("compaction:"))
       return this.onCompaction(event.type, loopId, payload);
+    if (event.type === "llm:first_token:delivered") {
+      const targetTurnId = String(payload.turn_id ?? "");
+      const active = this.activeTurns.get(loopId);
+      if (active && (!targetTurnId || active.turnId === targetTurnId)) {
+        this.applyFirstTokenDelivery(active, payload);
+        return this.syncPatch(active);
+      }
+      const latest = targetTurnId ? this.turnsById.get(targetTurnId) : this.latestTurns.get(loopId);
+      const duration = payload.first_token_delivery_ms;
+      if (!latest || latest.role !== "assistant" || typeof duration !== "number" || duration < 0) {
+        return null;
+      }
+      const turn = { ...latest, first_token_delivery_ms: duration };
+      this.turnsById.set(turn.turn_id, turn);
+      if (this.latestTurns.get(loopId)?.turn_id === turn.turn_id) {
+        this.latestTurns.set(loopId, turn);
+      }
+      return [{ kind: "upsert", turn }];
+    }
     const state = this.activeTurns.get(loopId);
     if (!state) {
       if (event.type === "chat:end") {
@@ -1155,16 +1400,28 @@ var ClientProjectionBuilder = class {
         state.toolCalls = [];
         state.usage = null;
         state.responseDone = false;
+        state.firstTokenMs = null;
+        state.streamDurationMs = null;
+        state.firstTokenDeliveryMs = null;
         return this.syncPatch(state);
       case "llm:thinking:delta":
+        this.applyFirstTokenDelivery(state, payload);
         return this.onDelta(state, "thinking", "", String(payload.content ?? ""));
       case "llm:content:delta":
+        this.applyFirstTokenDelivery(state, payload);
         return this.onDelta(state, "text", "", String(payload.content ?? ""));
       case "llm:content:complete":
         replaceTextContent(state, String(payload.content ?? ""));
         return this.syncPatch(state);
+      case "llm:content:done":
+        this.applyStreamTiming(state, payload);
+        return this.syncPatch(state);
       case "llm:tool_call:created":
+        this.applyFirstTokenDelivery(state, payload);
         return this.onToolCallCreated(state, payload);
+      case "llm:tool_call:arguments:delta":
+        this.applyFirstTokenDelivery(state, payload);
+        return this.onToolCallArgumentsDelta(state, payload);
       case "llm:response:done":
         return this.onResponseDone(state, loopId, payload);
       case "tool:result:delta":
@@ -1191,6 +1448,7 @@ var ClientProjectionBuilder = class {
     this.activeTurns.clear();
     this.lastTurnIds.clear();
     this.latestTurns.clear();
+    this.turnsById.clear();
     this.loopDescriptions.clear();
     this.pendingChildPauses.clear();
     this.pendingMemoryRefs.clear();
@@ -1206,15 +1464,18 @@ var ClientProjectionBuilder = class {
   }
   _seedTurns(turns) {
     const latestTurns = /* @__PURE__ */ new Map();
+    const turnsById = /* @__PURE__ */ new Map();
     for (const turn of turns) {
       this.seedSequence(turn.sequence);
       if (!isConversationTurn(turn)) continue;
+      turnsById.set(turn.turn_id, turn);
       const current = latestTurns.get(turn.loop_id);
       if (!current || turn.sequence >= current.sequence) {
         latestTurns.set(turn.loop_id, turn);
       }
     }
     this.latestTurns = latestTurns;
+    this.turnsById = turnsById;
   }
   // --- Event handlers ---
   onMemoryInject(loopId, payload) {
@@ -1232,6 +1493,11 @@ var ClientProjectionBuilder = class {
     }
     return null;
   }
+  onContextEntry(payload) {
+    if (!isRecord(payload.entry)) return null;
+    const turn = buildContextTurn(payload.entry, this.nextSeq());
+    return turn ? [{ kind: "upsert", turn }] : null;
+  }
   onLoopTurn(loopId, payload) {
     let turnId = String(payload.turn_id ?? this.nextTurnId(`turn:${loopId}`));
     let memoryRefs = null;
@@ -1252,6 +1518,7 @@ var ClientProjectionBuilder = class {
     this.lastTurnIds.set(loopId, turnId);
     const turn = snapshot(state, this.nextSeq(), "streaming");
     this.latestTurns.set(loopId, turn);
+    this.turnsById.set(turn.turn_id, turn);
     return [{ kind: "upsert", turn }];
   }
   onModeChange(loopId, payload) {
@@ -1288,11 +1555,11 @@ var ClientProjectionBuilder = class {
         loopId,
         toolCallId: optStr(payload.tool_call_id) ?? void 0,
         toolName: toolNameFromPayload(payload) ?? void 0,
-        workspacePath: isRecord2(payload.workspace_change) ? optStr(payload.workspace_change.to) ?? void 0 : void 0
+        workspacePath: isRecord(payload.workspace_change) ? optStr(payload.workspace_change.to) ?? void 0 : void 0
       }
     ];
     const change = payload.workspace_change;
-    if (isRecord2(change)) {
+    if (isRecord(change)) {
       const source = optStr(change.source) ?? "";
       const projectName = optStr(change.project_name) ?? "";
       const fromPath = optStr(change.from) ?? "";
@@ -1385,7 +1652,32 @@ var ClientProjectionBuilder = class {
     }
     const directTurn = this.activeTurns.get(loopId) ?? this.latestTurns.get(loopId);
     setToolCallStatus(directTurn, toolCallId, "done", null, null);
-    return this.collectLoopUpdates(loopId, parentLoopId);
+    const updates = this.collectLoopUpdates(loopId, parentLoopId);
+    const entryId = typeof payload.entry_id === "string" ? payload.entry_id : "";
+    if (!entryId) return updates;
+    const answerData = isRecord(payload.answer_data) ? payload.answer_data : {};
+    const answerTurn = {
+      id: entryId,
+      sequence: this.nextSeq(),
+      turn_id: entryId,
+      loop_id: loopId,
+      kind: "message",
+      role: "assistant",
+      status: "completed",
+      blocks: [
+        {
+          type: "ask_user_answer",
+          content: answerData,
+          tool_call_id: toolCallId || null
+        }
+      ],
+      tool_calls: [],
+      model: null,
+      usage: null,
+      duration_ms: 0,
+      client_request_id: typeof payload.client_request_id === "string" ? payload.client_request_id : null
+    };
+    return [...updates, { kind: "upsert", turn: answerTurn }];
   }
   onUserMessage(_loopId, payload) {
     const entryId = String(payload.entry_id ?? this.nextTurnId("user"));
@@ -1402,7 +1694,8 @@ var ClientProjectionBuilder = class {
       tool_calls: [],
       model: null,
       usage: null,
-      duration_ms: 0
+      duration_ms: 0,
+      client_request_id: typeof payload.client_request_id === "string" ? payload.client_request_id : null
     };
     this.latestTurns.set("root", turn);
     return [{ kind: "upsert", turn }];
@@ -1430,13 +1723,7 @@ var ClientProjectionBuilder = class {
   }
   onToolCallCreated(state, payload) {
     if ("arguments_delta" in payload) {
-      const delta = String(payload.arguments_delta ?? "");
-      const toolCallId2 = String(payload.id ?? "");
-      if (delta && toolCallId2) {
-        appendToolCallArguments(state, toolCallId2, delta);
-        return this.syncPatch(state);
-      }
-      return null;
+      return this.onToolCallArgumentsDelta(state, payload);
     }
     const toolCallId = String(payload.id ?? "");
     const toolName = toolNameFromPayload(payload);
@@ -1445,16 +1732,21 @@ var ClientProjectionBuilder = class {
     upsertToolCall(state, toolCallId, toolName, displayName, args);
     return this.syncPatch(state);
   }
+  onToolCallArgumentsDelta(state, payload) {
+    const delta = String(payload.arguments_delta ?? "");
+    const toolCallId = String(payload.id ?? "");
+    if (!delta || !toolCallId) return null;
+    appendToolCallArguments(state, toolCallId, delta);
+    return this.syncPatch(state);
+  }
   onResponseDone(state, loopId, payload) {
     state.responseDone = true;
+    this.applyStreamTiming(state, payload);
     const model = optStr(payload.model);
     if (model) state.model = model;
     if (typeof payload.usage === "object" && payload.usage !== null) {
       state.usage = { ...payload.usage };
     }
-    if ("content" in payload) {
-      replaceTextContent(state, completedResponseText(payload.content));
-    }
     const toolCalls = payload.tool_calls;
     if (Array.isArray(toolCalls)) {
       for (const raw of toolCalls) {
@@ -1472,11 +1764,35 @@ var ClientProjectionBuilder = class {
         );
       }
     }
-    if (state.toolCalls.length === 0) {
+    if (!applyResponseBlockOrder(state, payload.response_blocks) && "content" in payload) {
+      replaceTextContent(state, completedResponseText(payload.content));
+    }
+    const isNativeProviderResponse = typeof payload.provider === "string" && payload.provider !== "";
+    if (state.toolCalls.length === 0 || isNativeProviderResponse && state.toolCalls.every(
+      (toolCall) => toolCall.status !== "pending" && toolCall.status !== "awaiting_answer"
+    )) {
       return this.finalize(loopId, "completed");
     }
     return this.syncPatch(state);
   }
+  applyFirstTokenDelivery(state, payload) {
+    const firstTokenMs = payload.first_token_ms;
+    if (state.firstTokenMs === null && typeof firstTokenMs === "number" && firstTokenMs >= 0) {
+      state.firstTokenMs = Math.round(firstTokenMs);
+    }
+    const duration = payload.first_token_delivery_ms;
+    if (state.firstTokenDeliveryMs === null && typeof duration === "number" && duration >= 0) {
+      state.firstTokenDeliveryMs = duration;
+    }
+  }
+  applyStreamTiming(state, payload) {
+    if (typeof payload.first_token_ms === "number" && payload.first_token_ms >= 0) {
+      state.firstTokenMs = Math.round(payload.first_token_ms);
+    }
+    if (typeof payload.stream_duration_ms === "number" && payload.stream_duration_ms >= 0) {
+      state.streamDurationMs = Math.round(payload.stream_duration_ms);
+    }
+  }
   onToolResultDone(state, loopId, payload) {
     const toolCallId = String(payload.tool_call_id ?? "");
     const streamedResult = state.toolCalls.find((toolCall) => toolCall.id === toolCallId)?.result;
@@ -1484,9 +1800,11 @@ var ClientProjectionBuilder = class {
     const status = toolStatusFromResult(content);
     const rawDuration = payload.duration_ms;
     const durationMs = typeof rawDuration === "number" && rawDuration >= 0 ? Math.round(rawDuration) : null;
+    const ranInParallel = typeof payload.ran_in_parallel === "boolean" ? payload.ran_in_parallel : null;
     const sl = sourceLoopFor(state.loopId, this.loopDescriptions);
-    applyToolResult(state, toolCallId, content, status, durationMs, sl);
-    if (this.shouldFinalizeAfterToolResults(state)) {
+    applyToolResult(state, toolCallId, content, status, durationMs, ranInParallel, sl);
+    const isNativeProviderResult = typeof payload.provider === "string" && payload.provider !== "";
+    if (!isNativeProviderResult && this.shouldFinalizeAfterToolResults(state)) {
       return this.finalize(loopId, "completed");
     }
     return this.syncPatch(state);
@@ -1515,10 +1833,13 @@ var ClientProjectionBuilder = class {
   onToolBridge(state, payload) {
     const bridge = payload.bridge;
     if (typeof bridge !== "object" || bridge === null) return null;
+    const toolCallId = String(payload.tool_call_id ?? "");
+    if (!toolCallId || !state.toolCalls.some((toolCall) => toolCall.id === toolCallId)) return null;
     state.blocks.push({
       type: "tool_bridge",
       content: bridge,
-      tool_call_id: String(payload.tool_call_id ?? "") || null
+      delivery_id: String(payload.delivery_id ?? "") || null,
+      tool_call_id: toolCallId
     });
     return this.syncPatch(state);
   }
@@ -1527,6 +1848,11 @@ var ClientProjectionBuilder = class {
     const toolName = String(payload.tool_name ?? "");
     const displayName = this.displayNameResolver(toolName);
     upsertToolCall(state, toolCallId, toolName, displayName, "");
+    const relatedToolCallId = String(payload.related_tool_call_id ?? "");
+    if (relatedToolCallId && relatedToolCallId !== toolCallId) {
+      const related = state.toolCalls.find((toolCall) => toolCall.id === relatedToolCallId);
+      if (related) related.status = "awaiting_answer";
+    }
     return this.syncPatch(state);
   }
   onChildPause(state, loopId, payload) {
@@ -1707,6 +2033,7 @@ var ClientProjectionBuilder = class {
   syncPatch(state) {
     const turn = snapshot(state, this.nextSeq(), "streaming");
     this.latestTurns.set(state.loopId, turn);
+    this.turnsById.set(turn.turn_id, turn);
     this.lastTurnIds.set(state.loopId, turn.turn_id);
     return [{ kind: "upsert", turn }];
   }
@@ -1717,6 +2044,7 @@ var ClientProjectionBuilder = class {
     const turn = snapshot(state, this.nextSeq(), status);
     this.lastTurnIds.set(loopId, turn.turn_id);
     this.latestTurns.set(loopId, turn);
+    this.turnsById.set(turn.turn_id, turn);
     return [{ kind: "upsert", turn }];
   }
   shouldFinalizeAfterToolResults(state) {
@@ -1754,9 +2082,6 @@ var ClientProjectionBuilder = class {
     return `${prefix}:${this.syntheticCounter}:${hex}`;
   }
 };
-function isRecord2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function optStr(value) {
   if (value == null || value === "") return null;
   return String(value);
@@ -1783,6 +2108,8 @@ function projectHistory(entries) {
   const latestAssistantByLoop = /* @__PURE__ */ new Map();
   const pendingChildPauses = /* @__PURE__ */ new Map();
   const answeredToolCallIds = /* @__PURE__ */ new Set();
+  const nativeToolTurns = /* @__PURE__ */ new Set();
+  const turnEntryAliases = /* @__PURE__ */ new Map();
   let latestRootMessage = null;
   let latestRootAssistant = null;
   let sequence = 0;
@@ -1790,7 +2117,14 @@ function projectHistory(entries) {
     const kind = String(entry.kind ?? "");
     const loopId = String(entry.loop_name ?? "root");
     const id = String(entry.id ?? `history-${sequence + 1}`);
-    if (kind === "post_chat_followup" && isRecord3(entry.data)) {
+    if (kind === "turn_timing" && isRecord(entry.data)) {
+      const turnId = typeof entry.data.turn_id === "string" ? entry.data.turn_id : "";
+      const duration = numberOrNull(entry.data.first_token_delivery_ms);
+      const target = turnEntryAliases.get(turnId);
+      if (target && duration !== null) target.first_token_delivery_ms = duration;
+      continue;
+    }
+    if (kind === "post_chat_followup" && isRecord(entry.data)) {
       const assistantEntryId = String(entry.data.assistant_entry_id ?? "");
       if (latestRootMessage?.role === "assistant" && latestRootMessage.turn_id === assistantEntryId) {
         const followup = normalizePostChatFollowup(entry.data, assistantEntryId);
@@ -1798,7 +2132,15 @@ function projectHistory(entries) {
       }
       continue;
     }
-    if (kind === "message" && isRecord3(entry.message)) {
+    if (kind === "context") {
+      const turn = buildContextTurn(entry, sequence + 1);
+      if (turn) {
+        sequence += 1;
+        turns.push(turn);
+      }
+      continue;
+    }
+    if (kind === "message" && isRecord(entry.message)) {
       const message = entry.message;
       const role = String(message.role ?? "");
       if (role === "tool") {
@@ -1808,6 +2150,9 @@ function projectHistory(entries) {
         if (owner && toolCall) {
           toolCall.status = message._error ? "error" : inferToolStatus(String(message.content ?? ""));
           toolCall.result = message.content ?? "";
+          const duration = numberOrNull(message._duration_ms);
+          if (duration !== null) toolCall.duration_ms = duration;
+          if (message._ran_in_parallel === true) toolCall.ran_in_parallel = true;
           owner.blocks.push({
             type: "tool_result",
             content: message.content ?? "",
@@ -1817,7 +2162,7 @@ function projectHistory(entries) {
         continue;
       }
       if (role !== "user" && role !== "assistant" && role !== "system") continue;
-      const toolCalls = role === "assistant" ? buildToolCalls(message.tool_calls) : [];
+      const toolCalls = role === "assistant" && !message._error ? buildToolCalls(message.tool_calls) : [];
       const blocks = buildBlocks(message, toolCalls);
       const turn = {
         id,
@@ -1830,14 +2175,45 @@ function projectHistory(entries) {
         blocks,
         tool_calls: toolCalls,
         model: stringOrNull(message.model),
-        usage: isRecord3(message._usage) ? { ...message._usage } : null,
+        usage: isRecord(message._usage) ? { ...message._usage } : null,
         duration_ms: numberOrZero(message._duration_ms),
-        started_at: typeof entry.timestamp === "string" ? entry.timestamp : void 0
+        first_token_ms: numberOrNull(message._first_token_ms),
+        stream_duration_ms: numberOrNull(message._stream_duration_ms),
+        started_at: typeof entry.timestamp === "string" ? entry.timestamp : void 0,
+        // fork 子会话的父锚点:历史里落在消息级 _parent_fork_tool_call_id。丢掉它,
+        // 刷新后工作流步骤 fork 就配不回 workflow:run 工具调用(普通 Agent fork 有
+        // root Agent 工具调用兜底配对,工作流 fork 没有,子智能体卡会整体消失)。
+        parent_fork_tool_call_id: stringOrNull(message._parent_fork_tool_call_id)
       };
+      const isNativeToolEntry = role === "assistant" && Array.isArray(message.tool_calls) && message.tool_calls.some(
+        (toolCall) => isRecord(toolCall) && typeof toolCall.provider === "string"
+      );
+      const previousTurn = turns[turns.length - 1];
+      if (role === "assistant" && previousTurn?.role === "assistant" && previousTurn.loop_id === loopId && nativeToolTurns.has(previousTurn)) {
+        nativeToolTurns.delete(previousTurn);
+        previousTurn.blocks.push(...turn.blocks);
+        previousTurn.tool_calls.push(...turn.tool_calls);
+        previousTurn.status = turn.status;
+        previousTurn.model = turn.model ?? previousTurn.model;
+        previousTurn.usage = turn.usage ?? previousTurn.usage;
+        previousTurn.duration_ms = turn.duration_ms || previousTurn.duration_ms;
+        previousTurn.first_token_ms = turn.first_token_ms ?? previousTurn.first_token_ms;
+        previousTurn.stream_duration_ms = turn.stream_duration_ms ?? previousTurn.stream_duration_ms;
+        if (turn.started_at) previousTurn.started_at = turn.started_at;
+        previousTurn.id = turn.id;
+        previousTurn.turn_id = turn.turn_id;
+        if (isNativeToolEntry) nativeToolTurns.add(previousTurn);
+        turnEntryAliases.set(id, previousTurn);
+        if (loopId === "root") latestRootMessage = previousTurn;
+        latestAssistantByLoop.set(loopId, previousTurn);
+        continue;
+      }
       if (loopId === "root" && (role === "user" || role === "assistant")) {
         latestRootMessage = turn;
       }
       turns.push(turn);
+      turnEntryAliases.set(id, turn);
+      if (isNativeToolEntry) nativeToolTurns.add(turn);
       if (role === "assistant") latestAssistantByLoop.set(loopId, turn);
       if (loopId === "root") {
         if (role === "assistant") latestRootAssistant = turn;
@@ -1846,10 +2222,25 @@ function projectHistory(entries) {
       for (const toolCall of toolCalls) toolOwners.set(toolCall.id, turn);
       continue;
     }
+    if (kind === "tool_result") {
+      const data = entry.data ?? {};
+      const toolCallId = String(data.tool_call_id ?? "");
+      const owner = toolOwners.get(toolCallId) ?? findLatestAssistant(turns, loopId);
+      if (owner && toolCallId) {
+        const rawContent = data.content;
+        const content = typeof rawContent === "string" ? rawContent : Array.isArray(rawContent) ? rawContent : String(rawContent ?? "");
+        const status = data.is_error === true ? "error" : inferToolStatus(typeof content === "string" ? content : JSON.stringify(content));
+        setToolCallStatus(owner, toolCallId, status, content, null);
+        if (!owner.blocks.some((block) => block.type === "tool_result" && block.tool_call_id === toolCallId)) {
+          owner.blocks.push({ type: "tool_result", content, tool_call_id: toolCallId });
+        }
+      }
+      continue;
+    }
     if (kind === "mode_change") {
       turns.push(markerTurn(id, ++sequence, loopId, "mode_change", entry.data ?? {}));
     } else if (kind === "workspace_change") {
-      const change = isRecord3(entry.data) ? entry.data : {};
+      const change = isRecord(entry.data) ? entry.data : {};
       const source = stringOrNull(change.source) ?? "";
       const projectName = stringOrNull(change.project_name) ?? "";
       const fromPath = stringOrNull(change.from) ?? "";
@@ -1878,19 +2269,20 @@ function projectHistory(entries) {
     } else if (kind === "tool_ui" || kind === "tool_bridge") {
       const data = entry.data ?? {};
       const toolCallId = String(data.tool_call_id ?? "");
-      const owner = toolOwners.get(toolCallId) ?? findLatestAssistant(turns, loopId);
+      const owner = kind === "tool_bridge" ? toolCallId ? toolOwners.get(toolCallId) : void 0 : toolOwners.get(toolCallId) ?? findLatestAssistant(turns, loopId);
       const content = kind === "tool_ui" ? data.ui : data.bridge;
       if (owner && content !== void 0) {
         owner.blocks.push({
           type: kind,
           content,
+          ...kind === "tool_bridge" ? { delivery_id: id } : {},
           tool_call_id: toolCallId || null
         });
       }
     } else if (kind === "compaction" || kind === "tool_result_archive") {
       const data = entry.data ?? {};
       const compactionId = String(data.compaction_id ?? entry.id ?? `history-${sequence + 1}`);
-      let content = isRecord3(entry.message) ? entry.message.content : void 0;
+      let content = isRecord(entry.message) ? entry.message.content : void 0;
       if (kind === "tool_result_archive") {
         const archivedCount = Array.isArray(data.archived_files) ? data.archived_files.length : 0;
         content = `<compaction-summary>
@@ -1898,18 +2290,24 @@ function projectHistory(entries) {
 </compaction-summary>`;
       }
       turns.push(
-        buildCompactionTurn(++sequence, compactionId, loopId, "completed", {
-          ...data,
-          content
-        })
+        buildCompactionTurn(
+          ++sequence,
+          compactionId,
+          loopId,
+          data.status === "failed" ? "failed" : "completed",
+          {
+            ...data,
+            content
+          }
+        )
       );
     } else if (kind === "child_pause") {
       const data = entry.data ?? {};
-      const sourceLoop = isRecord3(data.source_loop) ? data.source_loop : {};
+      const sourceLoop = isRecord(data.source_loop) ? data.source_loop : {};
       const childLoopId = String(data.child_loop_name ?? sourceLoop.name ?? "");
       const childToolCallId = String(data.child_pause_tool_call_id ?? "");
       const parentToolCallId = String(data.parent_fork_tool_call_id ?? "");
-      const pauseToolData = isRecord3(data.pause_tool_data) ? data.pause_tool_data : {};
+      const pauseToolData = isRecord(data.pause_tool_data) ? data.pause_tool_data : {};
       const description = String(sourceLoop.description ?? "");
       applyAskUserPauseToTurn(
         latestAssistantByLoop.get(childLoopId),
@@ -1997,15 +2395,15 @@ function parseToolArguments(value) {
   if (!value) return {};
   try {
     const parsed = JSON.parse(value);
-    return isRecord3(parsed) ? parsed : {};
+    return isRecord(parsed) ? parsed : {};
   } catch {
     return {};
   }
 }
 function buildToolCalls(value) {
   if (!Array.isArray(value)) return [];
-  return value.filter(isRecord3).map((raw) => {
-    const fn = isRecord3(raw.function) ? raw.function : {};
+  return value.filter(isRecord).map((raw) => {
+    const fn = isRecord(raw.function) ? raw.function : {};
     const name = String(fn.name ?? "");
     return {
       id: String(raw.id ?? ""),
@@ -2021,23 +2419,40 @@ function buildBlocks(message, toolCalls) {
   const displayContent = message.role === "user" ? message._display_content : void 0;
   const stored = message._blocks;
   const blocks = [];
+  const storedToolCallIds = /* @__PURE__ */ new Set();
   if (displayContent !== void 0) {
     blocks.push({ type: "text", content: displayContent });
   } else if (Array.isArray(stored)) {
     for (const raw of stored) {
-      if (!isRecord3(raw)) continue;
+      if (!isRecord(raw)) continue;
       const type3 = String(raw.type ?? "");
       if (type3 === "thinking") blocks.push({ type: type3, content: raw.thinking ?? raw.content ?? "" });
       if (type3 === "text") blocks.push({ type: type3, content: raw.text ?? raw.content ?? "" });
+      if (type3 === "tool_call") {
+        const toolCallId = String(raw.id ?? "");
+        const toolCall = toolCalls.find((candidate) => candidate.id === toolCallId);
+        if (!toolCall) continue;
+        storedToolCallIds.add(toolCallId);
+        blocks.push({
+          type: "tool_use",
+          content: toolCall.arguments,
+          tool_call_id: toolCall.id,
+          tool_name: toolCall.tool_name,
+          display_name: toolCall.display_name
+        });
+      }
     }
   } else if (message.content !== void 0 && message.content !== "") {
     blocks.push({ type: "text", content: message.content });
   }
   for (const toolCall of toolCalls) {
+    if (storedToolCallIds.has(toolCall.id)) continue;
     blocks.push({
       type: "tool_use",
-      content: { name: toolCall.tool_name, arguments: toolCall.arguments },
-      tool_call_id: toolCall.id
+      content: toolCall.arguments,
+      tool_call_id: toolCall.id,
+      tool_name: toolCall.tool_name,
+      display_name: toolCall.display_name
     });
   }
   return blocks;
@@ -2058,15 +2473,15 @@ function markerTurn(id, sequence, loopId, type3, content, toolCallId = null) {
     duration_ms: 0
   };
 }
-function isRecord3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function stringOrNull(value) {
   return typeof value === "string" ? value : null;
 }
 function numberOrZero(value) {
   return typeof value === "number" ? value : 0;
 }
+function numberOrNull(value) {
+  return typeof value === "number" && value >= 0 ? value : null;
+}
 function findLatestAssistant(turns, loopId) {
   for (let index = turns.length - 1; index >= 0; index -= 1) {
     const turn = turns[index];
@@ -2094,13 +2509,13 @@ function toCreateSessionPayload(request) {
     solution_snapshot_session_id: request.solution_snapshot_session_id ?? null,
     compaction_ratio: request.compaction_ratio ?? null,
     ...request.runtime_type ? { runtime_type: request.runtime_type } : {},
-    ...request.daemon_id ? { daemon_id: request.daemon_id } : {}
+    ...request.daemon_id ? { daemon_id: request.daemon_id } : {},
+    ...request.agent_runtime_id ? { agent_runtime_id: request.agent_runtime_id } : {}
   };
 }
 var builtinSolutionIds = /* @__PURE__ */ new Set([
   "app-dev",
   "general_chat",
-  "multica",
   "night_build",
   "skill_editor",
   "smart_bid",
@@ -2329,6 +2744,27 @@ var SessionsResource = class {
     );
     return projectHistory(entries);
   }
+  async getSessionTurnsPage(sessionId, options = {}) {
+    const query = new URLSearchParams();
+    if (options.limit !== void 0) query.set("limit", String(options.limit));
+    if (options.before !== void 0) query.set("before", options.before);
+    const suffix = query.size ? `?${query}` : "";
+    const page = await this.client.json("GET", `/api/sessions/${encodeURIComponent(sessionId)}/turns${suffix}`);
+    return {
+      turns: page.turns,
+      nextBefore: page.next_before,
+      currentMode: page.current_mode
+    };
+  }
+  async getSessionTurnCommands(sessionId) {
+    const commands = await this.client.json("GET", `/api/sessions/${encodeURIComponent(sessionId)}/turn-commands`);
+    return commands.map((command) => ({
+      deliveryId: command.delivery_id,
+      toolCallId: command.tool_call_id ?? void 0,
+      action: command.action,
+      payload: command.payload
+    }));
+  }
   listResultFeedback(sessionId) {
     return this.client.json("GET", `/api/sessions/${encodeURIComponent(sessionId)}/feedback`);
   }
@@ -2700,6 +3136,36 @@ var Emitter = class {
   }
 };
 
+// src/session/history-page.ts
+function sortedUnique(turns) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const turn of turns) byId.set(turn.turn_id, turn);
+  return [...byId.values()].sort((left, right) => left.sequence - right.sequence);
+}
+function prependOlder(current, page) {
+  const currentById = new Map(current.map((turn) => [turn.turn_id, turn]));
+  return sortedUnique([
+    ...current,
+    ...page.map((turn) => {
+      const live = currentById.get(turn.turn_id);
+      return live ? { ...live, sequence: turn.sequence } : turn;
+    })
+  ]);
+}
+function replaceWindow(current, page, liveRevisionAtStart, liveRevisions) {
+  const pageById = new Map(page.map((turn) => [turn.turn_id, turn]));
+  const newerLive = current.filter(
+    (turn) => turn.turn_id.startsWith("local-user-") || (liveRevisions.byTurnId.get(turn.turn_id) ?? 0) > liveRevisionAtStart
+  );
+  return sortedUnique([
+    ...page,
+    ...newerLive.map((turn) => {
+      const snapshot2 = pageById.get(turn.turn_id);
+      return snapshot2 ? { ...turn, sequence: snapshot2.sequence } : turn;
+    })
+  ]);
+}
+
 // src/schemas/message-utils.ts
 var SYSTEM_REMINDER_PATTERN = /^<system-reminder>\s*[\s\S]*?\s*<\/system-reminder>$/i;
 var SYSTEM_NOTIFICATION_PATTERN = /^<system-notification>\s*[\s\S]*?\s*<\/system-notification>$/i;
@@ -2708,6 +3174,36 @@ var LEGACY_FORK_CONTEXT_MARKERS = [
   "\u53EF\u901A\u8FC7 `read_file` \u8BFB\u53D6\u3002",
   "# \u4F60\u7684\u4EFB\u52A1"
 ];
+var INTERNAL_CHAT_ERROR_PATTERNS = [
+  /\b(?:ENOENT|EACCES|EPERM)\b/i,
+  /\[(?:Errno -?\d+|WinError \d+)\]/i,
+  /\b(?:ECONNRESET|ECONNREFUSED|ETIMEDOUT|EHOSTUNREACH|ENETUNREACH|ENOTFOUND|EAI_AGAIN)\b/i,
+  /\b(?:Connection refused|Connection reset by peer|All connection attempts failed|getaddrinfo failed)\b/i,
+  /(?:^|[\s("'`])\/(?:root|home|Users|tmp|var|opt|etc)\//,
+  /[A-Za-z]:\\(?:Users|Windows|Program Files|AppData)\\/i,
+  /(?:^|\n)Traceback \(most recent call last\):/,
+  /(?:^|\n)\s*at\s+\S+(?:\s+\(|:\d+:\d+)/,
+  /(?:^|\n)File "[^"]+", line \d+/
+];
+var SAFE_CHAT_ERROR_PREFIXES = [
+  "\u6C99\u76D2\u8FD0\u884C\u73AF\u5883\u6682\u65F6\u4E0D\u53EF\u7528\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002",
+  "\u6A21\u578B\u670D\u52A1\u6682\u65F6\u4E0D\u53EF\u7528\uFF0C\u8BF7\u68C0\u67E5\u6A21\u578B\u914D\u7F6E\u540E\u91CD\u8BD5\u3002"
+];
+var GENERIC_CHAT_ERROR = "\u6D88\u606F\u53D1\u9001\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5\u3002";
+function chatErrorForDisplay(message, developer = false) {
+  const normalized = message.trim();
+  if (!developer) {
+    const safePrefix = SAFE_CHAT_ERROR_PREFIXES.find((prefix) => normalized.startsWith(prefix));
+    if (safePrefix) return safePrefix;
+  }
+  if (!developer && /no source matches this model/i.test(normalized)) {
+    return "\u5F53\u524D\u6A21\u578B\u6682\u65F6\u4E0D\u53EF\u7528\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u6216\u91CD\u65B0\u9009\u62E9\u6A21\u578B\u3002";
+  }
+  if (!developer && INTERNAL_CHAT_ERROR_PATTERNS.some((pattern) => pattern.test(normalized))) {
+    return GENERIC_CHAT_ERROR;
+  }
+  return normalized || GENERIC_CHAT_ERROR;
+}
 function normalizeMessageContent(content) {
   if (typeof content === "string") return content;
   if (Array.isArray(content)) return content;
@@ -2727,10 +3223,10 @@ function isLegacyForkContextText(text) {
   const normalized = text.trim();
   return LEGACY_FORK_CONTEXT_MARKERS.every((marker) => normalized.includes(marker));
 }
-function isHiddenInternalMessage(message) {
+function isHiddenInternalMessage(message, options = {}) {
   if (message.role !== "user") return false;
   const text = getTextContent(normalizeMessageContent(message.content));
-  return isSystemReminderText(text) || isSystemNotificationText(text) || isLegacyForkContextText(text);
+  return isSystemReminderText(text) || isSystemNotificationText(text) || (options.includeLegacyForkContext ?? true) && isLegacyForkContextText(text);
 }
 function buildMessageContent(text, attachments) {
   if (attachments.length === 0) return text;
@@ -2877,7 +3373,9 @@ function createInitialSessionState(sessionId) {
     agentLoops: {},
     activeCompaction: null,
     replay: null,
-    viewerRole: null
+    viewerRole: null,
+    nextBefore: null,
+    loadingOlder: false
   };
 }
 function parseAgentDescription(argumentsJson) {
@@ -2903,10 +3401,10 @@ function inferLoopStatusFromMessages(messages) {
 }
 function inferLoopStatusFromTurns(turns, messages) {
   const latestAgentNotification = [...turns].reverse().flatMap((turn) => turn.blocks).find((block) => {
-    if (block.type !== "system_notification" || !isRecord4(block.content)) return false;
+    if (block.type !== "system_notification" || !isRecord(block.content)) return false;
     return block.content.notification_type === "agent:start" || block.content.notification_type === "agent:end";
   });
-  if (latestAgentNotification?.type === "system_notification" && isRecord4(latestAgentNotification.content)) {
+  if (latestAgentNotification?.type === "system_notification" && isRecord(latestAgentNotification.content)) {
     const notificationType = latestAgentNotification.content.notification_type;
     const status = latestAgentNotification.content.status;
     if (notificationType === "agent:start" || status === "running") return "running";
@@ -2915,17 +3413,44 @@ function inferLoopStatusFromTurns(turns, messages) {
   }
   return inferLoopStatusFromMessages(messages);
 }
-function isRecord4(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+function toSelectionMap(value) {
+  if (!isRecord(value)) return {};
+  const entries = Object.entries(value).map(([questionKey, optionIndexes]) => {
+    if (!Array.isArray(optionIndexes)) return null;
+    const parsedIndexes = optionIndexes.map((item) => typeof item === "number" ? item : Number(item)).filter((item) => Number.isInteger(item));
+    return [Number(questionKey), parsedIndexes];
+  }).filter((entry) => entry !== null);
+  return Object.fromEntries(entries);
+}
+function toCustomMap(value) {
+  if (!isRecord(value)) return {};
+  const entries = Object.entries(value).filter(([, text]) => typeof text === "string").map(([questionKey, text]) => [Number(questionKey), text]);
+  return Object.fromEntries(entries);
+}
+function extractAskAnswers(turns) {
+  const answers = {};
+  for (const turn of turns) {
+    for (const block of turn.blocks) {
+      if (block.type !== "ask_user_answer" || typeof block.tool_call_id !== "string") continue;
+      if (!isRecord(block.content)) continue;
+      const note = typeof block.content.note === "string" ? block.content.note.trim() : "";
+      answers[block.tool_call_id] = {
+        selections: toSelectionMap(block.content.selections),
+        custom: toCustomMap(block.content.custom),
+        ...note ? { note } : {}
+      };
+    }
+  }
+  return answers;
 }
 function parentForkToolCallIdFromTurn(turn) {
   if (typeof turn.parent_fork_tool_call_id === "string" && turn.parent_fork_tool_call_id.length > 0) {
     return turn.parent_fork_tool_call_id;
   }
   for (const block of turn.blocks) {
-    if (block.type !== "system_notification" || !isRecord4(block.content)) continue;
+    if (block.type !== "system_notification" || !isRecord(block.content)) continue;
     const metadata = block.content.metadata;
-    if (!isRecord4(metadata)) continue;
+    if (!isRecord(metadata)) continue;
     const parentId = metadata.parent_fork_tool_call_id;
     if (typeof parentId === "string" && parentId.length > 0) return parentId;
   }
@@ -2942,16 +3467,16 @@ function buildMessageContent2(turn) {
 }
 function workspaceNotificationContent(turn) {
   const block = turn.blocks.find(
-    (candidate) => candidate.type === "system_notification" && isRecord4(candidate.content) && candidate.content.notification_type === "workspace_change"
+    (candidate) => candidate.type === "system_notification" && isRecord(candidate.content) && candidate.content.notification_type === "workspace_change"
   );
-  if (!block || !isRecord4(block.content)) return "";
+  if (!block || !isRecord(block.content)) return "";
   const title = typeof block.content.title === "string" ? block.content.title.trim() : "";
   const detail = typeof block.content.detail === "string" ? block.content.detail.trim() : "";
   return [title ? `**${title}**` : "", detail].filter(Boolean).join("\n\n");
 }
 function askUserAnswerContent(turn) {
   const answerBlock = turn.blocks.find((block) => block.type === "ask_user_answer");
-  if (!answerBlock || !isRecord4(answerBlock.content)) return null;
+  if (!answerBlock || !isRecord(answerBlock.content)) return null;
   const answer = answerBlock.content.answer;
   return typeof answer === "string" && answer.trim().length > 0 ? answer : null;
 }
@@ -2971,6 +3496,19 @@ function extractModeFromBlocks(blocks) {
   return null;
 }
 function projectionToMessage(turn) {
+  if (turn.kind === "context") {
+    const context = contextProjectionData(turn);
+    if (!context) return null;
+    return {
+      role: "assistant",
+      content: "",
+      kind: "context",
+      context,
+      loop_name: turn.loop_id,
+      entry_id: turn.turn_id,
+      status: turn.status
+    };
+  }
   if (turn.kind === "compaction" && turn.compaction_id) {
     return {
       role: "assistant",
@@ -3140,6 +3678,56 @@ function orderTurns(turns) {
   }
   return turns;
 }
+function reconcileOptimisticUserTurns(currentTurns, incomingTurns) {
+  return reconcileUserTurns(currentTurns, incomingTurns, true);
+}
+function reconcileHistoricalUserTurns(currentTurns, incomingTurns) {
+  return reconcileUserTurns(currentTurns, incomingTurns, false);
+}
+function reconcileUserTurns(currentTurns, incomingTurns, allowLiveFallback) {
+  const preservedTurns = preserveClientRenderIds(currentTurns, incomingTurns);
+  const optimisticUserTurns = currentTurns.filter(
+    (turn) => turn.role === "user" && (turn.kind ?? "message") === "message" && turn.turn_id.startsWith("local-user-")
+  );
+  const optimisticByRequestId = new Map(
+    optimisticUserTurns.map((turn) => [
+      turn.turn_id.slice("local-user-".length),
+      turn
+    ])
+  );
+  const currentTurnIds = new Set(currentTurns.map((turn) => turn.turn_id));
+  const claimedOptimisticIds = /* @__PURE__ */ new Set();
+  const reconciled = preservedTurns.map((turn) => {
+    const exactOptimistic = typeof turn.client_request_id === "string" ? optimisticByRequestId.get(turn.client_request_id) : void 0;
+    if (exactOptimistic && !claimedOptimisticIds.has(exactOptimistic.turn_id) && isUserConfirmation(turn)) {
+      claimedOptimisticIds.add(exactOptimistic.turn_id);
+      return { ...turn, client_render_id: exactOptimistic.turn_id };
+    }
+    const fallbackOptimistic = optimisticUserTurns.find(
+      (candidate) => !claimedOptimisticIds.has(candidate.turn_id)
+    );
+    if (allowLiveFallback && typeof turn.client_request_id !== "string" && fallbackOptimistic && isUserConfirmation(turn) && !turn.turn_id.startsWith("local-user-") && !currentTurnIds.has(turn.turn_id)) {
+      claimedOptimisticIds.add(fallbackOptimistic.turn_id);
+      return { ...turn, client_render_id: fallbackOptimistic.turn_id };
+    }
+    return turn;
+  });
+  return claimedOptimisticIds.size === 0 ? reconciled : reconciled.filter((turn) => !claimedOptimisticIds.has(turn.turn_id));
+}
+function isUserConfirmation(turn) {
+  return turn.role === "user" && (turn.kind ?? "message") === "message" || turn.blocks.some((block) => block.type === "ask_user_answer");
+}
+function preserveClientRenderIds(currentTurns, incomingTurns) {
+  const currentById = new Map(currentTurns.map((turn) => [turn.turn_id, turn]));
+  return incomingTurns.map((turn) => {
+    const current = currentById.get(turn.turn_id);
+    if (current) {
+      const currentRenderId = current.client_render_id;
+      return turn.client_render_id || !currentRenderId ? turn : { ...turn, client_render_id: currentRenderId };
+    }
+    return turn;
+  });
+}
 function areAgentLoopsEqual(left, right) {
   if (!left) return Object.keys(right).length === 0;
   const leftEntries = Object.entries(left);
@@ -3151,7 +3739,7 @@ function areAgentLoopsEqual(left, right) {
   });
 }
 function withTurns(state, turns) {
-  const orderedTurns = orderTurns(turns);
+  const orderedTurns = orderTurns(reconcileHistoricalUserTurns(state.turns, turns));
   const { messages, agentLoops, activeCompaction } = materialize(orderedTurns);
   const isWaitingForInput = orderedTurns.some(
     (turn) => turn.tool_calls.some((toolCall) => toolCall.status === "awaiting_answer")
@@ -3161,14 +3749,31 @@ function withTurns(state, turns) {
   const preservedErrors = lastTurnId ? state.messages.filter(
     (m) => m.role === "error" && typeof m.entry_id === "string" && m.entry_id.startsWith(`${ERROR_ANCHOR_PREFIX}${lastTurnId}:`)
   ) : [];
-  const mergedMessages = preservedErrors.length > 0 ? [...messages, ...preservedErrors] : messages;
+  const turnById = new Map(orderedTurns.map((turn) => [turn.turn_id, turn]));
+  const messagesWithRenderIds = messages.map((message) => {
+    if (!message.entry_id) return message;
+    const renderId = turnById.get(message.entry_id)?.client_render_id;
+    return renderId ? { ...message, render_id: renderId } : message;
+  });
+  const mergedMessages = preservedErrors.length > 0 ? [...messagesWithRenderIds, ...preservedErrors] : messagesWithRenderIds;
   const latestMode = [...orderedTurns].reverse().map((turn) => extractModeFromBlocks(turn.blocks)).find((mode) => mode !== null);
+  const askAnswersFromHistory = extractAskAnswers(orderedTurns);
+  const presentToolCallIds = new Set(
+    orderedTurns.flatMap((turn) => turn.tool_calls.map((toolCall) => toolCall.id))
+  );
+  const askAnswers = { ...askAnswersFromHistory };
+  for (const [toolCallId, answer] of Object.entries(state.askAnswers)) {
+    if (!(toolCallId in askAnswers) && presentToolCallIds.has(toolCallId)) {
+      askAnswers[toolCallId] = answer;
+    }
+  }
   return {
     ...state,
     turns: orderedTurns,
     messages: mergedMessages,
     agentLoops: stableAgentLoops,
     activeCompaction,
+    askAnswers,
     mode: latestMode ?? state.mode,
     // 历史恢复时 chat:end(paused) 可能已不在 socket replay 缓存中；
     // awaiting_answer 是投影里的持久权威状态，必须据此恢复问答交互。
@@ -3176,9 +3781,9 @@ function withTurns(state, turns) {
   };
 }
 var localTurnCounter = 0;
-function addUserMessage(state, content) {
+function addUserMessage(state, content, clientRequestId) {
   localTurnCounter += 1;
-  const turnId = `local-user-${Date.now()}-${localTurnCounter}`;
+  const turnId = `local-user-${clientRequestId ?? `${Date.now()}-${localTurnCounter}`}`;
   const optimisticTurn = {
     id: turnId,
     sequence: Math.max(0, ...state.turns.map((turn) => turn.sequence)) + 1,
@@ -3196,14 +3801,16 @@ function addUserMessage(state, content) {
 }
 function upsertTurn(state, turn) {
   let existing = [...state.turns];
-  if (turn.role === "user" && !turn.turn_id.startsWith("local-user-")) {
-    existing = existing.filter((t) => !t.turn_id.startsWith("local-user-"));
+  const [nextTurn] = reconcileOptimisticUserTurns(existing, [turn]);
+  const claimedOptimisticId = nextTurn.client_render_id;
+  if (claimedOptimisticId?.startsWith("local-user-")) {
+    existing = existing.filter((item) => item.turn_id !== claimedOptimisticId);
   }
-  const index = existing.findIndex((item) => item.turn_id === turn.turn_id);
+  const index = existing.findIndex((item) => item.turn_id === nextTurn.turn_id);
   if (index >= 0) {
-    existing[index] = turn;
+    existing[index] = nextTurn;
   } else {
-    existing.push(turn);
+    existing.push(nextTurn);
   }
   return withTurns(state, existing);
 }
@@ -3216,13 +3823,7 @@ function applyTurnPatch(state, patch) {
   if (lastSequence !== null && patch.sequence <= lastSequence) {
     return state;
   }
-  const nextTurn = { ...turn, sequence: patch.sequence };
-  if (index >= 0) {
-    existing[index] = nextTurn;
-  } else {
-    existing.push(nextTurn);
-  }
-  return withTurns(state, existing);
+  return upsertTurn(state, { ...turn, sequence: patch.sequence });
 }
 function addErrorMessage(state, content) {
   const anchorTurnId = state.turns[state.turns.length - 1]?.turn_id ?? null;
@@ -3254,19 +3855,26 @@ function markStreamingTurns(state, turnStatus, toolCallStatus) {
 
 // src/session/agent-session.ts
 var OOM_MESSAGE = "\u6C99\u76D2\u5185\u5B58\u4F7F\u7528\u8D85\u51FA\u9650\u5236\uFF0C\u5DF2\u81EA\u52A8\u91CD\u542F\u3002\u5982\u679C\u7ECF\u5E38\u89E6\u53D1\uFF0C\u53EF\u4EE5\u8054\u7CFB\u7BA1\u7406\u5458\u8C03\u6574\u989D\u5EA6\u3002";
-var OOM_KEYWORDS_RE = /(?:\b(?:exit_code|ExitedWith|exited with)|退出码)\D*(?<!\d)137(?!\d)/i;
-function isRecord5(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+var COMMAND_RESTORE_RETRY_BASE_MS = 1e3;
+var COMMAND_RESTORE_RETRY_MAX_MS = 3e4;
+var fallbackRequestCounter = 0;
+function createClientRequestId() {
+  if (typeof globalThis.crypto?.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  fallbackRequestCounter += 1;
+  return `${Date.now()}-${Math.random().toString(36).slice(2)}-${fallbackRequestCounter}`;
 }
+var OOM_KEYWORDS_RE = /(?:\b(?:exit_code|ExitedWith|exited with)|退出码)\D*(?<!\d)137(?!\d)/i;
 function isOomText(value) {
   return typeof value === "string" && OOM_KEYWORDS_RE.test(value);
 }
 function parseJsonRecord(value) {
-  if (isRecord5(value)) return value;
+  if (isRecord(value)) return value;
   if (typeof value !== "string") return null;
   try {
     const parsed = JSON.parse(value);
-    return isRecord5(parsed) ? parsed : null;
+    return isRecord(parsed) ? parsed : null;
   } catch {
     return null;
   }
@@ -3292,6 +3900,12 @@ function isOomResult(value) {
 function isToolBridgeContent(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) && typeof value.action === "string";
 }
+function isCursorInvalidError(error) {
+  return typeof error === "object" && error !== null && "status" in error && error.status === 409;
+}
+function commandDeliveryKey(deliveryId) {
+  return `tool-command:${deliveryId}`;
+}
 function sessionStatusFromChatEnd(status) {
   if (status === "paused") return "waiting_for_input";
   if (status === "interrupted") return "interrupted";
@@ -3307,13 +3921,8 @@ function extractTerminalChatEndStatus(events) {
   }
   return null;
 }
-function hasChatRunEvent2(events) {
-  return events.some(
-    (event) => event.type !== "session:post_chat_followup" && !event.type.startsWith("compaction:")
-  );
-}
 function isUiMetaLike(value) {
-  return isRecord5(value) && ("resourceHTML" in value || "resourceUri" in value || "resourceURI" in value);
+  return isRecord(value) && ("resourceHTML" in value || "resourceUri" in value || "resourceURI" in value);
 }
 var AgentSession = class _AgentSession {
   sessionId;
@@ -3328,14 +3937,39 @@ var AgentSession = class _AgentSession {
   patchFlushCancel = null;
   joined = false;
   joinPending = null;
+  // bootstrap 与每次 reconnect 共用一条订阅生命周期队列。它们都会重置 join
+  // 状态并临时设置 replay source，禁止并发，否则较早操作的 finally 会清掉
+  // 较晚操作仍在使用的来源上下文。
+  subscriptionQueue = Promise.resolve();
+  replaceQueue = Promise.resolve();
+  timelineEpoch = 0;
+  pagingGeneration = 0;
+  liveRevision = 0;
+  modeRevision = 0;
+  liveRevisions = /* @__PURE__ */ new Map();
+  pendingOptimisticTurnIds = /* @__PURE__ */ new Set();
+  /** Consecutive supplements are persisted as one authoritative user turn. */
+  pendingAppendTurnId = null;
+  olderPending = null;
+  replaceInFlight = 0;
   // 回放控制请求排成一条队列。连着点"5x"再点"退出回放"时，并发发出去的两个
   // 请求响应可能乱序回来，晚到的旧值会把已经退出的会话又显示成回放中；用
   // 序号丢弃过期响应又会在失败时留下中间态。串行执行就没有这些情况：每个
   // 响应都是当时最新的，失败也只影响自己。
   replayQueue = Promise.resolve();
+  // Historical snapshots and live commands share one delivery barrier. A
+  // repair closes the barrier before joining, snapshots the raw command log
+  // after the join, then releases buffered commands in socket arrival order.
+  commandRestoreQueue = Promise.resolve();
+  commandRecoveryGeneration = 0;
+  commandRestoreRetryAttempt = 0;
+  commandRestoreRetryHandle = null;
+  bufferedCommandDeliveries = null;
   pendingReplayMessage = null;
   pendingReplayMode;
+  pendingReplayKbIds;
   recentChatEndAt = 0;
+  subscriptionReplaySource = null;
   disposed = false;
   getAppContext = null;
   sendPending = false;
@@ -3359,11 +3993,11 @@ var AgentSession = class _AgentSession {
     const session = new _AgentSession(
       sessionId,
       {
-        streamTokens: false,
         emitEvent: readonlyError,
         emitWithAck: async () => readonlyError(),
         ensureConnected: readonlyError,
-        fetchTurns: async () => turns,
+        fetchTurnsPage: async () => ({ turns, nextBefore: null, currentMode: "executing" }),
+        fetchCommands: async () => [],
         // 静态历史没有回放身份可言，给个空详情即可，不要抛错——_bootstrap
         // 不会跑到这里，但保持只读语义一致。
         fetchSessionInfo: async () => ({ replay_state: null }),
@@ -3387,6 +4021,42 @@ var AgentSession = class _AgentSession {
   getState() {
     return this.state;
   }
+  get hasOlderHistory() {
+    return this.state.nextBefore !== null;
+  }
+  /** Load the page immediately preceding the current display window. */
+  loadOlderHistory(options = {}) {
+    if (this.disposed) return Promise.resolve();
+    if (this.olderPending) return this.olderPending;
+    if (this.replaceInFlight > 0) {
+      return this.replaceQueue.then(() => this.loadOlderHistory(options));
+    }
+    const before = this.state.nextBefore;
+    if (!before) return Promise.resolve();
+    const epoch = this.timelineEpoch;
+    const generation = this.pagingGeneration;
+    this.update((state) => ({ ...state, loadingOlder: true }));
+    const request = this.runtime.fetchTurnsPage(this.sessionId, before).then((page) => {
+      if (epoch !== this.timelineEpoch || generation !== this.pagingGeneration || this.state.nextBefore !== before) return;
+      options.beforeCommit?.();
+      this.update((state) => ({
+        ...withTurns(state, prependOlder(state.turns, page.turns)),
+        nextBefore: page.nextBefore,
+        loadingOlder: false
+      }));
+    }).catch((error) => {
+      if (isCursorInvalidError(error) && epoch === this.timelineEpoch && generation === this.pagingGeneration && this.state.nextBefore === before) {
+        this.timelineEpoch += 1;
+        return this.replaceFromHistory();
+      }
+    }).finally(() => {
+      if (this.olderPending !== request) return;
+      this.olderPending = null;
+      this.update((state) => ({ ...state, loadingOlder: false }));
+    });
+    this.olderPending = request;
+    return request;
+  }
   /** 订阅状态变化。返回取消订阅函数。 */
   subscribe(listener) {
     this.listeners.add(listener);
@@ -3452,6 +4122,22 @@ var AgentSession = class _AgentSession {
       this.sendPending = false;
     }
   }
+  /** Queue a plain-text prompt while a turn is streaming. */
+  async queue(content) {
+    const text = content.trim();
+    if (!text) return false;
+    this.runtime.ensureConnected();
+    this.runtime.emitEvent("chat:append", { session_id: this.sessionId, message: text });
+    return true;
+  }
+  async listQueue() {
+    const response = await this.runtime.emitWithAck("chat:queue:list", { session_id: this.sessionId }, 1e4);
+    return Array.isArray(response?.items) ? response.items : [];
+  }
+  async cancelQueued(id) {
+    const response = await this.runtime.emitWithAck("chat:queue:cancel", { session_id: this.sessionId, id }, 1e4);
+    return response?.cancelled === true;
+  }
   async sendUnlocked(content, options) {
     await this.ensureIdleBeforeSend();
     if (this.state.isStreaming || this.state.activeCompaction || this.manualCompactionPending) {
@@ -3464,7 +4150,7 @@ var AgentSession = class _AgentSession {
     if (this.getAppContext) {
       try {
         const rawContext = await this.getAppContext();
-        if (!isRecord5(rawContext)) {
+        if (!isRecord(rawContext)) {
           throw new Error("getContext \u5FC5\u987B\u8FD4\u56DE JSON \u5BF9\u8C61");
         }
         const serialized = JSON.stringify(rawContext);
@@ -3472,7 +4158,7 @@ var AgentSession = class _AgentSession {
           throw new Error("getContext \u5FC5\u987B\u8FD4\u56DE\u53EF\u5E8F\u5217\u5316\u7684 JSON \u5BF9\u8C61");
         }
         const normalized = JSON.parse(serialized);
-        if (!isRecord5(normalized)) {
+        if (!isRecord(normalized)) {
           throw new Error("getContext \u5FC5\u987B\u8FD4\u56DE JSON \u5BF9\u8C61");
         }
         appContext = normalized;
@@ -3484,15 +4170,15 @@ var AgentSession = class _AgentSession {
     }
     const askUserAnswer = options.askUserAnswer;
     let optimisticTurnId = null;
+    const clientRequestId = createClientRequestId();
     let optimisticAskAnswer;
     let previousAskAnswer;
-    if (!(askUserAnswer && typeof askUserAnswer.tool_call_id === "string")) {
-      this.update((state) => {
-        const next = addUserMessage(state, content);
-        optimisticTurnId = next.turns.at(-1)?.turn_id ?? null;
-        return next;
-      });
-    }
+    this.update((state) => {
+      const next = addUserMessage(state, content, clientRequestId);
+      optimisticTurnId = next.turns.at(-1)?.turn_id ?? null;
+      return next;
+    });
+    if (optimisticTurnId) this.markOptimisticTurnPending(optimisticTurnId);
     this.update((s) => ({ ...s, isStreaming: true }));
     if (askUserAnswer && typeof askUserAnswer.tool_call_id === "string") {
       const { tool_call_id, ...rest } = askUserAnswer;
@@ -3506,17 +4192,20 @@ var AgentSession = class _AgentSession {
     if (!options.replayDecision) {
       this.pendingReplayMessage = content;
       this.pendingReplayMode = options.mode;
+      this.pendingReplayKbIds = options.kbIds;
     }
     const payload = {
       session_id: this.sessionId,
       message: content,
+      client_request_id: clientRequestId,
       mode: options.mode,
       askuser_answer: askUserAnswer,
       model: options.model,
       thinking_override: options.thinkingOverride,
       whatif: options.whatif,
       replay_decision: options.replayDecision,
-      app_context: appContext
+      app_context: appContext,
+      kb_ids: options.kbIds && options.kbIds.length > 0 ? options.kbIds : void 0
     };
     try {
       await this.ensureJoined();
@@ -3552,6 +4241,7 @@ var AgentSession = class _AgentSession {
   rollbackOptimisticSend(optimisticTurnId, askUserAnswer, optimisticAskAnswer, previousAskAnswer, message) {
     this.pendingReplayMessage = null;
     this.pendingReplayMode = void 0;
+    this.pendingReplayKbIds = void 0;
     this.update((current) => {
       let next = optimisticTurnId ? withTurns(
         current,
@@ -3569,16 +4259,51 @@ var AgentSession = class _AgentSession {
       }
       return addErrorMessage({ ...next, isStreaming: false }, message);
     });
+    if (optimisticTurnId) {
+      this.pendingOptimisticTurnIds.delete(optimisticTurnId);
+      this.liveRevisions.delete(optimisticTurnId);
+      if (this.pendingAppendTurnId === optimisticTurnId) this.pendingAppendTurnId = null;
+    }
   }
   /** 智能体运行期间追加补充说明（不打断当前回复）。 */
   append(text) {
     this.runtime.ensureConnected();
-    this.runtime.emitEvent("chat:append", { session_id: this.sessionId, message: text });
-    this.update((s) => addUserMessage(s, text));
+    const existingAppendId = this.pendingAppendTurnId;
+    let optimisticTurnId = existingAppendId;
+    this.update((state) => {
+      const existing = existingAppendId ? state.turns.find((turn) => turn.turn_id === existingAppendId) : void 0;
+      if (existing && existing.role === "user") {
+        const blocks = existing.blocks.map(
+          (block, index) => index === 0 && block.type === "text" ? { ...block, content: `${block.content}
+${text}` } : block
+        );
+        return withTurns(state, state.turns.map(
+          (turn) => turn.turn_id === existingAppendId ? { ...turn, blocks } : turn
+        ));
+      }
+      const next = addUserMessage(state, text, createClientRequestId());
+      optimisticTurnId = next.turns.at(-1)?.turn_id ?? null;
+      return next;
+    });
+    if (optimisticTurnId) {
+      this.pendingAppendTurnId = optimisticTurnId;
+      if (!this.pendingOptimisticTurnIds.has(optimisticTurnId)) {
+        this.markOptimisticTurnPending(optimisticTurnId);
+      }
+    }
+    this.runtime.emitEvent("chat:append", {
+      session_id: this.sessionId,
+      message: text,
+      ...optimisticTurnId ? { client_request_id: optimisticTurnId.slice("local-user-".length) } : {}
+    });
   }
   /** 停止当前回复。 */
   stop() {
-    return this.runtime.emitWithAck("chat:stop", { session_id: this.sessionId }, 35e3).then((response) => response ?? {});
+    return this.runtime.emitWithAck("chat:stop", { session_id: this.sessionId }, 35e3).then((response) => {
+      const result = response ?? {};
+      if (result.status !== "accepted") this.manualCompactionPending = false;
+      return result;
+    });
   }
   /** 手动触发上下文压缩。 */
   compact() {
@@ -3598,8 +4323,10 @@ var AgentSession = class _AgentSession {
         trigger: "manual"
       }
     }));
-    return this.runtime.emitWithAck("chat:compact", { session_id: this.sessionId }, 3e4).then((response) => response ?? {}).finally(() => {
+    return this.runtime.emitWithAck("chat:compact", { session_id: this.sessionId }, 3e4).then((response) => response ?? {}).catch((error) => {
       this.manualCompactionPending = false;
+      throw error;
+    }).finally(() => {
       if (this.state.activeCompaction?.compaction_id === "pending-manual-compaction") {
         this.update((state) => ({ ...state, activeCompaction: null }));
       }
@@ -3638,10 +4365,20 @@ var AgentSession = class _AgentSession {
     if (this.disposed) return;
     if (!this.runtime.onDispose(this)) return;
     this.disposed = true;
+    this.timelineEpoch += 1;
+    this.invalidateOlderPaging();
+    this.state = { ...this.state, nextBefore: null, loadingOlder: false };
     this.cancelPatchFlush();
     this.listeners.clear();
     this.emitter.clear();
     this.commands.clear();
+    this.commandRecoveryGeneration += 1;
+    this.commandRestoreRetryAttempt = 0;
+    this.bufferedCommandDeliveries = null;
+    if (this.commandRestoreRetryHandle !== null) {
+      globalThis.clearTimeout(this.commandRestoreRetryHandle);
+      this.commandRestoreRetryHandle = null;
+    }
   }
   get isDisposed() {
     return this.disposed;
@@ -3653,27 +4390,55 @@ var AgentSession = class _AgentSession {
     this.update((s) => ({ ...s, connection }));
   }
   /** @internal socket 重连后由 Hub 调用：重新加入房间并补数。 */
-  async _rejoinAfterReconnect() {
-    const turnsBeforeRejoin = this.state.turns;
-    this.joined = false;
-    this.joinPending = null;
-    try {
-      await this.ensureJoined();
-      await Promise.all([
-        this.syncTurnsFromHistory({
-          clearOnEmpty: true,
-          preserveChangesSince: turnsBeforeRejoin
-        }),
-        this.syncReplayFromSession()
-      ]);
-    } catch {
-    }
+  _rejoinAfterReconnect() {
+    this.timelineEpoch += 1;
+    this.invalidateOlderPaging();
+    this.update((state) => ({ ...state, nextBefore: null, loadingOlder: false }));
+    const reconnectLiveRevision = this.liveRevision;
+    const reconnectModeRevision = this.modeRevision;
+    const commandRecoveryGeneration = this.beginCommandRecovery();
+    return this.enqueueSubscription(async () => {
+      this.joined = false;
+      this.joinPending = null;
+      try {
+        this.subscriptionReplaySource = "reconnect_replay";
+        try {
+          await this.ensureJoined(reconnectLiveRevision);
+        } finally {
+          this.subscriptionReplaySource = null;
+          this.scheduleHistoricalCommandRestore(commandRecoveryGeneration);
+        }
+        await Promise.all([
+          this.replaceFromHistory({
+            liveRevisionAtStart: reconnectLiveRevision,
+            modeRevisionAtStart: reconnectModeRevision
+          }),
+          this.syncReplayFromSession()
+        ]);
+      } catch {
+      }
+    });
   }
   /** @internal 首次连接：加载历史 + 加入房间。 */
-  async _bootstrap() {
-    await this.syncTurnsFromHistory({ suppressErrors: false });
-    await this.ensureJoined();
-    await this.syncReplayFromSession();
+  _bootstrap() {
+    const commandRecoveryGeneration = this.beginCommandRecovery();
+    return this.enqueueSubscription(async () => {
+      await this.replaceFromHistory({ suppressErrors: false });
+      this.subscriptionReplaySource = "bootstrap_replay";
+      try {
+        await this.ensureJoined();
+      } finally {
+        this.subscriptionReplaySource = null;
+      }
+      this.scheduleHistoricalCommandRestore(commandRecoveryGeneration);
+      await this.syncReplayFromSession();
+    });
+  }
+  /** 订阅生命周期串行执行；一次失败只由自己的调用方观察，不截断后续重连。 */
+  enqueueSubscription(operation) {
+    const run = this.subscriptionQueue.then(operation);
+    this.subscriptionQueue = run.catch(() => void 0);
+    return run;
   }
   /** 改回放是 owner 专属（服务端 PATCH 走 _get_owned_session）。 */
   get canControlReplay() {
@@ -3730,10 +4495,16 @@ var AgentSession = class _AgentSession {
     this.applyTurn(turn);
   }
   /** @internal 历史回放通道（event_format: raw）。 */
-  _handleTurnEvents(events) {
+  _handleTurnEvents(events, replayed = false) {
     if (!events.length) return;
+    if (events.some(
+      (event) => event.type === "compaction:end" || event.type === "compaction:error" || event.type === "compaction:abort"
+    )) {
+      this.manualCompactionPending = false;
+    }
+    this.dispatchRawCommands(events);
     const terminalChatEndStatus = extractTerminalChatEndStatus(events);
-    if (!terminalChatEndStatus && hasChatRunEvent2(events)) {
+    if (!terminalChatEndStatus && hasChatRunEvent(events) && this.state.status !== "waiting_for_input") {
       this.markRunningIfIdle();
     }
     if (this.state.turns.length) {
@@ -3742,7 +4513,10 @@ var AgentSession = class _AgentSession {
     const updates = this.projectionBuilder.processBatch(events);
     for (const update of updates) {
       if (update.kind === "upsert") {
-        this.applyTurn(update.turn);
+        this.applyTurn(
+          update.turn,
+          replayed ? this.subscriptionReplaySource ?? "bootstrap_replay" : "live"
+        );
       } else if (update.kind === "workspace_changed") {
         this.emitter.emit("workspaceChanged", {});
       }
@@ -3797,16 +4571,26 @@ var AgentSession = class _AgentSession {
   }
   /** @internal */
   _handleRewind(checkpointId) {
-    this.update((s) => ({ ...s, mode: null, errorMessage: null }));
-    void this.syncTurnsFromHistory({ clearOnEmpty: true });
+    this.timelineEpoch += 1;
+    this.invalidateOlderPaging();
+    this.update((s) => ({
+      ...s,
+      mode: null,
+      errorMessage: null,
+      nextBefore: null,
+      loadingOlder: false
+    }));
+    void this.replaceFromHistory();
     this.emitter.emit("rewind", { checkpointId });
   }
   /** @internal */
   _handleReplayMismatch(data) {
     const message = this.pendingReplayMessage ?? data.actual_message ?? "";
     const mode = this.pendingReplayMode;
+    const kbIds = this.pendingReplayKbIds;
     this.pendingReplayMessage = null;
     this.pendingReplayMode = void 0;
+    this.pendingReplayKbIds = void 0;
     const respond = (decision) => {
       void this.runtime.emitWithAck(
         "chat:send",
@@ -3814,7 +4598,8 @@ var AgentSession = class _AgentSession {
           session_id: this.sessionId,
           message,
           mode,
-          replay_decision: decision
+          replay_decision: decision,
+          kb_ids: kbIds && kbIds.length > 0 ? kbIds : void 0
         },
         3e4
       ).then((response) => {
@@ -3855,9 +4640,9 @@ var AgentSession = class _AgentSession {
       detail,
       status,
       loopId,
-      metadata: isRecord5(notification.metadata) ? notification.metadata : void 0
+      metadata: isRecord(notification.metadata) ? notification.metadata : void 0
     });
-    if (notificationType === "bg:started" && isRecord5(notification.metadata)) {
+    if (notificationType === "bg:started" && isRecord(notification.metadata)) {
       const taskId = typeof notification.metadata.task_id === "string" ? notification.metadata.task_id : "";
       if (taskId) {
         this.emitter.emit("backgroundTask", {
@@ -3879,12 +4664,12 @@ var AgentSession = class _AgentSession {
     this.emitter.emit("artifact", event);
   }
   /** @internal 加入房间的应答里带 is_running，据此校准流式状态。 */
-  _applyRunningState(isRunning) {
+  _applyRunningState(isRunning, liveRevisionAtJoin = this.liveRevision) {
     if (isRunning) {
       this.update((s) => ({ ...s, status: "running", isStreaming: true }));
     } else if (this.state.isStreaming) {
       this.update((s) => ({ ...s, isStreaming: false }));
-      void this.syncTurnsFromHistory();
+      void this.replaceFromHistory({ liveRevisionAtStart: liveRevisionAtJoin });
     }
   }
   // ---------------------------------------------------------------- 内部实现
@@ -3905,14 +4690,36 @@ var AgentSession = class _AgentSession {
   completeChat(status) {
     this.finishStreaming(status);
     this.recentChatEndAt = Date.now();
-    void this.syncTurnsFromHistory();
+    void this.replaceFromHistory();
     this.emitter.emit("chatEnd", { status });
   }
-  applyTurn(turn) {
+  markTurnFresh(turnId) {
+    this.liveRevision += 1;
+    this.liveRevisions.set(turnId, this.liveRevision);
+  }
+  markOptimisticTurnPending(turnId) {
+    this.pendingOptimisticTurnIds.add(turnId);
+    this.markTurnFresh(turnId);
+  }
+  pruneOptimisticLiveRevisions() {
+    const retained = new Set(
+      this.state.turns.map((turn) => turn.turn_id).filter((turnId) => turnId.startsWith("local-user-"))
+    );
+    for (const turnId of this.liveRevisions.keys()) {
+      if (turnId.startsWith("local-user-") && !retained.has(turnId)) {
+        this.pendingOptimisticTurnIds.delete(turnId);
+        this.liveRevisions.delete(turnId);
+      }
+    }
+  }
+  applyTurn(turn, source = "live") {
     this.flushPatches();
+    this.markTurnFresh(turn.turn_id);
+    if (extractModeFromBlocks(turn.blocks)) this.modeRevision += 1;
     const previous = this.state;
     this.update((s) => upsertTurn(s, turn));
-    this.emitTurnDerivedEvents(previous, turn);
+    this.pruneOptimisticLiveRevisions();
+    this.emitTurnDerivedEvents(previous, turn, source);
   }
   schedulePatchFlush() {
     if (this.patchFlushHandle != null) return;
@@ -3945,11 +4752,15 @@ var AgentSession = class _AgentSession {
     this.pendingTurnPatches.clear();
     for (const patch of patches) {
       const previous = this.state;
-      this.update((s) => applyTurnPatch(s, patch));
+      const next = applyTurnPatch(previous, patch);
+      if (next === previous) continue;
+      this.liveRevision += 1;
+      this.liveRevisions.set(patch.turn_id, this.liveRevision);
       const turn = patch.data.turn;
-      if (turn) {
-        this.emitTurnDerivedEvents(previous, turn);
-      }
+      if (turn && extractModeFromBlocks(turn.blocks)) this.modeRevision += 1;
+      this.setState(next);
+      this.pruneOptimisticLiveRevisions();
+      if (turn) this.emitTurnDerivedEvents(previous, turn);
     }
     if (this.patchFlushCancel) {
       this.patchFlushCancel();
@@ -3958,7 +4769,7 @@ var AgentSession = class _AgentSession {
     }
   }
   /** turn 数据落地后统一派生语义事件（指令 / 工具调用 / 消息 / 模式 / 预览 / OOM）。 */
-  emitTurnDerivedEvents(previous, turn) {
+  emitTurnDerivedEvents(previous, turn, source = "live") {
     const mode = extractModeFromBlocks(turn.blocks);
     if (mode && previous.mode !== mode) {
       this.emitter.emit("modeChange", { mode });
@@ -3987,7 +4798,7 @@ var AgentSession = class _AgentSession {
           title: ui.title ?? "\u5DE5\u5177\u9884\u89C8"
         });
       }
-      if (block.type === "system_notification" && isRecord5(block.content)) {
+      if (block.type === "system_notification" && isRecord(block.content)) {
         this._handleSystemNotification(turn.loop_id, block.content);
       }
     }
@@ -4007,7 +4818,7 @@ var AgentSession = class _AgentSession {
       const finished = toolCall.status === "done" || toolCall.status === "error" || toolCall.status === "cancelled";
       if (finished && !this.finishedToolCallIds.has(toolCall.id)) {
         this.finishedToolCallIds.add(toolCall.id);
-        this.emitter.emit("toolResult", { toolCall: info, turn });
+        this.emitter.emit("toolResult", { toolCall: info, turn, source });
         if (isOomResult(toolCall.result)) {
           this.notifySandboxOom(toolCall.id);
         }
@@ -4024,17 +4835,36 @@ var AgentSession = class _AgentSession {
   dispatchCommand(turn, block) {
     if (!isToolBridgeContent(block.content)) return;
     const { action, payload } = block.content;
-    let payloadKey = "";
-    try {
-      payloadKey = JSON.stringify(payload ?? null);
-    } catch {
-      payloadKey = String(payload ?? "");
+    const deliveryKey = block.delivery_id ? commandDeliveryKey(block.delivery_id) : `legacy-tool-command:${turn.turn_id}:${block.tool_call_id ?? ""}:${action}:${JSON.stringify(payload)}`;
+    this.deliverCommand(deliveryKey, action, payload, block.tool_call_id ?? void 0);
+  }
+  dispatchRawCommands(events) {
+    for (const event of events) {
+      if (event.type !== "loop:tool_bridge") continue;
+      const deliveryId = String(event.payload.delivery_id ?? "");
+      const bridge = event.payload.bridge;
+      if (!deliveryId || !isToolBridgeContent(bridge)) continue;
+      this.deliverCommand(
+        commandDeliveryKey(deliveryId),
+        bridge.action,
+        bridge.payload,
+        String(event.payload.tool_call_id ?? "") || void 0
+      );
     }
-    const deliveryKey = [block.tool_call_id ?? turn.id, action, payloadKey].join("\0");
+  }
+  deliverCommand(deliveryKey, action, payload, toolCallId) {
+    if (this.bufferedCommandDeliveries) {
+      this.bufferedCommandDeliveries.push({ deliveryKey, action, payload, toolCallId });
+      return;
+    }
+    this.deliverCommandNow({ deliveryKey, action, payload, toolCallId });
+  }
+  deliverCommandNow(command) {
+    const { deliveryKey, action, payload, toolCallId } = command;
     if (this.deliveredCommandKeys.has(deliveryKey)) return;
     this.deliveredCommandKeys.add(deliveryKey);
-    const meta = { toolCallId: block.tool_call_id ?? void 0 };
-    this.emitter.emit("command", { action, payload, toolCallId: meta.toolCallId });
+    const meta = { toolCallId };
+    this.emitter.emit("command", { action, payload, toolCallId });
     this.commands.dispatch(action, payload, meta);
   }
   notifySandboxOom(key) {
@@ -4043,49 +4873,146 @@ var AgentSession = class _AgentSession {
     this.update((s) => addErrorMessage(s, OOM_MESSAGE));
     this.emitter.emit("sandboxOom", { toolCallId: key });
   }
-  async syncTurnsFromHistory(options = {}) {
-    const { clearOnEmpty = false, suppressErrors = true, preserveChangesSince } = options;
-    const turnsAtRequestStart = this.state.turns;
-    try {
-      const turns = await this.runtime.fetchTurns(this.sessionId);
-      if (turns.length === 0 && !clearOnEmpty) return;
-      this.update((state) => {
-        const mergeBaseline = preserveChangesSince ?? turnsAtRequestStart;
-        if (state.turns === mergeBaseline) return withTurns(state, turns);
-        const historyById = new Map(turns.map((turn) => [turn.turn_id, turn]));
-        let merged = withTurns(state, turns);
-        for (const current of state.turns) {
-          const fromHistory = historyById.get(current.turn_id);
-          if (!fromHistory || current.sequence > fromHistory.sequence) {
-            merged = upsertTurn(merged, current);
-          }
+  replaceFromHistory(options = {}) {
+    if (this.disposed) return Promise.resolve();
+    const operationEpoch = this.timelineEpoch;
+    const liveRevisionAtStart = options.liveRevisionAtStart ?? this.liveRevision;
+    const modeRevisionAtStart = options.modeRevisionAtStart ?? this.modeRevision;
+    this.invalidateOlderPaging();
+    this.replaceInFlight += 1;
+    const operation = async () => {
+      let previousNextBefore = null;
+      try {
+        if (this.disposed || operationEpoch !== this.timelineEpoch) return;
+        this.invalidateOlderPaging();
+        previousNextBefore = this.state.nextBefore;
+        this.update((state) => ({ ...state, nextBefore: null, loadingOlder: false }));
+        const page = await this.runtime.fetchTurnsPage(this.sessionId);
+        if (this.disposed || operationEpoch !== this.timelineEpoch) return;
+        if (!this.joined) this.seedToolCallDeliveryBaseline(page.turns);
+        this.update((state) => {
+          const next = withTurns(
+            state,
+            replaceWindow(state.turns, page.turns, liveRevisionAtStart, {
+              current: this.liveRevision,
+              byTurnId: this.liveRevisions
+            })
+          );
+          return {
+            ...next,
+            mode: this.modeRevision === modeRevisionAtStart ? page.currentMode : state.mode,
+            nextBefore: page.nextBefore,
+            loadingOlder: false
+          };
+        });
+        this.pruneOptimisticLiveRevisions();
+        this.projectionBuilder._seedTurns(this.state.turns);
+      } catch (error) {
+        if (!this.disposed && operationEpoch === this.timelineEpoch) {
+          this.update((state) => ({
+            ...state,
+            nextBefore: previousNextBefore,
+            loadingOlder: false
+          }));
         }
-        return merged;
-      });
-      this.replayCommandsFromTurns(turns);
-    } catch (error) {
-      if (!suppressErrors) throw error;
+        if (options.suppressErrors === false) throw error;
+      } finally {
+        this.replaceInFlight -= 1;
+      }
+    };
+    const run = this.replaceQueue.then(operation);
+    this.replaceQueue = run.catch(() => void 0);
+    return run;
+  }
+  invalidateOlderPaging() {
+    this.pagingGeneration += 1;
+    this.olderPending = null;
+  }
+  beginCommandRecovery() {
+    this.commandRecoveryGeneration += 1;
+    this.commandRestoreRetryAttempt = 0;
+    this.bufferedCommandDeliveries ??= [];
+    if (this.commandRestoreRetryHandle !== null) {
+      globalThis.clearTimeout(this.commandRestoreRetryHandle);
+      this.commandRestoreRetryHandle = null;
     }
+    return this.commandRecoveryGeneration;
   }
-  /**
-   * 把历史里的指令补投给宿主页面。
-   *
-   * 重开会话、断线补数时，地图高亮这类"页面当前状态"必须能恢复——
-   * 否则刷新一次页面，之前智能体让页面做的事就全丢了。
-   * 只回放指令：toolCall / message 这些事件如果按历史全量重放，
-   * 监听器会在挂载瞬间收到几百条陈年事件。
-   * dispatch 内部按 deliveredCommandKeys 去重，重复调用安全。
-   */
-  replayCommandsFromTurns(turns) {
+  scheduleHistoricalCommandRestore(generation) {
+    const restore = async () => {
+      if (this.disposed || generation !== this.commandRecoveryGeneration) return;
+      try {
+        const commands = await this.runtime.fetchCommands(this.sessionId);
+        if (this.disposed) return;
+        for (const command of commands) {
+          if (this.disposed) return;
+          this.deliverCommandNow({
+            deliveryKey: commandDeliveryKey(command.deliveryId),
+            action: command.action,
+            payload: command.payload,
+            toolCallId: command.toolCallId
+          });
+        }
+        if (generation !== this.commandRecoveryGeneration) return;
+        this.commandRestoreRetryAttempt = 0;
+        this.flushBufferedCommands(generation);
+      } catch {
+        if (!this.disposed && generation === this.commandRecoveryGeneration && this.commandRestoreRetryHandle === null) {
+          const retryDelay = Math.min(
+            COMMAND_RESTORE_RETRY_BASE_MS * 2 ** this.commandRestoreRetryAttempt,
+            COMMAND_RESTORE_RETRY_MAX_MS
+          );
+          this.commandRestoreRetryAttempt += 1;
+          this.commandRestoreRetryHandle = globalThis.setTimeout(() => {
+            this.commandRestoreRetryHandle = null;
+            if (!this.disposed && generation === this.commandRecoveryGeneration) {
+              this.scheduleHistoricalCommandRestore(generation);
+            }
+          }, retryDelay);
+        }
+      }
+    };
+    const run = this.commandRestoreQueue.then(restore);
+    this.commandRestoreQueue = run.catch(() => void 0);
+  }
+  flushBufferedCommands(generation) {
+    const pending = [...this.bufferedCommandDeliveries ?? []];
+    this.bufferedCommandDeliveries = [];
+    let index = 0;
+    while (index < pending.length) {
+      if (this.disposed) return;
+      if (generation !== this.commandRecoveryGeneration) {
+        const currentGenerationBuffer = this.bufferedCommandDeliveries ?? [];
+        this.bufferedCommandDeliveries = [
+          ...pending.slice(index),
+          ...currentGenerationBuffer
+        ];
+        return;
+      }
+      this.deliverCommandNow(pending[index]);
+      index += 1;
+      const reentrantBuffer = this.bufferedCommandDeliveries;
+      if (index === pending.length && reentrantBuffer && reentrantBuffer.length > 0) {
+        pending.push(...reentrantBuffer);
+        this.bufferedCommandDeliveries = [];
+      }
+    }
+    if (!this.disposed && generation === this.commandRecoveryGeneration) {
+      this.bufferedCommandDeliveries = null;
+    }
+  }
+  /** 首次订阅前的 REST 历史建立语义事件基线，随后同一工具的订阅回放不再投递。 */
+  seedToolCallDeliveryBaseline(turns) {
     for (const turn of turns) {
-      for (const block of turn.blocks) {
-        if (block.type === "tool_bridge" && isToolBridgeContent(block.content)) {
-          this.dispatchCommand(turn, block);
+      for (const toolCall of turn.tool_calls) {
+        this.seenToolCallIds.add(toolCall.id);
+        if (toolCall.status === "done" || toolCall.status === "error" || toolCall.status === "cancelled") {
+          this.finishedToolCallIds.add(toolCall.id);
         }
       }
     }
   }
-  ensureJoined() {
+  ensureJoined(liveRevisionBoundary = this.liveRevision) {
     if (this.joined) return Promise.resolve();
     if (this.joinPending) return this.joinPending;
     const join = this.runtime.emitWithAck(
@@ -4093,8 +5020,7 @@ var AgentSession = class _AgentSession {
       {
         session_id: this.sessionId,
         event_format: "raw",
-        resume: true,
-        stream_tokens: this.runtime.streamTokens
+        resume: true
       },
       5e3
     ).then((response) => {
@@ -4104,7 +5030,7 @@ var AgentSession = class _AgentSession {
         );
       }
       this.joined = true;
-      this._applyRunningState(Boolean(response?.is_running));
+      this._applyRunningState(Boolean(response?.is_running), liveRevisionBoundary);
     }).finally(() => {
       this.joinPending = null;
     });
@@ -4167,16 +5093,28 @@ var SessionHub = class {
    * 只有最后一份归还才退订房间——否则 StrictMode 双跑、路由抖动这类"连两次
    * 只释放一次"的场景会把仍在用的会话退订掉，之后所有 turn/chat 事件静默丢失。
    */
-  async connect(sessionId) {
+  async connect(sessionId, options = {}) {
     const existing = this.sessions.get(sessionId);
     if (existing && !existing.isDisposed) {
       this.hold(sessionId);
+      try {
+        options.setup?.(existing);
+      } catch (error) {
+        existing.dispose();
+        throw error;
+      }
       return this.bootstrapPending.get(sessionId) ?? existing;
     }
     this.ensureBound();
     const session = new AgentSession(sessionId, this.runtimeFor(), this.connection);
     this.sessions.set(sessionId, session);
     this.hold(sessionId);
+    try {
+      options.setup?.(session);
+    } catch (error) {
+      session.dispose();
+      throw error;
+    }
     this.ensureConnected();
     const bootstrap = session._bootstrap().then(() => session);
     this.bootstrapPending.set(sessionId, bootstrap);
@@ -4231,7 +5169,6 @@ var SessionHub = class {
   }
   runtimeFor() {
     return {
-      streamTokens: this.client.options?.streamTokens !== false,
       emitEvent: (event, data) => {
         ;
         this.client.socket().emit(event, data);
@@ -4247,7 +5184,8 @@ var SessionHub = class {
         });
       }),
       ensureConnected: () => this.ensureConnected(),
-      fetchTurns: (sessionId) => this.client.sessions.getSessionTurns(sessionId),
+      fetchTurnsPage: (sessionId, before) => this.client.sessions.getSessionTurnsPage(sessionId, { before }),
+      fetchCommands: (sessionId) => this.client.sessions.getSessionTurnCommands(sessionId),
       fetchSessionInfo: (sessionId) => this.client.sessions.getSession(sessionId),
       updateReplay: (sessionId, payload) => this.client.sessions.updateReplaySession(sessionId, payload).then((result) => result.replay_state ?? null),
       listDir: (sessionId, dirPath) => this.client.sessions.listDir(sessionId, dirPath),
@@ -4339,9 +5277,25 @@ var SessionHub = class {
     socket.on("turn:end", (data) => {
       for (const session of this.route(data.session_id)) session._handleTurnEnd(data);
     });
-    socket.on("turn:events", (data) => {
-      for (const session of this.route(data.session_id)) session._handleTurnEvents(data.events ?? []);
-    });
+    socket.on(
+      "turn:timing",
+      (data) => {
+        for (const session of this.route(data.session_id)) {
+          session._handleTurnEvents([
+            { type: "llm:first_token:delivered", payload: data }
+          ]);
+        }
+      }
+    );
+    socket.on(
+      "turn:events",
+      (data, acknowledge) => {
+        acknowledgeTurnEvents(acknowledge);
+        for (const session of this.route(data.session_id)) {
+          session._handleTurnEvents(data.events ?? [], data.replayed === true);
+        }
+      }
+    );
     socket.on("chat:start", (data) => {
       for (const session of this.route(data?.session_id)) session._handleChatStart();
     });
@@ -4469,21 +5423,14 @@ function resolveAuthToken(options) {
   return token ? token : null;
 }
 
-// src/version.ts
-var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.0-beta.4" : "1.1.1";
-
 // src/socket.ts
-function withSdkIdentity(auth) {
-  return { ...auth ?? {}, sdk: SDK_NAME, sdk_version: SDK_VERSION };
-}
 function createSocket(options) {
   const token = resolveAuthToken(options);
   return io(options.baseUrl, {
     path: options.path ?? "/socket.io",
     withCredentials: true,
     query: token ? { token } : void 0,
-    auth: typeof options.token === "function" ? (cb) => cb(withSdkIdentity(buildSocketAuth(options))) : withSdkIdentity(buildSocketAuth(options)),
+    auth: typeof options.token === "function" ? (cb) => cb(buildSocketAuth(options) ?? {}) : buildSocketAuth(options) ?? {},
     autoConnect: false
   });
 }
@@ -4499,6 +5446,7 @@ var BladeClient = class {
   options;
   auth;
   headless;
+  computers;
   models;
   sessions;
   /** 实时会话中枢：client.sessions.connect() 内部使用，一般不直接访问。 */
@@ -4510,6 +5458,7 @@ var BladeClient = class {
     };
     this.auth = new AuthResource(this);
     this.headless = new HeadlessResource(this);
+    this.computers = new ComputersResource(this);
     this.models = new ModelsResource(this);
     this.sessions = new SessionsResource(this);
     this.hub = new SessionHub(this);
@@ -4864,6 +5813,90 @@ function parseXhrHeaders(rawHeaders) {
   return headers;
 }
 
+// src/platform-endpoints.ts
+var PLATFORM_SERVICE_NAMES = [
+  "os",
+  "hub",
+  "agent",
+  "oauth",
+  "llmGateway",
+  "gitea",
+  "tile"
+];
+var EMPTY_PLATFORM_ENDPOINTS = Object.freeze({
+  services: Object.freeze({})
+});
+function defaultDocumentBaseUrl() {
+  if (typeof document === "undefined") return void 0;
+  if (document.querySelector("base[href]")) return document.baseURI;
+  if (typeof location !== "undefined" && location.origin) return `${location.origin}/`;
+  return document.baseURI;
+}
+function normalizeServiceUrl(value) {
+  if (typeof value !== "string" || !value.trim()) return null;
+  if (value.includes("?") || value.includes("#")) return null;
+  try {
+    const url = new URL(value.trim());
+    if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+    if (url.username || url.password || url.search || url.hash) return null;
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return null;
+  }
+}
+function parsePlatformEndpoints(value) {
+  if (!isRecord(value) || !isRecord(value.services)) return null;
+  const services = {};
+  for (const name of PLATFORM_SERVICE_NAMES) {
+    if (!(name in value.services)) continue;
+    const url = normalizeServiceUrl(value.services[name]);
+    if (!url) return null;
+    if (name === "agent" && new URL(url).pathname !== "/") return null;
+    services[name] = url;
+  }
+  return { services };
+}
+async function loadPlatformEndpoints(options = {}) {
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+  const baseUrl = options.baseUrl ?? defaultDocumentBaseUrl();
+  if (!fetchImpl || !baseUrl) return EMPTY_PLATFORM_ENDPOINTS;
+  const controller = new AbortController();
+  const timeout = globalThis.setTimeout(() => controller.abort(), options.timeoutMs ?? 3e3);
+  try {
+    const response = await fetchImpl(new URL("config.json", baseUrl), {
+      cache: "no-store",
+      credentials: "same-origin",
+      headers: { Accept: "application/json" },
+      signal: controller.signal
+    });
+    if (!response.ok) return EMPTY_PLATFORM_ENDPOINTS;
+    return parsePlatformEndpoints(await response.json()) ?? EMPTY_PLATFORM_ENDPOINTS;
+  } catch {
+    return EMPTY_PLATFORM_ENDPOINTS;
+  } finally {
+    globalThis.clearTimeout(timeout);
+  }
+}
+function resolveServiceUrl(endpoints, name, path = "") {
+  const baseUrl = endpoints.services[name];
+  if (!baseUrl) return null;
+  if (!path) return baseUrl;
+  const pathReference = path.trimStart();
+  if (path.includes("\\") || pathReference.startsWith("//") || /^[a-z][a-z0-9+.-]*:/i.test(pathReference)) {
+    return null;
+  }
+  const base = new URL(`${baseUrl}/`);
+  const target = new URL(path.replace(/^\/+/, ""), base);
+  if (target.origin !== base.origin || !target.pathname.startsWith(base.pathname)) {
+    return null;
+  }
+  return target.toString();
+}
+
+// src/version.ts
+var SDK_NAME = "agent-client";
+var SDK_VERSION = true ? "2610.0.0-beta.40" : "1.1.1";
+
 // src/commands/protocol.ts
 function isCommandEnvelope(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -4967,7 +6000,9 @@ export {
   BladeApiError,
   BladeClient,
   ClientProjectionBuilder,
+  ComputersResource,
   DEFAULT_REPLAY_SPEED,
+  EMPTY_PLATFORM_ENDPOINTS,
   LayoutType,
   ModelsResource,
   SDK_NAME,
@@ -4979,21 +6014,40 @@ export {
   Task,
   TaskStatus,
   acceptedPostChatFollowupCompletesLatestRun,
+  acknowledgeTurnEvents,
   buildMessageContent,
+  canToggleComputer,
+  chatErrorForDisplay,
+  computerDaemonVersion,
+  computerOS,
+  computerPlatformLabel,
+  computerState,
   connectEmbedded,
   contentPreview,
+  contextProjectionData,
   createInitialSessionState,
   createSocket,
   extractTextAttachments,
+  getContextDisplayState,
+  getContextGroupDisplayState,
   getFileParts,
   getImageParts,
   getTextContent,
+  groupAdjacentContextRuns,
   groupMessagesByLoop,
+  hasChatRunEvent,
   isCommandEnvelope,
   isHiddenInternalMessage,
   isInboundEnvelope,
   latestPostChatFollowup,
+  loadPlatformEndpoints,
   normalizeMessageContent,
+  prependOlder,
+  reconcileHistoricalUserTurns,
+  reconcileOptimisticUserTurns,
+  replaceWindow,
+  resolveServiceUrl,
+  sortComputers,
   toReplaySnapshot,
   transformSlashCommand
 };