@nextclaw/ui 0.15.11 → 0.15.13

package/src/features/right-panel-resources/utils/__tests__/right-panel-resource-uri.utils.test.ts

@@ -1,6 +1,10 @@
 import { describe, expect, it } from 'vitest';
 import type { PanelAppEntryView } from '@/shared/lib/api';
-import { createPanelAppRightPanelResourceTarget } from '@/features/right-panel-resources/utils/right-panel-resource-uri.utils';
+import {
+  createPanelAppContentPath,
+  createPanelAppResourceUri,
+  createPanelAppRightPanelResourceTarget,
+} from '@/features/right-panel-resources/utils/right-panel-resource-uri.utils';
 
 function createPanelAppEntry(overrides: Partial<PanelAppEntryView> = {}): PanelAppEntryView {
   return {
@@ -22,6 +26,15 @@ function createPanelAppEntry(overrides: Partial<PanelAppEntryView> = {}): PanelA
 }
 
 describe('right-panel-resource uri utils', () => {
+  it('builds matching external panel app resource and content URLs', () => {
+    expect(createPanelAppResourceUri('demo', '/tmp/demo.panel')).toBe(
+      'nextclaw://panel-app/demo?path=%2Ftmp%2Fdemo.panel',
+    );
+    expect(createPanelAppContentPath('demo', '/tmp/demo.panel')).toBe(
+      '/api/panel-apps/demo/content?path=%2Ftmp%2Fdemo.panel',
+    );
+  });
+
   it('keeps panel app image icons as dock image icons', () => {
     const target = createPanelAppRightPanelResourceTarget(createPanelAppEntry({
       icon: '/api/panel-apps/demo/assets/icon.png',

package/src/features/right-panel-resources/utils/right-panel-resource-uri.utils.ts

@@ -34,8 +34,16 @@ export function normalizeRightPanelAppsUrl(url: string): string {
   return createRightPanelAppsUrl(getRightPanelAppsTabFromUrl(url));
 }
 
-export function createPanelAppResourceUri(appId: string): string {
-  return `nextclaw://panel-app/${encodeURIComponent(appId)}`;
+export function createPanelAppResourceUri(appId: string, sourcePath?: string): string {
+  const uri = `nextclaw://panel-app/${encodeURIComponent(appId)}`;
+  const path = sourcePath?.trim();
+  return path ? `${uri}?${new URLSearchParams({ path }).toString()}` : uri;
+}
+
+export function createPanelAppContentPath(appId: string, sourcePath?: string): string {
+  const url = `/api/panel-apps/${encodeURIComponent(appId)}/content`;
+  const path = sourcePath?.trim();
+  return path ? `${url}?${new URLSearchParams({ path }).toString()}` : url;
 }
 
 function isPanelAppImageIcon(icon: string): boolean {

package/src/shared/components/path-picker/__tests__/server-path-picker-dialog.test.tsx

@@ -20,6 +20,7 @@ vi.mock('@/shared/hooks/use-server-path-create-directory', () => ({
 }));
 
 type PickerOverrides = {
+  allowCreateDirectory?: boolean;
   currentPath?: string;
   defaultWorkspacePath?: string;
   description?: string;
@@ -29,6 +30,7 @@ type PickerOverrides = {
 const createPickerElement = (overrides?: PickerOverrides) => (
   <ServerPathPickerDialog
     open={overrides?.open ?? true}
+    allowCreateDirectory={overrides?.allowCreateDirectory}
     currentPath={overrides?.currentPath ?? '/workspace'}
     defaultWorkspacePath={overrides?.defaultWorkspacePath}
     isSaving={false}
@@ -236,6 +238,13 @@ describe('ServerPathPickerDialog', () => {
     );
   });
 
+  it('hides directory creation when the caller only allows existing directories', () => {
+    renderPicker({ allowCreateDirectory: false });
+
+    expect(screen.queryByRole('button', { name: '新建文件夹' })).toBeNull();
+    expect(screen.getByText('单击选择，双击进入')).toBeTruthy();
+  });
+
   it('uses single click to select and double click to enter a folder', async () => {
     const user = userEvent.setup();
     renderPicker();

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

@@ -20,6 +20,7 @@ import { t } from '@/shared/lib/i18n';
 
 type ServerPathPickerDialogProps = {
   open: boolean;
+  allowCreateDirectory?: boolean;
   currentPath?: string | null;
   defaultWorkspacePath?: string | null;
   isSaving: boolean;
@@ -51,6 +52,7 @@ function resolveHomeRelativePath(path: string, homePath?: string | null): string
 
 export function ServerPathPickerDialog({
   open,
+  allowCreateDirectory = true,
   currentPath,
   defaultWorkspacePath,
   isSaving,
@@ -88,6 +90,7 @@ export function ServerPathPickerDialog({
         {open ? (
           <ServerPathPickerSession
             key={sessionKey}
+            allowCreateDirectory={allowCreateDirectory}
             currentPath={normalizedCurrentPath}
             defaultWorkspacePath={normalizedDefaultWorkspacePath}
             isSaving={isSaving}
@@ -105,6 +108,7 @@ export function ServerPathPickerDialog({
 }
 
 type ServerPathPickerSessionProps = {
+  allowCreateDirectory: boolean;
   currentPath: string;
   defaultWorkspacePath: string;
   isSaving: boolean;
@@ -117,6 +121,7 @@ type ServerPathPickerSessionProps = {
 };
 
 function ServerPathPickerSession({
+  allowCreateDirectory,
   currentPath,
   defaultWorkspacePath,
   isSaving,
@@ -245,7 +250,7 @@ function ServerPathPickerSession({
   const createDirectory = async () => {
     const parentPath = browseQuery.data?.currentPath;
     const name = newFolderName.trim();
-    if (!parentPath || !name || createDirectoryMutation.isPending) {
+    if (!allowCreateDirectory || !parentPath || !name || createDirectoryMutation.isPending) {
       return;
     }
     try {
@@ -301,6 +306,7 @@ function ServerPathPickerSession({
           />
 
           <ServerPathPickerToolbar
+            allowCreateDirectory={allowCreateDirectory}
             disabled={navigationDisabled || !browseQuery.data?.currentPath}
             onNewFolder={() => {
               setNewFolderVisible(true);
@@ -320,7 +326,7 @@ function ServerPathPickerSession({
             />
           </div>
 
-          {newFolderVisible ? (
+          {allowCreateDirectory && newFolderVisible ? (
             <ServerPathPickerNewFolder
               errorMessage={createDirectoryErrorMessage}
               isCreating={createDirectoryMutation.isPending}

package/src/shared/components/path-picker/server-path-picker-toolbar.tsx

@@ -3,20 +3,24 @@ import { Button } from '@/shared/components/ui/button';
 import { t } from '@/shared/lib/i18n';
 
 type ServerPathPickerToolbarProps = {
+  allowCreateDirectory: boolean;
   disabled: boolean;
   onNewFolder: () => void;
 };
 
 export function ServerPathPickerToolbar({
+  allowCreateDirectory,
   disabled,
   onNewFolder,
 }: ServerPathPickerToolbarProps) {
   return (
     <div className="flex items-center border-b border-border bg-background px-3 py-1.5">
-      <Button type="button" variant="ghost" size="sm" onClick={onNewFolder} disabled={disabled}>
-        <FolderPlus className="mr-1 h-4 w-4" />
-        {t('pathPickerNewFolder')}
-      </Button>
+      {allowCreateDirectory ? (
+        <Button type="button" variant="ghost" size="sm" onClick={onNewFolder} disabled={disabled}>
+          <FolderPlus className="mr-1 h-4 w-4" />
+          {t('pathPickerNewFolder')}
+        </Button>
+      ) : null}
       <span className="ml-auto text-xs text-muted-foreground">
         {t('pathPickerDoubleClickHint')}
       </span>

package/src/shared/hooks/use-projects.ts

@@ -1,6 +1,6 @@
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { toast } from "sonner";
-import { createProject, fetchProjects } from "@/shared/lib/api";
+import { addExistingProject, createProject, fetchProjects } from "@/shared/lib/api";
 import { t } from "@/shared/lib/i18n";
 
 const PROJECTS_QUERY_KEY = ["projects"] as const;
@@ -26,3 +26,17 @@ export function useCreateProject() {
     },
   });
 }
+
+export function useAddExistingProject() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: addExistingProject,
+    onSuccess: async () => {
+      await queryClient.invalidateQueries({ queryKey: PROJECTS_QUERY_KEY });
+      toast.success(t("chatProjectExistingAdded"));
+    },
+    onError: (error: Error) => {
+      toast.error(`${t("chatProjectExistingFailed")}: ${error.message}`);
+    },
+  });
+}

package/src/shared/lib/api/projects/project.utils.ts

@@ -1,5 +1,6 @@
 import { nextclawClient } from "@/shared/lib/api/managers/client.manager";
 import type {
+  ProjectAddExistingRequest,
   ProjectCreateRequest,
   ProjectListView,
   ProjectView,
@@ -12,3 +13,9 @@ export async function fetchProjects(): Promise<ProjectListView> {
 export async function createProject(input: ProjectCreateRequest): Promise<ProjectView> {
   return await nextclawClient.projects.create(input);
 }
+
+export async function addExistingProject(
+  input: ProjectAddExistingRequest,
+): Promise<ProjectView> {
+  return await nextclawClient.projects.addExisting(input);
+}

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

@@ -1,6 +1,6 @@
 import type { NcpSessionStatus } from '@nextclaw/ncp';
 import type { RuntimeEntryView, NcpSessionSummaryView } from './ncp-session.types';
-export type { ProjectCreateRequest, ProjectListView, ProjectTemplateView, ProjectView } from '@nextclaw/client-sdk';
+export type { ProjectAddExistingRequest, ProjectCreateRequest, ProjectListView, ProjectTemplateView, ProjectView } from '@nextclaw/client-sdk';
 export type { SessionEntryView, RuntimeEntryView, SessionTypeIconView, SessionMessageView, SessionEventView, NcpSessionSummaryView, NcpSessionsListView, NcpMessageView, NcpSessionMessagesView, SessionContextWindowView } from './ncp-session.types';
 
 // API Types - matching backend response format

package/src/shared/lib/api/utils/ncp-session.utils.ts

@@ -45,6 +45,13 @@ export async function updateNcpSession(
   )) as NcpSessionSummaryView;
 }
 
+// POST /api/ncp/sessions/:sessionId/context/compact
+export async function compactNcpSessionContext(
+  sessionId: string,
+): Promise<{ compacted: true; sessionId: string }> {
+  return await nextclawClient.sessions.compactContext(sessionId);
+}
+
 // DELETE /api/ncp/sessions/:sessionId
 export async function deleteNcpSession(
   sessionId: string,

package/src/shared/lib/i18n/locales/en-US/chat.json

@@ -76,6 +76,7 @@
   "chatWorkspacePreviewUnsupported": "This file is not supported in the sidebar preview yet.",
   "chatWorkspacePreviewUnsupportedHint": "Legacy Word or PowerPoint files, archives, and other unsupported formats can be downloaded and opened with a local app.",
   "chatWorkspacePreviewFailed": "The file could not be previewed. You can still download it and open it with a local app.",
+  "chatWorkspacePreviewNotFound": "This file could not be found. It may have been moved, renamed, or deleted.",
   "chatWorkspaceSpreadsheetPreviewTruncated": "This workbook is large. The preview shows up to 500 rows and 100 columns.",
   "chatWorkspacePreviewDownload": "Download file",
   "chatWorkspacePreviewOpenExternally": "Open with system app",
@@ -153,7 +154,6 @@
   "chatAiExecutionOutput": "output",
   "chatAiExecutionTokens": "tokens",
   "chatAiExecutionPartial": "partial usage",
-  "chatAiExecutionUnavailable": "Token usage unavailable",
   "chatMessageMoreActions": "More actions",
   "chatAiExecutionViewMetadata": "View run metadata",
   "chatAiExecutionMetadataTitle": "AI run metadata",
@@ -221,6 +221,11 @@
   "chatSlashCommandSideChatTitle": "Side chat",
   "chatSlashCommandSideChatDescription": "Open a draft side conversation that inherits this session context.",
   "chatSlashCommandSideChatDetail": "Creates the child session only after your first message.",
+  "chatSlashCommandCompactContextTitle": "Compact context",
+  "chatSlashCommandCompactContextDescription": "Summarize older messages to free context space in this session.",
+  "chatSlashCommandCompactContextDetail": "Keeps the latest turn and the active task available for continuation.",
+  "chatSlashCommandCompactContextSuccess": "Context compacted",
+  "chatSlashCommandCompactContextFailed": "Couldn't compact context",
   "chatSlashPanelAppHint": "Press Enter to open this panel app on the right.",
   "chatSlashSkillHint": "Press Enter to add this skill for the next turn.",
   "chatPanelAppReferenceLoading": "Loading panel apps...",
@@ -310,22 +315,34 @@
   "chatSessionProjectUpdateHint": "The browser lists directories from the server machine. Changing the project directory only affects future messages and tool runs. History stays unchanged.",
   "chatSessionProjectUpdated": "Project directory updated",
   "chatSessionProjectCleared": "Project directory cleared",
-  "chatProjectCreate": "New Project",
-  "chatProjectCreateTitle": "New Project",
-  "chatProjectCreateDescription": "Create an independent project that remains in the project list even before it has any sessions.",
+  "chatProjectAdd": "Add Project",
+  "chatProjectAddTitle": "Add Project",
+  "chatProjectAddDescription": "Create a new project directory or add an existing directory to the project list.",
+  "chatProjectCreateMode": "Create new",
+  "chatProjectCreateModeDescription": "Create a new project directory and optionally initialize it from a template.",
+  "chatProjectExistingMode": "Add existing directory",
+  "chatProjectExistingModeDescription": "Select an existing directory on the server machine. Its folder name becomes the project name, and its contents will not be changed or initialized.",
   "chatProjectNameLabel": "Project name",
   "chatProjectNamePlaceholder": "For example: Personal knowledge base",
   "chatProjectTemplateLabel": "Project template",
   "chatProjectTemplateEmpty": "Empty project",
   "chatProjectTemplateKnowledgeBase": "Knowledge base",
-  "chatProjectPathLabel": "Target directory (optional)",
-  "chatProjectPathPlaceholder": "/path/to/project",
-  "chatProjectPathHint": "Leave this blank to create a same-named folder under the default working directory, or enter a target directory on the server machine.",
-  "chatProjectPathPickerTitle": "Select Project Target Directory",
-  "chatProjectPathPickerDescription": "Browse directories on the server machine and select where the project contents will be stored.",
+  "chatProjectCreatePathLabel": "Project directory (optional)",
+  "chatProjectCreatePathPlaceholder": "/path/to/new-project",
+  "chatProjectCreatePathHint": "Leave this blank to create a same-named folder under the default working directory, or select an empty directory.",
+  "chatProjectCreatePathPickerTitle": "Select or Create Project Directory",
+  "chatProjectCreatePathPickerDescription": "Select an empty directory or create a new folder for the project.",
+  "chatProjectExistingPathLabel": "Existing project directory",
+  "chatProjectExistingPathPlaceholder": "/path/to/existing-project",
+  "chatProjectExistingPathHint": "The directory must already exist. Its contents will remain unchanged.",
+  "chatProjectExistingPathPickerTitle": "Select Existing Project Directory",
+  "chatProjectExistingPathPickerDescription": "Select the server directory to add to the project list.",
   "chatProjectCreateAction": "Create project",
+  "chatProjectExistingAction": "Add to project list",
   "chatProjectCreated": "Project created",
   "chatProjectCreateFailed": "Failed to create project",
+  "chatProjectExistingAdded": "Project added",
+  "chatProjectExistingFailed": "Failed to add project",
   "chatSessionErrorTitle": "Something went wrong",
   "chatSendFailed": "Failed to send message",
   "chatErrorDetails": "Details",

package/src/shared/lib/i18n/locales/zh-CN/chat.json

@@ -76,6 +76,7 @@
   "chatWorkspacePreviewUnsupported": "该文件暂不支持在侧栏预览。",
   "chatWorkspacePreviewUnsupportedHint": "旧版 Word、PowerPoint、压缩包等暂不支持的格式，可以下载后用本机应用打开。",
   "chatWorkspacePreviewFailed": "文件预览失败。你仍可以下载后用本机应用打开。",
+  "chatWorkspacePreviewNotFound": "找不到这个文件。它可能已被移动、重命名或删除。",
   "chatWorkspaceSpreadsheetPreviewTruncated": "工作簿较大，当前最多显示 500 行和 100 列。",
   "chatWorkspacePreviewDownload": "下载文件",
   "chatWorkspacePreviewOpenExternally": "用系统应用打开",
@@ -153,7 +154,6 @@
   "chatAiExecutionOutput": "输出",
   "chatAiExecutionTokens": "Token",
   "chatAiExecutionPartial": "部分用量",
-  "chatAiExecutionUnavailable": "Token 用量不可用",
   "chatMessageMoreActions": "更多操作",
   "chatAiExecutionViewMetadata": "查看运行元数据",
   "chatAiExecutionMetadataTitle": "AI 运行元数据",
@@ -221,6 +221,11 @@
   "chatSlashCommandSideChatTitle": "侧边对话",
   "chatSlashCommandSideChatDescription": "打开一个继承当前会话上下文的右侧草稿会话。",
   "chatSlashCommandSideChatDetail": "只有发送第一条消息后才会创建真实 child 会话。",
+  "chatSlashCommandCompactContextTitle": "压缩上下文",
+  "chatSlashCommandCompactContextDescription": "总结较早的消息，为当前会话释放上下文空间。",
+  "chatSlashCommandCompactContextDetail": "保留最近一轮和当前任务，供后续继续处理。",
+  "chatSlashCommandCompactContextSuccess": "上下文已压缩",
+  "chatSlashCommandCompactContextFailed": "无法压缩上下文",
   "chatSlashPanelAppHint": "回车在右侧打开这个面板应用。",
   "chatSlashSkillHint": "回车把该技能加入本轮请求。",
   "chatPanelAppReferenceLoading": "加载面板应用中…",
@@ -310,22 +315,34 @@
   "chatSessionProjectUpdateHint": "这里浏览和选择的是服务端机器上的目录。修改项目目录只影响后续消息和后续工具执行，不会改写历史会话。",
   "chatSessionProjectUpdated": "项目目录已更新",
   "chatSessionProjectCleared": "项目目录已清除",
-  "chatProjectCreate": "新建项目",
-  "chatProjectCreateTitle": "新建项目",
-  "chatProjectCreateDescription": "创建一个独立项目。即使还没有会话，项目也会保留在项目列表中。",
+  "chatProjectAdd": "添加项目",
+  "chatProjectAddTitle": "添加项目",
+  "chatProjectAddDescription": "新建一个项目目录，或将已有目录添加到项目列表。",
+  "chatProjectCreateMode": "新建项目",
+  "chatProjectCreateModeDescription": "创建新的项目目录，并可使用模板初始化项目内容。",
+  "chatProjectExistingMode": "添加已有目录",
+  "chatProjectExistingModeDescription": "选择服务端机器上的已有目录。项目名称取目录名，不会修改或初始化目录内容。",
   "chatProjectNameLabel": "项目名称",
   "chatProjectNamePlaceholder": "例如：个人知识库",
   "chatProjectTemplateLabel": "项目模板",
   "chatProjectTemplateEmpty": "空项目",
   "chatProjectTemplateKnowledgeBase": "知识库",
-  "chatProjectPathLabel": "目标目录（可选）",
-  "chatProjectPathPlaceholder": "/path/to/project",
-  "chatProjectPathHint": "留空时，将在默认工作目录下创建与项目同名的文件夹；也可以填写服务端机器上的目标目录。",
-  "chatProjectPathPickerTitle": "选择项目目标目录",
-  "chatProjectPathPickerDescription": "浏览服务端机器上的目录，并选择项目内容保存的位置。",
+  "chatProjectCreatePathLabel": "项目目录（可选）",
+  "chatProjectCreatePathPlaceholder": "/path/to/new-project",
+  "chatProjectCreatePathHint": "留空时，会在默认工作目录下新建与项目同名的文件夹；也可以选择一个空目录。",
+  "chatProjectCreatePathPickerTitle": "选择或新建项目目录",
+  "chatProjectCreatePathPickerDescription": "选择一个空目录，或新建文件夹作为项目目录。",
+  "chatProjectExistingPathLabel": "已有项目目录",
+  "chatProjectExistingPathPlaceholder": "/path/to/existing-project",
+  "chatProjectExistingPathHint": "目录必须已经存在；添加后目录内容保持不变。",
+  "chatProjectExistingPathPickerTitle": "选择已有项目目录",
+  "chatProjectExistingPathPickerDescription": "选择要添加到项目列表的服务端目录。",
   "chatProjectCreateAction": "创建项目",
+  "chatProjectExistingAction": "添加到项目列表",
   "chatProjectCreated": "项目已创建",
   "chatProjectCreateFailed": "创建项目失败",
+  "chatProjectExistingAdded": "项目已添加",
+  "chatProjectExistingFailed": "添加项目失败",
   "chatSessionErrorTitle": "出错了",
   "chatSendFailed": "发送消息失败",
   "chatErrorDetails": "查看详情",

package/src/shared/lib/resource-uri/utils/__tests__/resource-uri-resolver.utils.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { ResourceUriResolver } from '@/shared/lib/resource-uri';
+import { parseResourceUri, ResourceUriResolver } from '@/shared/lib/resource-uri';
 import type { ResourceUriRouteDefinition } from '@/shared/lib/resource-uri';
 
 type TestTarget = {
@@ -27,6 +27,18 @@ const routeDefinitions: ResourceUriRouteDefinition<TestTarget>[] = [
 ];
 
 describe('ResourceUriResolver', () => {
+  it('parses query parameters from root-relative resource URLs', () => {
+    const uri = parseResourceUri('/api/panel-apps/timer/content?path=%2Ftmp%2Ftimer.panel');
+
+    expect(uri).toMatchObject({
+      authority: '',
+      pathSegments: ['api', 'panel-apps', 'timer', 'content'],
+      pathname: '/api/panel-apps/timer/content',
+      scheme: '',
+    });
+    expect(uri.searchParams.get('path')).toBe('/tmp/timer.panel');
+  });
+
   it('resolves URI targets through registered route definitions', () => {
     const resolver = new ResourceUriResolver(routeDefinitions, {
       getNormalizedUri: (target) => target.normalizedUri,

package/src/shared/lib/resource-uri/utils/resource-uri.utils.ts

@@ -10,13 +10,16 @@ function normalizePathSegments(pathname: string): string[] {
 export function parseResourceUri(uri: string): ParsedResourceUri {
   const raw = uri.trim();
   try {
-    const parsed = new URL(raw);
+    const isRootRelative = raw.startsWith('/');
+    const parsed = isRootRelative
+      ? new URL(raw, 'http://nextclaw.local')
+      : new URL(raw);
     return {
-      authority: parsed.hostname,
+      authority: isRootRelative ? '' : parsed.hostname,
       pathSegments: normalizePathSegments(parsed.pathname),
       pathname: parsed.pathname,
       raw,
-      scheme: parsed.protocol.replace(/:$/, '').toLowerCase(),
+      scheme: isRootRelative ? '' : parsed.protocol.replace(/:$/, '').toLowerCase(),
       searchParams: parsed.searchParams,
     };
   } catch {