@nextclaw/ui 0.12.19 → 0.12.20-beta.1

package/src/shared/lib/i18n/{chat.ts → chat-labels.utils.ts}

@@ -24,7 +24,6 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatSessionTypeClaude: { zh: 'Claude Code', en: 'Claude Code' },
   chatSessionTypeWeixin: { zh: '微信', en: 'WeChat' },
   chatSessionTypeFeishu: { zh: '飞书', en: 'Feishu' },
-  chatSessionTypeHeartbeat: { zh: '心跳', en: 'Heartbeat' },
   chatSessionTypeCron: { zh: '定时任务', en: 'Cron' },
   chatSessionTypeUnavailableSuffix: {
     zh: '当前不可用，请启用对应插件或新建 Native 会话。',
@@ -92,6 +91,19 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatStop: { zh: '停止', en: 'Stop' },
   chatStopPreparing: { zh: '正在建立可停止会话，请稍候…', en: 'Preparing stoppable run…' },
   chatStopUnavailable: { zh: '当前后端引擎不支持手动停止。', en: 'Manual stop is not supported by the current backend engine.' },
+  chatContextWindow: { zh: '上下文窗口', en: 'Context window' },
+  chatContextWindowUsed: { zh: '预计占用', en: 'Projected use' },
+  chatContextWindowTotal: { zh: '总窗口', en: 'Total' },
+  chatContextWindowAvailable: { zh: '剩余', en: 'Available' },
+  chatContextWindowPruned: { zh: '安全裁剪后', en: 'After safety pruning' },
+  chatContextWindowDroppedHistory: { zh: '已丢弃历史消息', en: 'Dropped history' },
+  chatContextWindowTruncatedTools: { zh: '已截断工具结果', en: 'Truncated tool results' },
+  chatContextWindowUpdatedAt: { zh: '更新时间', en: 'Updated' },
+  chatContextCompactionCompressing: { zh: '正在压缩较早上下文', en: 'Compressing earlier context' },
+  chatContextCompactionCompressed: { zh: '较早上下文已自动压缩', en: 'Earlier context was auto-compacted' },
+  chatContextCompactionCoveredMessages: { zh: '覆盖消息数', en: 'Covered messages' },
+  chatContextCompactionOriginalTokens: { zh: '压缩前估算', en: 'Estimated before compaction' },
+  chatContextCompactionProjectedTokens: { zh: '压缩后估算', en: 'Estimated after compaction' },
   chatSending: { zh: '发送中...', en: 'Sending...' },
   chatQueueSend: { zh: '排队发送', en: 'Queue' },
   chatQueuedHintPrefix: { zh: '当前有', en: 'Queued' },

package/src/shared/lib/i18n/desktop-update-labels.utils.ts

@@ -1,5 +1,47 @@
 export const DESKTOP_UPDATE_LABELS: Record<string, { zh: string; en: string }> = {
   updates: { zh: '更新', en: 'Updates' },
+  runtimeUpdatesPageTitle: { zh: '版本更新', en: 'Runtime Updates' },
+  runtimeUpdatesPageDescription: {
+    zh: '自动检查并后台下载新版本，由你决定何时切换到新的运行版本。',
+    en: 'Check and download new versions automatically, then decide when to switch to the new runtime.'
+  },
+  runtimeUpdatesUnavailableTitle: { zh: '当前环境暂不支持更新', en: 'Updates Are Currently Unavailable' },
+  runtimeUpdatesUnavailableDescription: {
+    zh: '这个运行环境暂时没有可用的更新宿主。',
+    en: 'This runtime environment does not currently expose an update host.'
+  },
+  runtimeUpdatesUnavailableHint: {
+    zh: '更新入口会在宿主支持后自动出现，不需要前端单独区分环境。',
+    en: 'The update entry appears automatically once the host supports updates.'
+  },
+  runtimeUpdatesHostVersion: { zh: '宿主版本', en: 'Host Version' },
+  runtimeUpdatesDownloadedBannerDescription: {
+    zh: '版本 {version} 已下载完成，确认后即可切换到新版本。',
+    en: 'Version {version} has finished downloading and is ready to switch over when you confirm.'
+  },
+  runtimeUpdatesActionsDescription: {
+    zh: '支持手动检查、手动下载，以及在你准备好之后切换到已下载的新版本。',
+    en: 'Manually check, manually download, and switch to a downloaded version whenever you are ready.'
+  },
+  runtimeUpdatesApplyNow: { zh: '立即更新', en: 'Update Now' },
+  runtimeUpdatesLoadFailed: { zh: '读取更新状态失败', en: 'Failed to load update state' },
+  runtimeUpdatesCheckFailed: { zh: '检查更新失败', en: 'Failed to check for updates' },
+  runtimeUpdatesDownloadFailed: { zh: '下载更新失败', en: 'Failed to download update' },
+  runtimeUpdatesApplyFailed: { zh: '应用更新失败', en: 'Failed to apply update' },
+  runtimeUpdatesPreferencesFailed: { zh: '保存更新偏好失败', en: 'Failed to save update preferences' },
+  runtimeUpdatesChannelChangeFailed: { zh: '切换更新通道失败', en: 'Failed to change the release channel' },
+  runtimeUpdatesAlreadyLatest: { zh: '当前已经是最新版本。', en: 'You already have the latest version.' },
+  runtimeUpdatesReadyToApply: { zh: '更新已下载完成，已经可以切换到新版本。', en: 'The update is ready and can be applied now.' },
+  runtimeUpdatesAvailable: { zh: '发现新版本 {version}。', en: 'Version {version} is available.' },
+  runtimeUpdatesUnknownVersion: { zh: '新版本', en: 'a new version' },
+  runtimeUpdatesChannelChanged: {
+    zh: '已切换到 {channel} 更新通道。',
+    en: 'Switched to the {channel} release channel.'
+  },
+  runtimeUpdatesChannelChangedWithUpdate: {
+    zh: '已切换到 {channel} 通道，发现版本 {version}。',
+    en: 'Switched to the {channel} channel and found version {version}.'
+  },
   desktopUpdatesPageTitle: { zh: '桌面端更新', en: 'Desktop Updates' },
   desktopUpdatesPageDescription: {
     zh: '在应用内检查、下载并决定何时应用新的桌面端版本。',
@@ -26,7 +68,14 @@ export const DESKTOP_UPDATE_LABELS: Record<string, { zh: string; en: string }> =
   desktopUpdatesStatusDownloading: { zh: '下载中', en: 'Downloading' },
   desktopUpdatesStatusDownloaded: { zh: '已下载待应用', en: 'Downloaded' },
   desktopUpdatesStatusUpToDate: { zh: '已是最新', en: 'Up to Date' },
+  desktopUpdatesStatusBlocked: { zh: '更新被阻塞', en: 'Blocked' },
   desktopUpdatesStatusFailed: { zh: '更新失败', en: 'Failed' },
+  desktopUpdatesInlineDownload: { zh: '下载', en: 'Download' },
+  desktopUpdatesInlineDownloading: { zh: '下载中', en: 'Downloading' },
+  desktopUpdatesInlineDownloadingPercent: { zh: '下载 {percent}%', en: '{percent}%' },
+  desktopUpdatesInlineReady: { zh: '更新', en: 'Update' },
+  desktopUpdatesInlineApplying: { zh: '应用中', en: 'Applying' },
+  desktopUpdatesInlineAttention: { zh: '更新异常', en: 'Update Issue' },
   desktopUpdatesLauncherVersion: { zh: '桌面壳版本', en: 'Launcher Version' },
   desktopUpdatesCurrentBundleVersion: { zh: '当前内核版本', en: 'Current Kernel Version' },
   desktopUpdatesAvailableVersion: { zh: '可用版本', en: 'Available Version' },
@@ -37,6 +86,22 @@ export const DESKTOP_UPDATE_LABELS: Record<string, { zh: string; en: string }> =
     zh: '版本 {version} 已下载完成，等你确认后即可重启应用并完成更新。',
     en: 'Version {version} is ready. Restart the app whenever you want to apply it.'
   },
+  desktopUpdatesDownloadProgressPercent: {
+    zh: '正在下载 {percent}%',
+    en: 'Downloading {percent}%'
+  },
+  desktopUpdatesDownloadProgressUnknown: {
+    zh: '正在下载',
+    en: 'Downloading'
+  },
+  desktopUpdatesBlockedTitle: {
+    zh: '更新暂时无法继续',
+    en: 'Update Blocked'
+  },
+  desktopUpdatesBlockedDescription: {
+    zh: '当前安装环境需要先处理阻塞项，之后才能继续更新。',
+    en: 'Resolve the current installation requirement before continuing the update.'
+  },
   desktopUpdatesPreferencesTitle: { zh: '更新偏好', en: 'Update Preferences' },
   desktopUpdatesPreferencesDescription: {
     zh: '默认自动检查更新，但是否后台下载由你决定。',

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

@@ -1,7 +1,7 @@
 import { AGENT_LABELS } from './agents';
 import { CHANNEL_LABELS } from './channels';
 import { CHANNEL_AUTH_LABELS } from './channel-auth';
-import { CHAT_LABELS } from './chat';
+import { CHAT_LABELS } from './chat-labels.utils';
 import {
   getLanguage,
   getLocale,
@@ -343,14 +343,13 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   authPasswordAction: { zh: '更新密码', en: 'Update Password' },
   authPasswordUpdating: { zh: '更新中...', en: 'Updating...' },
   authLogoutAction: { zh: '退出当前标签页', en: 'Sign Out This Tab' },
-  authSessionMemoryNotice: {
-    zh: '当前版本的会话只保存在服务端内存里。NextClaw UI 进程重启后，需要重新登录。',
-    en: 'Sessions are stored only in server memory for now. You will need to sign in again after the NextClaw UI process restarts.'
-  },
+  authSessionMemoryNotice: { zh: '当前版本的会话只保存在服务端内存里。NextClaw UI 进程重启后，需要重新登录。', en: 'Sessions are stored only in server memory for now. You will need to sign in again after the NextClaw UI process restarts.' },
   dmScope: { zh: '私聊范围', en: 'DM Scope' },
   dmScopeHelp: { zh: '控制私聊会话如何隔离。', en: 'Control how direct-message sessions are isolated.' },
   defaultContextTokens: { zh: '默认上下文 Token', en: 'Default Context Tokens' },
   defaultContextTokensHelp: { zh: '当 Agent 未设置单独值时使用该上下文预算。', en: 'Input context budget for agents when no per-agent override is set.' },
+  runtimeCompanionEnabled: { zh: '桌宠 Companion', en: 'Companion' },
+  runtimeCompanionEnabledHelp: { zh: '开启后会自动拉起悬浮 Companion；关闭后会立即停止，并在下次启动时保持关闭。', en: 'When enabled, NextClaw auto-starts the floating companion. When disabled, it stops immediately and stays off after restart.' },
   defaultEngine: { zh: '默认 Runtime', en: 'Default Runtime' },
   defaultEngineHelp: { zh: '默认使用的 Agent Runtime，例如 native、codex 或 claude。', en: 'Default agent runtime, for example native, codex, or claude.' },
   agentList: { zh: 'Agent 列表', en: 'Agent List' },

package/src/shared/lib/i18n/runtime/i18n-language-owner.ts

@@ -100,9 +100,9 @@ class I18nLanguageOwner {
 
 const owner = new I18nLanguageOwner();
 
-export const resolveInitialLanguage = owner.resolveInitialLanguage;
+export const { resolveInitialLanguage } = owner;
 export const initializeI18n = owner.initialize;
-export const getLanguage = owner.getLanguage;
-export const setLanguage = owner.setLanguage;
-export const subscribeLanguageChange = owner.subscribeLanguageChange;
-export const getLocale = owner.getLocale;
+export const { getLanguage } = owner;
+export const { setLanguage } = owner;
+export const { subscribeLanguageChange } = owner;
+export const { getLocale } = owner;

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

@@ -1,4 +1,5 @@
 export { appClient } from './app-client.service';
+export { requestRawApiResponse } from './request-raw-api-response.utils';
 export type {
   AppEvent,
   AppTransport,

package/src/shared/lib/transport/local-transport.service.ts

@@ -1,5 +1,6 @@
 import { systemStatusManager } from '@/features/system-status';
 import type { AppEvent, AppTransport, RequestInput, StreamInput, StreamSession } from './transport.types';
+import { requestRawApiResponse } from './request-raw-api-response.utils';
 import { readSseStreamResult } from './sse-stream.utils';
 import { resolveTransportWebSocketUrl } from './transport-websocket-url.utils';
 
@@ -139,13 +140,14 @@ export class LocalAppTransport implements AppTransport {
     const timeoutId = timeoutMs
       ? window.setTimeout(() => controller?.abort(`Request timed out after ${timeoutMs}ms: ${input.method} ${input.path}`), timeoutMs)
       : null;
+    const requestBody = normalizeRequestBody(input.body);
 
     try {
-      const { requestRawApiResponse } = await import('@/shared/lib/api');
-      const response = await requestRawApiResponse<T>(input.path, {
+      const response = await requestRawApiResponse<T>(this.apiBase, input.path, {
         method: input.method,
-        ...(input.body !== undefined ? { body: JSON.stringify(input.body) } : {}),
-        ...(controller ? { signal: controller.signal } : {})
+        ...(requestBody !== undefined ? { body: requestBody } : {}),
+        ...(input.headers ? { headers: input.headers } : {}),
+        signal: controller?.signal ?? input.signal
       });
       if (!response.ok) {
         throw createTransportError(response, `Request failed for ${input.method} ${input.path}`);
@@ -228,3 +230,21 @@ export class LocalAppTransport implements AppTransport {
     return this.realtimeGateway.subscribe(handler);
   };
 }
+
+function normalizeRequestBody(body: unknown): BodyInit | undefined {
+  if (body === undefined) {
+    return undefined;
+  }
+  if (
+    body instanceof FormData ||
+    body instanceof URLSearchParams ||
+    body instanceof Blob ||
+    body instanceof ArrayBuffer
+  ) {
+    return body;
+  }
+  if (typeof body === 'string') {
+    return body;
+  }
+  return JSON.stringify(body);
+}

package/src/shared/lib/transport/remote-transport.service.ts

@@ -1,4 +1,4 @@
-import type { ApiError } from '@/shared/lib/api';
+import type { ApiError } from '@nextclaw/server';
 import type { AppEvent, AppTransport, RemoteRuntimeInfo, RequestInput, StreamInput, StreamSession } from './transport.types';
 import { resolveTransportWebSocketUrl } from './transport-websocket-url.utils';
 
@@ -291,7 +291,7 @@ export class RemoteSessionMultiplexTransport implements AppTransport {
         };
       });
 
-    const connectPromise = this.connectPromise;
+    const { connectPromise } = this;
     return await connectPromise;
   }
 

package/src/shared/lib/transport/request-raw-api-response.utils.ts

@@ -0,0 +1,133 @@
+import type { ApiResponse } from '@nextclaw/server';
+import { systemStatusManager } from '@/features/system-status';
+
+function compactSnippet(text: string) {
+  return text.replace(/\s+/g, ' ').trim().slice(0, 200);
+}
+
+function inferNonJsonHint(endpoint: string, status: number): string | undefined {
+  if (
+    status === 404 &&
+    endpoint.startsWith('/api/config/providers/') &&
+    endpoint.endsWith('/test')
+  ) {
+    return 'Provider test endpoint is missing. This usually means nextclaw runtime version is outdated.';
+  }
+  if (status === 401 || status === 403) {
+    return 'Authentication failed. Check apiKey and custom headers.';
+  }
+  if (status === 429) {
+    return 'Rate limited by upstream provider. Retry later or switch model/provider.';
+  }
+  if (status >= 500) {
+    return 'Upstream service error. Retry later and inspect server logs if it persists.';
+  }
+  return undefined;
+}
+
+function formatUnknownFetchError(error: unknown): {
+  summary: string;
+  details: Record<string, unknown>;
+} {
+  if (error instanceof Error) {
+    const name = error.name?.trim() || 'Error';
+    const message = error.message?.trim() || 'Unknown error';
+    return {
+      summary: `${name}: ${message}`,
+      details: {
+        errorName: name,
+        errorMessage: message,
+        ...(error.stack?.trim() ? { errorStack: error.stack.trim() } : {})
+      }
+    };
+  }
+  return {
+    summary: String(error ?? 'Unknown error'),
+    details: {
+      errorName: 'NonError',
+      errorMessage: String(error ?? 'Unknown error')
+    }
+  };
+}
+
+export async function requestRawApiResponse<T>(
+  apiBase: string,
+  endpoint: string,
+  options: RequestInit = {}
+): Promise<ApiResponse<T>> {
+  const url = `${apiBase}${endpoint}`;
+  const method = (options.method || 'GET').toUpperCase();
+
+  let response: Response;
+  try {
+    const headers = new Headers(options.headers);
+    if (!(options.body instanceof FormData) && !headers.has('Content-Type')) {
+      headers.set('Content-Type', 'application/json');
+    }
+    response = await fetch(url, {
+      credentials: 'include',
+      headers,
+      ...options
+    });
+  } catch (error) {
+    const formatted = formatUnknownFetchError(error);
+    systemStatusManager.reportTransportFailure(formatted.summary);
+    return {
+      ok: false,
+      error: {
+        code: 'NETWORK_ERROR',
+        message: `Fetch failed on ${method} ${endpoint} | ${formatted.summary}`,
+        details: {
+          method,
+          endpoint,
+          url,
+          ...formatted.details
+        }
+      }
+    };
+  }
+
+  const text = await response.text();
+  let data: ApiResponse<T> | null = null;
+  if (text) {
+    try {
+      data = JSON.parse(text) as ApiResponse<T>;
+    } catch {
+      // fall through to build a synthetic error response
+    }
+  }
+
+  if (!data) {
+    const snippet = text ? compactSnippet(text) : '';
+    const hint = inferNonJsonHint(endpoint, response.status);
+    const parts = [`Non-JSON response (${response.status} ${response.statusText}) on ${method} ${endpoint}`];
+    if (snippet) {
+      parts.push(`body=${snippet}`);
+    }
+    if (hint) {
+      parts.push(`hint=${hint}`);
+    }
+    return {
+      ok: false,
+      error: {
+        code: 'INVALID_RESPONSE',
+        message: parts.join(' | '),
+        details: {
+          status: response.status,
+          statusText: response.statusText,
+          method,
+          endpoint,
+          url,
+          bodySnippet: snippet || undefined,
+          hint
+        }
+      }
+    };
+  }
+
+  if (!response.ok) {
+    return data as ApiResponse<T>;
+  }
+
+  return data as ApiResponse<T>;
+}

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

@@ -1,4 +1,4 @@
-import type { WsEvent } from '@/shared/lib/api';
+import type { UiServerEvent } from '@nextclaw/server';
 
 export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
@@ -6,6 +6,8 @@ export type RequestInput = {
   method: RequestMethod;
   path: string;
   body?: unknown;
+  headers?: Record<string, string>;
+  signal?: AbortSignal;
   timeoutMs?: number;
 };
 
@@ -27,7 +29,11 @@ export type StreamSession<TFinal = unknown> = {
   cancel: () => void;
 };
 
-export type AppEvent = WsEvent;
+export type AppEvent =
+  | UiServerEvent
+  | { type: 'connection.open'; payload?: Record<string, never> }
+  | { type: 'connection.close'; payload?: Record<string, never> }
+  | { type: 'connection.error'; payload?: { message?: string } };
 
 export type AppTransport = {
   request<T>(input: RequestInput): Promise<T>;

package/src/shared/lib/ui-document-title/index.ts

@@ -16,7 +16,7 @@ const ROUTE_TITLE_KEYS: Array<{ prefix: string; key: string }> = [
   { prefix: '/providers', key: 'providersPageTitle' },
   { prefix: '/channels', key: 'channelsPageTitle' },
   { prefix: '/runtime', key: 'runtimePageTitle' },
-  { prefix: '/updates', key: 'desktopUpdatesPageTitle' },
+  { prefix: '/updates', key: 'runtimeUpdatesPageTitle' },
   { prefix: '/remote', key: 'remotePageTitle' },
   { prefix: '/security', key: 'authSecurityTitle' },
   { prefix: '/sessions', key: 'sessionsPageTitle' },

package/tsconfig.json

@@ -34,6 +34,7 @@
       "@/*": ["./src/*"],
       "@nextclaw/agent-chat": ["../nextclaw-agent-chat/src/index.ts"],
       "@nextclaw/agent-chat-ui": ["../nextclaw-agent-chat-ui/src/index.ts"],
+      "@nextclaw/kernel": ["../nextclaw-kernel/src/types/update.types.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"]