@nextclaw/ui 0.12.20-beta.6 → 0.12.21

package/src/features/agents/components/agents-page.tsx

@@ -1,5 +1,4 @@
 import { useMemo, useState } from "react";
-import { useNavigate } from "react-router-dom";
 import {
   useCreateAgent,
   useDeleteAgent,
@@ -19,8 +18,7 @@ import {
   normalizeSessionType,
   resolveAgentRuntimeSessionType,
   resolveSessionTypeLabel,
-  useChatInputStore,
-  useChatSessionListStore,
+  usePresenter,
   useNcpChatSessionTypes,
 } from "@/features/chat";
 import { AgentAvatar } from "@/shared/components/common/agent-avatar";
@@ -247,7 +245,7 @@ function AgentListCard(props: {
 }
 
 export function AgentsPage() {
-  const navigate = useNavigate();
+  const presenter = usePresenter();
   const agentsQuery = useAgents();
   const configQuery = useConfig();
   const configMetaQuery = useConfigMeta();
@@ -259,10 +257,6 @@ export function AgentsPage() {
   const [editingAgent, setEditingAgent] = useState<AgentProfileView | null>(
     null,
   );
-  const setSessionListSnapshot = useChatSessionListStore(
-    (state) => state.setSnapshot,
-  );
-
   const agents = useMemo(
     () => agentsQuery.data?.agents ?? [],
     [agentsQuery.data?.agents],
@@ -340,16 +334,10 @@ export function AgentsPage() {
   };
 
   const startChatWithAgent = (agent: AgentProfileView) => {
-    setSessionListSnapshot({
-      selectedAgentId: agent.id,
-      selectedSessionKey: null,
-    });
-    useChatInputStore.getState().setSnapshot({
-      pendingSessionType: resolveAgentRuntimeSessionType(agent, defaultRuntime),
-      pendingProjectRoot: null,
-      pendingProjectRootSessionKey: null,
-    });
-    navigate("/chat");
+    presenter.chatSessionListManager.startAgentDraftChat(
+      agent.id,
+      resolveAgentRuntimeSessionType(agent, defaultRuntime),
+    );
   };
 
   return (

package/src/features/channels/components/config/channel-form.tsx

@@ -1,6 +1,6 @@
 import { useMemo, useState, useSyncExternalStore } from 'react';
 import type { Dispatch, FormEvent, SetStateAction } from 'react';
-import { eventKeys } from '@nextclaw/kernel';
+import { eventKeys } from '@nextclaw/shared';
 import { BookOpen, ChevronDown } from 'lucide-react';
 import { toast } from 'sonner';
 import { LogoBadge } from '@/shared/components/common/logo-badge';
@@ -285,7 +285,11 @@ function ChannelFormEditor(props: ChannelFormEditorProps) {
       }
       const result = await executeAction.mutateAsync({ actionId: action.id, data: { scope, draftConfig: buildScopeDraft(scope, nextData) } });
       applyActionPatchToForm(result.patch);
-      result.ok ? toast.success(result.message || t('success')) : toast.error(result.message || t('error'));
+      if (result.ok) {
+        toast.success(result.message || t('success'));
+      } else {
+        toast.error(result.message || t('error'));
+      }
     } catch (error) {
       toast.error(`${t('error')}: ${error instanceof Error ? error.message : String(error)}`);
     } finally {

package/src/features/chat/index.ts

@@ -1,4 +1,4 @@
-export * from "./components/chat-sidebar-list-mode-switch"; export * from "./components/chat-sidebar-project-groups"; export * from "./components/chat-sidebar-session-item"; export * from "./components/chat-welcome";
+export * from "./components/chat-sidebar-list-mode-switch"; export * from "./components/chat-sidebar-project-groups"; export * from "./components/chat-sidebar-session-item"; export * from "./components/chat-welcome"; export * from "./components/providers/chat-presenter.provider";
 export * from "./components/conversation/chat-conversation-panel"; export * from "./components/layout/chat-sidebar";
 export * from "./components/chat-session-type-option-item"; export * from "./components/chat-session-workspace-file-preview"; export * from "./components/chat-session-workspace-panel"; export * from "./components/chat-session-workspace-panel-nav";
 export * from "./hooks/use-chat-session-type-state"; export * from "./hooks/use-ncp-chat-session-types"; export * from "./hooks/use-ncp-session-list-view";

package/src/features/chat/managers/chat-session-list.manager.test.ts

@@ -71,6 +71,30 @@ describe('ChatSessionListManager', () => {
     expect(useChatInputStore.getState().snapshot.pendingProjectRootSessionKey).toBeNull();
   });
 
+  it('starts an agent draft chat through one owner state transition', () => {
+    const uiManager = {
+      goToChatRoot: vi.fn(),
+      goToSession: vi.fn(),
+      isAtChatRoot: vi.fn(() => true),
+    } as unknown as ConstructorParameters<typeof ChatSessionListManager>[0];
+    const streamActionsManager = {
+      resetStreamState: vi.fn()
+    } as unknown as ConstructorParameters<typeof ChatSessionListManager>[1];
+
+    const manager = new ChatSessionListManager(uiManager, streamActionsManager);
+    const sessionKey = manager.startAgentDraftChat('researcher', 'codex');
+
+    expect(streamActionsManager.resetStreamState).toHaveBeenCalledTimes(1);
+    expect(uiManager.goToChatRoot).toHaveBeenCalledTimes(1);
+    expect(useChatSessionListStore.getState().snapshot.selectedAgentId).toBe('researcher');
+    expect(useChatSessionListStore.getState().snapshot.selectedSessionKey).toBeNull();
+    expect(useChatSessionListStore.getState().snapshot.draftSessionKey).toBe(sessionKey);
+    expect(useChatThreadStore.getState().snapshot.sessionKey).toBe(sessionKey);
+    expect(useChatInputStore.getState().snapshot.pendingSessionType).toBe('codex');
+    expect(useChatInputStore.getState().snapshot.pendingProjectRoot).toBeNull();
+    expect(useChatInputStore.getState().snapshot.pendingProjectRootSessionKey).toBeNull();
+  });
+
   it('hydrates the draft project root when creating a session inside a project group', () => {
     const uiManager = {
       goToChatRoot: vi.fn(),

package/src/features/chat/managers/chat-session-list.manager.ts

@@ -122,6 +122,13 @@ export class ChatSessionListManager {
     return nextSessionKey;
   };
 
+  startAgentDraftChat = (agentId: string, sessionType: string): string => {
+    const normalizedAgentId = agentId.trim() || 'main';
+    const nextSessionKey = this.createSession(sessionType);
+    this.setSelectedAgentId(normalizedAgentId);
+    return nextSessionKey;
+  };
+
   ensureDraftSession = (sessionType?: string): string => {
     const { snapshot } = useChatSessionListStore.getState();
     if (snapshot.selectedSessionKey) {

package/src/features/pwa/managers/pwa-service-worker-cache.manager.test.ts

@@ -0,0 +1,16 @@
+import serviceWorkerSource from '../../../../public/sw.js?raw';
+
+describe('NextClaw service worker cache policy', () => {
+  it('does not precache the app shell entrypoint', () => {
+    expect(serviceWorkerSource).not.toContain("'/'");
+  });
+
+  it('does not fall back to stale navigation responses', () => {
+    const navigationHandler = serviceWorkerSource.slice(
+      serviceWorkerSource.indexOf('async function handleNavigation'),
+      serviceWorkerSource.indexOf('async function handleStaticAsset')
+    );
+
+    expect(navigationHandler).not.toContain('caches.match(request)');
+  });
+});

package/src/features/system-status/components/desktop-update-config.tsx

@@ -1,4 +1,4 @@
-import type { UpdateSnapshot } from '@nextclaw/kernel';
+import type { UpdateSnapshot } from '@nextclaw/shared';
 import { runtimeUpdateManager, useRuntimeUpdateStore } from '@/features/system-status';
 import { Button } from '@/shared/components/ui/button';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/shared/components/ui/card';

package/src/features/system-status/managers/runtime-update.manager.ts

@@ -1,12 +1,10 @@
-import type { UpdatePreferences, UpdateSnapshot } from '@nextclaw/kernel';
+import type { UpdatePreferences, UpdateSnapshot } from '@nextclaw/shared';
 import { applyRuntimeUpdate, checkRuntimeUpdate, downloadRuntimeUpdate, fetchRuntimeUpdate, updateRuntimeUpdateChannel, updateRuntimeUpdatePreferences } from '@/shared/lib/api';
 import type { NextClawDesktopBridge } from '@/platforms/desktop';
 import { t } from '@/shared/lib/i18n';
 import { toast } from 'sonner';
 import { useRuntimeUpdateStore, type RuntimeUpdateBusyAction } from '@/features/system-status/stores/runtime-update.store';
 
-type RuntimeUpdateSourceKind = 'desktop-bridge' | 'runtime-host';
-
 interface RuntimeUpdateSourceBase {
   getState: () => Promise<UpdateSnapshot>;
   checkForUpdates: () => Promise<UpdateSnapshot>;

package/src/features/system-status/stores/runtime-update.store.ts

@@ -1,4 +1,4 @@
-import type { UpdateSnapshot } from '@nextclaw/kernel';
+import type { UpdateSnapshot } from '@nextclaw/shared';
 import { create } from 'zustand';
 
 export type RuntimeUpdateBusyAction =

package/src/platforms/desktop/types/desktop-update.types.ts

@@ -5,7 +5,7 @@ import type {
   UpdateProgress,
   UpdateSnapshot,
   UpdateStatus,
-} from '@nextclaw/kernel';
+} from '@nextclaw/shared';
 
 export type DesktopUpdateStatus = Extract<
   UpdateStatus,

package/src/shared/components/common/brand-header.tsx

@@ -1,4 +1,4 @@
-import type { UpdateSnapshot } from '@nextclaw/kernel';
+import type { UpdateSnapshot } from '@nextclaw/shared';
 import { runtimeUpdateManager, useRuntimeUpdateStore } from '@/features/system-status';
 import { useAppMeta } from '@/shared/hooks/use-config';
 import { type ReactNode, useState } from 'react';

package/src/shared/lib/api/README.md

@@ -1,3 +1,7 @@
+## 目录预算豁免
+
+- 原因：`shared/lib/api` 是历史形成的前端 API facade 根边界，当前仍需要保留若干公共导出、类型、query cache、runtime update helper 与测试入口。新的 endpoint 薄封装已收敛到 `utils/` 子目录，后续继续治理时应优先减少根目录直接文件，而不是继续新增 root 文件。
+
 ## 子树边界豁免
 
 - 原因：`shared/lib/api` 是历史形成的前端 API facade，当前同时承载 client、endpoint wrapper、query cache、transport helper 与 response view types。本次新增 `ncp-session.types.ts` 是为了把会话类型从超大的 `types.ts` 中拆出，实际降低核心类型文件体积；完整子树化需要同步改造大量公共导出和调用方，适合单独结构治理批次推进。

package/src/shared/lib/api/index.ts

@@ -1,22 +1,22 @@
-export * from './services/agents.service';
+export * from './utils/agents.utils';
 export * from './api-base';
 export * from './auth.types';
-export * from './services/channel-auth.service';
+export * from './utils/channel-auth.utils';
 export * from './channel-auth.types';
 export * from './chat-session-type.types';
-export * from './services/client.service';
-export * from './services/config.service';
-export * from './services/marketplace.service';
-export * from './services/mcp-marketplace.service';
-export * from './services/ncp-attachments.service';
-export * from './services/ncp-session.service';
+export * from './managers/client.manager';
+export * from './utils/config.utils';
+export * from './utils/marketplace.utils';
+export * from './utils/mcp-marketplace.utils';
+export * from './utils/ncp-attachments.utils';
+export * from './utils/ncp-session.utils';
 export * from './ncp-session.types';
 export * from './ncp-session-query-cache';
 export * from './raw-client.utils';
-export * from './services/remote.service';
+export * from './utils/remote.utils';
 export * from './remote.types';
-export * from './services/runtime-control.service';
+export * from './utils/runtime-control.utils';
 export * from './runtime-control.types';
-export * from './services/runtime-update.service';
-export * from './services/server-path.service';
+export * from './runtime-update.utils';
+export * from './utils/server-path.utils';
 export * from './types';

package/src/shared/lib/api/{services/client.service.ts → managers/client.manager.ts}

@@ -1,5 +1,5 @@
 import {
-  createNextClawClient,
+  NextClawClient,
   type NextClawRealtimeEvent,
   type NextClawTransport,
   type NextClawTransportRequestInput,
@@ -36,7 +36,7 @@ const nextclawUiTransport: NextClawTransport = {
   subscribe: (handler: (event: NextClawRealtimeEvent) => void) => appClient.subscribe(handler)
 };
 
-export const nextclawClient = createNextClawClient({
+export const nextclawClient = new NextClawClient({
   baseUrl: API_BASE,
   transport: nextclawUiTransport
 });

package/src/shared/lib/api/ncp-session.test.ts

@@ -1,7 +1,7 @@
-import { fetchNcpSessionSkills } from './services/ncp-session.service';
-import { nextclawClient } from './services/client.service';
+import { fetchNcpSessionSkills } from './utils/ncp-session.utils';
+import { nextclawClient } from './managers/client.manager';
 
-vi.mock('./services/client.service', () => ({
+vi.mock('./managers/client.manager', () => ({
   nextclawClient: {
     sessions: {
       listSkills: vi.fn()

package/src/shared/lib/api/{services/runtime-update.service.ts → runtime-update.utils.ts}

@@ -1,5 +1,5 @@
-import type { UpdatePreferences, UpdateSnapshot } from '@nextclaw/kernel';
-import { nextclawClient } from './client.service';
+import type { UpdatePreferences, UpdateSnapshot } from '@nextclaw/shared';
+import { nextclawClient } from './managers/client.manager';
 
 export async function fetchRuntimeUpdate(): Promise<UpdateSnapshot> {
   return await nextclawClient.runtimeUpdate.fetch();

package/src/shared/lib/api/{services/agents.service.ts → utils/agents.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from "./client.service";
+import { nextclawClient } from "../managers/client.manager";
 import type { AgentCreateRequest, AgentDeleteResult, AgentProfileView, AgentUpdateRequest } from "@/shared/lib/api/types";
 
 export async function fetchAgents(): Promise<{ agents: AgentProfileView[] }> {

package/src/shared/lib/api/{services/channel-auth.service.ts → utils/channel-auth.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type {
   ChannelAuthPollRequest,
   ChannelAuthPollResult,

package/src/shared/lib/api/{services/config.service.ts → utils/config.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type {
   AuthEnabledUpdateRequest,
   AuthLoginRequest,

package/src/shared/lib/api/{services/marketplace.service.ts → utils/marketplace.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type {
   MarketplaceInstallRequest,
   MarketplaceInstallResult,

package/src/shared/lib/api/{services/mcp-marketplace.service.ts → utils/mcp-marketplace.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type {
   MarketplaceInstalledView,
   MarketplaceItemView,

package/src/shared/lib/api/{services/ncp-attachments.service.ts → utils/ncp-attachments.utils.ts}

@@ -1,5 +1,5 @@
 import type { NcpDraftAttachment } from "@nextclaw/ncp-react";
-import { nextclawClient } from "./client.service";
+import { nextclawClient } from "../managers/client.manager";
 
 export async function uploadNcpAssets(files: File[]): Promise<NcpDraftAttachment[]> {
   const payload = await nextclawClient.sessions.uploadAssets(files);

package/src/shared/lib/api/{services/ncp-session.service.ts → utils/ncp-session.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type {
   NcpSessionMessagesView,
   NcpSessionSkillsView,

package/src/shared/lib/api/{services/remote.service.ts → utils/remote.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type {
   RemoteAccessView,
   RemoteAccountProfileUpdateRequest,

package/src/shared/lib/api/{services/runtime-control.service.ts → utils/runtime-control.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type { RuntimeControlActionResult, RuntimeControlView } from '@/shared/lib/api/runtime-control.types';
 
 export async function fetchRuntimeControl(): Promise<RuntimeControlView> {

package/src/shared/lib/api/{services/server-path.service.ts → utils/server-path.utils.ts}

@@ -1,4 +1,4 @@
-import { nextclawClient } from './client.service';
+import { nextclawClient } from '../managers/client.manager';
 import type { ServerPathBrowseView, ServerPathReadView } from '@/shared/lib/api/types';
 
 export async function fetchServerPathBrowse(params?: {

package/src/shared/lib/transport/transport.types.ts

@@ -1,4 +1,4 @@
-import type { AppEvent as KernelAppEvent } from '@nextclaw/kernel';
+import type { AppEvent as KernelAppEvent } from '@nextclaw/shared';
 
 export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 

package/tsconfig.json

@@ -2,7 +2,7 @@
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
     "target": "ES2020",
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
     "module": "ESNext",
     "moduleResolution": "bundler",
     "jsx": "react-jsx",
@@ -35,8 +35,7 @@
       "@nextclaw/agent-chat": ["../nextclaw-agent-chat/src/index.ts"],
       "@nextclaw/agent-chat-ui": ["../nextclaw-agent-chat-ui/src/index.ts"],
       "@nextclaw/client-sdk": ["../nextclaw-client-sdk/src/index.ts"],
-      "@nextclaw/kernel": ["../nextclaw-kernel/src/index.ts"],
-      "@kernel/*": ["../nextclaw-kernel/src/*"],
+      "@nextclaw/shared": ["../nextclaw-shared/src/index.ts"],
       "@nextclaw/ncp": ["../ncp-packages/nextclaw-ncp/src/index.ts"],
       "@nextclaw/ncp-http-agent-client": ["../ncp-packages/nextclaw-ncp-http-agent-client/src/index.ts"],
       "@nextclaw/ncp-react": ["../ncp-packages/nextclaw-ncp-react/src/index.ts"]

package/vite.config.ts

@@ -33,8 +33,7 @@ export default defineConfig({
       '@nextclaw/agent-chat': path.resolve(__dirname, '../nextclaw-agent-chat/src/index.ts'),
       '@nextclaw/agent-chat-ui': path.resolve(__dirname, '../nextclaw-agent-chat-ui/src/index.ts'),
       '@nextclaw/client-sdk': path.resolve(__dirname, '../nextclaw-client-sdk/src/index.ts'),
-      '@nextclaw/kernel': path.resolve(__dirname, '../nextclaw-kernel/src/index.ts'),
-      '@kernel': path.resolve(__dirname, '../nextclaw-kernel/src')
+      '@nextclaw/shared': path.resolve(__dirname, '../nextclaw-shared/src/index.ts')
     }
   },
   server: {

package/vitest.config.ts

@@ -28,8 +28,7 @@ export default defineConfig({
       '@nextclaw/agent-chat': path.resolve(__dirname, '../nextclaw-agent-chat/src/index.ts'),
       '@nextclaw/agent-chat-ui': path.resolve(__dirname, '../nextclaw-agent-chat-ui/src/index.ts'),
       '@nextclaw/client-sdk': path.resolve(__dirname, '../nextclaw-client-sdk/src/index.ts'),
-      '@nextclaw/kernel': path.resolve(__dirname, '../nextclaw-kernel/src/index.ts'),
-      '@kernel': path.resolve(__dirname, '../nextclaw-kernel/src')
+      '@nextclaw/shared': path.resolve(__dirname, '../nextclaw-shared/src/index.ts')
     }
   },
   test: {