@nextclaw/ui 0.12.20-beta.3 → 0.12.20-beta.5

package/dist/index.html

@@ -78,21 +78,21 @@
     })();
   </script>
   <title>NextClaw</title>
-  <script type="module" crossorigin src="/assets/index-CM-57d8J.js"></script>
+  <script type="module" crossorigin src="/assets/index-B7RsQ-ne.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/i18n-C5Mibli1.js">
   <link rel="modulepreload" crossorigin href="/assets/chunk-JZWAC4HX-u4uYphxM.js">
-  <link rel="modulepreload" crossorigin href="/assets/api-BcqDx0tm.js">
-  <link rel="modulepreload" crossorigin href="/assets/es2015-JCM5-KtW.js">
+  <link rel="modulepreload" crossorigin href="/assets/api-Dai6UR3J.js">
+  <link rel="modulepreload" crossorigin href="/assets/es2015-BVRlEE06.js">
   <link rel="modulepreload" crossorigin href="/assets/createLucideIcon-BZkY6emz.js">
-  <link rel="modulepreload" crossorigin href="/assets/select-DIZrwsKU.js">
-  <link rel="modulepreload" crossorigin href="/assets/dist-Bl94Ahwx.js">
+  <link rel="modulepreload" crossorigin href="/assets/select-uO-zhYsH.js">
+  <link rel="modulepreload" crossorigin href="/assets/dist-CxcPOISF.js">
   <link rel="modulepreload" crossorigin href="/assets/x-DpTzXQcX.js">
-  <link rel="modulepreload" crossorigin href="/assets/dialog-csshWetU.js">
-  <link rel="modulepreload" crossorigin href="/assets/popover-YAsxDBhY.js">
-  <link rel="modulepreload" crossorigin href="/assets/tooltip-Dq5Xehpk.js">
+  <link rel="modulepreload" crossorigin href="/assets/dialog-DgybjpeU.js">
+  <link rel="modulepreload" crossorigin href="/assets/popover-C8tMB7tR.js">
+  <link rel="modulepreload" crossorigin href="/assets/tooltip-CvAtG-kT.js">
   <link rel="modulepreload" crossorigin href="/assets/refresh-cw-BxojR62w.js">
-  <link rel="modulepreload" crossorigin href="/assets/use-config-BQJjq1mP.js">
-  <link rel="modulepreload" crossorigin href="/assets/theme-provider-W704JWF8.js">
+  <link rel="modulepreload" crossorigin href="/assets/use-config-D2QgG7qc.js">
+  <link rel="modulepreload" crossorigin href="/assets/theme-provider-BU77FNSB.js">
   <link rel="modulepreload" crossorigin href="/assets/search-vChioOoe.js">
   <link rel="modulepreload" crossorigin href="/assets/book-open-DgLqYpNY.js">
   <link rel="modulepreload" crossorigin href="/assets/external-link-Sw3ah_JD.js">
@@ -107,16 +107,16 @@
   <link rel="modulepreload" crossorigin href="/assets/doc-browser-context-DfLHAWbG.js">
   <link rel="modulepreload" crossorigin href="/assets/doc-browser-CzCV73NJ.js">
   <link rel="modulepreload" crossorigin href="/assets/doc-browser-BUlCkZo2.js">
-  <link rel="modulepreload" crossorigin href="/assets/use-viewport-layout-BX3XqzJ4.js">
+  <link rel="modulepreload" crossorigin href="/assets/use-viewport-layout-C6EN0_eq.js">
   <link rel="modulepreload" crossorigin href="/assets/logo-badge-BQgKnVtz.js">
   <link rel="modulepreload" crossorigin href="/assets/skeleton-CFQRIUzt.js">
-  <link rel="modulepreload" crossorigin href="/assets/chat-ahMH_i_K.js">
+  <link rel="modulepreload" crossorigin href="/assets/chat-ZQIVJChB.js">
   <link rel="modulepreload" crossorigin href="/assets/key-round-CnI1mc9F.js">
   <link rel="modulepreload" crossorigin href="/assets/message-square-D6Z4NwpG.js">
-  <link rel="modulepreload" crossorigin href="/assets/app-navigation.config-BOVDFMnp.js">
-  <link rel="modulepreload" crossorigin href="/assets/notice-card-CCgk6FvF.js">
+  <link rel="modulepreload" crossorigin href="/assets/app-navigation.config-BjIj_FLm.js">
+  <link rel="modulepreload" crossorigin href="/assets/notice-card-uzwjFyML.js">
   <link rel="modulepreload" crossorigin href="/assets/status-dot-Dv_hiUVa.js">
