@nextclaw/ui 0.15.19 → 0.15.21

package/src/features/chat/features/input/input-surface-plugins/__tests__/slash-command-plugin.test.ts

@@ -86,6 +86,7 @@ describe('createSlashCommandInputSurfacePlugin', () => {
     const state = resolveChatInputSurfaceState({
       data: {
         isPanelAppsLoading: false,
+        isProjectsLoading: false,
         isServerPathSearchLoading: false,
         isSkillsLoading: false,
         panelApps: [
@@ -96,8 +97,10 @@ describe('createSlashCommandInputSurfacePlugin', () => {
           }),
         ],
         projectRoot: '/tmp/project',
+        projects: [],
+        projectsError: null,
         recentSkillValues: [],
-        referencePath: null,
+        referenceLocation: { view: 'root' },
         serverPathEntries: [],
         serverPathSearchError: null,
         skillRecords: [
@@ -153,12 +156,15 @@ describe('createSlashCommandInputSurfacePlugin', () => {
     const state = resolveChatInputSurfaceState({
       data: {
         isPanelAppsLoading: false,
+        isProjectsLoading: false,
         isServerPathSearchLoading: false,
         isSkillsLoading: false,
         panelApps: [],
         projectRoot: '/tmp/project',
+        projects: [],
+        projectsError: null,
         recentSkillValues: [],
-        referencePath: null,
+        referenceLocation: { view: 'root' },
         serverPathEntries: [],
         serverPathSearchError: null,
         skillRecords: [
@@ -202,12 +208,15 @@ describe('createSlashCommandInputSurfacePlugin', () => {
     const state = resolveChatInputSurfaceState({
       data: {
         isPanelAppsLoading: false,
+        isProjectsLoading: false,
         isServerPathSearchLoading: false,
         isSkillsLoading: false,
         panelApps: [],
         projectRoot: '/tmp/project',
+        projects: [],
+        projectsError: null,
         recentSkillValues: [],
-        referencePath: null,
+        referenceLocation: { view: 'root' },
         serverPathEntries: [],
         serverPathSearchError: null,
         skillRecords: [],
@@ -233,6 +242,7 @@ describe('createSlashCommandInputSurfacePlugin', () => {
     const state = resolveChatInputSurfaceState({
       data: {
         isPanelAppsLoading: false,
+        isProjectsLoading: false,
         isServerPathSearchLoading: false,
         isSkillsLoading: false,
         panelApps: [
@@ -243,8 +253,10 @@ describe('createSlashCommandInputSurfacePlugin', () => {
           }),
         ],
         projectRoot: '/tmp/project',
+        projects: [],
+        projectsError: null,
         recentSkillValues: [],
-        referencePath: null,
+        referenceLocation: { view: 'root' },
         serverPathEntries: [],
         serverPathSearchError: null,
         skillRecords: [],

package/src/features/chat/features/input/input-surface-plugins/chat-input-product-plugin-adapters.types.ts

@@ -1,14 +1,22 @@
 import type { ChatSkillRecord } from '@/features/chat/types/chat-input-bar.types';
-import type { PanelAppEntryView, ServerPathSearchEntryView } from '@/shared/lib/api';
+import type { PanelAppEntryView, ProjectView, ServerPathSearchEntryView } from '@/shared/lib/api';
+
+export type ContextReferenceLocation =
+  | { view: 'root' }
+  | { view: 'files'; path: string }
+  | { view: 'projects' };
 
 export type ChatInputProductPluginData = {
   isPanelAppsLoading: boolean;
+  isProjectsLoading: boolean;
   isServerPathSearchLoading: boolean;
   isSkillsLoading: boolean;
   panelApps: readonly PanelAppEntryView[];
   projectRoot: string;
+  projects: readonly ProjectView[];
+  projectsError: string | null;
   recentSkillValues: readonly string[];
-  referencePath: string | null;
+  referenceLocation: ContextReferenceLocation;
   serverPathEntries: readonly ServerPathSearchEntryView[];
   serverPathSearchError: string | null;
   skillRecords: readonly ChatSkillRecord[];

package/src/features/chat/features/input/input-surface-plugins/context-reference-items.utils.ts

@@ -0,0 +1,240 @@
+import type { ChatInputSurfaceItem } from '@nextclaw/agent-chat-ui';
+import {
+  CHAT_PROJECT_TOKEN_KIND,
+  CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
+  CHAT_WORKSPACE_FILE_TOKEN_KIND,
+} from '@nextclaw/shared';
+import type { ProjectView, ServerPathSearchEntryView } from '@/shared/lib/api';
+import type { ContextReferenceLocation } from './chat-input-product-plugin-adapters.types';
+import {
+  resolveInputSurfaceMatchTier,
+  scoreInputSurfaceSearchCandidate,
+} from './input-surface-search.utils';
+
+export const FILES_NAVIGATION_ITEM_KEY = 'context-reference:navigate:files';
+export const PROJECTS_NAVIGATION_ITEM_KEY = 'context-reference:navigate:projects';
+export const ROOT_NAVIGATION_ITEM_KEY = 'context-reference:navigate:root';
+
+const WORKSPACE_SECTION_KEY = 'workspace';
+const PROJECT_SECTION_KEY = 'projects';
+
+export type ContextReferenceInputSurfaceTexts = {
+  backLabel: string;
+  backDescription: string;
+  backHintLabel: string;
+  currentDirectoryLabel: string;
+  directoryDescription: string;
+  fileDescription: string;
+  filesDescription: string;
+  filesHintLabel: string;
+  filesLabel: string;
+  filesSubtitle: string;
+  panelAppSectionLabel: string;
+  parentLabel: string;
+  parentDescription: string;
+  parentHintLabel: string;
+  projectDescription: string;
+  projectPathLabel: string;
+  projectSectionLabel: string;
+  projectSubtitle: string;
+  projectsDescription: string;
+  projectsHintLabel: string;
+  projectsLabel: string;
+  projectsLoadFailedLabel: string;
+  projectsSubtitle: string;
+  projectRootLabel: string;
+  searchFailedLabel: string;
+  workspaceSectionLabel: string;
+};
+
+function resolveProjectLabel(projectRoot: string): string {
+  return projectRoot.split(/[\\/]+/).filter(Boolean).at(-1) ?? projectRoot;
+}
+
+function buildPathPreview(params: {
+  kind: 'directory' | 'file';
+  projectRoot: string;
+  relativePath: string;
+}) {
+  const { kind, projectRoot, relativePath } = params;
+  const pathSegments = relativePath.split('/').filter(Boolean);
+  return {
+    rootLabel: resolveProjectLabel(projectRoot),
+    segments: pathSegments.map((label, index) => ({
+      label,
+      kind: index === pathSegments.length - 1 ? kind : 'directory' as const,
+    })),
+  };
+}
+
+export function buildProjectReferenceItems(params: {
+  projects: readonly ProjectView[];
+  query: string;
+  texts: ContextReferenceInputSurfaceTexts;
+}): ChatInputSurfaceItem[] {
+  const collator = new Intl.Collator(undefined, { sensitivity: 'base', numeric: true });
+  return params.projects
+    .map((project, order) => ({
+      order,
+      project,
+      score: scoreInputSurfaceSearchCandidate(
+        {
+          id: project.rootPath,
+          label: project.name,
+          description: project.rootPath,
+          aliases: project.template ? [project.template] : [],
+        },
+        params.query,
+      ),
+    }))
+    .filter(({ score }) => score > 0)
+    .sort((left, right) => {
+      const leftTier = resolveInputSurfaceMatchTier(left.score);
+      const rightTier = resolveInputSurfaceMatchTier(right.score);
+      if (rightTier !== leftTier) {
+        return rightTier - leftTier;
+      }
+      if (right.score !== left.score) {
+        return right.score - left.score;
+      }
+      return collator.compare(left.project.name, right.project.name) || left.order - right.order;
+    })
+    .map(({ project }) => ({
+      key: `context-reference:project:${project.rootPath}`,
+      icon: 'project',
+      title: project.name,
+      subtitle: params.texts.projectSubtitle,
+      description: params.texts.projectDescription,
+      detailLines: [`${params.texts.projectPathLabel}: ${project.rootPath}`],
+      sectionKey: PROJECT_SECTION_KEY,
+      sectionLabel: params.texts.projectSectionLabel,
+      value: project.rootPath,
+      tokenKind: CHAT_PROJECT_TOKEN_KIND,
+      tokenKey: project.rootPath,
+    }));
+}
+
+export function buildWorkspaceReferenceItems(params: {
+  entries: readonly ServerPathSearchEntryView[];
+  navigateDirectories: boolean;
+  projectRoot: string;
+  texts: ContextReferenceInputSurfaceTexts;
+}): ChatInputSurfaceItem[] {
+  const projectLabel = resolveProjectLabel(params.projectRoot);
+  return params.entries.map((entry) => {
+    const navigates = params.navigateDirectories && entry.kind === 'directory';
+    return {
+      key: `workspace:${entry.kind}:${entry.relativePath}`,
+      icon: entry.kind === 'directory' ? 'folder' : 'file',
+      title: entry.name,
+      subtitle: entry.parentRelativePath || projectLabel,
+      description: entry.kind === 'directory'
+        ? params.texts.directoryDescription
+        : params.texts.fileDescription,
+      detailLines: [
+        `${params.texts.projectRootLabel}: ${params.projectRoot}`,
+        entry.relativePath,
+      ],
+      sectionKey: WORKSPACE_SECTION_KEY,
+      sectionLabel: params.texts.workspaceSectionLabel,
+      value: entry.relativePath,
+      tokenKind: navigates
+        ? undefined
+        : entry.kind === 'directory'
+          ? CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND
+          : CHAT_WORKSPACE_FILE_TOKEN_KIND,
+      tokenKey: navigates ? undefined : entry.relativePath,
+      selectionBehavior: navigates ? 'navigate' : undefined,
+      pathPreview: buildPathPreview({
+        kind: entry.kind,
+        projectRoot: params.projectRoot,
+        relativePath: entry.relativePath,
+      }),
+    } satisfies ChatInputSurfaceItem;
+  });
+}
+
+export function buildCurrentDirectoryReferenceItem(params: {
+  projectRoot: string;
+  referencePath: string;
+  texts: ContextReferenceInputSurfaceTexts;
+}): ChatInputSurfaceItem {
+  const { projectRoot, referencePath, texts } = params;
+  const title = referencePath.split('/').filter(Boolean).at(-1) ?? referencePath;
+  return {
+    key: `context-reference:current-directory:${referencePath}`,
+    icon: 'folder',
+    title: texts.currentDirectoryLabel,
+    subtitle: title,
+    description: texts.directoryDescription,
+    detailLines: [
+      `${texts.projectRootLabel}: ${projectRoot}`,
+      referencePath,
+    ],
+    sectionKey: WORKSPACE_SECTION_KEY,
+    sectionLabel: texts.workspaceSectionLabel,
+    value: referencePath,
+    tokenKind: CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
+    tokenKey: referencePath,
+    pathPreview: buildPathPreview({
+      kind: 'directory',
+      projectRoot,
+      relativePath: referencePath,
+    }),
+  };
+}
+
+export function buildFilesNavigationItem(
+  texts: ContextReferenceInputSurfaceTexts,
+): ChatInputSurfaceItem {
+  return {
+    key: FILES_NAVIGATION_ITEM_KEY,
+    icon: 'files',
+    title: texts.filesLabel,
+    subtitle: texts.filesSubtitle,
+    description: texts.filesDescription,
+    detailLines: [],
+    hintLabel: texts.filesHintLabel,
+    selectionBehavior: 'navigate',
+  };
+}
+
+export function buildProjectsNavigationItem(
+  texts: ContextReferenceInputSurfaceTexts,
+): ChatInputSurfaceItem {
+  return {
+    key: PROJECTS_NAVIGATION_ITEM_KEY,
+    icon: 'project',
+    title: texts.projectsLabel,
+    subtitle: texts.projectsSubtitle,
+    description: texts.projectsDescription,
+    detailLines: [],
+    hintLabel: texts.projectsHintLabel,
+    selectionBehavior: 'navigate',
+  };
+}
+
+function resolveParentReferencePath(referencePath: string): string | null {
+  const segments = referencePath.split('/').filter(Boolean);
+  return segments.length === 0 ? null : segments.slice(0, -1).join('/');
+}
+
+export function buildBackNavigationItem(params: {
+  location: ContextReferenceLocation;
+  texts: ContextReferenceInputSurfaceTexts;
+}): ChatInputSurfaceItem {
+  const { location, texts } = params;
+  const referencePath = location.view === 'files' ? location.path : '';
+  const isRootView = location.view !== 'files' || !referencePath;
+  return {
+    key: ROOT_NAVIGATION_ITEM_KEY,
+    icon: 'back',
+    title: isRootView ? texts.backLabel : texts.parentLabel,
+    subtitle: '',
+    description: isRootView ? texts.backDescription : texts.parentDescription,
+    detailLines: [],
+    hintLabel: isRootView ? texts.backHintLabel : texts.parentHintLabel,
+    value: resolveParentReferencePath(referencePath) ?? '',
+    selectionBehavior: 'navigate',
+  };
+}

package/src/features/chat/features/input/input-surface-plugins/context-reference-plugin.utils.ts

@@ -5,20 +5,28 @@ import {
   type ChatInputSurfacePlugin,
   type ChatInputSurfaceTriggerSpec,
 } from '@nextclaw/agent-chat-ui';
+import type { PanelAppEntryView } from '@/shared/lib/api';
+import type {
+  ChatInputProductPluginData,
+  ContextReferenceLocation,
+} from './chat-input-product-plugin-adapters.types';
 import {
-  CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
-  CHAT_WORKSPACE_FILE_TOKEN_KIND,
-} from '@nextclaw/shared';
-import type { PanelAppEntryView, ServerPathSearchEntryView } from '@/shared/lib/api';
-import type { ChatInputProductPluginData } from './chat-input-product-plugin-adapters.types';
+  buildBackNavigationItem,
+  buildCurrentDirectoryReferenceItem,
+  buildFilesNavigationItem,
+  buildProjectReferenceItems,
+  buildProjectsNavigationItem,
+  buildWorkspaceReferenceItems,
+  FILES_NAVIGATION_ITEM_KEY,
+  PROJECTS_NAVIGATION_ITEM_KEY,
+  ROOT_NAVIGATION_ITEM_KEY,
+  type ContextReferenceInputSurfaceTexts,
+} from './context-reference-items.utils';
 import {
   scoreInputSurfaceSearchCandidate,
   resolveInputSurfaceMatchTier,
 } from './input-surface-search.utils';
 
-const FILES_NAVIGATION_ITEM_KEY = 'context-reference:navigate:files';
-const ROOT_NAVIGATION_ITEM_KEY = 'context-reference:navigate:root';
-const WORKSPACE_SECTION_KEY = 'workspace';
 const PANEL_APP_SECTION_KEY = 'panel-apps';
 
 export const CONTEXT_REFERENCE_TRIGGER_SPEC: ChatInputSurfaceTriggerSpec = {
@@ -33,34 +41,10 @@ export type PanelAppInputSurfaceItemTexts = {
   subtitle: string;
 };
 
-export type ContextReferenceInputSurfaceTexts = {
-  backLabel: string;
-  backDescription: string;
-  backHintLabel: string;
-  currentDirectoryLabel: string;
-  directoryDescription: string;
-  fileDescription: string;
-  filesDescription: string;
-  filesHintLabel: string;
-  filesLabel: string;
-  filesSubtitle: string;
-  panelAppSectionLabel: string;
-  parentLabel: string;
-  parentDescription: string;
-  parentHintLabel: string;
-  projectRootLabel: string;
-  searchFailedLabel: string;
-  workspaceSectionLabel: string;
-};
-
 function getPanelAppActivityTime(entry: PanelAppEntryView): number {
   return Date.parse(entry.lastOpenedAt ?? entry.updatedAt) || 0;
 }
 
-function resolveProjectLabel(projectRoot: string): string {
-  return projectRoot.split(/[\\/]+/).filter(Boolean).at(-1) ?? projectRoot;
-}
-
 function resolvePanelAppInputSurfaceEntries(params: {
   entries: readonly PanelAppEntryView[];
   query: string;
@@ -155,171 +139,64 @@ function buildPanelAppReferenceItems(params: {
   }));
 }
 
-function buildPathPreview(params: {
-  kind: 'directory' | 'file';
-  projectRoot: string;
-  relativePath: string;
-}) {
-  const { kind, projectRoot, relativePath } = params;
-  const pathSegments = relativePath.split('/').filter(Boolean);
-  return {
-    rootLabel: resolveProjectLabel(projectRoot),
-    segments: pathSegments.map((label, index) => ({
-      label,
-      kind: index === pathSegments.length - 1 ? kind : 'directory' as const,
-    })),
-  };
-}
-
-function buildWorkspaceReferenceItems(params: {
-  entries: readonly ServerPathSearchEntryView[];
-  navigateDirectories: boolean;
-  projectRoot: string;
-  texts: ContextReferenceInputSurfaceTexts;
-}): ChatInputSurfaceItem[] {
-  const projectLabel = resolveProjectLabel(params.projectRoot);
-  return params.entries.map((entry) => {
-    const navigates = params.navigateDirectories && entry.kind === 'directory';
-    return {
-      key: `workspace:${entry.kind}:${entry.relativePath}`,
-      icon: entry.kind === 'directory' ? 'folder' : 'file',
-      title: entry.name,
-      subtitle: entry.parentRelativePath || projectLabel,
-      description: entry.kind === 'directory'
-        ? params.texts.directoryDescription
-        : params.texts.fileDescription,
-      detailLines: [
-        `${params.texts.projectRootLabel}: ${params.projectRoot}`,
-        entry.relativePath,
-      ],
-      sectionKey: WORKSPACE_SECTION_KEY,
-      sectionLabel: params.texts.workspaceSectionLabel,
-      value: entry.relativePath,
-      tokenKind: navigates
-        ? undefined
-        : entry.kind === 'directory'
-          ? CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND
-          : CHAT_WORKSPACE_FILE_TOKEN_KIND,
-      tokenKey: navigates ? undefined : entry.relativePath,
-      selectionBehavior: navigates ? 'navigate' : undefined,
-      pathPreview: buildPathPreview({
-        kind: entry.kind,
-        projectRoot: params.projectRoot,
-        relativePath: entry.relativePath,
-      }),
-    } satisfies ChatInputSurfaceItem;
-  });
-}
-
-function resolveParentReferencePath(referencePath: string): string | null {
-  const segments = referencePath.split('/').filter(Boolean);
-  if (segments.length === 0) {
-    return null;
-  }
-  return segments.slice(0, -1).join('/');
-}
-
-function buildCurrentDirectoryReferenceItem(params: {
-  projectRoot: string;
-  referencePath: string;
-  texts: ContextReferenceInputSurfaceTexts;
-}): ChatInputSurfaceItem {
-  const { projectRoot, referencePath, texts } = params;
-  const title = referencePath.split('/').filter(Boolean).at(-1) ?? referencePath;
-  return {
-    key: `context-reference:current-directory:${referencePath}`,
-    icon: 'folder',
-    title: texts.currentDirectoryLabel,
-    subtitle: title,
-    description: texts.directoryDescription,
-    detailLines: [
-      `${texts.projectRootLabel}: ${projectRoot}`,
-      referencePath,
-    ],
-    sectionKey: WORKSPACE_SECTION_KEY,
-    sectionLabel: texts.workspaceSectionLabel,
-    value: referencePath,
-    tokenKind: CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
-    tokenKey: referencePath,
-    pathPreview: buildPathPreview({
-      kind: 'directory',
-      projectRoot,
-      relativePath: referencePath,
-    }),
-  };
-}
-
-function buildFilesNavigationItem(texts: ContextReferenceInputSurfaceTexts): ChatInputSurfaceItem {
-  return {
-    key: FILES_NAVIGATION_ITEM_KEY,
-    icon: 'files',
-    title: texts.filesLabel,
-    subtitle: texts.filesSubtitle,
-    description: texts.filesDescription,
-    detailLines: [],
-    hintLabel: texts.filesHintLabel,
-    selectionBehavior: 'navigate',
-  };
-}
-
-function buildBackNavigationItem(params: {
-  referencePath: string;
-  texts: ContextReferenceInputSurfaceTexts;
-}): ChatInputSurfaceItem {
-  const { referencePath, texts } = params;
-  const isProjectRoot = !referencePath;
-  return {
-    key: ROOT_NAVIGATION_ITEM_KEY,
-    icon: 'back',
-    title: isProjectRoot ? texts.backLabel : texts.parentLabel,
-    subtitle: '',
-    description: isProjectRoot ? texts.backDescription : texts.parentDescription,
-    detailLines: [],
-    hintLabel: isProjectRoot ? texts.backHintLabel : texts.parentHintLabel,
-    value: resolveParentReferencePath(referencePath) ?? '',
-    selectionBehavior: 'navigate',
-  };
-}
-
 export function createContextReferenceInputSurfacePlugin(params: {
   itemTexts: {
     context: ContextReferenceInputSurfaceTexts;
     panelApp: PanelAppInputSurfaceItemTexts;
   };
   menuTexts: ChatInputSurfaceMenuTexts;
-  onNavigate: (path: string | null) => void;
+  onNavigate: (location: ContextReferenceLocation) => void;
 }): ChatInputSurfacePlugin<ChatInputProductPluginData> {
   return createInputSurfaceTriggeredPanelPlugin({
     key: 'context-reference',
     trigger: CONTEXT_REFERENCE_TRIGGER_SPEC,
     resolvePanel: ({ data, trigger }) => {
-      const isFilesMode = data.referencePath !== null;
+      const isFilesMode = data.referenceLocation.view === 'files';
+      const isProjectsMode = data.referenceLocation.view === 'projects';
       const isBrowsing = isFilesMode && !trigger.query.trim();
+      const referencePath = data.referenceLocation.view === 'files'
+        ? data.referenceLocation.path
+        : '';
       const workspaceItems = buildWorkspaceReferenceItems({
         entries: data.serverPathEntries,
         navigateDirectories: isBrowsing,
         projectRoot: data.projectRoot,
         texts: params.itemTexts.context,
       });
-      const currentDirectoryItem = isBrowsing && data.referencePath
+      const projectItems = buildProjectReferenceItems({
+        projects: data.projects,
+        query: trigger.query,
+        texts: params.itemTexts.context,
+      });
+      const currentDirectoryItem = isBrowsing && referencePath
         ? buildCurrentDirectoryReferenceItem({
             projectRoot: data.projectRoot,
-            referencePath: data.referencePath,
+            referencePath,
             texts: params.itemTexts.context,
           })
         : null;
       const items = isFilesMode
         ? [
             buildBackNavigationItem({
-              referencePath: data.referencePath ?? '',
+              location: data.referenceLocation,
               texts: params.itemTexts.context,
             }),
             ...(currentDirectoryItem ? [currentDirectoryItem] : []),
             ...workspaceItems,
           ]
-        : [
+        : isProjectsMode
+          ? [
+              buildBackNavigationItem({
+                location: data.referenceLocation,
+                texts: params.itemTexts.context,
+              }),
+              ...projectItems,
+            ]
+          : [
             buildFilesNavigationItem(params.itemTexts.context),
+            buildProjectsNavigationItem(params.itemTexts.context),
             ...(trigger.query ? workspaceItems : []),
+            ...(trigger.query ? projectItems : []),
             ...buildPanelAppReferenceItems({
               entries: data.panelApps,
               query: trigger.query,
@@ -329,25 +206,37 @@ export function createContextReferenceInputSurfacePlugin(params: {
           ];
       const relevantLoading = isFilesMode
         ? data.isServerPathSearchLoading
-        : data.isPanelAppsLoading || (Boolean(trigger.query) && data.isServerPathSearchLoading);
+        : isProjectsMode
+          ? data.isProjectsLoading
+          : data.isPanelAppsLoading ||
+            (Boolean(trigger.query) && (data.isProjectsLoading || data.isServerPathSearchLoading));
+      const errorMessage = isProjectsMode && data.projectsError
+        ? `${params.itemTexts.context.projectsLoadFailedLabel}: ${data.projectsError}`
+        : data.serverPathSearchError
+          ? `${params.itemTexts.context.searchFailedLabel}: ${data.serverPathSearchError}`
+          : null;
       return {
-        isLoading: isFilesMode
-          ? relevantLoading
-          : relevantLoading && items.length === 0,
+        isLoading: isProjectsMode ? relevantLoading : relevantLoading && items.length === 0,
         items,
-        notice: data.serverPathSearchError
+        notice: errorMessage
           ? {
-              message: `${params.itemTexts.context.searchFailedLabel}: ${data.serverPathSearchError}`,
+              message: errorMessage,
               tone: 'error',
             }
           : undefined,
         onSelectItem: (item) => {
           if (item.key === FILES_NAVIGATION_ITEM_KEY) {
-            params.onNavigate('');
+            params.onNavigate({ view: 'files', path: '' });
+          } else if (item.key === PROJECTS_NAVIGATION_ITEM_KEY) {
+            params.onNavigate({ view: 'projects' });
           } else if (item.key === ROOT_NAVIGATION_ITEM_KEY) {
-            params.onNavigate(data.referencePath ? item.value ?? '' : null);
+            params.onNavigate(
+              isFilesMode && referencePath
+                ? { view: 'files', path: item.value ?? '' }
+                : { view: 'root' },
+            );
           } else if (item.selectionBehavior === 'navigate' && item.value) {
-            params.onNavigate(item.value);
+            params.onNavigate({ view: 'files', path: item.value });
           }
         },
         texts: params.menuTexts,

package/src/features/chat/features/input/utils/__tests__/chat-inline-token.utils.test.ts

@@ -226,6 +226,35 @@ describe('chat inline token workspace references', () => {
     ]);
   });
 
+  it('serializes project references with their registered path and display name', () => {
+    expect(
+      buildInlineTokensFromComposer([
+        createChatComposerTokenNode({
+          tokenKind: 'project',
+          tokenKey: '/tmp/NextClaw Project',
+          label: 'NextClaw',
+        }),
+      ]),
+    ).toEqual([
+      {
+        kind: 'project',
+        key: '/tmp/NextClaw Project',
+        label: 'NextClaw',
+        rawText: '@project:%2Ftmp%2FNextClaw%20Project',
+      },
+    ]);
+    expect(
+      buildInlineTokensFromTextProtocol('review @project:%2Ftmp%2FNextClaw%20Project'),
+    ).toEqual([
+      {
+        kind: 'project',
+        key: '/tmp/NextClaw Project',
+        label: 'NextClaw Project',
+        rawText: '@project:%2Ftmp%2FNextClaw%20Project',
+      },
+    ]);
+  });
+
   it('resolves workspace token paths inside POSIX and Windows project roots', () => {
     expect(resolveWorkspaceReferencePath({
       projectRoot: '/tmp/project/',