@blade-hq/agent-client 2610.0.3-beta.1 → 2610.0.4

package/README.md

@@ -780,3 +780,5 @@ HTML 一律判无效）；`isInternalStatusToolUiCard` 识别内部「阶段进
 会话列表和详情的 `SessionInfo.initiator` 表示首次发起来源：`ui` 为界面，`sdk` 为 SDK；旧会话缺少可靠记录时为 `unknown`，尚未发起会话时为 `null` 或未提供。它不等同于后台运行标记 `is_headless`，后续继续会话不会改变来源。
 
 后台唤醒输入可用 `isBackgroundWakeMessage(message)` 识别，它读取消息的结构化通知 block。自定义 UI 应为这类输入显示说明卡片；`isHiddenInternalMessage` 仍将其视为内部输入，避免作为用户发言或回溯导航点。
+
+`@blade-hq/agent-client/internal`（exports 子路径 `./internal`）供 Blade 自有渲染层共享服务器时钟。普通接入方使用会话快照中的 `chat_run` 读取本轮整体区间，`duration_ms` 仍表示模型请求耗时。

package/dist/index.js

@@ -4,7 +4,7 @@ import {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.3-beta.1" : "1.1.1";
+var SDK_VERSION = true ? "2610.0.4" : "1.1.1";
 
 // src/auth-login.ts
 function isAuthCallbackMessage(value) {
@@ -584,6 +584,54 @@ var SessionSetupError = class extends Error {
   cause;
 };
 
+// src/shared/projection/chat-run.ts
+function readChatRun(payload, ended = false) {
+  const runId = payload.chat_run_id;
+  const start = payload.started_at;
+  if (typeof runId !== "string" || !runId || typeof start !== "string" || !Number.isFinite(Date.parse(start))) return null;
+  const status = payload.status === "interrupted" ? "cancelled" : payload.status;
+  return {
+    run_id: runId,
+    scope: "chat",
+    loop_id: "root",
+    started_at: start,
+    duration_ms: ended && typeof payload.duration_ms === "number" ? Math.max(0, payload.duration_ms) : null,
+    status: ended && ["completed", "failed", "paused", "cancelled"].includes(String(status)) ? status : "incomplete"
+  };
+}
+function isUserSupplement(entry) {
+  const message = entry.message;
+  if (!message || message.role !== "user" || !("_display_content" in message)) return false;
+  const content = message.content;
+  if (typeof content === "string") return content.startsWith("<user-supplement>") && content.endsWith("</user-supplement>");
+  if (!Array.isArray(content) || content.length < 2) return false;
+  const first = content[0], last = content[content.length - 1];
+  return first?.type === "text" && first.text === "<user-supplement>" && last?.type === "text" && last.text === "</user-supplement>";
+}
+function applyHistoryChatRuns(turns, entries, aliases) {
+  const byRun = /* @__PURE__ */ new Map();
+  const supplements = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    const supplement = aliases.get(String(entry.id ?? ""));
+    if (supplement && isUserSupplement(entry)) supplements.add(supplement.turn_id);
+    if (entry.kind !== "run_timing" || !entry.data || entry.data.scope !== "chat") continue;
+    const data = entry.data;
+    const anchor = aliases.get(String(data.anchor_entry_id ?? ""));
+    const timing = readChatRun({ ...data, chat_run_id: data.run_id }, data.status !== "incomplete");
+    if (anchor && timing) byRun.set(timing.run_id, { anchor, timing });
+  }
+  const runs = [...byRun.values()].sort((a, b) => a.anchor.sequence - b.anchor.sequence);
+  let index = -1;
+  let active;
+  for (const turn of turns) {
+    if (turn.loop_id === "root" && (turn.role === "user" && !supplements.has(turn.turn_id) || turn.blocks.some((block) => block.type === "ask_user_answer"))) active = void 0;
+    while (index + 1 < runs.length && runs[index + 1].anchor.sequence <= turn.sequence) active = runs[++index].timing;
+    if (active && turn.loop_id === "root" && turn.role === "assistant" && (turn.kind ?? "message") === "message") {
+      turn.chat_run = active;
+    }
+  }
+}
+
 // src/shared/projection/helpers.ts
 function upsertToolCall(state, toolCallId, toolName, displayName, args) {
   if (!toolCallId) return;
@@ -1270,6 +1318,7 @@ function acceptedPostChatFollowupCompletesLatestRun(events, updates) {
     updates.flatMap((update) => {
       if (update.kind !== "upsert") return [];
       const followup = update.turn.post_chat_followup;
+      if (update.turn.chat_run?.status === "incomplete") return [];
       return followup?.assistant_entry_id ? [followup.assistant_entry_id] : [];
     })
   );
@@ -1352,6 +1401,9 @@ var ClientProjectionBuilder = class {
   pendingMemoryRefs = /* @__PURE__ */ new Map();
   activeCompactions = /* @__PURE__ */ new Map();
   failedCompactions = /* @__PURE__ */ new Map();
+  // undefined: history may seed the builder; null: a live start reported no interval.
+  chatRun = void 0;
+  chatTurnIds = /* @__PURE__ */ new Set();
   seq = 0;
   syntheticCounter = 0;
   displayNameResolver;
@@ -1375,6 +1427,35 @@ var ClientProjectionBuilder = class {
     return [...nonUpserts, ...lastUpsertByTurn.values()];
   }
   processEvent(event) {
+    if (event.type === "chat:start") {
+      const timing = readChatRun(event.payload);
+      this.chatTurnIds.clear();
+      this.chatRun = timing;
+    }
+    const ended = event.type === "chat:end" ? readChatRun(event.payload, true) : null;
+    if (ended && (!this.chatRun || ended.run_id === this.chatRun.run_id)) this.chatRun = ended;
+    const updates = this.processTurnEvent(event) ?? [];
+    const changed = /* @__PURE__ */ new Set();
+    for (const update of updates) {
+      if (update.kind !== "upsert" || update.turn.loop_id !== "root" || update.turn.role !== "assistant" || !this.chatRun) continue;
+      update.turn.chat_run = this.chatRun;
+      this.chatTurnIds.add(update.turn.turn_id);
+      changed.add(update.turn.turn_id);
+    }
+    if (ended && ended.run_id === this.chatRun?.run_id) {
+      for (const id of this.chatTurnIds) {
+        if (changed.has(id)) continue;
+        const previous = this.turnsById.get(id);
+        if (!previous) continue;
+        const turn = { ...previous, chat_run: ended };
+        this.turnsById.set(id, turn);
+        if (this.latestTurns.get("root")?.turn_id === id) this.latestTurns.set("root", turn);
+        updates.push({ kind: "upsert", turn });
+      }
+    }
+    return updates.length ? updates : null;
+  }
+  processTurnEvent(event) {
     const payload = event.payload;
     const loopId = String(payload.loop_name ?? "root");
     switch (event.type) {
@@ -1486,6 +1567,8 @@ var ClientProjectionBuilder = class {
     }
   }
   reset() {
+    this.chatRun = void 0;
+    this.chatTurnIds.clear();
     this.activeTurns.clear();
     this.lastTurnIds.clear();
     this.latestTurns.clear();
@@ -1518,6 +1601,15 @@ var ClientProjectionBuilder = class {
     }
     this.latestTurns = latestTurns;
     this.turnsById = turnsById;
+    const root = latestTurns.get("root");
+    const timing = root?.role === "assistant" ? root.chat_run ?? null : null;
+    if (this.chatRun === void 0 || timing && timing.run_id === this.chatRun?.run_id) {
+      this.chatRun = timing;
+      this.chatTurnIds.clear();
+    }
+    for (const turn of turns) {
+      if (turn.chat_run && turn.chat_run.run_id === this.chatRun?.run_id) this.chatTurnIds.add(turn.turn_id);
+    }
   }
   // --- Event handlers ---
   onMemoryInject(loopId, payload) {
@@ -2614,6 +2706,7 @@ function projectHistory(entries) {
       );
     }
   }
+  applyHistoryChatRuns(turns, entries, turnEntryAliases);
   return turns;
 }
 function parseToolArguments(value) {
@@ -4189,7 +4282,8 @@ function projectionToMessage(turn) {
       entry_id: turn.turn_id,
       status: turn.status,
       ...typeof turn.duration_ms === "number" ? { duration_ms: turn.duration_ms } : {},
-      ...turn.started_at ? { timestamp: turn.started_at } : {}
+      ...turn.started_at ? { timestamp: turn.started_at } : {},
+      ...turn.chat_run ? { chat_run: turn.chat_run } : {}
     };
   }
   const content = buildMessageContent2(turn) || workspaceNotificationContent(turn);
@@ -4218,6 +4312,7 @@ function projectionToMessage(turn) {
     status: turn.status,
     ...typeof turn.duration_ms === "number" ? { duration_ms: turn.duration_ms } : {},
     ...turn.started_at ? { timestamp: turn.started_at } : {},
+    ...turn.chat_run ? { chat_run: turn.chat_run } : {},
     ...turn.memory_refs?.length ? { memory_refs: turn.memory_refs } : {}
   };
 }