@nextclaw/ui 0.13.9 → 0.13.10-beta.1

package/src/features/pwa/managers/pwa-runtime.manager.ts

@@ -1,11 +1,6 @@
-import { usePwaStore } from '@/features/pwa/stores/pwa.store';
-
-const PWA_DEV_RESET_SESSION_KEY = 'nextclaw-pwa-dev-sw-reset';
-
 export class PwaRuntimeManager {
   private started = false;
   private registration: ServiceWorkerRegistration | null = null;
-  private reloadWhenControllerChanges = false;
 
   start = async () => {
     if (this.started || typeof window === 'undefined') {
@@ -25,55 +20,9 @@ export class PwaRuntimeManager {
     try {
       const registration = await navigator.serviceWorker.register('/sw.js');
       this.registration = registration;
-      this.bindRegistration(registration);
-      navigator.serviceWorker.addEventListener('controllerchange', this.handleControllerChange);
-      await this.syncUpdateAvailability();
     } catch {
-      usePwaStore.setState({
-        registrationFailed: true
-      });
-    }
-  };
-
-  syncUpdateAvailability = async () => {
-    if (
-      typeof window === 'undefined' ||
-      !('serviceWorker' in navigator) ||
-      typeof navigator.serviceWorker.getRegistration !== 'function'
-    ) {
-      usePwaStore.setState({
-        updateAvailable: false
-      });
       return;
     }
-
-    const registration = this.registration ?? (await navigator.serviceWorker.getRegistration('/sw.js')) ?? null;
-    usePwaStore.setState({
-      updateAvailable: this.shouldSurfaceUpdate(registration)
-    });
-  };
-
-  applyUpdate = async () => {
-    const registration = this.registration ?? (await navigator.serviceWorker.getRegistration('/sw.js')) ?? null;
-    if (!registration) {
-      window.location.reload();
-      return;
-    }
-
-    if (!registration.waiting) {
-      await registration.update();
-    }
-
-    const waitingWorker = registration.waiting;
-    if (!waitingWorker) {
-      window.location.reload();
-      return;
-    }
-
-    this.reloadWhenControllerChanges = true;
-    waitingWorker.postMessage({
-      type: 'SKIP_WAIT'
-    });
   };
 
   stop = () => {
@@ -81,34 +30,8 @@ export class PwaRuntimeManager {
       return;
     }
 
-    navigator.serviceWorker.removeEventListener('controllerchange', this.handleControllerChange);
     this.started = false;
     this.registration = null;
-    this.reloadWhenControllerChanges = false;
-  };
-
-  private bindRegistration = (registration: ServiceWorkerRegistration) => {
-    registration.addEventListener('updatefound', () => {
-      const installingWorker = registration.installing;
-      if (!installingWorker) {
-        return;
-      }
-
-      installingWorker.addEventListener('statechange', () => {
-        if (installingWorker.state === 'installed') {
-          void this.syncUpdateAvailability();
-        }
-      });
-    });
-  };
-
-  private handleControllerChange = () => {
-    if (!this.reloadWhenControllerChanges) {
-      return;
-    }
-
-    this.reloadWhenControllerChanges = false;
-    window.location.reload();
   };
 
   private isEligibleInstallContext = (): boolean => {
@@ -123,13 +46,6 @@ export class PwaRuntimeManager {
     return import.meta.env.DEV && !import.meta.env.VITEST;
   };
 
-  private shouldSurfaceUpdate = (registration: ServiceWorkerRegistration | null): boolean => {
-    if (!registration?.waiting || !navigator.serviceWorker.controller) {
-      return false;
-    }
-    return usePwaStore.getState().installability === 'installed';
-  };
-
   private cleanupDevelopmentRegistrations = async () => {
     if (typeof navigator.serviceWorker.getRegistrations !== 'function') {
       return;
@@ -142,21 +58,10 @@ export class PwaRuntimeManager {
         .some((scriptUrl) => scriptUrl.endsWith('/sw.js'))
     );
 
-    if (nextclawRegistrations.length === 0) {
-      this.clearDevResetMarker();
-      return;
-    }
-
     await Promise.all(nextclawRegistrations.map(async (registration) => await registration.unregister()));
-    await this.clearNextClawCaches();
-
-    if (navigator.serviceWorker.controller && !this.hasDevResetMarker()) {
-      this.setDevResetMarker();
-      window.location.reload();
-      return;
+    if (nextclawRegistrations.length > 0) {
+      await this.clearNextClawCaches();
     }
-
-    this.clearDevResetMarker();
   };
 
   private clearNextClawCaches = async () => {
@@ -168,29 +73,6 @@ export class PwaRuntimeManager {
     await Promise.all(keys.filter((key) => key.startsWith('nextclaw-ui-')).map(async (key) => await caches.delete(key)));
   };
 
-  private hasDevResetMarker = (): boolean => {
-    try {
-      return window.sessionStorage.getItem(PWA_DEV_RESET_SESSION_KEY) === '1';
-    } catch {
-      return false;
-    }
-  };
-
-  private setDevResetMarker = () => {
-    try {
-      window.sessionStorage.setItem(PWA_DEV_RESET_SESSION_KEY, '1');
-    } catch {
-      // ignore sessionStorage availability failures in dev cleanup
-    }
-  };
-
-  private clearDevResetMarker = () => {
-    try {
-      window.sessionStorage.removeItem(PWA_DEV_RESET_SESSION_KEY);
-    } catch {
-      // ignore sessionStorage availability failures in dev cleanup
-    }
-  };
 }
 
 export const pwaRuntimeManager = new PwaRuntimeManager();

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

@@ -6,11 +6,13 @@ describe('NextClaw service worker cache policy', () => {
   });
 
   it('does not fall back to stale navigation responses', () => {
-    const navigationHandler = serviceWorkerSource.slice(
-      serviceWorkerSource.indexOf('async function handleNavigation'),
-      serviceWorkerSource.indexOf('async function handleStaticAsset')
-    );
+    expect(serviceWorkerSource).not.toContain("request.mode === 'navigate'");
+    expect(serviceWorkerSource).not.toContain('handleNavigation');
+    expect(serviceWorkerSource).toContain('SHELL_ASSETS.includes(url.pathname)');
+  });
 
-    expect(navigationHandler).not.toContain('caches.match(request)');
+  it('does not force service worker activation or page control', () => {
+    expect(serviceWorkerSource).not.toContain('skipWaiting');
+    expect(serviceWorkerSource).not.toContain('clients.claim');
   });
 });

package/src/features/pwa/stores/pwa.store.ts

@@ -8,9 +8,7 @@ export function createInitialPwaState(): PwaInstallStateSnapshot {
     installability: 'unsupported',
     installMethod: 'none',
     blockedReason: 'missing-browser-support',
-    dismissedInstallPrompt: isPwaInstallBannerDismissed(),
-    updateAvailable: false,
-    registrationFailed: false
+    dismissedInstallPrompt: isPwaInstallBannerDismissed()
   };
 }
 

package/src/features/pwa/types/pwa.types.ts

@@ -17,6 +17,4 @@ export interface PwaInstallStateSnapshot {
   installMethod: PwaInstallMethod;
   blockedReason: PwaInstallBlockedReason;
   dismissedInstallPrompt: boolean;
-  updateAvailable: boolean;
-  registrationFailed: boolean;
 }

package/src/features/right-panel-resources/utils/right-panel-resource-uri.utils.test.ts

@@ -4,11 +4,15 @@ import { createPanelAppRightPanelResourceTarget } from '@/features/right-panel-r
 
 function createPanelAppEntry(overrides: Partial<PanelAppEntryView> = {}): PanelAppEntryView {
   return {
+    appId: 'demo',
+    clientDeclared: false,
+    clientGranted: false,
     contentPath: '/api/panel-apps/demo/content',
     createdAt: '2026-06-02T00:00:00.000Z',
     favorite: false,
     fileName: 'demo.html',
     id: 'demo',
+    kind: 'single-file',
     openCount: 0,
     sizeBytes: 1024,
     title: 'Demo App',

package/src/features/service-apps/components/service-apps-panel.tsx

@@ -77,9 +77,9 @@ export function ServiceAppsPanel({
     );
   }
 
-  const apps = serviceApps.data?.entries ?? [];
-  const actions = serviceActions.data?.actions ?? [];
-  const grants = serviceActionGrants.data?.grants ?? [];
+  const apps: ServiceAppRecordView[] = serviceApps.data?.entries ?? [];
+  const actions: ServiceActionView[] = serviceActions.data?.actions ?? [];
+  const grants: ServiceActionGrantView[] = serviceActionGrants.data?.grants ?? [];
   const discover = (appId: string) => {
     void discoverServiceAppActions.mutateAsync(appId).then((result) => {
       setDiscoveredActionsByApp((current) => ({

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

@@ -11,7 +11,7 @@ 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 './ncp-session-query-cache.utils';
 export * from './raw-client.utils';
 export * from './utils/remote.utils';
 export * from './remote.types';

package/src/shared/lib/api/{ncp-session-query-cache.test.ts → ncp-session-query-cache.utils.test.ts}

@@ -131,6 +131,29 @@ describe('ncp-session-query-cache', () => {
     });
   });
 
+  it('keeps the realtime running overlay when a newer persisted idle summary arrives', () => {
+    const current = updateNcpSessionRunStatusList(createSessionsList(), {
+      sessionKey: 'session-1',
+      status: 'running'
+    });
+
+    const updated = upsertNcpSessionSummaryList(current, {
+      sessionId: 'session-1',
+      messageCount: 2,
+      createdAt: '2026-03-29T08:00:00.000Z',
+      updatedAt: '2026-03-29T10:01:00.000Z',
+      lastMessageAt: '2026-03-29T10:01:00.000Z',
+      status: 'idle',
+      metadata: { last_activity_preview: { state: 'running' } }
+    });
+
+    expect(updated?.sessions[0]).toMatchObject({
+      sessionId: 'session-1',
+      messageCount: 2,
+      status: 'running'
+    });
+  });
+
   it('applies realtime upsert/delete events to every ncp-sessions query cache entry', () => {
     const queryClient = new QueryClient();
     queryClient.setQueryData(['ncp-sessions', 200], createSessionsList());

package/src/shared/lib/api/{ncp-session-query-cache.ts → ncp-session-query-cache.utils.ts}

@@ -14,18 +14,11 @@ function shouldReplaceSessionSummary(
   next: NcpSessionSummaryView
 ): boolean {
   const timeOrder = next.updatedAt.localeCompare(current.updatedAt);
-  if (timeOrder > 0) {
-    return true;
-  }
-  if (timeOrder < 0) {
-    return false;
-  }
-
-  if (current.status === next.status) {
-    return true;
+  if (timeOrder !== 0) {
+    return timeOrder > 0;
   }
 
-  return next.status === 'idle';
+  return current.status === next.status || next.status === 'idle';
 }
 
 export function upsertNcpSessionSummaryList(
@@ -40,7 +33,12 @@ export function upsertNcpSessionSummaryList(
   const nextSessions =
     existingIndex >= 0
       ? current.sessions.map((session, index) =>
-          index === existingIndex && shouldReplaceSessionSummary(session, summary) ? summary : session
+          index === existingIndex && shouldReplaceSessionSummary(session, summary)
+            ? {
+                ...summary,
+                status: session.status === 'running' && summary.status === 'idle' ? 'running' : summary.status
+              }
+            : session
         )
       : [...current.sessions, summary];
   const sortedSessions = sortSessionSummaries(nextSessions);

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

@@ -363,7 +363,9 @@ export type ServerPathReadView = { requestedPath: string; resolvedPath: string;
 
 export type PanelAppEntryView = {
   id: string;
+  appId: string;
   fileName: string;
+  kind: "single-file" | "folder";
   title: string;
   description?: string;
   icon?: string;
@@ -372,6 +374,8 @@ export type PanelAppEntryView = {
   updatedAt: string;
   sizeBytes: number;
   favorite: boolean;
+  clientDeclared: boolean;
+  clientGranted: boolean;
   lastOpenedAt?: string;
   openCount: number;
 };

package/src/shared/lib/i18n/runtime/doc-browser-labels.utils.ts

@@ -39,6 +39,11 @@ export const DOC_BROWSER_LABELS = {
     zh: '将删除这个面板应用文件，删除后不可恢复。',
     en: 'This will delete the panel app file and cannot be undone.',
   },
+  panelAppsClientGrantTitle: { zh: 'NextClaw Client SDK', en: 'NextClaw Client SDK' },
+  panelAppsClientGrantDescription: {
+    zh: '允许这个面板应用使用完整 NextClaw Client SDK。',
+    en: 'Allow this panel app to use the full NextClaw Client SDK.',
+  },
   panelAppsLastOpened: { zh: '上次打开', en: 'Last opened' },
   panelAppsUpdated: { zh: '更新于', en: 'Updated' },
   serviceAppsTitle: { zh: '服务应用', en: 'Service Apps' },