@nextclaw/ui 0.17.2 → 0.18.1

package/src/features/chat/features/conversation/hooks/use-session-conversation-preference-persistence.ts

@@ -0,0 +1,88 @@
+import { useCallback, useRef } from 'react';
+
+import type { SessionPatchUpdate, ThinkingLevel } from '@/shared/lib/api';
+import { useChatSessionUpdate } from '@/features/chat/features/session/hooks/use-chat-session-update';
+import type {
+  SessionConversationInputActions,
+  SessionConversationInputSnapshot,
+} from '@/features/chat/features/conversation/hooks/use-session-conversation-input-state';
+
+type SessionPreferencePatch = Pick<
+  SessionPatchUpdate,
+  'preferredModel' | 'preferredThinking'
+>;
+
+type SessionPreferenceRollback = Pick<
+  SessionConversationInputSnapshot,
+  'selectedModel' | 'selectedThinkingLevel'
+>;
+
+function ownsField<T extends object>(value: T, field: keyof T): boolean {
+  return Object.prototype.hasOwnProperty.call(value, field);
+}
+
+export function useSessionConversationPreferencePersistence(params: {
+  readonly inputActions: SessionConversationInputActions;
+  readonly selectedSessionKey: string | null;
+}) {
+  const { inputActions, selectedSessionKey } = params;
+  const updateSession = useChatSessionUpdate();
+  const mutationSequenceRef = useRef(0);
+  const latestMutationByFieldRef = useRef(new Map<string, number>());
+  const persistenceQueueRef = useRef<Promise<void>>(Promise.resolve());
+
+  return useCallback((
+    patch: SessionPreferencePatch,
+    optimistic: Partial<SessionPreferenceRollback>,
+    rollback: Partial<SessionPreferenceRollback>,
+  ) => {
+    const sessionKey = selectedSessionKey?.trim();
+    if (!sessionKey) {
+      return;
+    }
+
+    const mutationId = ++mutationSequenceRef.current;
+    const modelMutationKey = `${sessionKey}:model`;
+    const thinkingMutationKey = `${sessionKey}:thinking`;
+    if (ownsField(patch, 'preferredModel')) {
+      latestMutationByFieldRef.current.set(modelMutationKey, mutationId);
+    }
+    if (ownsField(patch, 'preferredThinking')) {
+      latestMutationByFieldRef.current.set(thinkingMutationKey, mutationId);
+    }
+
+    const operation = persistenceQueueRef.current.then(() => updateSession({
+      invalidateSessionSkills: false,
+      sessionKey,
+      patch,
+      successMessage: null,
+    }));
+    persistenceQueueRef.current = operation.catch(() => undefined);
+
+    void operation.catch(() => {
+      inputActions.update((current) => {
+        const next: {
+          selectedModel?: string | null | undefined;
+          selectedThinkingLevel?: ThinkingLevel | null;
+        } = {};
+        if (
+          ownsField(patch, 'preferredModel') &&
+          latestMutationByFieldRef.current.get(modelMutationKey) === mutationId &&
+          current.selectedModel === optimistic.selectedModel &&
+          ownsField(rollback, 'selectedModel')
+        ) {
+          next.selectedModel = rollback.selectedModel;
+        }
+        if (
+          ownsField(patch, 'preferredThinking') &&
+          latestMutationByFieldRef.current.get(thinkingMutationKey) === mutationId &&
+          current.selectedThinkingLevel === optimistic.selectedThinkingLevel &&
+          ownsField(rollback, 'selectedThinkingLevel')
+        ) {
+          next.selectedThinkingLevel = rollback.selectedThinkingLevel;
+        }
+        return next;
+      });
+    });
+  }, [inputActions, selectedSessionKey, updateSession]);
+}

package/src/features/chat/features/conversation/hooks/use-session-conversation-slash-commands.ts

@@ -8,9 +8,15 @@ import type { ChatSlashCommandDescriptor } from '@/features/chat/features/input/
 export function useSessionConversationSlashCommands(params: {
   language: I18nLanguage;
   onContextCompactingChange?: (sessionId: string, isCompacting: boolean) => void;
+  onSendPresetMessage: (message: string) => Promise<void> | void;
   selectedSessionKey?: string | null;
 }): readonly ChatSlashCommandDescriptor[] {
-  const { language, onContextCompactingChange, selectedSessionKey } = params;
+  const {
+    language,
+    onContextCompactingChange,
+    onSendPresetMessage,
+    selectedSessionKey,
+  } = params;
   const presenter = usePresenter();
   const compactingSessionIdsRef = useRef(new Set<string>());
   const compactContext = useCallback(async (sessionId: string) => {
@@ -46,6 +52,17 @@ export function useSessionConversationSlashCommands(params: {
         keywords: ['side', 'chat', 'child', 'branch', 'new'],
         onSelect: () => presenter.chatThreadManager.openSideChatDraft(sessionId),
       },
+      {
+        key: 'update-session-title',
+        icon: 'command',
+        title: t('chatSlashCommandUpdateSessionTitleTitle', language),
+        description: t('chatSlashCommandUpdateSessionTitleDescription', language),
+        detailLines: [t('chatSlashCommandUpdateSessionTitleDetail', language)],
+        keywords: ['update', 'rename', 'title', 'session', '更新', '重命名', '标题', '会话'],
+        onSelect: () => void onSendPresetMessage(
+          t('chatSlashCommandUpdateSessionTitlePrompt', language),
+        ),
+      },
       {
         key: 'compact-context',
         icon: 'list-collapse',
@@ -56,5 +73,11 @@ export function useSessionConversationSlashCommands(params: {
         onSelect: () => void compactContext(sessionId),
       },
     ];
-  }, [compactContext, language, presenter.chatThreadManager, selectedSessionKey]);
+  }, [
+    compactContext,
+    language,
+    onSendPresetMessage,
+    presenter.chatThreadManager,
+    selectedSessionKey,
+  ]);
 }

