@nextclaw/ui 0.12.19 → 0.12.20-beta.1

package/src/features/chat/utils/ncp-chat-runtime-availability.utils.ts

@@ -0,0 +1,50 @@
+import { isTransientRuntimeConnectionErrorMessage, type SystemStatusView } from '@/features/system-status';
+import { t } from '@/shared/lib/i18n';
+
+type ChatRuntimeStatus = Pick<SystemStatusView, 'activeSystemAction' | 'bootstrapStatus' | 'lastError' | 'lastReadyAt' | 'lifecyclePhase' | 'phase'>;
+
+export function isNcpChatRuntimeBlocked(status: Pick<SystemStatusView, 'bootstrapStatus'>): boolean {
+  return status.bootstrapStatus?.ncpAgent.state !== 'ready';
+}
+
+export function resolveNcpChatRuntimeMessage(
+  status: ChatRuntimeStatus
+): string | null {
+  const actionMessage = status.activeSystemAction?.message?.trim();
+  if (actionMessage) return actionMessage;
+  if (status.lifecyclePhase === 'cold-starting') {
+    return t('chatRuntimeInitializing');
+  }
+  if (status.lifecyclePhase === 'startup-failed') {
+    return (
+      status.bootstrapStatus?.ncpAgent.error?.trim() ||
+      status.bootstrapStatus?.lastError?.trim() ||
+      status.lastError?.trim() ||
+      t('chatRuntimeInitializationFailed')
+    );
+  }
+  return null;
+}
+
+export function resolveNcpChatSendErrorMessage(params: {
+  message: string | null | undefined;
+  status: ChatRuntimeStatus;
+}): string | null {
+  const { message: rawMessage, status } = params;
+  const message = rawMessage?.trim();
+  if (!message) {
+    return resolveNcpChatRuntimeMessage(status);
+  }
+  const actionMessage = status.activeSystemAction?.message?.trim();
+  if (status.phase === 'service-transitioning' && actionMessage) {
+    return actionMessage;
+  }
+  const isTransientTransportError = isTransientRuntimeConnectionErrorMessage(message);
+  if (status.phase === 'recovering' && isTransientTransportError) {
+    return t('runtimeControlRecoveringHelp');
+  }
+  if (status.phase === 'stalled' && isTransientTransportError) {
+    return null;
+  }
+  return message;
+}

package/src/features/chat/utils/ncp-session-adapter.utils.test.ts

@@ -69,6 +69,33 @@ describe('adaptNcpSessionSummary', () => {
       spawnedByRequestId: 'request-1',
     });
   });
