@nextclaw/ui 0.15.25 → 0.15.26

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

@@ -1,16 +1,19 @@
 import type { ChatSkillRecord } from '@/features/chat/types/chat-input-bar.types';
-import type { PanelAppEntryView, ProjectView, ServerPathSearchEntryView } from '@/shared/lib/api';
+import type { PanelAppEntryView, ProjectView, ServerPathSearchEntryView, SystemObjectReferenceGroupView } from '@/shared/lib/api';
 
 export type ContextReferenceLocation =
   | { view: 'root' }
   | { view: 'files'; path: string }
-  | { view: 'projects' };
+  | { view: 'folders'; path: string }
+  | { view: 'projects' }
+  | { view: 'system-objects'; objectType: string };
 
 export type ChatInputProductPluginData = {
   isPanelAppsLoading: boolean;
   isProjectsLoading: boolean;
   isServerPathSearchLoading: boolean;
   isSkillsLoading: boolean;
+  isSystemObjectsLoading?: boolean;
   panelApps: readonly PanelAppEntryView[];
   projectRoot: string;
   projects: readonly ProjectView[];
@@ -20,4 +23,6 @@ export type ChatInputProductPluginData = {
   serverPathEntries: readonly ServerPathSearchEntryView[];
   serverPathSearchError: string | null;
   skillRecords: readonly ChatSkillRecord[];
+  systemObjectGroups?: readonly SystemObjectReferenceGroupView[];
+  systemObjectsError?: string | null;
 };

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

@@ -0,0 +1,124 @@
+import type { ChatInputSurfacePlugin } from '@nextclaw/agent-chat-ui';
+import { t, type I18nLanguage } from '@/shared/lib/i18n';
+import type { ChatInputBarAdapterTexts } from '@/features/chat/types/chat-input-bar.types';
+import {
+  createContextReferenceInputSurfacePlugin,
+} from './context-reference-plugin.utils';
+import {
+  createSlashCommandInputSurfacePlugin,
+  type ChatSlashCommandDescriptor,
+} from './slash-command-plugin.utils';
+import type {
+  ChatInputProductPluginData,
+  ContextReferenceLocation,
+} from './chat-input-product-plugin-adapters.types';
+
+export type ChatInputSurfaceSlashTexts = Pick<
+  ChatInputBarAdapterTexts,
+  'slashSkillSubtitle' | 'slashSkillSpecLabel' | 'slashSkillScopeLabel' | 'noSkillDescription'
+>;
+
+export function buildChatInputProductPlugins(params: {
+  commands: readonly ChatSlashCommandDescriptor[];
+  language: I18nLanguage;
+  onNavigate: (location: ContextReferenceLocation) => void;
+  onSelectPanelApp: (appId: string) => void;
+  onSelectSkill: (skillRef: string) => void;
+  onSelectSystemObject: (uri: string) => void;
+  slashTexts: ChatInputSurfaceSlashTexts;
+}): ChatInputSurfacePlugin<ChatInputProductPluginData>[] {
+  const {
+    commands,
+    language,
+    onNavigate,
+    onSelectPanelApp,
+    onSelectSkill,
+    onSelectSystemObject,
+    slashTexts,
+  } = params;
+  const panelAppTexts = {
+    appIdLabel: t('chatPanelAppReferenceAppId', language),
+    fileLabel: t('chatPanelAppReferenceFile', language),
+    noDescriptionLabel: t('chatPanelAppReferenceNoDescription', language),
+    subtitle: t('chatPanelAppReferenceType', language),
+  };
+  return [
+    createSlashCommandInputSurfacePlugin({
+      commands,
+      itemTexts: {
+        panelAppTexts,
+        skillTexts: slashTexts,
+      },
+      menuTexts: {
+        loadingLabel: t('chatSlashLoading', language),
+        sectionLabel: t('chatSlashSection', language),
+        emptyLabel: t('chatSlashNoResult', language),
+        hintLabel: t('chatSlashHint', language),
+        itemHintLabel: t('chatSlashSkillHint', language),
+      },
+      labels: {
+        commandHintLabel: t('chatSlashCommandHint', language),
+        commandSectionLabel: t('chatSlashSectionCommands', language),
+        commandSubtitle: t('chatSlashTypeCommand', language),
+        filterAllLabel: t('chatSlashFilterAll', language),
+        filterCommandsLabel: t('chatSlashFilterCommands', language),
+        filterPanelAppsLabel: t('chatSlashFilterPanelApps', language),
+        filterSkillsLabel: t('chatSlashFilterSkills', language),
+        panelAppHintLabel: t('chatSlashPanelAppHint', language),
+        panelAppSectionLabel: t('chatPanelAppReferenceSection', language),
+        skillHintLabel: t('chatSlashSkillHint', language),
+        skillSectionLabel: t('chatSlashSectionSkills', language),
+      },
+      onSelectPanelApp,
+      onSelectSkill,
+    }),
+    createContextReferenceInputSurfacePlugin({
+      itemTexts: {
+        context: {
+          backLabel: t('chatContextReferenceBack', language),
+          backDescription: t('chatContextReferenceBackDescription', language),
+          backHintLabel: t('chatContextReferenceBackHint', language),
+          currentDirectoryLabel: t('chatContextReferenceCurrentDirectory', language),
+          directoryDescription: t('chatContextReferenceDirectoryDescription', language),
+          fileDescription: t('chatContextReferenceFileDescription', language),
+          filesDescription: t('chatContextReferenceFilesDescription', language),
+          filesHintLabel: t('chatContextReferenceFilesHint', language),
+          filesLabel: t('chatContextReferenceFilesLabel', language),
+          filesSubtitle: t('chatContextReferenceFilesType', language),
+          foldersDescription: t('chatContextReferenceFoldersDescription', language),
+          foldersHintLabel: t('chatContextReferenceFoldersHint', language),
+          foldersLabel: t('chatContextReferenceFoldersLabel', language),
+          foldersSubtitle: t('chatContextReferenceFoldersType', language),
+          panelAppSectionLabel: t('chatPanelAppReferenceSection', language),
+          parentLabel: t('chatContextReferenceParent', language),
+          parentDescription: t('chatContextReferenceParentDescription', language),
+          parentHintLabel: t('chatContextReferenceParentHint', language),
+          projectDescription: t('chatContextReferenceProjectDescription', language),
+          projectPathLabel: t('chatContextReferenceProjectPath', language),
+          projectSectionLabel: t('chatContextReferenceProjectSection', language),
+          projectSubtitle: t('chatContextReferenceProjectType', language),
+          projectsDescription: t('chatContextReferenceProjectsDescription', language),
+          projectsHintLabel: t('chatContextReferenceProjectsHint', language),
+          projectsLabel: t('chatContextReferenceProjectsLabel', language),
+          projectsLoadFailedLabel: t('chatContextReferenceProjectsLoadFailed', language),
+          projectsSubtitle: t('chatContextReferenceProjectsType', language),
+          projectRootLabel: t('chatContextReferenceProjectRoot', language),
+          searchFailedLabel: t('chatContextReferenceSearchFailed', language),
+          systemObjectGroupHintLabel: t('chatSystemObjectGroupHint', language),
+          systemObjectSectionLabel: t('chatSystemObjectSection', language),
+        },
+        panelApp: panelAppTexts,
+      },
+      menuTexts: {
+        loadingLabel: t('chatContextReferenceLoading', language),
+        sectionLabel: t('chatContextReferenceSection', language),
+        emptyLabel: t('chatContextReferenceNoResult', language),
+        hintLabel: t('chatContextReferenceHint', language),
+        itemHintLabel: t('chatContextReferenceItemHint', language),
+      },
+      language,
+      onNavigate,
+      onSelectSystemObject,
+    }),
+  ];
+}

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

@@ -4,7 +4,13 @@ import {
   CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
   CHAT_WORKSPACE_FILE_TOKEN_KIND,
 } from '@nextclaw/shared';
-import type { ProjectView, ServerPathSearchEntryView } from '@/shared/lib/api';
+import type { I18nLanguage } from '@/shared/lib/i18n';
+import type {
+  ProjectView,
+  ServerPathSearchEntryView,
+  SystemObjectReferenceDisplayText,
+  SystemObjectReferenceGroupView,
+} from '@/shared/lib/api';
 import type { ContextReferenceLocation } from './chat-input-product-plugin-adapters.types';
 import {
   resolveInputSurfaceMatchTier,
@@ -12,10 +18,14 @@ import {
 } from './input-surface-search.utils';
 
 export const FILES_NAVIGATION_ITEM_KEY = 'context-reference:navigate:files';
+export const FOLDERS_NAVIGATION_ITEM_KEY = 'context-reference:navigate:folders';
 export const PROJECTS_NAVIGATION_ITEM_KEY = 'context-reference:navigate:projects';
 export const ROOT_NAVIGATION_ITEM_KEY = 'context-reference:navigate:root';
+export const SYSTEM_OBJECT_GROUP_ITEM_KEY_PREFIX = 'context-reference:navigate:system-object-group:';
+export const SYSTEM_OBJECT_ITEM_KEY_PREFIX = 'context-reference:system-object:';
 
-const WORKSPACE_SECTION_KEY = 'workspace';
+export const FILES_SECTION_KEY = 'workspace-files';
+export const FOLDERS_SECTION_KEY = 'workspace-folders';
 const PROJECT_SECTION_KEY = 'projects';
 
 export type ContextReferenceInputSurfaceTexts = {
@@ -29,6 +39,10 @@ export type ContextReferenceInputSurfaceTexts = {
   filesHintLabel: string;
   filesLabel: string;
   filesSubtitle: string;
+  foldersDescription: string;
+  foldersHintLabel: string;
+  foldersLabel: string;
+  foldersSubtitle: string;
   panelAppSectionLabel: string;
   parentLabel: string;
   parentDescription: string;
@@ -44,9 +58,59 @@ export type ContextReferenceInputSurfaceTexts = {
   projectsSubtitle: string;
   projectRootLabel: string;
   searchFailedLabel: string;
-  workspaceSectionLabel: string;
+  systemObjectGroupHintLabel: string;
+  systemObjectSectionLabel: string;
 };
 
+function resolveSystemObjectDisplayText(
+  text: SystemObjectReferenceDisplayText,
+  language: I18nLanguage,
+): string {
+  return text.translations?.[language] ?? text.default;
+}
+
+export function buildSystemObjectGroupNavigationItems(params: {
+  groups: readonly SystemObjectReferenceGroupView[];
+  language: I18nLanguage;
+  texts: ContextReferenceInputSurfaceTexts;
+}): ChatInputSurfaceItem[] {
+  return params.groups.map((group) => ({
+    key: `${SYSTEM_OBJECT_GROUP_ITEM_KEY_PREFIX}${group.objectType}`,
+    icon: group.icon,
+    title: resolveSystemObjectDisplayText(group.label, params.language),
+    subtitle: params.texts.systemObjectSectionLabel,
+    description: resolveSystemObjectDisplayText(group.description, params.language),
+    detailLines: [],
+    hintLabel: params.texts.systemObjectGroupHintLabel,
+    sectionKey: 'system-object-groups',
+    sectionLabel: params.texts.systemObjectSectionLabel,
+    selectionBehavior: 'navigate',
+    value: group.objectType,
+  }));
+}
+
+export function buildSystemObjectReferenceItems(params: {
+  groups: readonly SystemObjectReferenceGroupView[];
+  language: I18nLanguage;
+  texts: ContextReferenceInputSurfaceTexts;
+}): ChatInputSurfaceItem[] {
+  return params.groups.flatMap((group) => {
+    const groupLabel = resolveSystemObjectDisplayText(group.label, params.language);
+    return group.items.map((item) => ({
+      key: `${SYSTEM_OBJECT_ITEM_KEY_PREFIX}${item.uri}`,
+      icon: group.icon,
+      title: item.label,
+      subtitle: groupLabel,
+      description: item.description ?? item.objectId,
+      detailLines: [item.uri],
+      sectionKey: `system-objects:${group.objectType}`,
+      sectionLabel: groupLabel,
+      selectionBehavior: 'action',
+      value: item.uri,
+    }));
+  });
+}
+
 function resolveProjectLabel(projectRoot: string): string {
   return projectRoot.split(/[\\/]+/).filter(Boolean).at(-1) ?? projectRoot;
 }
@@ -118,6 +182,8 @@ export function buildWorkspaceReferenceItems(params: {
   entries: readonly ServerPathSearchEntryView[];
   navigateDirectories: boolean;
   projectRoot: string;
+  sectionKey: string;
+  sectionLabel: string;
   texts: ContextReferenceInputSurfaceTexts;
 }): ChatInputSurfaceItem[] {
   const projectLabel = resolveProjectLabel(params.projectRoot);
@@ -135,8 +201,8 @@ export function buildWorkspaceReferenceItems(params: {
         `${params.texts.projectRootLabel}: ${params.projectRoot}`,
         entry.relativePath,
       ],
-      sectionKey: WORKSPACE_SECTION_KEY,
-      sectionLabel: params.texts.workspaceSectionLabel,
+      sectionKey: params.sectionKey,
+      sectionLabel: params.sectionLabel,
       value: entry.relativePath,
       tokenKind: navigates
         ? undefined
@@ -160,26 +226,28 @@ export function buildCurrentDirectoryReferenceItem(params: {
   texts: ContextReferenceInputSurfaceTexts;
 }): ChatInputSurfaceItem {
   const { projectRoot, referencePath, texts } = params;
-  const title = referencePath.split('/').filter(Boolean).at(-1) ?? referencePath;
+  const normalizedPath = referencePath.split('/').filter(Boolean).join('/');
+  const tokenKey = normalizedPath || '.';
+  const title = normalizedPath.split('/').filter(Boolean).at(-1) ?? resolveProjectLabel(projectRoot);
   return {
-    key: `context-reference:current-directory:${referencePath}`,
+    key: `context-reference:current-directory:${tokenKey}`,
     icon: 'folder',
     title: texts.currentDirectoryLabel,
     subtitle: title,
     description: texts.directoryDescription,
     detailLines: [
       `${texts.projectRootLabel}: ${projectRoot}`,
-      referencePath,
+      tokenKey,
     ],
-    sectionKey: WORKSPACE_SECTION_KEY,
-    sectionLabel: texts.workspaceSectionLabel,
-    value: referencePath,
+    sectionKey: FOLDERS_SECTION_KEY,
+    sectionLabel: texts.foldersLabel,
+    value: tokenKey,
     tokenKind: CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
-    tokenKey: referencePath,
+    tokenKey,
     pathPreview: buildPathPreview({
       kind: 'directory',
       projectRoot,
-      relativePath: referencePath,
+      relativePath: normalizedPath,
     }),
   };
 }
@@ -199,6 +267,21 @@ export function buildFilesNavigationItem(
   };
 }
 
+export function buildFoldersNavigationItem(
+  texts: ContextReferenceInputSurfaceTexts,
+): ChatInputSurfaceItem {
+  return {
+    key: FOLDERS_NAVIGATION_ITEM_KEY,
+    icon: 'folder',
+    title: texts.foldersLabel,
+    subtitle: texts.foldersSubtitle,
+    description: texts.foldersDescription,
+    detailLines: [],
+    hintLabel: texts.foldersHintLabel,
+    selectionBehavior: 'navigate',
+  };
+}
+
 export function buildProjectsNavigationItem(
   texts: ContextReferenceInputSurfaceTexts,
 ): ChatInputSurfaceItem {
@@ -224,8 +307,9 @@ export function buildBackNavigationItem(params: {
   texts: ContextReferenceInputSurfaceTexts;
 }): ChatInputSurfaceItem {
   const { location, texts } = params;
-  const referencePath = location.view === 'files' ? location.path : '';
-  const isRootView = location.view !== 'files' || !referencePath;
+  const isWorkspaceView = location.view === 'files' || location.view === 'folders';
+  const referencePath = isWorkspaceView ? location.path : '';
+  const isRootView = !isWorkspaceView || !referencePath;
   return {
     key: ROOT_NAVIGATION_ITEM_KEY,
     icon: 'back',