package/src/features/chat/features/session/hooks/__tests__/use-chat-session-update.test.tsx

@@ -71,4 +71,31 @@ describe('useChatSessionUpdate', () => {
     });
     expect(toast.success).toHaveBeenCalledWith('Project directory updated');
   });
+
+  it('can update an inline preference without showing a success toast', async () => {
+    const queryClient = new QueryClient();
+    const invalidateQueriesSpy = vi.spyOn(queryClient, 'invalidateQueries');
+    mocks.updateNcpSession.mockResolvedValue({
+      sessionId: 'session-1',
+      updatedAt: '2026-08-15T00:00:00.000Z',
+      status: 'idle',
+      metadata: { preferred_thinking: 'off' },
+    });
+    const { result } = renderHook(() => useChatSessionUpdate(), {
+      wrapper: createWrapper(queryClient),
+    });
+
+    await act(async () => {
+      await result.current({
+        invalidateSessionSkills: false,
+        sessionKey: 'session-1',
+        patch: { preferredThinking: 'off' },
+        successMessage: null,
+      });
+    });
+
+    expect(toast.success).not.toHaveBeenCalled();
+    expect(mocks.upsertNcpSessionSummaryInQueryClient).toHaveBeenCalledOnce();
+    expect(invalidateQueriesSpy).not.toHaveBeenCalled();
+  });
 });

package/src/features/chat/features/session/hooks/use-chat-session-update.ts

@@ -1,3 +1,4 @@
+import { useCallback } from 'react';
 import { useQueryClient } from '@tanstack/react-query';
 import { toast } from 'sonner';
 import type { SessionPatchUpdate } from '@/shared/lib/api';
@@ -6,9 +7,10 @@ import { upsertNcpSessionSummaryInQueryClient } from '@/shared/lib/api';
 import { t } from '@/shared/lib/i18n';
 
 type UpdateChatSessionParams = {
+  invalidateSessionSkills?: boolean;
   sessionKey: string;
   patch: SessionPatchUpdate;
-  successMessage?: string;
+  successMessage?: string | null;
 };
 
 type UpdateChatSessionLabelParams = {
@@ -19,18 +21,27 @@ type UpdateChatSessionLabelParams = {
 export function useChatSessionUpdate() {
   const queryClient = useQueryClient();
 
-  return async (params: UpdateChatSessionParams): Promise<void> => {
-    const { sessionKey, patch, successMessage } = params;
+  return useCallback(async (params: UpdateChatSessionParams): Promise<void> => {
+    const {
+      invalidateSessionSkills = true,
+      sessionKey,
+      patch,
+      successMessage,
+    } = params;
     try {
       const updated = await updateNcpSession(sessionKey, patch);
       upsertNcpSessionSummaryInQueryClient(queryClient, updated);
-      await queryClient.invalidateQueries({ queryKey: ['ncp-session-skills', sessionKey] });
-      toast.success(successMessage ?? t('configSavedApplied'));
+      if (invalidateSessionSkills) {
+        await queryClient.invalidateQueries({ queryKey: ['ncp-session-skills', sessionKey] });
+      }
+      if (successMessage !== null) {
+        toast.success(successMessage ?? t('configSavedApplied'));
+      }
     } catch (error) {
       toast.error(t('configSaveFailed') + ': ' + (error instanceof Error ? error.message : String(error)));
       throw error;
     }
-  };
+  }, [queryClient]);
 }
 
 export function useChatSessionLabel() {

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

@@ -296,6 +296,10 @@
   "chatSlashCommandCompactContextDetail": "Keeps the latest turn and the active task available for continuation.",
   "chatSlashCommandCompactContextSuccess": "Context compacted",
   "chatSlashCommandCompactContextFailed": "Couldn't compact context",
+  "chatSlashCommandUpdateSessionTitleTitle": "Update session title",
+  "chatSlashCommandUpdateSessionTitleDescription": "Ask AI to create a concise title from this conversation and update the session.",
+  "chatSlashCommandUpdateSessionTitleDetail": "Sends a message automatically without replacing your current draft.",
+  "chatSlashCommandUpdateSessionTitlePrompt": "Create a concise, accurate title based on this conversation, then use the sessions_update tool to update the current session title now. Do not only suggest a title.",
   "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...",

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

@@ -296,6 +296,10 @@
   "chatSlashCommandCompactContextDetail": "保留最近一轮和当前任务，供后续继续处理。",
   "chatSlashCommandCompactContextSuccess": "上下文已压缩",
   "chatSlashCommandCompactContextFailed": "无法压缩上下文",
+  "chatSlashCommandUpdateSessionTitleTitle": "更新会话标题",
+  "chatSlashCommandUpdateSessionTitleDescription": "让 AI 根据当前会话内容生成简洁标题并完成更新。",
+  "chatSlashCommandUpdateSessionTitleDetail": "命令会自动发送一条消息，不会覆盖输入框中的草稿。",
+  "chatSlashCommandUpdateSessionTitlePrompt": "请根据当前会话内容生成一个简洁、准确的标题，然后立即使用 sessions_update 工具更新当前会话标题。不要只给出标题建议。",
   "chatSlashPanelAppHint": "回车在右侧打开这个面板应用。",
   "chatSlashSkillHint": "回车把该技能加入本轮请求。",
   "chatPanelAppReferenceLoading": "加载面板应用中…",

package/dist/assets/doc-browser-DUqckL2E.js

@@ -1 +0,0 @@
-import{t as e}from"./doc-browser-CbCBDdap.js";export{e as DocBrowser};