@nextclaw/ui 0.15.24 → 0.15.26

package/src/features/chat/features/conversation/components/__tests__/session-conversation-area.test.tsx

@@ -4,6 +4,7 @@ import { MemoryRouter } from "react-router-dom";
 import { describe, expect, it, vi, beforeEach } from "vitest";
 
 import { SessionConversationArea } from "@/features/chat/features/conversation/components/session-conversation-area";
+import type { ChatDraftIntent } from "@/features/chat/managers/chat-draft-intent.manager";
 
 const mocks = vi.hoisted(() => {
   const inputRenderSpy = vi.fn();
@@ -106,6 +107,7 @@ const mocks = vi.hoisted(() => {
     inputRenderSpy,
     initialPromptSpy,
     inputSnapshot,
+    runtimeBlocked: false,
     presenter: {
       chatUiManager: {
         goToProviders: vi.fn(),
@@ -117,7 +119,7 @@ const mocks = vi.hoisted(() => {
     },
     appPresenter: {
       chatDraftIntentManager: {
-        consumePending: vi.fn(() => null),
+        consumePending: vi.fn<() => ChatDraftIntent | null>(() => null),
         markConsumed: vi.fn(),
         subscribe: vi.fn(() => vi.fn()),
       },
@@ -139,12 +141,14 @@ vi.mock(
     ChatConversationContent: ({
       bottomSlot,
       isContextCompacting,
+      messageActionsDisabled,
       messages,
       showWelcome,
       welcomeSlot,
     }: {
       bottomSlot?: ReactNode;
       isContextCompacting?: boolean;
+      messageActionsDisabled?: boolean;
       messages: readonly unknown[];
       showWelcome: boolean;
       welcomeSlot?: ReactNode;
@@ -152,6 +156,7 @@ vi.mock(
       <div
         data-testid="conversation-content"
         data-context-compacting={String(Boolean(isContextCompacting))}
+        data-message-actions-disabled={String(Boolean(messageActionsDisabled))}
         data-show-welcome={String(showWelcome)}
       >
         {showWelcome ? (
@@ -198,7 +203,7 @@ vi.mock(
 vi.mock(
   "@/features/chat/features/runtime/utils/ncp-chat-runtime-availability.utils",
   () => ({
-    isNcpChatRuntimeBlocked: () => false,
+    isNcpChatRuntimeBlocked: () => mocks.runtimeBlocked,
     resolveNcpChatSendErrorMessage: ({ message }: { message: string | null }) =>
       message,
   }),
@@ -273,6 +278,7 @@ describe("SessionConversationArea input boundary", () => {
     mocks.agent.snapshot.contextWindow = null;
     mocks.agent.snapshot.error = null;
     mocks.controller.isSending = true;
+    mocks.runtimeBlocked = false;
     mocks.inputSnapshot.sendError = null;
     mocks.inputQuery.defaultModel = undefined;
     mocks.inputQuery.fallbackPreferredModel = undefined;
@@ -294,6 +300,30 @@ describe("SessionConversationArea input boundary", () => {
     expect(params.agent.isSending).toBe(false);
   });
 
+  it("disables message recovery actions until the NCP agent is ready", () => {
+    mocks.agent.isRunning = false;
+    mocks.agent.isSending = false;
+    mocks.controller.isSending = false;
+    mocks.runtimeBlocked = true;
+
+    const rendered = renderArea("session-1");
+
+    expect(
+      screen.getByTestId("conversation-content").dataset.messageActionsDisabled,
+    ).toBe("true");
+
+    mocks.runtimeBlocked = false;
+    rendered.rerender(
+      <MemoryRouter>
+        <SessionConversationArea sessionKey="session-1" />
+      </MemoryRouter>,
+    );
+
+    expect(
+      screen.getByTestId("conversation-content").dataset.messageActionsDisabled,
+    ).toBe("false");
+  });
+
   it("keeps the composer input subtree stable when only streamed messages change", () => {
     const rendered = renderArea("session-1");
 
@@ -380,6 +410,53 @@ describe("SessionConversationArea input boundary", () => {
     );
   });
 
+  it("consumes a system object draft intent as a visible composer token", () => {
+    const reference = {
+      uri: "nextclaw://objects/inbox-delivery/delivery-1",
+      objectType: "inbox-delivery",
+      objectId: "delivery-1",
+      label: "OOM investigation report",
+      description: "Root cause and mitigation",
+      updatedAt: "2026-08-11T00:00:00.000Z",
+      version: "sha256-report",
+      assetUri: "asset://store/report",
+      fileName: "oom-investigation-report.md",
+      mimeType: "text/markdown",
+      sizeBytes: 128,
+    };
+    mocks.appPresenter.chatDraftIntentManager.consumePending.mockReturnValueOnce({
+      id: 1,
+      kind: "system-object-reference",
+      reference,
+    });
+
+    render(
+      <MemoryRouter>
+        <SessionConversationArea
+          consumeDraftIntent
+          sessionKey={null}
+        />
+      </MemoryRouter>,
+    );
+
+    expect(mocks.presenter.chatSessionListManager.createSession).toHaveBeenCalledOnce();
+    expect(mocks.appPresenter.chatDraftIntentManager.markConsumed).toHaveBeenCalledWith(1);
+    const update = mocks.inputActions.update.mock.calls.at(-1)?.[0] as (
+      current: { nodes: []; text: string },
+    ) => { nodes: Array<Record<string, unknown>>; text: string };
+    const next = update({ nodes: [], text: "" });
+    expect(next.nodes).toEqual([
+      expect.objectContaining({
+        type: "token",
+        tokenKind: "system_object",
+        tokenKey: reference.uri,
+        label: reference.label,
+        data: { reference },
+      }),
+    ]);
+    expect(next.text).toBe("");
+  });
+
   it("syncs draft preferences with the selected runtime context", () => {
     mocks.inputQuery.defaultModel = "openai/gpt-5";
     mocks.inputQuery.fallbackPreferredModel = "minimax/MiniMax-M3";

package/src/features/chat/features/conversation/components/__tests__/session-conversation-input.streaming.test.tsx

@@ -349,7 +349,7 @@ describe('SessionConversationInput streaming stability', () => {
 
   it('inserts a project file reference at the saved composer caret', async () => {
     const controlRef: MutableRefObject<StreamingInputControl | null> = { current: null };
-    render(
+    renderInput(
       <StreamingSessionConversationInputHarness
         controlRef={controlRef}
         initialText="Hello"
@@ -431,7 +431,7 @@ describe('SessionConversationInput streaming stability', () => {
     const controlRef: MutableRefObject<StreamingInputControl | null> = { current: null };
     const providerError = 'Chat Completions API failed (402): raw provider error';
 
-    render(
+    renderInput(
       <StreamingSessionConversationInputHarness
         controlRef={controlRef}
         sendError={providerError}
@@ -546,7 +546,7 @@ describe('SessionConversationInput attachment submit', () => {
   it('preserves a project file reference in the outgoing user message and AI context', async () => {
     const send = vi.fn<AttachmentSubmitAgentSend>(async () => createAttachmentRunHandle());
 
-    render(<AttachmentSubmitHarness initialPrompt="这里面有啥" send={send} />);
+    renderInput(<AttachmentSubmitHarness initialPrompt="这里面有啥" send={send} />);
 
     const textbox = screen.getByRole('textbox');
     fireEvent.focus(textbox);
@@ -605,7 +605,7 @@ describe('SessionConversationInput attachment submit', () => {
 
   it('preserves an exact workspace excerpt in the outgoing message metadata', async () => {
     const send = vi.fn<AttachmentSubmitAgentSend>(async () => createAttachmentRunHandle());
-    render(<AttachmentSubmitHarness initialPrompt="解释一下" send={send} />);
+    renderInput(<AttachmentSubmitHarness initialPrompt="解释一下" send={send} />);
 
     const textbox = screen.getByRole('textbox');
     await waitFor(() => expect(textbox.textContent).toBe('解释一下'));

package/src/features/chat/features/conversation/components/session-conversation-area.tsx

@@ -18,6 +18,10 @@ import { ChatConversationWelcome } from "@/features/chat/features/welcome/compon
 import { useChatSessionListStore } from "@/features/chat/stores/chat-session-list.store";
 import { useSystemStatus } from "@/features/system-status";
 import { t } from "@/shared/lib/i18n";
+import type { SystemObjectResolvedReference } from "@nextclaw/shared";
+import { deriveChatComposerDraft } from "@/features/chat/features/input/utils/chat-composer-state.utils";
+import { appendSystemObjectReferenceToken } from "@/features/chat/features/input/utils/chat-system-object-reference.utils";
+import type { ChatDraftIntent } from "@/features/chat/managers/chat-draft-intent.manager";
 
 import {
   useSessionConversationController,
@@ -42,18 +46,23 @@ type SessionConversationAreaProps = {
 function useSessionConversationDraftIntent(params: {
   readonly consumeDraftIntent: boolean;
   readonly applyPromptSuggestion: (prompt: string) => void;
+  readonly applySystemObjectReference: (reference: SystemObjectResolvedReference) => void;
 }) {
-  const { applyPromptSuggestion, consumeDraftIntent } = params;
+  const { applyPromptSuggestion, applySystemObjectReference, consumeDraftIntent } = params;
   const appPresenter = useAppPresenter();
   const presenter = usePresenter();
   useEffect(() => {
     if (!consumeDraftIntent) {
       return undefined;
     }
-    const applyIntent = (intent: { id: number; prompt: string }) => {
+    const applyIntent = (intent: ChatDraftIntent) => {
       presenter.chatSessionListManager.createSession();
       presenter.chatSessionListManager.setSelectedAgentId("main");
-      applyPromptSuggestion(intent.prompt);
+      if (intent.kind === 'prompt') {
+        applyPromptSuggestion(intent.prompt);
+      } else {
+        applySystemObjectReference(intent.reference);
+      }
       appPresenter.chatDraftIntentManager.markConsumed(intent.id);
     };
     const unsubscribe =
@@ -63,7 +72,7 @@ function useSessionConversationDraftIntent(params: {
       applyIntent(pendingIntent);
     }
     return unsubscribe;
-  }, [appPresenter, applyPromptSuggestion, consumeDraftIntent, presenter]);
+  }, [appPresenter, applyPromptSuggestion, applySystemObjectReference, consumeDraftIntent, presenter]);
 }
 
 type ChatDraftRouteState = {
@@ -204,6 +213,17 @@ export function SessionConversationArea(props: SessionConversationAreaProps) {
     initialPrompt,
     sessionKey,
   );
+  const applySystemObjectReference = useCallback((reference: SystemObjectResolvedReference) => {
+    inputActions.update((current) => {
+      const nodes = appendSystemObjectReferenceToken(current.nodes, reference);
+      return {
+        nodes,
+        text: deriveChatComposerDraft(nodes),
+        composerFocusRequestId: Date.now(),
+        sendError: null,
+      };
+    });
+  }, [inputActions]);
   const inputQuery = useSessionConversationInputQuery({
     sessionKey,
     inputSnapshot,
@@ -355,6 +375,7 @@ export function SessionConversationArea(props: SessionConversationAreaProps) {
   useSessionConversationDraftIntent({
     consumeDraftIntent,
     applyPromptSuggestion: inputActions.applyPromptSuggestion,
+    applySystemObjectReference,
   });
   const renderInput = useCallback(
     (surface: "default" | "embedded", placeholder?: string) => (
@@ -395,7 +416,7 @@ export function SessionConversationArea(props: SessionConversationAreaProps) {
         isLoadingPreviousMessages={agent.isLoadingPreviousMessages}
         isSending={controller.isSending}
         canContinue={controller.canContinue}
-        messageActionsDisabled={controller.isSending}
+        messageActionsDisabled={controller.isSending || isRuntimeBlocked}
         isContextCompacting={Boolean(
           sessionKey && compactingSessionIds.has(sessionKey),
         )}

package/src/features/chat/features/conversation/components/session-conversation-input.tsx

@@ -47,6 +47,7 @@ import { useSessionConversationInputAttachments } from '@/features/chat/features
 import { useChatComposerReferenceIntent } from '@/features/chat/features/conversation/hooks/use-chat-composer-reference-intent';
 import { useSessionConversationComposerNodes } from '@/features/chat/features/conversation/hooks/use-session-conversation-composer-nodes';
 import { useSessionConversationSlashCommands } from '@/features/chat/features/conversation/hooks/use-session-conversation-slash-commands';
+import { useSystemObjectReferenceSelect } from '@/features/chat/features/conversation/hooks/use-system-object-reference-select';
 import { ChatConversationTrack } from '@/features/chat/components/conversation/chat-conversation-track';
 import { useChatMessageLayoutStore } from '@/features/chat/stores/chat-message-layout.store';
 import type { useSessionConversationInputQuery } from '@/features/chat/features/conversation/hooks/use-session-conversation-input-query';
@@ -231,6 +232,7 @@ export const SessionConversationInput = memo(function SessionConversationInput(p
   const contextReferenceProjectRoot = inputQuery.selectedSessionKey
     ? inputQuery.selectedSession?.projectRoot ?? inputQuery.defaultProjectRoot ?? ''
     : inputSnapshot.pendingProjectRoot ?? inputQuery.defaultProjectRoot ?? '';
+  const handleSystemObjectSelect = useSystemObjectReferenceSelect(inputBarRef);
   const { inputSurfaceState, setInputSurfaceTrigger } = useChatInputSurfaceState({
     commands: slashCommands,
     isSkillsLoading: inputQuery.isSkillsLoading,
@@ -240,6 +242,7 @@ export const SessionConversationInput = memo(function SessionConversationInput(p
     language,
     onSelectPanelApp: handleSlashPanelAppSelect,
     onSelectSkill: chatRecentSkillsManager.remember,
+    onSelectSystemObject: handleSystemObjectSelect,
     projectRoot: contextReferenceProjectRoot,
     recentSkillValues,
     skillRecords,

package/src/features/chat/features/conversation/hooks/use-system-object-reference-select.ts

@@ -0,0 +1,27 @@
+import { useCallback, type RefObject } from 'react';
+import type { ChatInputBarHandle } from '@nextclaw/agent-chat-ui';
+import { CHAT_SYSTEM_OBJECT_TOKEN_KIND } from '@nextclaw/shared';
+import { toast } from 'sonner';
+
+import { nextclawClient } from '@/shared/lib/api';
+import { t } from '@/shared/lib/i18n';
+
+export function useSystemObjectReferenceSelect(
+  inputBarRef: RefObject<ChatInputBarHandle | null>,
+) {
+  return useCallback((uri: string) => {
+    void nextclawClient.systemObjectReferences.resolve(uri)
+      .then((reference) => {
+        inputBarRef.current?.insertInputSurfaceToken({
+          tokenKind: CHAT_SYSTEM_OBJECT_TOKEN_KIND,
+          tokenKey: reference.uri,
+          label: reference.label,
+          data: { reference },
+        });
+      })
+      .catch((error: unknown) => {
+        const message = error instanceof Error ? error.message : t('error');
+        toast.error(`${t('chatSystemObjectResolveFailed')}: ${message}`);
+      });
+  }, [inputBarRef]);
+}

package/src/features/chat/features/conversation/utils/session-message-composer.utils.ts

@@ -6,6 +6,7 @@ import {
 } from '@nextclaw/agent-chat-ui';
 import type { NcpMessage } from '@nextclaw/ncp';
 import type { NcpDraftAttachment } from '@nextclaw/ncp-react';
+import { CHAT_SYSTEM_OBJECT_TOKEN_KIND } from '@nextclaw/shared';
 
 import { deriveChatComposerDraft } from '@/features/chat/features/input/utils/chat-composer-state.utils';
 import {
@@ -44,6 +45,10 @@ function buildTextNodes(
       tokenKind: nextToken.token.kind,
       tokenKey: 'ref' in nextToken.token ? nextToken.token.ref : nextToken.token.key,
       label: nextToken.token.label,
+      data: nextToken.token.kind === CHAT_SYSTEM_OBJECT_TOKEN_KIND &&
+        'reference' in nextToken.token
+        ? { reference: nextToken.token.reference }
+        : undefined,
     }));
     offset = nextToken.index + nextToken.token.rawText.length;
   }

package/src/features/chat/features/input/hooks/__tests__/use-chat-input-surface-state.test.tsx

@@ -42,6 +42,14 @@ const useServerPathBrowseMock = vi.hoisted(() =>
     isLoading: false,
   })),
 );
+const useSystemObjectReferencesMock = vi.hoisted(() =>
+  vi.fn(() => ({
+    data: { groups: [], total: 0 },
+    error: null,
+    isFetching: false,
+    isLoading: false,
+  })),
+);
 
 vi.mock('@/features/panel-apps', () => ({
   usePanelApps: usePanelAppsMock,
@@ -55,6 +63,9 @@ vi.mock('@/shared/hooks/use-server-path-search', () => ({
 vi.mock('@/shared/hooks/use-server-path-browse', () => ({
   useServerPathBrowse: useServerPathBrowseMock,
 }));
+vi.mock('@/shared/hooks/use-system-object-references', () => ({
+  useSystemObjectReferences: useSystemObjectReferencesMock,
+}));
 
 function createHookParams() {
   return {
@@ -71,6 +82,7 @@ function createHookParams() {
     language: 'zh' as const,
     onSelectPanelApp: vi.fn(),
     onSelectSkill: vi.fn(),
+    onSelectSystemObject: vi.fn(),
     projectRoot: '/tmp/project',
     recentSkillValues: [],
     skillRecords: [],
@@ -82,6 +94,62 @@ beforeEach(() => {
   useProjectsMock.mockClear();
   useServerPathBrowseMock.mockClear();
   useServerPathSearchMock.mockClear();
+  useSystemObjectReferencesMock.mockReset();
+  useSystemObjectReferencesMock.mockReturnValue({
+    data: { groups: [], total: 0 },
+    error: null,
+    isFetching: false,
+    isLoading: false,
+  } as never);
+});
+
+it('loads the catalog at root and scopes queries after entering a system object group', () => {
+  useSystemObjectReferencesMock.mockReturnValue({
+    data: {
+      groups: [{
+        objectType: 'cron-job',
+        label: { default: 'Scheduled Tasks', translations: { zh: '定时任务' } },
+        description: { default: 'Browse tasks', translations: { zh: '浏览定时任务' } },
+        icon: 'calendar-clock',
+        order: 200,
+        items: [],
+        total: 1,
+      }],
+      total: 1,
+    },
+    error: null,
+    isFetching: false,
+    isLoading: false,
+  } as never);
+  const { result } = renderHook(() => useChatInputSurfaceState(createHookParams()));
+
+  act(() => result.current.setInputSurfaceTrigger({
+    end: 1,
+    key: 'context-reference',
+    marker: '@',
+    query: '',
+    start: 0,
+  }));
+  expect(useSystemObjectReferencesMock).toHaveBeenLastCalledWith({
+    enabled: true,
+    query: '',
+    limit: 6,
+    objectType: undefined,
+  });
+  const groupItem = result.current.inputSurfaceState.panel?.items.find(
+    (item) => item.title === '定时任务',
+  );
+  act(() => result.current.inputSurfaceState.panel?.onSelectItem?.(groupItem!));
+
+  expect(useSystemObjectReferencesMock).toHaveBeenLastCalledWith({
+    enabled: true,
+    query: '',
+    limit: 20,
+    objectType: 'cron-job',
+  });
+  expect(useServerPathSearchMock).toHaveBeenLastCalledWith(expect.objectContaining({
+    enabled: false,
+  }));
 });
 
 it('browses nested folders while reserving search for project-wide queries', () => {
@@ -133,6 +201,40 @@ it('browses nested folders while reserving search for project-wide queries', ()
   });
 });
 
+it('uses a folder-only browser and exposes the current folder as the selection', () => {
+  const { result } = renderHook(() => useChatInputSurfaceState(createHookParams()));
+
+  act(() => result.current.setInputSurfaceTrigger({
+    end: 1,
+    key: 'context-reference',
+    marker: '@',
+    query: '',
+    start: 0,
+  }));
+  const foldersItem = result.current.inputSurfaceState.panel?.items.find(
+    (item) => item.title === '文件夹',
+  );
+  act(() => result.current.inputSurfaceState.panel?.onSelectItem?.(foldersItem!));
+
+  expect(useServerPathBrowseMock).toHaveBeenLastCalledWith({
+    path: '.',
+    basePath: '/tmp/project',
+    includeFiles: false,
+    enabled: true,
+  });
+  expect(result.current.inputSurfaceState.panel?.items).toEqual(expect.arrayContaining([
+    expect.objectContaining({
+      title: '引用当前文件夹',
+      tokenKind: 'workspace_directory',
+      tokenKey: '.',
+    }),
+    expect.objectContaining({
+      title: 'src',
+      selectionBehavior: 'navigate',
+    }),
+  ]));
+});
+
 it('keeps equivalent input surface trigger updates from rerendering the composer owner', () => {
   let renderCount = 0;
   const trigger = {