+
+  it('does not hydrate context window metadata from persisted session summaries', () => {
+    const adapted = adaptNcpSessionSummary(
+      createSummary({
+        metadata: {
+          last_context_window: {
+            version: 1,
+            usedContextTokens: 76000,
+            totalContextTokens: 200000,
+            prunedUsedContextTokens: 61200,
+            availableContextTokens: 124000,
+            droppedHistoryCount: 3,
+            truncatedToolResultCount: 1,
+            truncatedSystemPrompt: false,
+            truncatedUserMessage: false,
+            compacted: true,
+            checkpointId: 'ctx-20260505123456-8',
+            compactedMessageCount: 8,
+            compactedUsedContextTokens: 51000,
+            updatedAt: '2026-05-05T12:34:56.000Z',
+          },
+        },
+      }),
+    );
+
+    expect(adapted.contextWindow).toBeUndefined();
+  });
 });
 
 describe('adaptNcpMessageToUiMessage file rendering', () => {

package/src/features/chat/utils/ncp-session-adapter.utils.ts

@@ -1,6 +1,11 @@
 import { ToolInvocationStatus, type UIMessage } from '@nextclaw/agent-chat';
 import type { NcpMessagePart } from '@nextclaw/ncp';
-import type { NcpMessageView, NcpSessionSummaryView, SessionEntryView, ThinkingLevel } from '@/shared/lib/api';
+import type {
+  NcpMessageView,
+  NcpSessionSummaryView,
+  SessionEntryView,
+  ThinkingLevel
+} from '@/shared/lib/api';
 import { API_BASE } from '@/shared/lib/api';
 import {
   getSessionProjectName,
@@ -132,9 +137,6 @@ function readPromotedChildSession(summary: NcpSessionSummaryView): boolean {
 }
 
 function parseSessionContext(sessionKey: string): { channel?: string; type?: string } {
-  if (sessionKey === 'heartbeat') {
-    return { type: 'heartbeat' };
-  }
   if (sessionKey.startsWith('cron:')) {
     return { type: 'cron' };
   }

package/src/features/chat/utils/ncp-session-context-metadata.utils.ts

@@ -0,0 +1,121 @@
+import type {
+  NcpMessageView,
+  SessionContextWindowView,
+} from '@/shared/lib/api';
+
+function readOptionalString(value: unknown): string | null {
+  if (typeof value !== 'string') {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
+function readNonNegativeInteger(value: unknown): number | null {
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    return null;
+  }
+  const normalized = Math.trunc(value);
+  return normalized >= 0 ? normalized : null;
+}
+
+function readBoolean(value: unknown): boolean {
+  return value === true;
+}
+
+export function readNcpContextWindowValue(value: unknown): SessionContextWindowView | null {
+  const rawContextWindow = value;
+  if (!rawContextWindow || typeof rawContextWindow !== 'object' || Array.isArray(rawContextWindow)) {
+    return null;
+  }
+  const contextWindow = rawContextWindow as Record<string, unknown>;
+  const usedContextTokens = readNonNegativeInteger(contextWindow.usedContextTokens);
+  const totalContextTokens = readNonNegativeInteger(contextWindow.totalContextTokens);
+  const prunedUsedContextTokens = readNonNegativeInteger(contextWindow.prunedUsedContextTokens);
+  const updatedAt = readOptionalString(contextWindow.updatedAt);
+  if (usedContextTokens === null || totalContextTokens === null || prunedUsedContextTokens === null || !updatedAt) {
+    return null;
+  }
+  const compactedUsedContextTokens = readNonNegativeInteger(contextWindow.compactedUsedContextTokens);
+  return {
+    usedContextTokens,
+    totalContextTokens,
+    prunedUsedContextTokens,
+    availableContextTokens: readNonNegativeInteger(contextWindow.availableContextTokens) ?? Math.max(0, totalContextTokens - usedContextTokens),
+    droppedHistoryCount: readNonNegativeInteger(contextWindow.droppedHistoryCount) ?? 0,
+    truncatedToolResultCount: readNonNegativeInteger(contextWindow.truncatedToolResultCount) ?? 0,
+    truncatedSystemPrompt: readBoolean(contextWindow.truncatedSystemPrompt),
+    truncatedUserMessage: readBoolean(contextWindow.truncatedUserMessage),
+    compacted: readBoolean(contextWindow.compacted),
+    ...(readOptionalString(contextWindow.checkpointId)
+      ? { checkpointId: readOptionalString(contextWindow.checkpointId) ?? undefined }
+      : {}),
+    compactedMessageCount: readNonNegativeInteger(contextWindow.compactedMessageCount) ?? 0,
+    ...(compactedUsedContextTokens !== null
+      ? { compactedUsedContextTokens }
+      : {}),
+    updatedAt,
+  };
+}
+
+export const NEXTCLAW_TIMELINE_KIND_METADATA_KEY = 'nextclaw_timeline_kind';
+export const CONTEXT_COMPACTION_TIMELINE_KIND = 'context_compaction';
+
+export type ContextCompactionTimelineView = {
+  id: string;
+  status: 'compressing' | 'compressed';
+  summary: string;
+  coveredMessageCount: number;
+  coveredSessionMessageCount: number;
+  originalEstimatedTokens: number;
+  projectedEstimatedTokens: number;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export function readContextCompactionTimeline(message: Pick<NcpMessageView, 'metadata'>): ContextCompactionTimelineView | null {
+  const { metadata } = message;
+  if (!metadata || metadata[NEXTCLAW_TIMELINE_KIND_METADATA_KEY] !== CONTEXT_COMPACTION_TIMELINE_KIND) {
+    return null;
+  }
+  const rawCheckpoint =
+    metadata.checkpoint && typeof metadata.checkpoint === 'object' && !Array.isArray(metadata.checkpoint)
+      ? (metadata.checkpoint as Record<string, unknown>)
+      : null;
+  if (!rawCheckpoint) {
+    return null;
+  }
+  const id = readOptionalString(rawCheckpoint.id);
+  const status = rawCheckpoint.status === 'compressing' ? 'compressing' : rawCheckpoint.status === 'compressed' ? 'compressed' : null;
+  const summary = readOptionalString(rawCheckpoint.summary);
+  const coveredMessageCount = readNonNegativeInteger(rawCheckpoint.coveredMessageCount);
+  const coveredSessionMessageCount = readNonNegativeInteger(rawCheckpoint.coveredSessionMessageCount);
+  const originalEstimatedTokens = readNonNegativeInteger(rawCheckpoint.originalEstimatedTokens);
+  const projectedEstimatedTokens = readNonNegativeInteger(rawCheckpoint.projectedEstimatedTokens);
+  const createdAt = readOptionalString(rawCheckpoint.createdAt);
+  const updatedAt = readOptionalString(rawCheckpoint.updatedAt);
+  if (
+    !id ||
+    !status ||
+    !summary ||
+    coveredMessageCount === null ||
+    coveredSessionMessageCount === null ||
+    originalEstimatedTokens === null ||
+    projectedEstimatedTokens === null ||
+    !createdAt ||
+    !updatedAt
+  ) {
+    return null;
+  }
+  return {
+    id,
+    status,
+    summary,
+    coveredMessageCount,
+    coveredSessionMessageCount,
+    originalEstimatedTokens,
+    projectedEstimatedTokens,
+    createdAt,
+    updatedAt,
+  };
+}

package/src/features/chat/utils/session-context.utils.ts

@@ -2,7 +2,7 @@ import type { SessionEntryView, SessionTypeIconView } from '@/shared/lib/api';
 import { t } from '@/shared/lib/i18n';
 import { getChannelLogo } from '@/shared/lib/logos';
 
-type SessionContextSymbolIcon = 'heartbeat' | 'cron';
+type SessionContextSymbolIcon = 'cron';
 
 export type SessionContextIcon =
   | { kind: 'channel-logo'; channel: string }
@@ -20,7 +20,6 @@ const CHANNEL_ALIAS_REGISTRY: Record<string, string> = {
 };
 
 const TYPE_CONTEXT_REGISTRY: Record<string, { icon: SessionContextSymbolIcon }> = {
-  heartbeat: { icon: 'heartbeat' },
   cron: { icon: 'cron' },
 };
 

package/src/features/system-status/components/config/runtime-config-editor.tsx

@@ -35,6 +35,7 @@ export function RuntimeConfigEditor(props: {
   const [bindings, setBindings] = useState(initialState.bindings);
   const [runtimeEntries, setRuntimeEntries] = useState(initialState.runtimeEntries);
   const [dmScope, setDmScope] = useState<DmScope>(initialState.dmScope);
+  const [companionEnabled, setCompanionEnabled] = useState(initialState.companionEnabled);
   const [defaultContextTokens, setDefaultContextTokens] = useState(initialState.defaultContextTokens);
   const [defaultEngine, setDefaultEngine] = useState(initialState.defaultEngine);
 
@@ -60,6 +61,7 @@ export function RuntimeConfigEditor(props: {
   const handleSave = () => {
     try {
       const data = createRuntimeConfigUpdatePayload({
+        companionEnabled,
         agents,
         bindings,
         runtimeEntries,
@@ -78,12 +80,16 @@ export function RuntimeConfigEditor(props: {
     <PageLayout className="space-y-6">
       <RuntimeConfigOverview />
       <RuntimeSettingsCard
+        companionEnabled={companionEnabled}
         dmScope={dmScope}
         defaultContextTokens={defaultContextTokens}
         defaultEngine={defaultEngine}
+        onCompanionEnabledChange={setCompanionEnabled}
         onDmScopeChange={setDmScope}
         onDefaultContextTokensChange={setDefaultContextTokens}
         onDefaultEngineChange={setDefaultEngine}
+        companionEnabledLabel={hintForPath('companion.enabled', props.uiHints)?.label}
+        companionEnabledHelp={hintForPath('companion.enabled', props.uiHints)?.help}
         dmScopeLabel={hintForPath('session.dmScope', props.uiHints)?.label}
         dmScopeHelp={hintForPath('session.dmScope', props.uiHints)?.help}
         defaultContextTokensLabel={hintForPath('agents.defaults.contextTokens', props.uiHints)?.label}

package/src/features/system-status/components/config/runtime-settings-card.tsx

@@ -1,6 +1,7 @@
 import { Input } from '@/shared/components/ui/input';
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/shared/components/ui/select';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/shared/components/ui/card';
+import { Switch } from '@/shared/components/ui/switch';
 import { t } from '@/shared/lib/i18n';
 import type { DmScope } from '@/features/system-status/utils/runtime-config-agent.utils';
 
@@ -13,11 +14,15 @@ const DM_SCOPE_OPTIONS: Array<{ value: DmScope; label: string }> = [
 
 export function RuntimeSettingsCard(props: {
   dmScope: DmScope;
+  companionEnabled: boolean;
   defaultContextTokens: number;
   defaultEngine: string;
+  onCompanionEnabledChange: (value: boolean) => void;
   onDmScopeChange: (value: DmScope) => void;
   onDefaultContextTokensChange: (value: number) => void;
   onDefaultEngineChange: (value: string) => void;
+  companionEnabledLabel?: string;
+  companionEnabledHelp?: string;
   dmScopeLabel?: string;
   dmScopeHelp?: string;
   defaultContextTokensLabel?: string;
@@ -32,6 +37,13 @@ export function RuntimeSettingsCard(props: {
         <CardDescription>{props.dmScopeHelp ?? t('dmScopeHelp')}</CardDescription>
       </CardHeader>
       <CardContent className="space-y-4">
+        <div className="flex items-start justify-between gap-4 rounded-md border border-gray-200 px-4 py-3">
+          <div className="space-y-1">
+            <div className="text-sm font-medium text-gray-800">{props.companionEnabledLabel ?? t('runtimeCompanionEnabled')}</div>
+            <p className="text-xs text-gray-500">{props.companionEnabledHelp ?? t('runtimeCompanionEnabledHelp')}</p>
+          </div>
+          <Switch checked={props.companionEnabled} onCheckedChange={props.onCompanionEnabledChange} />
+        </div>
         <div className="space-y-2">
           <label className="text-sm font-medium text-gray-800">{props.defaultContextTokensLabel ?? t('defaultContextTokens')}</label>
           <Input

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

@@ -1,9 +1,9 @@
 import { render, screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { useRuntimeUpdateStore } from '@/features/system-status';
 import { DesktopUpdateConfig } from '@/features/system-status/components/desktop-update-config';
 import { setLanguage } from '@/shared/lib/i18n';
-import { useDesktopUpdateStore } from '@/platforms/desktop';
 
 const mocks = vi.hoisted(() => ({
   start: vi.fn(),
@@ -15,13 +15,13 @@ const mocks = vi.hoisted(() => ({
   updateChannel: vi.fn()
 }));
 
-vi.mock('@/platforms/desktop', async () => {
-  const actual = await vi.importActual<typeof import('@/platforms/desktop')>(
-    '@/platforms/desktop'
+vi.mock('@/features/system-status', async () => {
+  const actual = await vi.importActual<typeof import('@/features/system-status')>(
+    '@/features/system-status'
   );
   return {
     ...actual,
-    desktopUpdateManager: mocks,
+    runtimeUpdateManager: mocks,
   };
 });
 
@@ -46,19 +46,27 @@ describe('DesktopUpdateConfig', () => {
       HTMLElement.prototype.releasePointerCapture = () => {};
     }
 
-    useDesktopUpdateStore.setState({
+    useRuntimeUpdateStore.setState({
       supported: true,
       initialized: true,
       busyAction: null,
       snapshot: {
         status: 'idle',
+        installationKind: 'npm-runtime-bundle',
         channel: 'beta',
-        launcherVersion: '0.0.138',
+        hostVersion: '0.0.138',
         currentVersion: '0.18.0',
         availableVersion: '0.18.2-beta.1',
         downloadedVersion: null,
+        minimumHostVersion: null,
         releaseNotesUrl: 'https://example.com/release-notes',
         lastCheckedAt: '2026-04-13T12:00:00.000Z',
+        progress: null,
+        canAutoDownload: false,
+        canApplyInApp: false,
+        requiresRestart: false,
+        blockReason: null,
+        recoveryCommand: null,
         errorMessage: null,
         preferences: {
           automaticChecks: true,
@@ -72,6 +80,8 @@ describe('DesktopUpdateConfig', () => {
     render(<DesktopUpdateConfig />);
 
     expect(mocks.start).toHaveBeenCalledTimes(1);
+    expect(screen.getByText('版本更新')).toBeTruthy();
+    expect(screen.getByText('宿主版本')).toBeTruthy();
     expect(screen.getByText('当前更新通道')).toBeTruthy();
     expect(screen.getAllByText('Beta').length).toBeGreaterThan(0);
     expect(screen.getByText('当前正在跟随 Beta 通道')).toBeTruthy();

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

@@ -1,4 +1,6 @@
+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';
 import { Label } from '@/shared/components/ui/label';
@@ -7,11 +9,6 @@ import { Switch } from '@/shared/components/ui/switch';
 import { PageHeader, PageLayout } from '@/app/components/layout/page-layout';
 import { formatDateTime, t } from '@/shared/lib/i18n';
 import { cn } from '@/shared/lib/utils';
-import {
-  desktopUpdateManager,
-  type DesktopReleaseChannel,
-  useDesktopUpdateStore,
-} from '@/platforms/desktop';
 import { Download, ExternalLink, RefreshCw, RotateCw } from 'lucide-react';
 
 const STATUS_LABEL_KEYS: Record<string, string> = {
@@ -20,6 +17,7 @@ const STATUS_LABEL_KEYS: Record<string, string> = {
   downloading: 'desktopUpdatesStatusDownloading',
   downloaded: 'desktopUpdatesStatusDownloaded',
   'up-to-date': 'desktopUpdatesStatusUpToDate',
+  blocked: 'desktopUpdatesStatusBlocked',
   failed: 'desktopUpdatesStatusFailed',
 };
 
@@ -31,6 +29,28 @@ function OverviewStat({ label, value }: { label: string; value: string }) {
   return <div className="rounded-xl border border-gray-200 bg-gray-50/60 p-4"><p className="text-xs font-medium uppercase tracking-[0.08em] text-gray-500">{label}</p><p className="mt-2 text-base font-semibold text-gray-900">{value}</p></div>;
 }
 
+function DownloadProgress({ snapshot }: { snapshot: UpdateSnapshot }) {
+  if (snapshot.status !== 'downloading') {
+    return null;
+  }
+  const percent = snapshot.progress?.percent;
+  const progressLabel = percent === null || percent === undefined
+    ? t('desktopUpdatesDownloadProgressUnknown')
+    : t('desktopUpdatesDownloadProgressPercent').replace('{percent}', String(percent));
+  const byteLabel = formatDownloadBytes(snapshot.progress?.downloadedBytes ?? 0, snapshot.progress?.totalBytes ?? null);
+  return (
+    <div className="rounded-2xl border border-amber-200 bg-amber-50/70 p-4">
+      <div className="flex items-center justify-between gap-4">
+        <p className="text-sm font-semibold text-amber-800">{progressLabel}</p>
+        <p className="text-xs font-medium text-amber-700">{byteLabel}</p>
+      </div>
+      <div className="mt-3 h-2 overflow-hidden rounded-full bg-amber-100">
+        <div className="h-full rounded-full bg-amber-500 transition-[width]" style={{ width: `${percent ?? 0}%` }} />
+      </div>
+    </div>
+  );
+}
+
 function PreferenceToggle({
   label,
   help,
@@ -61,7 +81,24 @@ function formatVersion(value: string | null): string {
 function formatLastCheckedAt(value: string | null): string {
   return value ? formatDateTime(value) : '-';
 }
-function getChannelLabel(channel: DesktopReleaseChannel): string {
+function formatDownloadBytes(downloadedBytes: number, totalBytes: number | null): string {
+  const downloaded = formatBytes(downloadedBytes);
+  return totalBytes && totalBytes > 0 ? `${downloaded} / ${formatBytes(totalBytes)}` : downloaded;
+}
+function formatBytes(value: number): string {
+  if (!Number.isFinite(value) || value <= 0) {
+    return '0 B';
+  }
+  const units = ['B', 'KB', 'MB', 'GB'];
+  let cursor = value;
+  let unitIndex = 0;
+  while (cursor >= 1024 && unitIndex < units.length - 1) {
+    cursor /= 1024;
+    unitIndex += 1;
+  }
+  return `${cursor >= 10 || unitIndex === 0 ? cursor.toFixed(0) : cursor.toFixed(1)} ${units[unitIndex]}`;
+}
+function getChannelLabel(channel: UpdateSnapshot['channel']): string {
   return channel === 'beta' ? t('desktopUpdatesChannelBeta') : t('desktopUpdatesChannelStable');
 }
 function getStatusLabel(status: string): string {
@@ -74,40 +111,40 @@ function getStatusTone(status: string): string {
   if (status === 'update-available' || status === 'downloading' || status === 'checking') {
     return 'bg-amber-50 text-amber-700 ring-amber-100';
   }
-  if (status === 'failed') {
+  if (status === 'failed' || status === 'blocked') {
     return 'bg-red-50 text-red-700 ring-red-100';
   }
   return 'bg-gray-100 text-gray-700 ring-gray-200';
 }
 
-function DesktopOnlyState() {
+function RuntimeUpdateUnavailableState() {
   return (
     <PageLayout className="space-y-6">
-      <PageHeader title={t('desktopUpdatesPageTitle')} description={t('desktopUpdatesPageDescription')} />
+      <PageHeader title={t('runtimeUpdatesPageTitle')} description={t('runtimeUpdatesPageDescription')} />
       <Card>
         <CardHeader>
-          <CardTitle>{t('desktopUpdatesDesktopOnlyTitle')}</CardTitle>
-          <CardDescription>{t('desktopUpdatesDesktopOnlyDescription')}</CardDescription>
+          <CardTitle>{t('runtimeUpdatesUnavailableTitle')}</CardTitle>
+          <CardDescription>{t('runtimeUpdatesUnavailableDescription')}</CardDescription>
         </CardHeader>
-        <CardContent><p className="text-sm text-gray-500">{t('desktopUpdatesDesktopOnlyFutureHint')}</p></CardContent>
+        <CardContent><p className="text-sm text-gray-500">{t('runtimeUpdatesUnavailableHint')}</p></CardContent>
       </Card>
     </PageLayout>
   );
 }
 
 export function DesktopUpdateConfig() {
-  const { supported, initialized, busyAction, snapshot } = useDesktopUpdateStore();
+  const { supported, initialized, busyAction, snapshot } = useRuntimeUpdateStore();
   useEffect(() => {
-    void desktopUpdateManager.start();
+    void runtimeUpdateManager.start();
     return () => {
-      desktopUpdateManager.stop();
+      runtimeUpdateManager.stop();
     };
   }, []);
   if (!initialized) {
     return <div className="p-8 text-gray-400">{t('loading')}</div>;
   }
   if (!supported || !snapshot) {
-    return <DesktopOnlyState />;
+    return <RuntimeUpdateUnavailableState />;
   }
   const isChecking = busyAction === 'checking';
   const isDownloading = busyAction === 'downloading';
@@ -117,7 +154,7 @@ export function DesktopUpdateConfig() {
   const canDownload = snapshot.status === 'update-available' && !isDownloading && !isApplying;
   const canApply = snapshot.status === 'downloaded' && !isApplying;
   const overviewStats = [
-    [t('desktopUpdatesLauncherVersion'), formatVersion(snapshot.launcherVersion)],
+    [t('runtimeUpdatesHostVersion'), formatVersion(snapshot.hostVersion)],
     [t('desktopUpdatesCurrentBundleVersion'), formatVersion(snapshot.currentVersion)],
     [t('desktopUpdatesAvailableVersion'), formatVersion(snapshot.availableVersion)],
     [t('desktopUpdatesLastCheckedAt'), formatLastCheckedAt(snapshot.lastCheckedAt)],
@@ -126,9 +163,9 @@ export function DesktopUpdateConfig() {
   return (
     <PageLayout className="space-y-6">
       <PageHeader
-        title={t('desktopUpdatesPageTitle')}
-        description={t('desktopUpdatesPageDescription')}
-        actions={<Button variant="outline" onClick={() => void desktopUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying}><RefreshCw className={cn('mr-2 h-4 w-4', isChecking && 'animate-spin')} />{t('desktopUpdatesCheckNow')}</Button>}
+        title={t('runtimeUpdatesPageTitle')}
+        description={t('runtimeUpdatesPageDescription')}
+        actions={<Button variant="outline" onClick={() => void runtimeUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying}><RefreshCw className={cn('mr-2 h-4 w-4', isChecking && 'animate-spin')} />{t('desktopUpdatesCheckNow')}</Button>}
       />
       <Card>
         <CardHeader>
@@ -147,10 +184,18 @@ export function DesktopUpdateConfig() {
           {snapshot.downloadedVersion ? (
             <div className="rounded-2xl border border-emerald-200 bg-emerald-50/70 p-4">
               <p className="text-sm font-semibold text-emerald-800">{t('desktopUpdatesDownloadedBannerTitle')}</p>
-              <p className="mt-1 text-sm text-emerald-700">{t('desktopUpdatesDownloadedBannerDescription').replace('{version}', snapshot.downloadedVersion)}</p>
+              <p className="mt-1 text-sm text-emerald-700">{t('runtimeUpdatesDownloadedBannerDescription').replace('{version}', snapshot.downloadedVersion)}</p>
+            </div>
+          ) : null}
+          <DownloadProgress snapshot={snapshot} />
+          {snapshot.status === 'blocked' ? (
+            <div className="rounded-2xl border border-red-200 bg-red-50/70 p-4">
+              <p className="text-sm font-semibold text-red-800">{t('desktopUpdatesBlockedTitle')}</p>
+              <p className="mt-1 text-sm text-red-700">{snapshot.errorMessage ?? t('desktopUpdatesBlockedDescription')}</p>
+              {snapshot.recoveryCommand ? <code className="mt-3 block rounded-lg bg-white/70 px-3 py-2 text-xs text-red-800">{snapshot.recoveryCommand}</code> : null}
             </div>
           ) : null}
-          {snapshot.errorMessage ? <div className="rounded-2xl border border-red-200 bg-red-50/70 p-4 text-sm text-red-700">{snapshot.errorMessage}</div> : null}
+          {snapshot.errorMessage && snapshot.status !== 'blocked' ? <div className="rounded-2xl border border-red-200 bg-red-50/70 p-4 text-sm text-red-700">{snapshot.errorMessage}</div> : null}
         </CardContent>
       </Card>
       <Card>
@@ -165,7 +210,7 @@ export function DesktopUpdateConfig() {
                 <Label>{t('desktopUpdatesReleaseChannel')}</Label>
                 <p className="text-sm text-gray-500">{t('desktopUpdatesReleaseChannelHelp')}</p>
               </div>
-              <Select value={snapshot.channel} disabled={isSwitchingChannel || isChecking || isDownloading || isApplying} onValueChange={(value) => void desktopUpdateManager.updateChannel(value as DesktopReleaseChannel)}>
+              <Select value={snapshot.channel} disabled={isSwitchingChannel || isChecking || isDownloading || isApplying} onValueChange={(value) => void runtimeUpdateManager.updateChannel(value as UpdateSnapshot['channel'])}>
                 <SelectTrigger className="w-full max-w-sm">
                   <SelectValue placeholder={t('desktopUpdatesReleaseChannel')} />
                 </SelectTrigger>
@@ -182,34 +227,34 @@ export function DesktopUpdateConfig() {
             help={t('desktopUpdatesAutomaticChecksHelp')}
             checked={snapshot.preferences.automaticChecks}
             disabled={isSavingPreferences || isSwitchingChannel}
-            onCheckedChange={(checked) => void desktopUpdateManager.updatePreferences({ automaticChecks: checked })}
+            onCheckedChange={(checked) => void runtimeUpdateManager.updatePreferences({ automaticChecks: checked })}
           />
           <PreferenceToggle
             label={t('desktopUpdatesAutoDownload')}
             help={t('desktopUpdatesAutoDownloadHelp')}
             checked={snapshot.preferences.autoDownload}
             disabled={isSavingPreferences || isSwitchingChannel}
-            onCheckedChange={(checked) => void desktopUpdateManager.updatePreferences({ autoDownload: checked })}
+            onCheckedChange={(checked) => void runtimeUpdateManager.updatePreferences({ autoDownload: checked })}
           />
         </CardContent>
       </Card>
       <Card>
         <CardHeader>
           <CardTitle>{t('desktopUpdatesActionsTitle')}</CardTitle>
-          <CardDescription>{t('desktopUpdatesActionsDescription')}</CardDescription>
+          <CardDescription>{t('runtimeUpdatesActionsDescription')}</CardDescription>
         </CardHeader>
         <CardContent className="flex flex-wrap items-center gap-3">
-          <Button variant="outline" onClick={() => void desktopUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying}>
+          <Button variant="outline" onClick={() => void runtimeUpdateManager.checkForUpdates()} disabled={isChecking || isDownloading || isApplying}>
             <RefreshCw className={cn('mr-2 h-4 w-4', isChecking && 'animate-spin')} />
             {t('desktopUpdatesCheckNow')}
           </Button>
-          <Button onClick={() => void desktopUpdateManager.downloadUpdate()} disabled={!canDownload}>
+          <Button onClick={() => void runtimeUpdateManager.downloadUpdate()} disabled={!canDownload}>
             <Download className={cn('mr-2 h-4 w-4', isDownloading && 'animate-bounce')} />
             {t('desktopUpdatesDownloadNow')}
           </Button>
-          <Button variant="secondary" onClick={() => void desktopUpdateManager.applyDownloadedUpdate()} disabled={!canApply}>
+          <Button variant="secondary" onClick={() => void runtimeUpdateManager.applyDownloadedUpdate()} disabled={!canApply}>
             <RotateCw className={cn('mr-2 h-4 w-4', isApplying && 'animate-spin')} />
-            {t('desktopUpdatesApplyNow')}
+            {t('runtimeUpdatesApplyNow')}
           </Button>
           {snapshot.releaseNotesUrl ? <Button variant="ghost" onClick={() => window.open(snapshot.releaseNotesUrl ?? '', '_blank', 'noopener,noreferrer')}><ExternalLink className="mr-2 h-4 w-4" />{t('desktopUpdatesReleaseNotes')}</Button> : null}
         </CardContent>

package/src/features/system-status/hooks/use-system-status.ts

@@ -82,17 +82,6 @@ export function useSystemStatus() {
   return toSystemStatusView(state);
 }
 
-export function useChatRuntimeAvailability() {
-  const state = useSystemStatusStore((store) => store.state);
-  const view = toSystemStatusView(state);
-  return {
-    isBlocked: view.isChatBlocked,
-    message: view.chatMessage,
-    phase: view.phase,
-    lastReadyAt: view.lastReadyAt,
-  };
-}
-
 export function useRuntimeStatusBadgeView() {
   const state = useSystemStatusStore((store) => store.state);
   return toRuntimeStatusBadgeView(state);

package/src/features/system-status/index.ts

@@ -1,4 +1,7 @@
-export { useChatRuntimeAvailability, useRuntimeControlPanelView, useRuntimeStatusBadgeView, useSystemStatus, useSystemStatusSources } from './hooks/use-system-status';
+export { useRuntimeControlPanelView, useRuntimeStatusBadgeView, useSystemStatus, useSystemStatusSources } from './hooks/use-system-status';
 export { isTransientRuntimeConnectionErrorMessage, systemStatusManager } from './managers/system-status.manager';
+export { runtimeUpdateManager } from './managers/runtime-update.manager';
+export type { SystemStatusState, SystemStatusView } from './types/system-status.types';
 export { useSystemStatusStore } from './stores/system-status.store';
+export { useRuntimeUpdateStore } from './stores/runtime-update.store';
 export { SecurityConfig } from './components/security-config';