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

package/README.md

@@ -585,7 +585,7 @@ transformSlashCommand(skillId, prompt, { local: false, installed: false })
 - **会话回放**：`ReplayState`、`ReplaySpeed`、`ReplayPreview`、`ReplaySnapshot`、`toReplaySnapshot`、`DEFAULT_REPLAY_SPEED`
 - **会话状态机**：`SessionHub`、`SessionState`、`SendOptions`、`ConnectionStatus`、`AskUserAnswerData`、`AgentLoopInfo`、`ActiveCompactionState`、`createInitialSessionState`、`AgentSessionEventName`
 - **页面协作**：`EmbeddedChat`、`EmbeddedChatOptions`、`CommandHandler`、`CommandEnvelope`、`InboundAction`、`InboundEnvelope`、`isCommandEnvelope`、`isInboundEnvelope`
-- **消息与投影协议**：`MessageContent`、`MessageContentPart`、`TextContentPart`、`ImageUrlContentPart`、`FileContentPart`、`ToolCallInfo`、`ToolBridgeContent`、`CompactionInfo`、`ContextProjectionData`、`ContextProjectionFields`、`ContextDisplayState`、`ContextAction`、`ContextSourceInfo`、`MemoryRefInfo`、`ArchivedFileInfo`、`ArchivedToolCallInfo`、`TurnProjection`、`ContentBlock`、`PatchEnvelope`、`MemoryRef`、`PostChatFollowup`、`FinalArtifact`、`contextProjectionData`、`getContextDisplayState`、`latestPostChatFollowup`、`buildMessageContent`、`normalizeMessageContent`、`isHiddenInternalMessage`、`transformSlashCommand`、`SkillMentionAvailability`、`extractTextAttachments`、`ParsedTextAttachment`、`ParsedTextContext`
+- **消息与投影协议**：`MessageContent`、`MessageContentPart`、`TextContentPart`、`ImageUrlContentPart`、`FileContentPart`、`ToolCallInfo`、`ToolBridgeContent`、`CompactionInfo`、`ContextProjectionData`、`ContextProjectionFields`、`ContextDisplayState`、`ContextGroupDisplayState`、`ContextAction`、`ContextSourceInfo`、`MemoryRefInfo`、`ArchivedFileInfo`、`ArchivedToolCallInfo`、`TurnProjection`、`ContentBlock`、`PatchEnvelope`、`MemoryRef`、`PostChatFollowup`、`FinalArtifact`、`contextProjectionData`、`getContextDisplayState`、`getContextGroupDisplayState`、`groupAdjacentContextRuns`、`latestPostChatFollowup`、`buildMessageContent`、`normalizeMessageContent`、`isHiddenInternalMessage`、`transformSlashCommand`、`SkillMentionAvailability`、`extractTextAttachments`、`ParsedTextAttachment`、`ParsedTextContext`
 - **Solution / 任务协议**：`Solution`、`SolutionAppField`、`SolutionAppState`、`SolutionAppUiConfig`、`SolutionRef`、`PublishedSolutionRef`、`ExistingSolutionRef`、`PreparedSolution`、`PreparedSolutionAsset`、`LayoutType`、`BizRole`、`TaskStatus`、`BackgroundTask`、`BackgroundTaskStopResult`
 - **Headless**：`HeadlessResource`、`RunOptions`、`RunResult`、`RunTrace`
 - **低层通道（apps/web 等高级集成）**：`createSocket`、`CreateSocketOptions`、`TypedSocket`、`AsrAudioPayload`、`ClientProjectionBuilder`、`RawEvent`、`acceptedPostChatFollowupCompletesLatestRun`、`reconcileOptimisticUserTurns`

package/dist/index.d.ts

@@ -29,8 +29,8 @@ export type { SessionsResource } from "./resources/sessions";
 export type { CreateSessionRequest, AppCliAttachment, AppCliDefinition, FileEntry, ImportSessionOptions, PaginatedSessionsResult, GlobalSearchConversationResult, GlobalSearchFileResult, GlobalSearchResult, GlobalSearchResultItem, ResultFeedback, ResultFeedbackReason, SessionContextStats, SessionHistory, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
 export type { ArchivedFileInfo, ArchivedToolCallInfo, ChatMessage, CompactionInfo, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolBridgeContent, ToolCallInfo, } from "./schemas/message";
 export { buildMessageContent, chatErrorForDisplay, contentPreview, extractTextAttachments, getFileParts, getImageParts, getTextContent, groupMessagesByLoop, isHiddenInternalMessage, normalizeMessageContent, transformSlashCommand, } from "./schemas/message-utils";
-export { contextProjectionData, getContextDisplayState, } from "./schemas/context";
-export type { ContextAction, ContextDisplayState, ContextProjectionData, ContextProjectionFields, ContextSourceInfo, } from "./schemas/context";
+export { contextProjectionData, getContextDisplayState, getContextGroupDisplayState, groupAdjacentContextRuns, } from "./schemas/context";
+export type { ContextAction, ContextDisplayState, ContextGroupDisplayState, ContextProjectionData, ContextProjectionFields, ContextSourceInfo, } from "./schemas/context";
 export type { ParsedTextAttachment, ParsedTextContext, SkillMentionAvailability, } from "./schemas/message-utils";
 export type { ContentBlock, FinalArtifact, MemoryRef, PatchEnvelope, PostChatFollowup, TurnProjection, } from "./schemas/projection";
 export { latestPostChatFollowup } from "./schemas/projection-utils";

package/dist/index.js

@@ -1104,12 +1104,47 @@ function contextProjectionData(fields) {
   };
 }
 function getContextDisplayState(context) {
-  const title = BUILTIN_CONTEXT_TITLES[context.context_kind] ?? nonEmptyString(context.display_title) ?? "\u5BF9\u8BDD\u80CC\u666F";
+  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 isRecord2(value) {
@@ -2015,7 +2050,11 @@ function projectHistory(entries) {
         model: stringOrNull(message.model),
         usage: isRecord4(message._usage) ? { ...message._usage } : null,
         duration_ms: numberOrZero(message._duration_ms),
-        started_at: typeof entry.timestamp === "string" ? entry.timestamp : void 0
+        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) => isRecord4(toolCall) && typeof toolCall.provider === "string"
@@ -2990,10 +3029,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;
@@ -4818,7 +4857,7 @@ function resolveAuthToken(options) {
 
 // src/version.ts
 var SDK_NAME = "agent-client";
-var SDK_VERSION = true ? "2610.0.0-beta.30" : "1.1.1";
+var SDK_VERSION = true ? "2610.0.0-beta.31" : "1.1.1";
 
 // src/socket.ts
 function withSdkIdentity(auth) {
@@ -5424,9 +5463,11 @@ export {
   createSocket,
   extractTextAttachments,
   getContextDisplayState,
+  getContextGroupDisplayState,
   getFileParts,
   getImageParts,
   getTextContent,
+  groupAdjacentContextRuns,
   groupMessagesByLoop,
   isCommandEnvelope,
   isHiddenInternalMessage,