@nextclaw/ui 0.11.0 → 0.11.1

package/src/components/chat/ChatPage.tsx

@@ -1,16 +1,6 @@
-import { useLocation } from 'react-router-dom';
-import { resolveChatChain } from '@/components/chat/chat-chain';
 import type { ChatPageProps } from '@/components/chat/chat-page-shell';
-import { LegacyChatPage } from '@/components/chat/legacy/LegacyChatPage';
 import { NcpChatPage } from '@/components/chat/ncp/NcpChatPage';
 
 export function ChatPage({ view }: ChatPageProps) {
-  const location = useLocation();
-  const chatChain = resolveChatChain(location.search);
-
-  if (chatChain === 'ncp') {
-    return <NcpChatPage view={view} />;
-  }
-
-  return <LegacyChatPage view={view} />;
+  return <NcpChatPage view={view} />;
 }

package/src/components/chat/ChatSidebar.test.tsx

@@ -11,7 +11,6 @@ const mocks = vi.hoisted(() => ({
   setQuery: vi.fn(),
   selectSession: vi.fn(),
   docOpen: vi.fn(),
-  updateSession: vi.fn(),
   updateNcpSession: vi.fn()
 }));
 
@@ -33,15 +32,9 @@ vi.mock('@/components/doc-browser', () => ({
 
 vi.mock('@/components/chat/chat-session-label.service', () => ({
   useChatSessionLabelService: () => async (params: {
-    chatChain: 'legacy' | 'ncp';
     sessionKey: string;
     label: string | null;
-  }) => {
-    if (params.chatChain === 'ncp') {
-      return mocks.updateNcpSession(params.sessionKey, { label: params.label });
-    }
-    return mocks.updateSession(params.sessionKey, { label: params.label });
-  }
+  }) => mocks.updateNcpSession(params.sessionKey, { label: params.label })
 }));
 
 vi.mock('@/components/common/BrandHeader', () => ({
@@ -77,9 +70,7 @@ describe('ChatSidebar', () => {
     mocks.setQuery.mockReset();
     mocks.selectSession.mockReset();
     mocks.docOpen.mockReset();
-    mocks.updateSession.mockReset();
     mocks.updateNcpSession.mockReset();
-    mocks.updateSession.mockResolvedValue({});
     mocks.updateNcpSession.mockResolvedValue({});
 
     useChatInputStore.setState({
@@ -285,48 +276,9 @@ describe('ChatSidebar', () => {
         label: 'Renamed Label'
       });
     });
-    expect(mocks.updateSession).not.toHaveBeenCalled();
     expect(screen.getByText('Renamed Label')).not.toBeNull();
   });
 
-  it('routes inline session label edits to the legacy session api when chatChain=legacy', async () => {
-    useChatSessionListStore.setState({
-      snapshot: {
-        ...useChatSessionListStore.getState().snapshot,
-        sessions: [
-          {
-            key: 'session:legacy-1',
-            createdAt: '2026-03-19T09:00:00.000Z',
-            updatedAt: '2026-03-19T09:05:00.000Z',
-            label: 'Legacy Label',
-            sessionType: 'native',
-            sessionTypeMutable: false,
-            messageCount: 1
-          }
-        ]
-      }
-    });
-
-    render(
-      <MemoryRouter initialEntries={['/chat?chatChain=legacy']}>
-        <ChatSidebar />
-      </MemoryRouter>
-    );
-
-    fireEvent.click(screen.getByLabelText('Edit'));
-    fireEvent.change(screen.getByPlaceholderText('Session label (optional)'), {
-      target: { value: 'Legacy Renamed' }
-    });
-    fireEvent.click(screen.getByLabelText('Save'));
-
-    await waitFor(() => {
-      expect(mocks.updateSession).toHaveBeenCalledWith('session:legacy-1', {
-        label: 'Legacy Renamed'
-      });
-    });
-    expect(mocks.updateNcpSession).not.toHaveBeenCalled();
-  });
-
   it('cancels inline session label editing without saving', () => {
     useChatSessionListStore.setState({
       snapshot: {
@@ -357,7 +309,6 @@ describe('ChatSidebar', () => {
     });
     fireEvent.click(screen.getByLabelText('Cancel'));
 
-    expect(mocks.updateSession).not.toHaveBeenCalled();
     expect(mocks.updateNcpSession).not.toHaveBeenCalled();
     expect(screen.queryByDisplayValue('Should Not Persist')).toBeNull();
     expect(screen.getByText('Cancelable Label')).not.toBeNull();

package/src/components/chat/ChatSidebar.tsx

@@ -12,7 +12,6 @@ import { usePresenter } from '@/components/chat/presenter/chat-presenter-context
 import { useChatInputStore } from '@/components/chat/stores/chat-input.store';
 import { useChatRunStatusStore } from '@/components/chat/stores/chat-run-status.store';
 import { useChatSessionListStore } from '@/components/chat/stores/chat-session-list.store';
-import { resolveChatChain } from '@/components/chat/chat-chain';
 import { cn } from '@/lib/utils';
 import { LANGUAGE_OPTIONS, t, type I18nLanguage } from '@/lib/i18n';
 import { THEME_OPTIONS, type UiTheme } from '@/lib/theme';
@@ -21,7 +20,6 @@ import { useTheme } from '@/components/providers/ThemeProvider';
 import { useDocBrowser } from '@/components/doc-browser';
 import { SidebarActionItem, SidebarNavLinkItem, SidebarSelectItem } from '@/components/layout/sidebar-items';
 import { useUiStore } from '@/stores/ui.store';
-import { useLocation } from 'react-router-dom';
 import {
   AlarmClock,
   BookOpen,
@@ -117,7 +115,6 @@ const navItems = [
 export function ChatSidebar() {
   const presenter = usePresenter();
   const docBrowser = useDocBrowser();
-  const location = useLocation();
   const [isCreateMenuOpen, setIsCreateMenuOpen] = useState(false);
   const [editingSessionKey, setEditingSessionKey] = useState<string | null>(null);
   const [draftLabel, setDraftLabel] = useState('');
@@ -129,7 +126,6 @@ export function ChatSidebar() {
   const { language, setLanguage } = useI18n();
   const { theme, setTheme } = useTheme();
   const updateSessionLabel = useChatSessionLabelService();
-  const chatChain = resolveChatChain(location.search);
   const currentThemeLabel = t(THEME_OPTIONS.find((o) => o.value === theme)?.labelKey ?? 'themeWarm');
   const currentLanguageLabel = LANGUAGE_OPTIONS.find((o) => o.value === language)?.label ?? language;
 
@@ -182,7 +178,6 @@ export function ChatSidebar() {
     setSavingSessionKey(session.key);
     try {
       await updateSessionLabel({
-        chatChain,
         sessionKey: session.key,
         label: normalizedLabel || null
       });

package/src/components/chat/README.md

@@ -0,0 +1,2 @@
+## 目录预算豁免
+- 原因：聊天入口层需要并列承载页面壳、会话侧栏、会话偏好同步、展示组件与配套测试，且已通过 `ncp/` 等子目录承接更细分的实现，短期内仍需保留这组扁平入口文件。

package/src/components/chat/chat-attachment-upload-limit.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it, vi } from 'vitest';
+import {
+  DEFAULT_NCP_ATTACHMENT_MAX_BYTES,
+  uploadFilesAsNcpDraftAttachments
+} from '../../../../ncp-packages/nextclaw-ncp-react/src/attachments/ncp-attachments.ts';
+
+describe('ncp attachment upload limit', () => {
+  it('accepts files larger than the previous 10MB cap', async () => {
+    expect(DEFAULT_NCP_ATTACHMENT_MAX_BYTES).toBe(200 * 1024 * 1024);
+
+    const file = new File([new Uint8Array(12 * 1024 * 1024)], 'large-image.png', {
+      type: 'image/png'
+    });
+    const uploadBatch = vi.fn(async (files: File[]) =>
+      files.map((entry) => ({
+        id: entry.name,
+        name: entry.name,
+        mimeType: entry.type,
+        sizeBytes: entry.size,
+        assetUri: `asset://store/${entry.name}`,
+      }))
+    );
+
+    const result = await uploadFilesAsNcpDraftAttachments([file], {
+      uploadBatch
+    });
+
+    expect(result.rejected).toEqual([]);
+    expect(uploadBatch).toHaveBeenCalledOnce();
+    expect(uploadBatch).toHaveBeenCalledWith([file]);
+    expect(result.attachments).toEqual([
+      {
+        id: 'large-image.png',
+        name: 'large-image.png',
+        mimeType: 'image/png',
+        sizeBytes: 12 * 1024 * 1024,
+        assetUri: 'asset://store/large-image.png',
+      }
+    ]);
+  });
+});

package/src/components/chat/chat-session-display.ts

@@ -0,0 +1,9 @@
+import type { SessionEntryView } from '@/api/types';
+
+export function sessionDisplayName(session: SessionEntryView): string {
+  if (session.label && session.label.trim()) {
+    return session.label.trim();
+  }
+  const chunks = session.key.split(':');
+  return chunks[chunks.length - 1] || session.key;
+}

package/src/components/chat/chat-session-label.service.ts

@@ -1,12 +1,9 @@
 import { useQueryClient } from '@tanstack/react-query';
 import { toast } from 'sonner';
-import { updateSession } from '@/api/config';
 import { updateNcpSession } from '@/api/ncp-session';
-import type { ChatChain } from '@/components/chat/chat-chain';
 import { t } from '@/lib/i18n';
 
 type UpdateChatSessionLabelParams = {
-  chatChain: ChatChain;
   sessionKey: string;
   label: string | null;
 };
@@ -16,15 +13,9 @@ export function useChatSessionLabelService() {
 
   return async (params: UpdateChatSessionLabelParams): Promise<void> => {
     try {
-      if (params.chatChain === 'ncp') {
-        await updateNcpSession(params.sessionKey, { label: params.label });
-        queryClient.invalidateQueries({ queryKey: ['ncp-sessions'] });
-        queryClient.invalidateQueries({ queryKey: ['ncp-session-messages', params.sessionKey] });
-      } else {
-        await updateSession(params.sessionKey, { label: params.label });
-        queryClient.invalidateQueries({ queryKey: ['sessions'] });
-        queryClient.invalidateQueries({ queryKey: ['session-history', params.sessionKey] });
-      }
+      await updateNcpSession(params.sessionKey, { label: params.label });
+      queryClient.invalidateQueries({ queryKey: ['ncp-sessions'] });
+      queryClient.invalidateQueries({ queryKey: ['ncp-session-messages', params.sessionKey] });
       toast.success(t('configSavedApplied'));
     } catch (error) {
       toast.error(t('configSaveFailed') + ': ' + (error instanceof Error ? error.message : String(error)));

package/src/components/chat/chat-session-preference-sync.test.ts

@@ -1,19 +1,16 @@
 import { afterEach, describe, expect, it, vi } from 'vitest';
-import { updateSession } from '@/api/config';
+import { updateNcpSession } from '@/api/ncp-session';
 import { ChatSessionPreferenceSync } from '@/components/chat/chat-session-preference-sync';
 import { useChatInputStore } from '@/components/chat/stores/chat-input.store';
 import { useChatSessionListStore } from '@/components/chat/stores/chat-session-list.store';
 
-vi.mock('@/api/config', () => ({
-  updateSession: vi.fn(async () => ({
-    key: 'session-1',
-    totalMessages: 0,
-    totalEvents: 0,
-    sessionType: 'native',
-    sessionTypeMutable: false,
-    metadata: {},
-    messages: [],
-    events: []
+vi.mock('@/api/ncp-session', () => ({
+  updateNcpSession: vi.fn(async () => ({
+    sessionId: 'session-1',
+    messageCount: 0,
+    updatedAt: new Date().toISOString(),
+    status: 'idle',
+    metadata: {}
   }))
 }));
 
@@ -50,10 +47,10 @@ describe('ChatSessionPreferenceSync', () => {
       }
     }));
 
-    const sync = new ChatSessionPreferenceSync(updateSession);
+    const sync = new ChatSessionPreferenceSync(updateNcpSession);
     sync.syncSelectedSessionPreferences();
     await vi.waitFor(() => {
-      expect(updateSession).toHaveBeenCalledWith('session-1', {
+      expect(updateNcpSession).toHaveBeenCalledWith('session-1', {
         preferredModel: 'openai/gpt-5',
         preferredThinking: 'high'
       });

package/src/components/chat/chat-stream/types.ts

@@ -1,18 +1,9 @@
 import type { ChatComposerNode } from '@nextclaw/agent-chat-ui';
 import type { NcpMessagePart } from '@nextclaw/ncp';
 import type { NcpDraftAttachment } from '@nextclaw/ncp-react';
-import type { Dispatch, MutableRefObject, SetStateAction } from 'react';
-import type {
-  ChatRunView,
-  ChatTurnStreamDeltaEvent,
-  ChatTurnStreamReadyEvent,
-  ChatTurnStreamSessionEvent,
-  SessionMessageView,
-  ThinkingLevel
-} from '@/api/types';
+import type { ThinkingLevel } from '@/api/types';
 
 export type SendMessageParams = {
-  runId?: string;
   message: string;
   sessionKey: string;
   agentId: string;
@@ -28,58 +19,14 @@ export type SendMessageParams = {
   composerNodes?: ChatComposerNode[];
 };
 
-export type ActiveRunState = {
-  localRunId: number;
+export type ResumeRunParams = {
   sessionKey: string;
-  agentId?: string;
-  backendRunId?: string;
-  backendStopSupported: boolean;
-  backendStopReason?: string;
-};
-
-export type StreamReadyPayload = {
-  sessionKey: string;
-  runId?: string;
-  stopSupported?: boolean;
-  stopReason?: string;
-  requestedAt?: string;
-};
-
-export type StreamReadyEvent = ChatTurnStreamReadyEvent;
-export type StreamDeltaEvent = ChatTurnStreamDeltaEvent;
-export type StreamSessionEvent = ChatTurnStreamSessionEvent;
-
-export type NextbotAgentRunMetadata =
-  | {
-      driver: 'nextbot-stream';
-      mode: 'send';
-      payload: SendMessageParams;
-      requestedSkills: string[];
-    }
-  | {
-      driver: 'nextbot-stream';
-      mode: 'resume';
-      runId: string;
-      fromEventIndex?: number;
-      sessionKey?: string;
-      agentId?: string;
-      stopSupported?: boolean;
-      stopReason?: string;
-    };
-
-export type UseChatStreamControllerParams = {
-  selectedSessionKeyRef: MutableRefObject<string | null>;
-  setSelectedSessionKey: Dispatch<SetStateAction<string | null>>;
-  setDraft: Dispatch<SetStateAction<string>>;
-  setComposerNodes: Dispatch<SetStateAction<ChatComposerNode[]>>;
-  refetchSessions: () => Promise<unknown>;
-  refetchHistory: () => Promise<unknown>;
 };
 
 export type ChatStreamActions = {
   sendMessage: (payload: SendMessageParams) => Promise<void>;
   stopCurrentRun: () => Promise<void>;
-  resumeRun: (run: ChatRunView) => Promise<void>;
+  resumeRun: (run: ResumeRunParams) => Promise<void>;
   resetStreamState: () => void;
-  applyHistoryMessages: (messages: SessionMessageView[], options?: { isLoading?: boolean }) => void;
+  applyHistoryMessages: (messages: unknown[], options?: { isLoading?: boolean }) => void;
 };

package/src/components/chat/ncp/NcpChatPage.tsx

@@ -8,15 +8,15 @@ import {
 import { useLocation, useNavigate, useParams } from 'react-router-dom';
 import { API_BASE } from '@/api/api-base';
 import { fetchNcpSessionMessages } from '@/api/ncp-session';
-import type { ChatRunView } from '@/api/types';
-import { sessionDisplayName } from '@/components/chat/chat-page-data';
 import { ChatPageLayout, type ChatPageProps, useChatSessionSync } from '@/components/chat/chat-page-shell';
+import { sessionDisplayName } from '@/components/chat/chat-session-display';
 import { createNcpAppClientFetch } from '@/components/chat/ncp/ncp-app-client-fetch';
 import { parseSessionKeyFromRoute, resolveAgentIdFromSessionKey } from '@/components/chat/chat-session-route';
 import { useNcpChatPageData } from '@/components/chat/ncp/ncp-chat-page-data';
 import { NcpChatPresenter } from '@/components/chat/ncp/ncp-chat.presenter';
 import { adaptNcpMessagesToUiMessages, buildNcpSessionRunStatusByKey, createNcpSessionId } from '@/components/chat/ncp/ncp-session-adapter';
 import { ChatPresenterProvider } from '@/components/chat/presenter/chat-presenter-context';
+import type { ResumeRunParams } from '@/components/chat/chat-stream/types';
 import { useChatInputStore } from '@/components/chat/stores/chat-input.store';
 import { useChatSessionListStore } from '@/components/chat/stores/chat-session-list.store';
 import { resolveSessionTypeLabel } from '@/components/chat/useChatSessionTypeState';
@@ -224,7 +224,7 @@ export function NcpChatPage({ view }: ChatPageProps) {
         await agent.abort();
         await sessionsQuery.refetch();
       },
-      resumeRun: async (run: ChatRunView) => {
+      resumeRun: async (run: ResumeRunParams) => {
         if (run.sessionKey !== activeSessionId) {
           return;
         }

package/src/components/chat/useHydratedNcpAgent.test.tsx

@@ -0,0 +1,77 @@
+import { renderHook, waitFor } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { useHydratedNcpAgent } from '../../../../ncp-packages/nextclaw-ncp-react/src/hooks/use-hydrated-ncp-agent.ts';
+
+const mocks = vi.hoisted(() => ({
+  manager: {
+    reset: vi.fn(),
+    hydrate: vi.fn()
+  },
+  runtime: {
+    snapshot: {
+      messages: [],
+      streamingMessage: null,
+      activeRun: null,
+      error: null
+    },
+    visibleMessages: [],
+    activeRunId: null,
+    isRunning: false,
+    isSending: false,
+    send: vi.fn(),
+    abort: vi.fn(),
+    streamRun: vi.fn()
+  }
+}));
+
+vi.mock('../../../../ncp-packages/nextclaw-ncp-react/src/hooks/use-ncp-agent-runtime.js', () => ({
+  useScopedAgentManager: () => mocks.manager,
+  useNcpAgentRuntime: () => mocks.runtime
+}));
+
+describe('useHydratedNcpAgent', () => {
+  beforeEach(() => {
+    mocks.manager.reset.mockReset();
+    mocks.manager.hydrate.mockReset();
+    mocks.runtime.send.mockReset();
+    mocks.runtime.abort.mockReset();
+    mocks.runtime.streamRun.mockReset();
+  });
+
+  it('treats a newly selected session as hydrating immediately on rerender', async () => {
+    const client = {
+      stop: vi.fn().mockResolvedValue(undefined),
+      stream: vi.fn().mockResolvedValue(undefined)
+    } as never;
+    const loadSeed = vi
+      .fn()
+      .mockResolvedValueOnce({ messages: [], status: 'idle' })
+      .mockResolvedValueOnce({ messages: [], status: 'idle' });
+
+    const { result, rerender } = renderHook(
+      ({ sessionId }: { sessionId: string }) =>
+        useHydratedNcpAgent({
+          sessionId,
+          client,
+          loadSeed
+        }),
+      {
+        initialProps: {
+          sessionId: 'session-a'
+        }
+      }
+    );
+
+    await waitFor(() => {
+      expect(result.current.isHydrating).toBe(false);
+    });
+
+    rerender({ sessionId: 'session-b' });
+
+    expect(result.current.isHydrating).toBe(true);
+
+    await waitFor(() => {
+      expect(result.current.isHydrating).toBe(false);
+    });
+  });
+});

package/src/components/config/README.md

@@ -0,0 +1,2 @@
+## 目录预算豁免
+- 原因：配置中心目录按配置面板维度组织，每个面板都需要独立入口、局部测试与装配文件；当前结构受 UI 信息架构约束，需要保留超过 `20` 个直接代码文件的扁平集合。