@nextclaw/ui 0.11.20 → 0.11.22

package/src/components/path-picker/server-path-picker-dialog.tsx

@@ -0,0 +1,282 @@
+import { useEffect, useMemo, useState } from 'react';
+import { ChevronRight, Folder, FolderUp, Home, RefreshCcw, Search } from 'lucide-react';
+import { useServerPathBrowse } from '@/hooks/server-path/use-server-path-browse';
+import { Button } from '@/components/ui/button';
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from '@/components/ui/dialog';
+import { Input } from '@/components/ui/input';
+import { Label } from '@/components/ui/label';
+import { ScrollArea } from '@/components/ui/scroll-area';
+import { t } from '@/lib/i18n';
+
+type ServerPathPickerDialogProps = {
+  open: boolean;
+  currentPath?: string | null;
+  isSaving: boolean;
+  onOpenChange: (open: boolean) => void;
+  onConfirm: (path: string) => Promise<void> | void;
+  title: string;
+  description?: string;
+  pathLabel: string;
+  pathPlaceholder?: string;
+  confirmLabel: string;
+  hint?: string;
+};
+
+export function ServerPathPickerDialog({
+  open,
+  currentPath,
+  isSaving,
+  onOpenChange,
+  onConfirm,
+  title,
+  description,
+  pathLabel,
+  pathPlaceholder,
+  confirmLabel,
+  hint,
+}: ServerPathPickerDialogProps) {
+  const [draftPath, setDraftPath] = useState('');
+  const [browsePath, setBrowsePath] = useState<string | null>(null);
+  const [searchText, setSearchText] = useState('');
+
+  useEffect(() => {
+    if (!open) {
+      return;
+    }
+    const nextPath = currentPath?.trim() || null;
+    setDraftPath(nextPath ?? '');
+    setBrowsePath(nextPath);
+    setSearchText('');
+  }, [currentPath, open]);
+
+  const browseQuery = useServerPathBrowse({
+    path: browsePath,
+    enabled: open,
+  });
+
+  useEffect(() => {
+    if (!open || !browseQuery.data) {
+      return;
+    }
+    if (draftPath.trim().length === 0) {
+      setDraftPath(browseQuery.data.currentPath);
+    }
+  }, [browseQuery.data, draftPath, open]);
+
+  const normalizedDraftPath = draftPath.trim();
+  const submitDisabled = normalizedDraftPath.length === 0 || isSaving;
+  const errorMessage = useMemo(() => {
+    if (!browseQuery.error) {
+      return null;
+    }
+    return browseQuery.error instanceof Error
+      ? browseQuery.error.message
+      : String(browseQuery.error);
+  }, [browseQuery.error]);
+
+  const normalizedSearchText = searchText.trim().toLowerCase();
+  const filteredEntries = useMemo(() => {
+    const entries = browseQuery.data?.entries ?? [];
+    if (normalizedSearchText.length === 0) {
+      return entries;
+    }
+    return entries.filter((entry) => {
+      const normalizedName = entry.name.toLowerCase();
+      const normalizedPath = entry.path.toLowerCase();
+      return (
+        normalizedName.includes(normalizedSearchText) ||
+        normalizedPath.includes(normalizedSearchText)
+      );
+    });
+  }, [browseQuery.data?.entries, normalizedSearchText]);
+
+  const navigateTo = (path: string | null) => {
+    setBrowsePath(path);
+    setSearchText('');
+    if (path) {
+      setDraftPath(path);
+    }
+  };
+
+  return (
+    <Dialog
+      open={open}
+      onOpenChange={(nextOpen) => {
+        if (isSaving) {
+          return;
+        }
+        onOpenChange(nextOpen);
+      }}
+    >
+      <DialogContent className="max-h-[85vh] overflow-hidden sm:h-[42rem] sm:max-w-2xl sm:grid-rows-[auto_minmax(0,1fr)]">
+        <DialogHeader>
+          <DialogTitle>{title}</DialogTitle>
+          {description ? (
+            <DialogDescription>{description}</DialogDescription>
+          ) : null}
+        </DialogHeader>
+        <form
+          className="flex min-h-0 flex-col gap-4"
+          onSubmit={(event) => {
+            event.preventDefault();
+            if (submitDisabled) {
+              return;
+            }
+            void onConfirm(normalizedDraftPath);
+          }}
+        >
+          <div className="space-y-2">
+            <Label htmlFor="server-path-picker-input">{pathLabel}</Label>
+            <div className="flex gap-2">
+              <Input
+                id="server-path-picker-input"
+                value={draftPath}
+                onChange={(event) => setDraftPath(event.target.value)}
+                placeholder={pathPlaceholder}
+                autoFocus
+                disabled={isSaving}
+              />
+              <Button
+                type="button"
+                variant="outline"
+                onClick={() => navigateTo(normalizedDraftPath || null)}
+                disabled={isSaving}
+              >
+                {t('openPath')}
+              </Button>
+            </div>
+          </div>
+
+          <div className="flex min-h-0 flex-1 flex-col overflow-hidden rounded-2xl border border-gray-200 bg-gray-50/70">
+            <div className="flex flex-wrap items-center gap-2 border-b border-gray-200 px-3 py-2">
+              <Button
+                type="button"
+                variant="ghost"
+                size="sm"
+                onClick={() => navigateTo(browseQuery.data?.homePath ?? null)}
+                disabled={isSaving || browseQuery.isLoading}
+              >
+                <Home className="mr-1 h-4 w-4" />
+                {t('homeDirectory')}
+              </Button>
+              <Button
+                type="button"
+                variant="ghost"
+                size="sm"
+                onClick={() => navigateTo(browseQuery.data?.parentPath ?? null)}
+                disabled={!browseQuery.data?.parentPath || isSaving || browseQuery.isLoading}
+              >
+                <FolderUp className="mr-1 h-4 w-4" />
+                {t('parentDirectory')}
+              </Button>
+              <Button
+                type="button"
+                variant="ghost"
+                size="sm"
+                onClick={() => {
+                  void browseQuery.refetch();
+                }}
+                disabled={isSaving || browseQuery.isLoading}
+              >
+                <RefreshCcw className="mr-1 h-4 w-4" />
+                {t('chatRefresh')}
+              </Button>
+            </div>
+
+            <div className="border-b border-gray-200 px-3 py-2">
+              <div className="mb-2 text-xs font-medium text-gray-500">
+                {t('currentDirectory')}
+              </div>
+              <div className="flex flex-wrap items-center gap-1 text-xs text-gray-600">
+                {browseQuery.data?.breadcrumbs.map((breadcrumb, index) => (
+                  <div key={breadcrumb.path} className="flex items-center gap-1">
+                    <button
+                      type="button"
+                      className="rounded px-1.5 py-0.5 hover:bg-gray-200"
+                      onClick={() => navigateTo(breadcrumb.path)}
+                      disabled={isSaving}
+                    >
+                      {breadcrumb.label}
+                    </button>
+                    {index < browseQuery.data.breadcrumbs.length - 1 ? (
+                      <ChevronRight className="h-3 w-3 text-gray-400" />
+                    ) : null}
+                  </div>
+                ))}
+              </div>
+            </div>
+
+            <div className="border-b border-gray-200 px-3 py-2">
+              <div className="relative">
+                <Search className="pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-gray-400" />
+                <Input
+                  value={searchText}
+                  onChange={(event) => setSearchText(event.target.value)}
+                  placeholder={t('pathPickerSearchPlaceholder')}
+                  disabled={isSaving || browseQuery.isLoading}
+                  className="pl-9"
+                />
+              </div>
+            </div>
+
+            <ScrollArea className="min-h-0 flex-1 px-2 py-2">
+              {browseQuery.isLoading ? (
+                <div className="px-2 py-6 text-sm text-gray-500">{t('loading')}</div>
+              ) : errorMessage ? (
+                <div className="px-2 py-4 text-sm text-destructive">
+                  {t('pathBrowseFailed')}: {errorMessage}
+                </div>
+              ) : browseQuery.data && filteredEntries.length > 0 ? (
+                <div className="space-y-1">
+                  {filteredEntries.map((entry) => (
+                    <button
+                      key={entry.path}
+                      type="button"
+                      className="flex w-full items-center gap-2 rounded-xl px-3 py-2 text-left text-sm text-gray-700 transition-colors hover:bg-white"
+                      onClick={() => navigateTo(entry.path)}
+                      disabled={isSaving}
+                    >
+                      <Folder className="h-4 w-4 shrink-0 text-emerald-600" />
+                      <span className="truncate">{entry.name}</span>
+                    </button>
+                  ))}
+                </div>
+              ) : browseQuery.data && browseQuery.data.entries.length > 0 ? (
+                <div className="px-2 py-6 text-sm text-gray-500">
+                  {t('pathPickerSearchEmpty')}
+                </div>
+              ) : (
+                <div className="px-2 py-6 text-sm text-gray-500">{t('emptyDirectory')}</div>
+              )}
+            </ScrollArea>
+          </div>
+
+          {hint ? (
+            <p className="text-xs leading-relaxed text-gray-500">{hint}</p>
+          ) : null}
+
+          <DialogFooter>
+            <Button
+              type="button"
+              variant="outline"
+              onClick={() => onOpenChange(false)}
+              disabled={isSaving}
+            >
+              {t('cancel')}
+            </Button>
+            <Button type="submit" disabled={submitDisabled}>
+              {isSaving ? t('saving') : confirmLabel}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/src/hooks/server-path/use-server-path-browse.ts

@@ -0,0 +1,19 @@
+import { useQuery } from '@tanstack/react-query';
+import { fetchServerPathBrowse } from '@/api/server-path';
+
+export function useServerPathBrowse(params: {
+  path?: string | null;
+  includeFiles?: boolean;
+  enabled?: boolean;
+}) {
+  return useQuery({
+    queryKey: ['server-path-browse', params.path ?? null, params.includeFiles ?? false],
+    queryFn: () =>
+      fetchServerPathBrowse({
+        path: params.path,
+        includeFiles: params.includeFiles,
+      }),
+    enabled: params.enabled ?? true,
+    staleTime: 0,
+  });
+}

package/src/hooks/useConfig.ts

@@ -26,7 +26,13 @@ import {
   setCronJobEnabled,
   runCronJob
 } from '@/api/config';
-import { deleteNcpSession, fetchNcpSessionMessages, fetchNcpSessions, updateNcpSession } from '@/api/ncp-session';
+import {
+  deleteNcpSession,
+  fetchNcpSessionMessages,
+  fetchNcpSessionSkills,
+  fetchNcpSessions,
+  updateNcpSession
+} from '@/api/ncp-session';
 import { toast } from 'sonner';
 import { t } from '@/lib/i18n';
 
@@ -248,6 +254,24 @@ export function useNcpSessionMessages(sessionId: string | null, limit = 200) {
   });
 }
 