-  <link rel="modulepreload" crossorigin href="/assets/app-manager-provider-DVYBjif-.js">
+  <link rel="modulepreload" crossorigin href="/assets/app-manager-provider-BZr5VxCe.js">
   <link rel="stylesheet" crossorigin href="/assets/index-D8MKmXtO.css">
 </head>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ui",
-  "version": "0.12.20-beta.3",
+  "version": "0.12.20-beta.5",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -28,14 +28,14 @@
     "tailwind-merge": "^2.5.4",
     "zod": "^3.23.8",
     "zustand": "^5.0.2",
-    "@nextclaw/client-sdk": "0.1.1-beta.3",
-    "@nextclaw/kernel": "0.1.2-beta.3",
-    "@nextclaw/ncp-http-agent-client": "0.3.18-beta.2",
-    "@nextclaw/ncp": "0.5.6-beta.1",
-    "@nextclaw/server": "0.12.13-beta.3",
-    "@nextclaw/agent-chat-ui": "0.3.13-beta.1",
-    "@nextclaw/agent-chat": "0.1.11-beta.1",
-    "@nextclaw/ncp-react": "0.4.26-beta.2"
+    "@nextclaw/agent-chat": "0.1.11-beta.3",
+    "@nextclaw/agent-chat-ui": "0.3.13-beta.3",
+    "@nextclaw/client-sdk": "0.1.1-beta.5",
+    "@nextclaw/kernel": "0.1.2-beta.5",
+    "@nextclaw/ncp": "0.5.6-beta.3",
+    "@nextclaw/ncp-http-agent-client": "0.3.18-beta.4",
+    "@nextclaw/server": "0.12.13-beta.5",
+    "@nextclaw/ncp-react": "0.4.26-beta.4"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.0",

package/src/app/hooks/use-app-event-consumers.ts

@@ -0,0 +1,89 @@
+import { useEffect, useRef } from 'react';
+import { eventKeys } from '@nextclaw/kernel';
+import { applyNcpSessionRealtimeEvent, nextclawClient } from '@/shared/lib/api';
+import { runtimeUpdateManager, systemStatusManager } from '@/features/system-status';
+import type { QueryClient } from '@tanstack/react-query';
+
+function shouldInvalidateConfigQuery(configPath: string) {
+  const normalized = configPath.trim().toLowerCase();
+  if (!normalized) {
+    return true;
+  }
+  if (normalized.startsWith('plugins') || normalized.startsWith('skills')) {
+    return false;
+  }
+  return true;
+}
+
+function invalidateMarketplaceQueries(queryClient: QueryClient | undefined, configPath: string): void {
+  if (configPath.startsWith('plugins')) {
+    queryClient?.invalidateQueries({ queryKey: ['ncp-session-types'] });
+    queryClient?.invalidateQueries({ queryKey: ['marketplace-installed', 'plugin'] });
+    queryClient?.invalidateQueries({ queryKey: ['marketplace-items'] });
+  }
+  if (configPath.startsWith('mcp')) {
+    queryClient?.invalidateQueries({ queryKey: ['marketplace-mcp-installed'] });
+    queryClient?.invalidateQueries({ queryKey: ['marketplace-mcp-items'] });
+    queryClient?.invalidateQueries({ queryKey: ['marketplace-mcp-doctor'] });
+  }
+}
+
+function handleConfigUpdatedEvent(queryClient: QueryClient | undefined, path: string): void {
+  if (queryClient && shouldInvalidateConfigQuery(path)) {
+    queryClient.invalidateQueries({ queryKey: ['config'] });
+  }
+  invalidateMarketplaceQueries(queryClient, path);
+}
+
+export function useAppEventConsumers(queryClient?: QueryClient) {
+  const shouldResyncSessionsRef = useRef(false);
+
+  useEffect(() => {
+    const unsubscribeConnectionOpen = nextclawClient.eventBus.on(eventKeys.connectionOpen, () => {
+      systemStatusManager.handleConnectionRestored();
+      void runtimeUpdateManager.refreshAfterRealtimeReconnect();
+      if (shouldResyncSessionsRef.current) {
+        shouldResyncSessionsRef.current = false;
+        queryClient?.invalidateQueries({ queryKey: ['ncp-sessions'] });
+      }
+    });
+    const unsubscribeConnectionClose = nextclawClient.eventBus.on(eventKeys.connectionClose, () => {
+      systemStatusManager.handleConnectionInterrupted(null);
+      shouldResyncSessionsRef.current = true;
+    });
+    const unsubscribeConnectionError = nextclawClient.eventBus.on(eventKeys.connectionError, (payload) => {
+      systemStatusManager.handleConnectionInterrupted(payload?.message ?? null);
+      shouldResyncSessionsRef.current = true;
+    });
+    const unsubscribeConfigUpdated = nextclawClient.eventBus.on(eventKeys.configUpdated, ({ path }) => {
+      handleConfigUpdatedEvent(queryClient, path);
+    });
+    const unsubscribeRuntimeUpdate = nextclawClient.eventBus.on(eventKeys.runtimeUpdateSnapshot, (snapshot) => {
+      runtimeUpdateManager.reportSnapshot(snapshot);
+    });
+    const unsubscribeSessionRunStatus = nextclawClient.eventBus.on(eventKeys.sessionRunStatus, (payload) => {
+      applyNcpSessionRealtimeEvent(queryClient, { type: 'session.run-status', payload });
+    });
+    const unsubscribeSessionSummaryUpsert = nextclawClient.eventBus.on(eventKeys.sessionSummaryUpsert, (payload) => {
+      applyNcpSessionRealtimeEvent(queryClient, { type: 'session.summary.upsert', payload });
+    });
+    const unsubscribeSessionSummaryDelete = nextclawClient.eventBus.on(eventKeys.sessionSummaryDelete, (payload) => {
+      applyNcpSessionRealtimeEvent(queryClient, { type: 'session.summary.delete', payload });
+    });
+    const unsubscribeError = nextclawClient.eventBus.on(eventKeys.error, (payload) => {
+      console.error('Realtime transport error:', payload.message);
+    });
+
+    return () => {
+      unsubscribeConnectionOpen();
+      unsubscribeConnectionClose();
+      unsubscribeConnectionError();
+      unsubscribeConfigUpdated();
+      unsubscribeRuntimeUpdate();
+      unsubscribeSessionRunStatus();
+      unsubscribeSessionSummaryUpsert();
+      unsubscribeSessionSummaryDelete();
+      unsubscribeError();
+    };
+  }, [queryClient]);
+}

