@nextclaw/ui 0.12.10 → 0.12.12

package/src/{components → shared/components}/ui/textarea.tsx

@@ -1,5 +1,5 @@
 import * as React from "react";
-import { cn } from "@/lib/utils";
+import { cn } from "@/shared/lib/utils";
 
 export type TextareaProps = React.TextareaHTMLAttributes<HTMLTextAreaElement>;
 

package/src/{components → shared/components}/ui/tooltip.tsx

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 
-import { cn } from '@/lib/utils';
+import { cn } from '@/shared/lib/utils';
 
 const TooltipProvider = TooltipPrimitive.Provider;
 

package/src/{hooks/agents/useAgents.ts → shared/hooks/use-agents.ts}

@@ -1,7 +1,7 @@
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
-import { createAgent, deleteAgent, fetchAgents, updateAgent } from '@/api/agents';
+import { createAgent, deleteAgent, fetchAgents, updateAgent } from '@/shared/lib/api';
 import { toast } from 'sonner';
-import { t } from '@/lib/i18n';
+import { t } from '@/shared/lib/i18n';
 
 export function useAgents() {
   return useQuery({

package/src/{hooks/useConfig.ts → shared/hooks/use-config.ts}

@@ -2,7 +2,7 @@ import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
 import {
   deleteNcpSessionSummaryInQueryClient,
   upsertNcpSessionSummaryInQueryClient
-} from '@/api/ncp-session-query-cache';
+} from '@/shared/lib/api';
 import {
   fetchAppMeta,
   fetchConfig,
@@ -25,16 +25,16 @@ import {
   deleteCronJob,
   setCronJobEnabled,
   runCronJob
-} from '@/api/config';
+} from '@/shared/lib/api';
 import {
   deleteNcpSession,
   fetchNcpSessionMessages,
   fetchNcpSessionSkills,
   fetchNcpSessions,
   updateNcpSession
-} from '@/api/ncp-session';
+} from '@/shared/lib/api';
 import { toast } from 'sonner';
-import { t } from '@/lib/i18n';
+import { t } from '@/shared/lib/i18n';
 
 export function useConfig() {
   return useQuery({

package/src/{hooks/useConfirmDialog.tsx → shared/hooks/use-confirm-dialog.tsx}

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 import { useCallback, useState } from 'react';
-import { ConfirmDialog } from '@/components/ui/confirm-dialog';
-import { t } from '@/lib/i18n';
+import { ConfirmDialog } from '@/shared/components/ui/confirm-dialog';
+import { t } from '@/shared/lib/i18n';
 
 export type ConfirmOptions = {
   title: string;

package/src/{hooks/server-path → shared/hooks}/use-server-path-browse.ts

@@ -1,5 +1,5 @@
 import { useQuery } from '@tanstack/react-query';
-import { fetchServerPathBrowse } from '@/api/server-path';
+import { fetchServerPathBrowse } from '@/shared/lib/api';
 
 export function useServerPathBrowse(params: {
   path?: string | null;

package/src/{hooks/server-path → shared/hooks}/use-server-path-read.ts

@@ -1,5 +1,5 @@
 import { useQuery } from '@tanstack/react-query';
-import { fetchServerPathRead } from '@/api/server-path';
+import { fetchServerPathRead } from '@/shared/lib/api';
 
 export function useServerPathRead(params: {
   path?: string | null;

package/src/{api → shared/lib/api}/api-base.test.ts

@@ -18,7 +18,7 @@ describe('API_BASE', () => {
       }
     });
 
-    const { API_BASE } = await import('@/api/api-base');
+    const { API_BASE } = await import('@/shared/lib/api');
 
     expect(API_BASE).toBe('https://api.example.com');
   });
@@ -30,7 +30,7 @@ describe('API_BASE', () => {
       }
     });
 
-    const { API_BASE } = await import('@/api/api-base');
+    const { API_BASE } = await import('@/shared/lib/api');
 
     expect(API_BASE).toBe('https://remote.claw.cool');
   });

package/src/{api → shared/lib/api}/client.test.ts

@@ -1,10 +1,10 @@
-import { api, requestApiResponse } from '@/api/client';
+import { api, requestApiResponse } from '@/shared/lib/api';
 
 const mocks = vi.hoisted(() => ({
   request: vi.fn()
 }));
 
-vi.mock('@/transport', () => ({
+vi.mock('@/shared/lib/transport', () => ({
   appClient: {
     request: mocks.request
   }

package/src/{api → shared/lib/api}/client.ts

@@ -1,4 +1,4 @@
-import { appClient } from '@/transport';
+import { appClient } from '@/shared/lib/transport';
 import type { ApiResponse } from './types';
 
 export async function requestApiResponse<T>(

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

@@ -6,6 +6,7 @@ import type {
   AuthSetupRequest,
   AuthStatusView,
   AppMetaView,
+  BootstrapStatusView,
   ConfigView,
   ConfigMetaView,
   ConfigSchemaResponse,
@@ -99,6 +100,15 @@ export async function fetchAppMeta(): Promise<AppMetaView> {
   return response.data;
 }
 
+// GET /api/runtime/bootstrap-status
+export async function fetchBootstrapStatus(): Promise<BootstrapStatusView> {
+  const response = await api.get<BootstrapStatusView>('/api/runtime/bootstrap-status');
+  if (!response.ok) {
+    throw new Error(response.error.message);
+  }
+  return response.data;
+}
+
 // GET /api/config
 export async function fetchConfig(): Promise<ConfigView> {
   const response = await api.get<ConfigView>('/api/config');

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

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

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

@@ -5,8 +5,8 @@ import {
   deleteNcpSessionSummaryList,
   updateNcpSessionRunStatusList,
   upsertNcpSessionSummaryList
-} from '@/api/ncp-session-query-cache';
-import type { NcpSessionsListView } from '@/api/types';
+} from '@/shared/lib/api';
+import type { NcpSessionsListView } from '@/shared/lib/api';
 
 function createSessionsList(): NcpSessionsListView {
   return {

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

@@ -1,5 +1,5 @@
 import type { QueryClient } from '@tanstack/react-query';
-import type { NcpSessionSummaryView, NcpSessionsListView, WsEvent } from '@/api/types';
+import type { NcpSessionSummaryView, NcpSessionsListView, WsEvent } from '@/shared/lib/api';
 
 function sortSessionSummaries(summaries: readonly NcpSessionSummaryView[]): NcpSessionSummaryView[] {
   return [...summaries].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));

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

@@ -1,7 +1,7 @@
-import { fetchNcpSessionSkills } from '@/api/ncp-session';
-import { api } from '@/api/client';
+import { fetchNcpSessionSkills } from './ncp-session';
+import { api } from './client';
 
-vi.mock('@/api/client', () => ({
+vi.mock('./client', () => ({
   api: {
     get: vi.fn()
   }

package/src/{api → shared/lib/api}/raw-client.test.ts

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { requestRawApiResponse } from './raw-client';
+import { requestRawApiResponse } from './raw-client.utils';
 
 const fetchMock = vi.fn<typeof fetch>();
 

package/src/{api/raw-client.ts → shared/lib/api/raw-client.utils.ts}

@@ -1,5 +1,6 @@
 import { API_BASE } from './api-base';
 import type { ApiResponse } from './types';
+import { systemStatusManager } from '@/features/system-status';
 
 function compactSnippet(text: string) {
   return text.replace(/\s+/g, ' ').trim().slice(0, 200);
@@ -69,6 +70,7 @@ export async function requestRawApiResponse<T>(
     });
   } catch (error) {
     const formatted = formatUnknownFetchError(error);
+    systemStatusManager.reportTransportFailure(formatted.summary);
     return {
       ok: false,
       error: {

package/src/{api → shared/lib/api}/types.ts

@@ -13,6 +13,46 @@ export type ApiResponse<T> =
 
 export type AppMetaView = { name: string; productVersion: string };
 
+export type BootstrapPhase =
+  | 'kernel-starting'
+  | 'shell-ready'
+  | 'hydrating-capabilities'
+  | 'ready'
+  | 'error';
+
+export type BootstrapStageState = 'pending' | 'running' | 'ready' | 'error';
+
+export type BootstrapRemoteState = 'pending' | 'ready' | 'conflict' | 'disabled' | 'error';
+
+export type BootstrapStatusView = {
+  phase: BootstrapPhase;
+  shellReadyAt?: string;
+  ncpAgent: {
+    state: BootstrapStageState;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+  };
+  pluginHydration: {
+    state: BootstrapStageState;
+    loadedPluginCount: number;
+    totalPluginCount: number;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+  };
+  channels: {
+    state: BootstrapStageState;
+    enabled: string[];
+    error?: string;
+  };
+  remote: {
+    state: BootstrapRemoteState;
+    message?: string;
+  };
+  lastError?: string;
+};
+
 export type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "adaptive" | "xhigh";
 
 export type ProviderConfigView = {

package/src/{lib → shared/lib/app-resource-uri}/app-resource-uri.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { resolveAppResourceUri } from "@/lib/app-resource-uri";
+import { resolveAppResourceUri } from "@/shared/lib/app-resource-uri";
 
 describe("resolveAppResourceUri", () => {
   it("maps app resource uris to public app paths", () => {

package/src/{lib/config-hints.ts → shared/lib/config-hints/index.ts}

@@ -1,4 +1,4 @@
-import type { ConfigUiHints, ConfigUiHint } from '@/api/types';
+import type { ConfigUiHints, ConfigUiHint } from '@/shared/lib/api';
 
 function normalizePath(path: string | Array<string | number>): string {
   if (Array.isArray(path)) {

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

@@ -59,6 +59,14 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatWorkspacePreviewTruncated: { zh: '内容已截断', en: 'Preview truncated' },
   chatSessionUnread: { zh: '会话有未读更新', en: 'Session has unread updates' },
   chatTyping: { zh: 'Agent 正在思考...', en: 'Agent is thinking...' },
+  chatRuntimeInitializing: {
+    zh: '聊天能力正在初始化。你可以先输入内容，完成后即可发送。',
+    en: 'Chat is still initializing. You can keep typing and send once startup finishes.'
+  },
+  chatRuntimeInitializationFailed: {
+    zh: '聊天能力启动失败，请稍后重试或检查服务日志。',
+    en: 'Chat startup failed. Please retry in a moment or inspect the service logs.'
+  },
   chatInputPlaceholder: { zh: '输入消息，输入 / 选择技能，Enter 发送，Shift + Enter 换行', en: 'Type a message, type / to select skills, Enter to send, Shift + Enter for newline' },
   chatInputHint: { zh: '支持多轮上下文，默认走当前会话。', en: 'Multi-turn context is preserved in the current session.' },
   chatSlashSectionCommands: { zh: '命令', en: 'Commands' },

package/src/{lib/i18n.ts → shared/lib/i18n/index.ts}

@@ -1,7 +1,7 @@
-import { AGENT_LABELS } from './i18n.agents';
-import { CHANNEL_LABELS } from './i18n.channels';
-import { CHANNEL_AUTH_LABELS } from './i18n.channel-auth';
-import { CHAT_LABELS } from './i18n.chat';
+import { AGENT_LABELS } from './agents';
+import { CHANNEL_LABELS } from './channels';
+import { CHANNEL_AUTH_LABELS } from './channel-auth';
+import { CHAT_LABELS } from './chat';
 import {
   getLanguage,
   getLocale,
@@ -11,14 +11,14 @@ import {
   setLanguage,
   subscribeLanguageChange,
   type I18nLanguage
-} from './i18n-runtime/i18n-language-owner';
+} from './runtime/i18n-language-owner';
 import { DESKTOP_UPDATE_LABELS } from './desktop-update-labels.utils';
-import { MARKETPLACE_LABELS } from './i18n.marketplace';
-import { PATH_PICKER_LABELS } from './i18n-runtime/i18n.path-picker';
-import { PWA_LABELS } from './i18n.pwa';
-import { REMOTE_LABELS } from './i18n.remote';
-import { RUNTIME_CONTROL_LABELS } from './i18n.runtime-control';
-import { SEARCH_LABELS } from './i18n.search';
+import { MARKETPLACE_LABELS } from './marketplace';
+import { PATH_PICKER_LABELS } from './runtime/i18n.path-picker';
+import { PWA_LABELS } from './pwa';
+import { REMOTE_LABELS } from './remote';
+import { RUNTIME_CONTROL_LABELS } from './runtime-control';
+import { SEARCH_LABELS } from './search';
 export type { I18nLanguage };
 export { getLanguage, getLocale, initializeI18n, LANGUAGE_OPTIONS, resolveInitialLanguage, setLanguage, subscribeLanguageChange };
 export function formatDateTime(value?: string | Date, lang: I18nLanguage = getLanguage()): string {

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

@@ -0,0 +1,94 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+type I18nRuntimeModule = typeof import('./i18n-language-owner');
+
+type MockStorage = {
+  clear: () => void;
+  getItem: (key: string) => string | null;
+  removeItem: (key: string) => void;
+  setItem: (key: string, value: string) => void;
+};
+
+declare global {
+  interface Window {
+    nextclawDesktop?: {
+      localePreference?: 'en' | 'zh' | null;
+      setLocalePreference?: (language: 'en' | 'zh' | null) => Promise<'en' | 'zh' | null>;
+    };
+  }
+}
+
+async function loadOwner(): Promise<I18nRuntimeModule> {
+  vi.resetModules();
+  return await import('./i18n-language-owner');
+}
+
+function createMockStorage(): MockStorage {
+  const state = new Map<string, string>();
+  return {
+    clear: () => state.clear(),
+    getItem: (key) => state.get(key) ?? null,
+    removeItem: (key) => {
+      state.delete(key);
+    },
+    setItem: (key, value) => {
+      state.set(key, value);
+    }
+  };
+}
+
+describe('I18nLanguageOwner', () => {
+  beforeEach(() => {
+    Object.defineProperty(window, 'localStorage', {
+      configurable: true,
+      value: createMockStorage()
+    });
+    window.localStorage.clear();
+    window.nextclawDesktop = undefined;
+    Object.defineProperty(window.navigator, 'language', {
+      configurable: true,
+      value: 'en-US'
+    });
+  });
+
+  afterEach(() => {
+    window.localStorage.clear();
+    window.nextclawDesktop = undefined;
+    vi.restoreAllMocks();
+  });
+
+  it('prefers desktop locale preference over web localStorage', async () => {
+    window.localStorage.setItem('nextclaw.ui.language', 'en');
+    window.nextclawDesktop = {
+      localePreference: 'zh',
+      setLocalePreference: vi.fn(async (language) => language)
+    };
+
+    const owner = await loadOwner();
+
+    expect(owner.initializeI18n()).toBe('zh');
+  });
+
+  it('writes desktop locale preference through the desktop bridge', async () => {
+    const setLocalePreference = vi.fn(async (language: 'en' | 'zh' | null) => language);
+    window.nextclawDesktop = {
+      localePreference: 'en',
+      setLocalePreference
+    };
+
+    const owner = await loadOwner();
+    owner.initializeI18n();
+    owner.setLanguage('zh');
+
+    expect(setLocalePreference).toHaveBeenCalledWith('zh');
+    expect(window.localStorage.getItem('nextclaw.ui.language')).toBeNull();
+  });
+
+  it('keeps using localStorage on web runtimes', async () => {
+    const owner = await loadOwner();
+    owner.initializeI18n();
+    owner.setLanguage('zh');
+
+    expect(window.localStorage.getItem('nextclaw.ui.language')).toBe('zh');
+  });
+});

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

@@ -28,11 +28,22 @@ class I18nLanguageOwner {
     return preferred.startsWith('zh') ? 'zh' : 'en';
   };
 
+  private getDesktopBridge = () => {
+    return typeof window === 'undefined' ? null : window.nextclawDesktop ?? null;
+  };
+
   resolveInitialLanguage = (): I18nLanguage => {
     if (typeof window === 'undefined') {
       return 'en';
     }
 
+    const desktopBridge = this.getDesktopBridge();
+    if (desktopBridge) {
+      return this.isLanguage(desktopBridge.localePreference)
+        ? desktopBridge.localePreference
+        : this.detectBrowserLanguage();
+    }
+
     try {
       const saved = window.localStorage.getItem(I18N_STORAGE_KEY);
       if (this.isLanguage(saved)) {
@@ -63,7 +74,10 @@ class I18nLanguageOwner {
 
     this.activeLanguage = lang;
 
-    if (typeof window !== 'undefined') {
+    const desktopBridge = this.getDesktopBridge();
+    if (desktopBridge) {
+      void desktopBridge.setLocalePreference?.(lang);
+    } else if (typeof window !== 'undefined') {
       try {
         window.localStorage.setItem(I18N_STORAGE_KEY, lang);
       } catch {

package/src/{lib/provider-models.ts → shared/lib/provider-models/index.ts}

@@ -1,4 +1,4 @@
-import type { ConfigMetaView, ConfigView, ProviderConfigView, ThinkingLevel } from '@/api/types';
+import type { ConfigMetaView, ConfigView, ProviderConfigView, ThinkingLevel } from '@/shared/lib/api';
 
 const THINKING_LEVELS: ThinkingLevel[] = ['off', 'minimal', 'low', 'medium', 'high', 'adaptive', 'xhigh'];
 const THINKING_LEVEL_SET = new Set<string>(THINKING_LEVELS);

package/src/shared/lib/session-project/index.ts

@@ -0,0 +1,2 @@
+export * from './session-project.utils';
+export * from './workspace-file-breadcrumb';

package/src/{lib → shared/lib}/session-project/workspace-file-breadcrumb.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { buildWorkspaceFileBreadcrumb } from "@/lib/session-project/workspace-file-breadcrumb";
+import { buildWorkspaceFileBreadcrumb } from "@/shared/lib/session-project";
 
 describe("buildWorkspaceFileBreadcrumb", () => {
   it("builds project-relative breadcrumbs for files inside the active workspace", () => {

package/src/{lib → shared/lib}/session-project/workspace-file-breadcrumb.ts

@@ -1,4 +1,4 @@
-import { getSessionProjectName } from "@/lib/session-project/session-project.utils";
+import { getSessionProjectName } from "@/shared/lib/session-project";
 
 export type WorkspaceFileBreadcrumbSegmentViewModel = {
   key: string;

package/src/{transport/app-client.ts → shared/lib/transport/app-client.service.ts}

@@ -1,6 +1,5 @@
-import { API_BASE } from '@/api/api-base';
-import { LocalAppTransport } from './local.transport';
-import { RemoteSessionMultiplexTransport } from './remote.transport';
+import { LocalAppTransport } from './local-transport.service';
+import { RemoteSessionMultiplexTransport } from './remote-transport.service';
 import type { AppTransport, RemoteRuntimeInfo, RequestInput, StreamInput, StreamSession } from './transport.types';
 
 const REMOTE_RUNTIME_PATH = '/_remote/runtime';
@@ -57,20 +56,20 @@ async function resolveRuntime(apiBase: string): Promise<AppTransport> {
 class AppClient {
   private transportPromise: Promise<AppTransport> | null = null;
 
-  constructor(private readonly apiBase: string = API_BASE) {}
+  constructor(private readonly apiBase: string = import.meta.env.VITE_API_BASE?.trim().replace(/\/$/, '') || (typeof window !== 'undefined' ? window.location.origin : 'http://127.0.0.1:55667')) {}
 
-  private async getTransport(): Promise<AppTransport> {
+  private getTransport = async (): Promise<AppTransport> => {
     if (!this.transportPromise) {
       this.transportPromise = resolveRuntime(this.apiBase);
     }
     return await this.transportPromise;
-  }
+  };
 
-  async request<T>(input: RequestInput): Promise<T> {
+  request = async <T>(input: RequestInput): Promise<T> => {
     return await (await this.getTransport()).request<T>(input);
-  }
+  };
 
-  openStream<TFinal = unknown>(input: StreamInput): StreamSession<TFinal> {
+  openStream = <TFinal = unknown>(input: StreamInput): StreamSession<TFinal> => {
     let currentSession: StreamSession<TFinal> | null = null;
     let resolveFinished!: (value: TFinal) => void;
     let rejectFinished!: (error: Error) => void;
@@ -94,9 +93,9 @@ class AppClient {
       finished,
       cancel: () => currentSession?.cancel()
     };
-  }
+  };
 
-  subscribe(handler: (event: Parameters<Parameters<AppTransport['subscribe']>[0]>[0]) => void): () => void {
+  subscribe = (handler: (event: Parameters<Parameters<AppTransport['subscribe']>[0]>[0]) => void): () => void => {
     let unsubscribe = () => {};
     let active = true;
     void this.getTransport().then((transport) => {
@@ -117,7 +116,7 @@ class AppClient {
       active = false;
       unsubscribe();
     };
-  }
+  };
 }
 
 export const appClient = new AppClient();

package/src/{transport → shared/lib/transport}/app-client.test.ts

@@ -10,6 +10,12 @@ describe('appClient runtime detection', () => {
     vi.unstubAllGlobals();
   });
 
+  it('imports without triggering an API_BASE initialization cycle', async () => {
+    const { appClient } = await import('./app-client.service');
+
+    expect(appClient).toBeDefined();
+  });
+
   it('falls back to LocalAppTransport when runtime probe returns html', async () => {
     const fetchMock = vi.fn().mockResolvedValue(
       new Response('<html>ui shell</html>', {
@@ -21,12 +27,16 @@ describe('appClient runtime detection', () => {
     );
     vi.stubGlobal('fetch', fetchMock);
 
-    const { LocalAppTransport } = await import('@/transport/local.transport');
-    const localRequest = vi
-      .spyOn(LocalAppTransport.prototype, 'request')
-      .mockResolvedValue({ ok: true } as never);
+    const localRequest = vi.fn().mockResolvedValue({ ok: true } as never);
+    vi.doMock('./local-transport.service', () => ({
+      LocalAppTransport: class {
+        request = localRequest;
+        openStream = vi.fn();
+        subscribe = vi.fn();
+      }
+    }));
 
-    const { appClient } = await import('@/transport/app-client');
+    const { appClient } = await import('./app-client.service');
     const result = await appClient.request<{ ok: boolean }>({
       method: 'GET',
       path: '/api/config'

package/src/{transport → shared/lib/transport}/index.ts

@@ -1,4 +1,4 @@
-export { appClient } from './app-client';
+export { appClient } from './app-client.service';
 export type {
   AppEvent,
   AppTransport,