+export function useNcpSessionSkills(params: {
+  sessionId: string | null;
+  projectRoot?: string | null;
+}) {
+  return useQuery({
+    queryKey: ['ncp-session-skills', params.sessionId, params.projectRoot ?? null],
+    queryFn: () =>
+      fetchNcpSessionSkills(params.sessionId as string, {
+        ...(Object.prototype.hasOwnProperty.call(params, 'projectRoot')
+          ? { projectRoot: params.projectRoot ?? null }
+          : {})
+      }),
+    enabled: Boolean(params.sessionId),
+    staleTime: 5_000,
+    retry: false
+  });
+}
+
 export function useDeleteNcpSession() {
   const queryClient = useQueryClient();
 
@@ -272,6 +296,7 @@ export function useUpdateNcpSession() {
       updateNcpSession(sessionId, data),
     onSuccess: (data) => {
       upsertNcpSessionSummaryInQueryClient(queryClient, data);
+      queryClient.invalidateQueries({ queryKey: ['ncp-session-skills', data.sessionId] });
       toast.success(t('configSavedApplied'));
     },
     onError: (error: Error) => {

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

@@ -0,0 +1,94 @@
+export type I18nLanguage = 'zh' | 'en';
+
+const I18N_STORAGE_KEY = 'nextclaw.ui.language';
+const LANGUAGE_TO_LOCALE: Record<I18nLanguage, string> = {
+  en: 'en-US',
+  zh: 'zh-CN'
+};
+
+export const LANGUAGE_OPTIONS: Array<{ value: I18nLanguage; label: string }> = [
+  { value: 'en', label: 'English' },
+  { value: 'zh', label: '中文' }
+];
+
+class I18nLanguageOwner {
+  private activeLanguage: I18nLanguage = 'en';
+  private initialized = false;
+  private readonly listeners = new Set<(lang: I18nLanguage) => void>();
+
+  private isLanguage = (value: unknown): value is I18nLanguage => {
+    return value === 'en' || value === 'zh';
+  };
+
+  private detectBrowserLanguage = (): I18nLanguage => {
+    if (typeof navigator === 'undefined') {
+      return 'en';
+    }
+    const preferred = navigator.language?.toLowerCase() ?? 'en';
+    return preferred.startsWith('zh') ? 'zh' : 'en';
+  };
+
+  resolveInitialLanguage = (): I18nLanguage => {
+    if (typeof window === 'undefined') {
+      return 'en';
+    }
+
+    try {
+      const saved = window.localStorage.getItem(I18N_STORAGE_KEY);
+      if (this.isLanguage(saved)) {
+        return saved;
+      }
+    } catch {
+      // ignore storage failures
+    }
+
+    return this.detectBrowserLanguage();
+  };
+
+  initialize = (): I18nLanguage => {
+    if (!this.initialized) {
+      this.activeLanguage = this.resolveInitialLanguage();
+      this.initialized = true;
+    }
+    return this.activeLanguage;
+  };
+
+  getLanguage = (): I18nLanguage => (this.initialized ? this.activeLanguage : this.initialize());
+
+  setLanguage = (lang: I18nLanguage): void => {
+    this.initialize();
+    if (this.activeLanguage === lang) {
+      return;
+    }
+
+    this.activeLanguage = lang;
+
+    if (typeof window !== 'undefined') {
+      try {
+        window.localStorage.setItem(I18N_STORAGE_KEY, lang);
+      } catch {
+        // ignore storage failures
+      }
+    }
+
+    this.listeners.forEach((listener) => listener(lang));
+  };
+
+  subscribeLanguageChange = (listener: (lang: I18nLanguage) => void): (() => void) => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+
+  getLocale = (lang: I18nLanguage = this.getLanguage()): string => LANGUAGE_TO_LOCALE[lang];
+}
+
+const owner = new I18nLanguageOwner();
+
+export const resolveInitialLanguage = owner.resolveInitialLanguage;
+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;

package/src/lib/i18n/i18n.path-picker.ts

@@ -0,0 +1,12 @@
+export const PATH_PICKER_LABELS: Record<string, { zh: string; en: string }> = {
+  browse: { zh: '浏览', en: 'Browse' },
+  openPath: { zh: '打开', en: 'Open' },
+  homeDirectory: { zh: '主目录', en: 'Home' },
+  currentDirectory: { zh: '当前目录', en: 'Current Directory' },
+  parentDirectory: { zh: '上一级', en: 'Up' },
+  pathPickerSearchPlaceholder: { zh: '搜索当前目录', en: 'Search current directory' },
+  pathPickerSearchEmpty: { zh: '当前目录下没有匹配结果。', en: 'No matching entries in the current directory.' },
+  selectCurrentDirectory: { zh: '选择当前目录', en: 'Select Current Directory' },
+  emptyDirectory: { zh: '当前目录下暂无可浏览项。', en: 'No entries in the current directory.' },
+  pathBrowseFailed: { zh: '读取目录失败', en: 'Failed to load directory' },
+};

package/src/lib/i18n.chat.ts

@@ -50,11 +50,18 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatSlashTypeCommand: { zh: '命令', en: 'Command' },
   chatSlashTypeSkill: { zh: '技能', en: 'Skill' },
   chatSlashSkillSpec: { zh: '标识', en: 'Spec' },
+  chatSlashSkillScope: { zh: '作用域', en: 'Scope' },
   chatSlashLoading: { zh: '加载命令与技能中…', en: 'Loading commands and skills…' },
   chatSlashNoResult: { zh: '无匹配项', en: 'No matches' },
   chatSlashHint: { zh: '输入 / 触发命令或技能选择', en: 'Type / to access commands and skills' },
   chatSlashCommandHint: { zh: '回车插入命令，继续输入参数后发送。', en: 'Press Enter to insert command, then add args and send.' },
   chatSlashSkillHint: { zh: '回车把该技能加入本轮请求。', en: 'Press Enter to add this skill for the next turn.' },
+  chatSkillScopeProject: { zh: '项目', en: 'Project' },
+  chatSkillScopeWorkspace: { zh: '工作区', en: 'Workspace' },
+  chatPickerRecent: { zh: '最近使用', en: 'Recent' },
+  chatPickerRecentModels: { zh: '最近选择', en: 'Recent' },
+  chatPickerAllModels: { zh: '全部模型', en: 'All models' },
+  chatPickerAllSkills: { zh: '全部技能', en: 'All skills' },
   chatSend: { zh: '发送', en: 'Send' },
   chatStop: { zh: '停止', en: 'Stop' },
   chatStopPreparing: { zh: '正在建立可停止会话，请稍候…', en: 'Preparing stoppable run…' },
@@ -66,6 +73,22 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatQueueMoveFirst: { zh: '置顶到下一条', en: 'Move to Next' },
   chatDeleteSession: { zh: '删除会话', en: 'Delete Session' },
   chatDeleteSessionConfirm: { zh: '确认删除当前会话？', en: 'Delete the current session?' },
+  chatSessionMoreActions: { zh: '更多操作', en: 'More actions' },
+  chatSessionSetProject: { zh: '设置项目目录', en: 'Set Project Directory' },
+  chatSessionClearProject: { zh: '清除项目目录', en: 'Clear Project Directory' },
+  chatSessionProjectDialogTitle: { zh: '设置项目目录', en: 'Set Project Directory' },
+  chatSessionProjectDialogDescription: {
+    zh: '把当前会话绑定到运行 NextClaw 服务的那台机器上的一个目录，让后续消息和工具执行围绕这个目录展开。',
+    en: 'Bind this session to a directory on the machine running the NextClaw service so future messages and tool runs work around that directory.'
+  },
+  chatSessionProjectPathLabel: { zh: '项目目录路径', en: 'Project Directory Path' },
+  chatSessionProjectPathPlaceholder: { zh: '/path/to/project', en: '/path/to/project' },
+  chatSessionProjectUpdateHint: {
+    zh: '这里浏览和选择的是服务端机器上的目录。修改项目目录只影响后续消息和后续工具执行，不会改写历史会话。',
+    en: 'The browser lists directories from the server machine. Changing the project directory only affects future messages and tool runs. History stays unchanged.'
+  },
+  chatSessionProjectUpdated: { zh: '项目目录已更新', en: 'Project directory updated' },
+  chatSessionProjectCleared: { zh: '项目目录已清除', en: 'Project directory cleared' },
   chatSendFailed: { zh: '发送消息失败', en: 'Failed to send message' },
   chatRoleUser: { zh: '你', en: 'You' },
   chatRoleAssistant: { zh: '助手', en: 'Assistant' },
@@ -74,9 +97,10 @@ export const CHAT_LABELS: Record<string, { zh: string; en: string }> = {
   chatRoleMessage: { zh: '消息', en: 'Message' },
   chatToolCall: { zh: '工具调用', en: 'Tool Call' },
   chatToolResult: { zh: '工具结果', en: 'Tool Result' },
+  chatToolInput: { zh: '输入', en: 'Input' },
   chatToolWorkflow: { zh: '工具工作流', en: 'Tool Workflow' },
   chatToolWorkflowDetails: { zh: '展开查看参数和结果', en: 'Expand to view params and results' },
-  chatToolOutput: { zh: '查看输出', en: 'View Output' },
+  chatToolOutput: { zh: '输出', en: 'Output' },
   chatToolNoOutput: { zh: '无输出（执行完成）', en: 'No output (completed)' },
   chatToolStatusPreparing: { zh: '准备中', en: 'Preparing' },
   chatToolStatusRunning: { zh: '执行中', en: 'Running' },

package/src/lib/i18n.ts

@@ -1,94 +1,30 @@
 import { CHANNEL_LABELS } from './i18n.channels';
 import { CHANNEL_AUTH_LABELS } from './i18n.channel-auth';
 import { CHAT_LABELS } from './i18n.chat';
+import {
+  getLanguage,
+  getLocale,
+  initializeI18n,
+  LANGUAGE_OPTIONS,
+  resolveInitialLanguage,
+  setLanguage,
+  subscribeLanguageChange,
+  type I18nLanguage
+} from './i18n/i18n-language-owner';
 import { MARKETPLACE_LABELS } from './i18n.marketplace';
+import { PATH_PICKER_LABELS } from './i18n/i18n.path-picker';
 import { REMOTE_LABELS } from './i18n.remote';
-export type I18nLanguage = 'zh' | 'en';
-const I18N_STORAGE_KEY = 'nextclaw.ui.language';
-export const LANGUAGE_OPTIONS: Array<{ value: I18nLanguage; label: string }> = [
-  { value: 'en', label: 'English' },
-  { value: 'zh', label: '中文' }
-];
-const LANGUAGE_TO_LOCALE: Record<I18nLanguage, string> = {
-  en: 'en-US',
-  zh: 'zh-CN'
+export type { I18nLanguage };
+export {
+  getLanguage,
+  getLocale,
+  initializeI18n,
+  LANGUAGE_OPTIONS,
+  resolveInitialLanguage,
+  setLanguage,
+  subscribeLanguageChange
 };
 
-let activeLanguage: I18nLanguage = 'en';
-let initialized = false;
-const listeners = new Set<(lang: I18nLanguage) => void>();
-
-function isLanguage(value: unknown): value is I18nLanguage {
-  return value === 'en' || value === 'zh';
-}
-
-function detectBrowserLanguage(): I18nLanguage {
-  if (typeof navigator === 'undefined') {
-    return 'en';
-  }
-  const preferred = navigator.language?.toLowerCase() ?? 'en';
-  return preferred.startsWith('zh') ? 'zh' : 'en';
-}
-
-export function resolveInitialLanguage(): I18nLanguage {
-  if (typeof window === 'undefined') {
-    return 'en';
-  }
-
-  try {
-    const saved = window.localStorage.getItem(I18N_STORAGE_KEY);
-    if (isLanguage(saved)) {
-      return saved;
-    }
-  } catch {
-    // ignore storage failures
-  }
-
-  return detectBrowserLanguage();
-}
-
-export function initializeI18n(): I18nLanguage {
-  if (!initialized) {
-    activeLanguage = resolveInitialLanguage();
-    initialized = true;
-  }
-  return activeLanguage;
-}
-
-export function getLanguage(): I18nLanguage {
-  return initialized ? activeLanguage : initializeI18n();
-}
-
-export function setLanguage(lang: I18nLanguage): void {
-  initializeI18n();
-  if (activeLanguage === lang) {
-    return;
-  }
-
-  activeLanguage = lang;
-
-  if (typeof window !== 'undefined') {
-    try {
-      window.localStorage.setItem(I18N_STORAGE_KEY, lang);
-    } catch {
-      // ignore storage failures
-    }
-  }
-
-  listeners.forEach((listener) => listener(lang));
-}
-
-export function subscribeLanguageChange(listener: (lang: I18nLanguage) => void): () => void {
-  listeners.add(listener);
-  return () => {
-    listeners.delete(listener);
-  };
-}
-
-export function getLocale(lang: I18nLanguage = getLanguage()): string {
-  return LANGUAGE_TO_LOCALE[lang];
-}
-
 export function formatDateTime(value?: string | Date, lang: I18nLanguage = getLanguage()): string {
   if (!value) {
     return '-';
@@ -624,6 +560,7 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   docBrowserNewTab: { zh: '新建标签', en: 'New Tab' },
   docBrowserCloseTab: { zh: '关闭标签', en: 'Close Tab' },
   docBrowserTabUntitled: { zh: '未命名', en: 'Untitled' },
+  ...PATH_PICKER_LABELS,
   ...CHANNEL_AUTH_LABELS,
 };
 

package/src/lib/session-project/session-project.utils.ts

@@ -0,0 +1,30 @@
+function trimOptionalString(value: unknown): string | null {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
+export function normalizeSessionProjectRootValue(value: unknown): string | null {
+  return trimOptionalString(value);
+}
+
+export function getSessionProjectName(
+  projectRoot: string | null | undefined,
+): string | null {
+  const normalizedProjectRoot = trimOptionalString(projectRoot);
+  if (!normalizedProjectRoot) {
+    return null;
+  }
+
+  const trimmedTrailingSeparators = normalizedProjectRoot.replace(/[\\/]+$/, "");
+  if (!trimmedTrailingSeparators) {
+    return normalizedProjectRoot;
+  }
+
+  const pathSegments = trimmedTrailingSeparators
+    .split(/[\\/]/)
+    .filter(Boolean);
+  return pathSegments[pathSegments.length - 1] ?? trimmedTrailingSeparators;
+}