package/src/app/index.tsx

@@ -15,7 +15,7 @@ import {
   isTransientAuthStatusBootstrapError,
   useAuthStatus,
 } from "@/hooks/use-auth";
-import { useRealtimeQueryBridge } from "@/hooks/use-realtime-query-bridge";
+import { useAppEventConsumers } from "@/app/hooks/use-app-event-consumers";
 import {
   PwaInstallBanner,
   PwaUpdateBanner,
@@ -212,7 +212,7 @@ function ProtectedRoutes() {
 }
 
 function ProtectedApp() {
-  useRealtimeQueryBridge(appQueryClient);
+  useAppEventConsumers(appQueryClient);
   useSystemStatusSources();
   useEffect(() => {
     void runtimeUpdateManager.start();

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

@@ -1,5 +1,6 @@
 import { useMemo, useState, useSyncExternalStore } from 'react';
 import type { Dispatch, FormEvent, SetStateAction } from 'react';
+import { eventKeys } from '@nextclaw/kernel';
 import { BookOpen, ChevronDown } from 'lucide-react';
 import { toast } from 'sonner';
 import { LogoBadge } from '@/shared/components/common/logo-badge';
@@ -77,20 +78,17 @@ function ensureChannelApplySubscription() {
   if (channelApplyUnsubscribe) {
     return;
   }
-  channelApplyUnsubscribe = nextclawClient.realtime.subscribe((event) => {
-    if (event.type !== 'channel.config.apply-status') {
-      return;
-    }
+  channelApplyUnsubscribe = nextclawClient.eventBus.on(eventKeys.channelConfigApplyStatus, (payload) => {
     channelApplySnapshots.set(
-      event.payload.channel,
-      event.payload.status === 'started'
+      payload.channel,
+      payload.status === 'started'
         ? { status: 'applying' }
-        : event.payload.status === 'succeeded'
+        : payload.status === 'succeeded'
           ? { status: 'applied' }
-          : { status: 'failed', message: event.payload.message }
+          : { status: 'failed', message: payload.message }
     );
     channelApplyListeners.forEach((listener) => listener());
-  }).close;
+  });
 }
 
 function subscribeChannelApplyStore(listener: () => void) {

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

@@ -79,7 +79,8 @@ describe('DesktopUpdateConfig', () => {
   it('renders current channel information and beta guidance', () => {
     render(<DesktopUpdateConfig />);
 
-    expect(mocks.start).toHaveBeenCalledTimes(1);
+    expect(mocks.start).not.toHaveBeenCalled();
+    expect(mocks.stop).not.toHaveBeenCalled();
     expect(screen.getByText('版本更新')).toBeTruthy();
     expect(screen.getByText('宿主版本')).toBeTruthy();
     expect(screen.getByText('当前更新通道')).toBeTruthy();
@@ -98,4 +99,27 @@ describe('DesktopUpdateConfig', () => {
 
     expect(mocks.updateChannel).toHaveBeenCalledWith('stable');
   });
+
+  it('renders runtime download progress from the shared store', () => {
+    useRuntimeUpdateStore.setState((state) => ({
+      ...state,
+      busyAction: 'downloading',
+      snapshot: state.snapshot
+        ? {
+            ...state.snapshot,
+            status: 'downloading',
+            progress: {
+              downloadedBytes: 50,
+              totalBytes: 100,
+              percent: 50
+            }
+          }
+        : null
+    }));
+
+    render(<DesktopUpdateConfig />);
+
+    expect(screen.getByText('正在下载 50%')).toBeTruthy();
+    expect(screen.getByText('50 B / 100 B')).toBeTruthy();
+  });
 });

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

@@ -1,5 +1,4 @@
 import type { UpdateSnapshot } from '@nextclaw/kernel';
-import { useEffect } from 'react';
 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';
@@ -134,12 +133,6 @@ function RuntimeUpdateUnavailableState() {
 
 export function DesktopUpdateConfig() {
   const { supported, initialized, busyAction, snapshot } = useRuntimeUpdateStore();
-  useEffect(() => {
-    void runtimeUpdateManager.start();
-    return () => {
-      runtimeUpdateManager.stop();
-    };
-  }, []);
   if (!initialized) {
     return <div className="p-8 text-gray-400">{t('loading')}</div>;
   }

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

@@ -25,8 +25,6 @@ interface HostRuntimeUpdateSourceContract extends RuntimeUpdateSourceBase {
   kind: 'runtime-host';
 }
 
-const RUNTIME_HOST_POLL_INTERVAL_MS = 1000;
-
 type RuntimeUpdateSource = DesktopBridgeRuntimeUpdateSourceContract | HostRuntimeUpdateSourceContract;
 
 class DesktopBridgeRuntimeUpdateSource implements DesktopBridgeRuntimeUpdateSourceContract {
@@ -93,7 +91,6 @@ class HostRuntimeUpdateSource implements HostRuntimeUpdateSourceContract {
 
 export class RuntimeUpdateManager {
   private unsubscribe: (() => void) | null = null;
-  private pollingTimer: number | null = null;
   private subscriptionCount = 0;
   private source: RuntimeUpdateSource | null = null;
 
@@ -120,10 +117,6 @@ export class RuntimeUpdateManager {
       });
     }
 
-    if (source.kind === 'runtime-host') {
-      this.ensurePolling();
-    }
-
     useRuntimeUpdateStore.setState({
       supported: true,
       initialized: false
@@ -160,13 +153,27 @@ export class RuntimeUpdateManager {
     }
     this.unsubscribe?.();
     this.unsubscribe = null;
-    if (this.pollingTimer !== null && typeof window !== 'undefined') {
-      window.clearInterval(this.pollingTimer);
-    }
-    this.pollingTimer = null;
     this.source = null;
   };
 
+  reportSnapshot = (snapshot: UpdateSnapshot): void => {
+    if (this.source?.kind === 'desktop-bridge') {
+      return;
+    }
+    useRuntimeUpdateStore.setState({
+      supported: true,
+      initialized: true,
+      snapshot
+    });
+  };
+
+  refreshAfterRealtimeReconnect = async (): Promise<void> => {
+    if (this.source?.kind !== 'runtime-host') {
+      return;
+    }
+    await this.refreshSnapshot();
+  };
+
   checkForUpdates = async () => {
     let snapshot: UpdateSnapshot;
     try {
@@ -249,15 +256,6 @@ export class RuntimeUpdateManager {
     toast.success(t('runtimeUpdatesChannelChanged').replace('{channel}', this.getChannelLabel(channel)));
   };
 
-  private ensurePolling = () => {
-    if (this.pollingTimer !== null || typeof window === 'undefined') {
-      return;
-    }
-    this.pollingTimer = window.setInterval(() => {
-      void this.refreshSnapshot();
-    }, RUNTIME_HOST_POLL_INTERVAL_MS);
-  };
-
   private refreshSnapshot = async () => {
     if (!this.source || this.source.kind !== 'runtime-host') {
       return;

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

@@ -1,4 +1,4 @@
-import type { UiServerEvent } from '@nextclaw/server';
+import type { AppEvent as KernelAppEvent } from '@nextclaw/kernel';
 
 export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
@@ -30,7 +30,7 @@ export type StreamSession<TFinal = unknown> = {
 };
 
 export type AppEvent =
-  | UiServerEvent
+  | KernelAppEvent
   | { type: 'connection.open'; payload?: Record<string, never> }
   | { type: 'connection.close'; payload?: Record<string, never> }
   | { type: 'connection.error'; payload?: { message?: string } };

package/tsconfig.json

@@ -28,12 +28,13 @@
       "@/components/providers/I18nProvider": ["./src/app/components/i18n-provider.tsx"],
       "@/components/providers/ThemeProvider": ["./src/app/components/theme-provider.tsx"],
       "@/hooks/use-auth": ["./src/features/account/hooks/use-auth.ts"],
-      "@/hooks/use-realtime-query-bridge": ["./src/app/hooks/use-realtime-query-bridge.ts"],
+      "@/hooks/use-app-event-consumers": ["./src/app/hooks/use-app-event-consumers.ts"],
       "@/pwa/components/pwa-install-entry": ["./src/features/pwa/components/pwa-install-entry.tsx"],
       "@/pwa/register-pwa": ["./src/features/pwa/managers/pwa-bootstrap.manager.ts"],
       "@/*": ["./src/*"],
       "@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"],
       "@nextclaw/ncp": ["../ncp-packages/nextclaw-ncp/src/index.ts"],
       "@nextclaw/ncp-http-agent-client": ["../ncp-packages/nextclaw-ncp-http-agent-client/src/index.ts"],

package/vite.config.ts

@@ -26,12 +26,14 @@ export default defineConfig({
       '@/components/providers/I18nProvider': path.resolve(__dirname, './src/app/components/i18n-provider.tsx'),
       '@/components/providers/ThemeProvider': path.resolve(__dirname, './src/app/components/theme-provider.tsx'),
       '@/hooks/use-auth': path.resolve(__dirname, './src/features/account/hooks/use-auth.ts'),
-      '@/hooks/use-realtime-query-bridge': path.resolve(__dirname, './src/app/hooks/use-realtime-query-bridge.ts'),
+      '@/hooks/use-app-event-consumers': path.resolve(__dirname, './src/app/hooks/use-app-event-consumers.ts'),
       '@/pwa/components/pwa-install-entry': path.resolve(__dirname, './src/features/pwa/components/pwa-install-entry.tsx'),
       '@/pwa/register-pwa': path.resolve(__dirname, './src/features/pwa/managers/pwa-bootstrap.manager.ts'),
       '@': path.resolve(__dirname, './src'),
       '@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/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')
     }
   },
   server: {

package/vitest.config.ts

@@ -21,11 +21,13 @@ export default defineConfig({
       '@/components/providers/I18nProvider': path.resolve(__dirname, './src/app/components/i18n-provider.tsx'),
       '@/components/providers/ThemeProvider': path.resolve(__dirname, './src/app/components/theme-provider.tsx'),
       '@/hooks/use-auth': path.resolve(__dirname, './src/features/account/hooks/use-auth.ts'),
-      '@/hooks/use-realtime-query-bridge': path.resolve(__dirname, './src/app/hooks/use-realtime-query-bridge.ts'),
+      '@/hooks/use-app-event-consumers': path.resolve(__dirname, './src/app/hooks/use-app-event-consumers.ts'),
       '@/pwa/components/pwa-install-entry': path.resolve(__dirname, './src/features/pwa/components/pwa-install-entry.tsx'),
       '@/pwa/register-pwa': path.resolve(__dirname, './src/features/pwa/managers/pwa-bootstrap.manager.ts'),
       '@': path.resolve(__dirname, './src'),
-      '@nextclaw/agent-chat': path.resolve(__dirname, '../nextclaw-agent-chat/src/index.ts')
+      '@nextclaw/agent-chat': path.resolve(__dirname, '../nextclaw-agent-chat/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')
     }
   },
   test: {