@nextclaw/ui 0.20.0 → 0.20.1

package/src/features/chat/features/ncp/hooks/__tests__/use-ncp-agent-runtime.test.tsx

@@ -1,4 +1,4 @@
-import { act, renderHook, waitFor } from "@testing-library/react";
+import { act, render, renderHook, waitFor } from "@testing-library/react";
 import {
   type NcpAgentClientEndpoint,
   type NcpAgentSendEnvelope,
@@ -158,6 +158,29 @@ class ExistingSessionLiveClient implements NcpAgentClientEndpoint {
   };
 }
 
+function RuntimeMessagesProbe({
+  client,
+  manager,
+}: {
+  client: NcpAgentClientEndpoint;
+  manager: DefaultNcpAgentConversationStateManager;
+}) {
+  const { visibleMessages } = useNcpAgentRuntime({
+    sessionId: "ncp-mt7hs0u9-15yce6jv",
+    client,
+    manager,
+  });
+  return (
+    <div data-testid="runtime-messages">
+      {visibleMessages.map((message) => (
+        <div key={message.id} data-message-id={message.id}>
+          {message.id}
+        </div>
+      ))}
+    </div>
+  );
+}
+
 function readAssistantText(messages: readonly NcpMessage[]): string {
   const assistant = messages.find((message) => message.role === "assistant");
   return assistant?.parts
@@ -421,6 +444,72 @@ describe("useNcpAgentRuntime", () => {
     ]);
   });
 
+  it("keeps the live assistant boundary and DOM identity when a steered user has an earlier timestamp", async () => {
+    const client = new DeferredSendClient();
+    const manager = new DefaultNcpAgentConversationStateManager();
+    manager.hydrate({
+      sessionId: "ncp-mt7hs0u9-15yce6jv",
+      messages: [{
+        id: "user-mt7jp7vd",
+        sessionId: "ncp-mt7hs0u9-15yce6jv",
+        role: "user",
+        status: "final",
+        parts: [{ type: "text", text: "first" }],
+        timestamp: "2026-08-24T18:04:10.460Z",
+      }],
+    });
+    await manager.dispatchBatch([
+      {
+        type: NcpEventType.RunStarted,
+        payload: {
+          sessionId: "ncp-mt7hs0u9-15yce6jv",
+          runId: "agent-run-7c65d8b1-6bda-4f08-a2ad-d5f5318366fb",
+        },
+      },
+      {
+        type: NcpEventType.MessageReasoningDelta,
+        payload: {
+          sessionId: "ncp-mt7hs0u9-15yce6jv",
+          messageId: "assistant-message-2629eaf9-c4ce-4562-b22d-c70f1e8c85e2",
+          delta: "Planning",
+        },
+      },
+    ]);
+
+    const view = render(<RuntimeMessagesProbe client={client} manager={manager} />);
+    const assistantSelector = '[data-message-id="assistant-message-2629eaf9-c4ce-4562-b22d-c70f1e8c85e2"]';
+    const assistantNode = view.container.querySelector(assistantSelector);
+    expect(assistantNode).not.toBeNull();
+
+    await act(async () => {
+      await manager.dispatch({
+        type: NcpEventType.MessageSent,
+        payload: {
+          sessionId: "ncp-mt7hs0u9-15yce6jv",
+          message: {
+            id: "user-mt7jpad5",
+            sessionId: "ncp-mt7hs0u9-15yce6jv",
+            role: "user",
+            status: "final",
+            parts: [{ type: "text", text: "steer" }],
+            timestamp: "2026-08-24T18:04:13.625Z",
+          },
+        },
+      });
+    });
+
+    await waitFor(() => {
+      const ids = [...view.container.querySelectorAll("[data-message-id]")]
+        .map((node) => node.getAttribute("data-message-id"));
+      expect(ids).toEqual([
+        "user-mt7jp7vd",
+        "assistant-message-2629eaf9-c4ce-4562-b22d-c70f1e8c85e2",
+        "user-mt7jpad5",
+      ]);
+    });
+    expect(view.container.querySelector(assistantSelector)).toBe(assistantNode);
+  });
+
 });
 
 describe("useNcpAgentRuntime commands and live stream", () => {

package/src/features/chat/features/session/utils/ncp-session-context-metadata.utils.ts

@@ -91,7 +91,11 @@ export type ContextCompactionTimelineView = {
 
 export function readContextCompactionTimeline(message: Pick<NcpMessageView, 'metadata'>): ContextCompactionTimelineView | null {
   const { metadata } = message;
-  if (!metadata || metadata[NEXTCLAW_TIMELINE_KIND_METADATA_KEY] !== CONTEXT_COMPACTION_TIMELINE_KIND) {
+  if (
+    !metadata ||
+    readOptionalString(metadata.inherited_from_session_id) ||
+    metadata[NEXTCLAW_TIMELINE_KIND_METADATA_KEY] !== CONTEXT_COMPACTION_TIMELINE_KIND
+  ) {
     return null;
   }
   const rawCheckpoint =

package/src/features/chat/features/workspace/components/__tests__/chat-session-workspace-panel-content.test.tsx

@@ -222,7 +222,7 @@ function createChildTab(): ResolvedChildSessionTab {
   };
 }
 
-it('shows compact child session metadata in a full-height column layout', () => {
+it('shows child session content without a redundant metadata header', () => {
   render(
     <ChatSessionWorkspacePanelContent
       activeSelection={{
@@ -239,10 +239,10 @@ it('shows compact child session metadata in a full-height column layout', () =>
   );
 
   expect(screen.queryByText('Child title')).toBeNull();
-  expect(screen.getByText('原生')).toBeTruthy();
-  expect(screen.getByText('minimax/MiniMax-M3')).toBeTruthy();
-  expect(screen.getByText('nextbot')).toBeTruthy();
-  expect(screen.getByTitle('/Users/peiwang/Projects/nextbot')).toBeTruthy();
+  expect(screen.queryByText('原生')).toBeNull();
+  expect(screen.queryByText('minimax/MiniMax-M3')).toBeNull();
+  expect(screen.queryByText('nextbot')).toBeNull();
+  expect(screen.queryByTitle('/Users/peiwang/Projects/nextbot')).toBeNull();
   const conversationArea = screen.getByTestId('session-conversation-area');
   const selectedContentHost = conversationArea.parentElement?.parentElement;
   expect(Array.from(selectedContentHost?.classList ?? [])).toEqual(

package/src/features/chat/features/workspace/components/chat-session-workspace-panel-content.tsx

@@ -202,40 +202,6 @@ function WorkspaceProjectFiles({
   );
 }
 
-function ChildSessionMetaChip({ value }: { value: string }) {
-  return (
-    <span className="inline-flex max-w-full shrink-0 items-center rounded border border-gray-200 bg-gray-50 px-1.5 py-0.5 text-[10px] font-medium text-gray-600">
-      <span className="truncate">{value}</span>
-    </span>
-  );
-}
-
-function ChildSessionMetaStrip({ tab }: { tab: ResolvedChildSessionTab }) {
-  const metaItems = [tab.sessionTypeLabel, tab.preferredModel, tab.projectName].filter((value): value is string =>
-    Boolean(value?.trim()),
-  );
-
-  if (metaItems.length === 0 && !tab.projectRoot) {
-    return null;
-  }
-
-  return (
-    <div className="flex min-h-9 min-w-0 items-center gap-1.5 border-b border-gray-200/70 px-3 py-1.5 text-[11px] text-gray-500">
-      {metaItems.map((item) => (
-        <ChildSessionMetaChip key={item} value={item} />
-      ))}
-      {tab.projectRoot ? (
-        <span
-          title={tab.projectRoot}
-          className="min-w-0 flex-1 truncate rounded border border-gray-200 bg-gray-50 px-1.5 py-0.5 font-mono text-[10px] text-gray-500"
-        >
-          {tab.projectRoot}
-        </span>
-      ) : null}
-    </div>
-  );
-}
-
 function WorkspaceSideChatDraftHeader() {
   return (
     <div className="border-b border-gray-200/70 px-4 py-3">
@@ -307,12 +273,9 @@ function WorkspaceSelectedContent({
 
   if (activeSelection.kind === 'child-session') {
     return (
-      <>
-        <ChildSessionMetaStrip tab={activeSelection.tab} />
-        <div className="flex min-h-0 flex-1 flex-col">
-          <SessionConversationArea sessionKey={activeSelection.tab.sessionKey} />
-        </div>
-      </>
+      <div className="flex min-h-0 flex-1 flex-col">
+        <SessionConversationArea sessionKey={activeSelection.tab.sessionKey} />
+      </div>
     );
   }
 

package/src/features/chat/managers/__tests__/chat-completion-notification.manager.test.ts

@@ -117,6 +117,76 @@ describe("ChatCompletionNotificationManager", () => {
     expect(show).toHaveBeenCalledOnce();
   });
 
+  it("notifies only for human-triggered background runs", () => {
+    manager.start();
+    emit(createCompletedEvent(createMessage({
+      id: "assistant-agent",
+      metadata: {
+        run_trigger: {
+          version: 1,
+          actor: "agent",
+          source: "sessions_spawn",
+          triggeredAt: "2026-08-05T09:59:00.000Z",
+          targetRunId: "run-agent",
+        },
+      },
+    })));
+    emit(createCompletedEvent(createMessage({
+      id: "assistant-automation",
+      metadata: {
+        run_trigger: {
+          version: 1,
+          actor: "automation",
+          source: "observation",
+          triggeredAt: "2026-08-05T09:59:00.000Z",
+          targetRunId: "run-automation",
+        },
+      },
+    })));
+    emit(createCompletedEvent(createMessage({
+      id: "assistant-human",
+      metadata: {
+        run_trigger: {
+          version: 1,
+          actor: "human",
+          source: "ui-http",
+          triggeredAt: "2026-08-05T09:59:00.000Z",
+          targetRunId: "run-human",
+        },
+      },
+    })));
+
+    expect(show).toHaveBeenCalledOnce();
+    expect(show).toHaveBeenCalledWith(expect.objectContaining({
+      id: "chat-reply:assistant-human",
+    }));
+  });
+
+  it("silences legacy child replies without changing legacy top-level behavior", () => {
+    useChatQueryStore.setState({
+      snapshot: {
+        sessionsQuery: {
+          data: {
+            sessions: [{
+              sessionId: "session-background",
+              messageCount: 2,
+              updatedAt: "2026-08-05T10:00:00.000Z",
+              metadata: { parent_session_id: "parent-session" },
+            }],
+            total: 1,
+          },
+        } as never,
+      },
+    });
+    manager.start();
+    emit(createCompletedEvent());
+    expect(show).not.toHaveBeenCalled();
+
+    useChatQueryStore.setState({ snapshot: {} });
+    emit(createCompletedEvent(createMessage({ id: "legacy-top-level" })));
+    expect(show).toHaveBeenCalledOnce();
+  });
+
   it("ignores non-final, non-assistant, hidden, and unrelated events", () => {
     manager.start();
     emit(createCompletedEvent(createMessage({ status: "streaming" })));

package/src/features/chat/managers/chat-completion-notification.manager.ts

@@ -1,6 +1,7 @@
 import {
   isHiddenNcpMessage,
   NcpEventType,
+  readNcpRunTriggerMetadata,
   type NcpEndpointEvent,
   type NcpMessage,
 } from "@nextclaw/ncp";
@@ -16,6 +17,14 @@ import { t } from "@/shared/lib/i18n";
 const NOTIFICATION_PREVIEW_MAX_CHARACTERS = 120;
 const NOTIFIED_MESSAGE_HISTORY_LIMIT = 200;
 
+function isChildSessionMetadata(
+  metadata: Record<string, unknown> | null | undefined,
+): boolean {
+  return [metadata?.parent_session_id, metadata?.parentSessionId].some(
+    (value) => typeof value === "string" && value.trim().length > 0,
+  );
+}
+
 function buildNotificationPreview(value: string): string {
   const normalized = value
     .replace(/\r\n?/gu, "\n")
@@ -119,7 +128,18 @@ export class ChatCompletionNotificationManager {
       return;
     }
 
-    const title = this.resolveSessionTitle(sessionId);
+    const summary = this.resolveSessionSummary(sessionId);
+    const trigger = readNcpRunTriggerMetadata(message.metadata);
+    if (
+      (trigger && trigger.actor !== "human") ||
+      (!trigger && summary && isChildSessionMetadata(summary.metadata))
+    ) {
+      return;
+    }
+
+    const title = summary
+      ? sessionDisplayName(adaptNcpSessionSummary(summary))
+      : t("chatBackgroundReplyFallbackTitle");
     const preview = readAssistantReplyPreview(message);
     this.notificationManager.show({
       id: `chat-reply:${message.id}`,
@@ -130,13 +150,10 @@ export class ChatCompletionNotificationManager {
     });
   };
 
-  private readonly resolveSessionTitle = (sessionId: string): string => {
+  private readonly resolveSessionSummary = (sessionId: string) => {
     const summaries =
       useChatQueryStore.getState().snapshot.sessionsQuery?.data?.sessions ?? [];
-    const summary = summaries.find((item) => item.sessionId === sessionId);
-    return summary
-      ? sessionDisplayName(adaptNcpSessionSummary(summary))
-      : t("chatBackgroundReplyFallbackTitle");
+    return summaries.find((item) => item.sessionId === sessionId);
   };
 
   private readonly rememberHandledMessage = (messageId: string): void => {

package/src/shared/lib/i18n/locales/en-US/chat.json

@@ -280,6 +280,27 @@
   "chatAiExecutionUsageReported": "Reported",
   "chatAiExecutionUsagePartial": "Partial",
   "chatAiExecutionUsageUnavailable": "Unavailable",
+  "chatRunTriggerView": "View trigger details",
+  "chatRunTriggerTitle": "Run trigger",
+  "chatRunTriggerDescription": "See what started this run and the source context retained with the message.",
+  "chatRunTriggerClose": "Close trigger details",
+  "chatRunTriggerActor": "Started by",
+  "chatRunTriggerSource": "Trigger source",
+  "chatRunTriggerTime": "Triggered at",
+  "chatRunTriggerTargetRun": "Target run ID",
+  "chatRunTriggerSourceSession": "Source session ID",
+  "chatRunTriggerSourceMessage": "Source message ID",
+  "chatRunTriggerSourceRun": "Source run ID",
+  "chatRunTriggerSourceToolCall": "Source tool call ID",
+  "chatRunTriggerSourceRequest": "Source request ID",
+  "chatRunTriggerSourceModel": "Source model",
+  "chatRunTriggerTargetModel": "Run model",
+  "chatRunTriggerSourceContext": "Source context",
+  "chatRunTriggerRaw": "Raw metadata",
+  "chatRunTriggerActorHuman": "Human",
+  "chatRunTriggerActorAgent": "Agent",
+  "chatRunTriggerActorAutomation": "Automation",
+  "chatRunTriggerActorSystem": "System",
   "chatToolActivityReadOne": "Read 1 file",
   "chatToolActivityReadOther": "Read {count} files",
   "chatToolActivityEditOne": "Edit 1 file",

package/src/shared/lib/i18n/locales/zh-CN/chat.json

@@ -280,6 +280,27 @@
   "chatAiExecutionUsageReported": "已报告",
   "chatAiExecutionUsagePartial": "部分报告",
   "chatAiExecutionUsageUnavailable": "不可用",
+  "chatRunTriggerView": "查看触发详情",
+  "chatRunTriggerTitle": "运行触发信息",
+  "chatRunTriggerDescription": "查看本次运行由谁发起，以及消息中保留的来源信息。",
+  "chatRunTriggerClose": "关闭触发详情",
+  "chatRunTriggerActor": "发起方",
+  "chatRunTriggerSource": "触发来源",
+  "chatRunTriggerTime": "触发时间",
+  "chatRunTriggerTargetRun": "目标运行 ID",
+  "chatRunTriggerSourceSession": "来源会话 ID",
+  "chatRunTriggerSourceMessage": "来源消息 ID",
+  "chatRunTriggerSourceRun": "来源运行 ID",
+  "chatRunTriggerSourceToolCall": "来源工具调用 ID",
+  "chatRunTriggerSourceRequest": "来源请求 ID",
+  "chatRunTriggerSourceModel": "来源模型",
+  "chatRunTriggerTargetModel": "本次运行模型",
+  "chatRunTriggerSourceContext": "来源上下文",
+  "chatRunTriggerRaw": "原始元数据",
+  "chatRunTriggerActorHuman": "用户",
+  "chatRunTriggerActorAgent": "代理",
+  "chatRunTriggerActorAutomation": "自动任务",
+  "chatRunTriggerActorSystem": "系统",
   "chatToolActivityReadOne": "读取 1 个文件",
   "chatToolActivityReadOther": "读取 {count} 个文件",
   "chatToolActivityEditOne": "编辑 1 个文件",

package/dist/assets/doc-browser-Dto54tCf.js

@@ -1 +0,0 @@
-import{t as e}from"./doc-browser-Cm_tMZ_C.js";export{e as DocBrowser};