@nextclaw/ui 0.15.23 → 0.15.24

package/src/features/chat/features/conversation/hooks/use-chat-composer-reference-intent.ts

@@ -1,6 +1,9 @@
 import { useEffect, type RefObject } from 'react';
 import { type ChatInputBarHandle } from '@nextclaw/agent-chat-ui';
-import { CHAT_WORKSPACE_EXCERPT_TOKEN_KIND } from '@nextclaw/shared';
+import {
+  CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
+  CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
+} from '@nextclaw/shared';
 
 import type {
   ChatComposerIntentManager,
@@ -32,6 +35,12 @@ export function useChatComposerReferenceIntent(params: {
               startLine: intent.startLine,
               endLine: intent.endLine,
             }
+          : intent.kind === CHAT_CONVERSATION_EXCERPT_TOKEN_KIND
+            ? {
+                messageId: intent.messageId,
+                role: intent.role,
+                excerpt: intent.excerpt,
+              }
           : undefined,
       });
       intentManager.markConsumed(intent.id);

package/src/features/chat/features/conversation/hooks/use-session-provider-model-catalog.ts

@@ -4,12 +4,69 @@ import type { RuntimeModelSelectionMode } from '@nextclaw/shared';
 import type { ConfigView, ProvidersView, ProviderTemplatesView } from '@/shared/lib/api';
 import { useProviderModelCatalog, useUpdateProvider } from '@/shared/hooks/use-config';
 import { normalizeStringList } from '@/shared/lib/provider-models';
+import type { DiscoveredChatModelOption } from '@/features/chat/types/chat-input.types';
 import {
   buildNcpChatDiscoveredModelOptions,
   filterNcpChatDiscoveredModelOptionsBySessionType,
 } from '@/features/chat/features/ncp/utils/ncp-chat-query-derived.utils';
 import { providerModelCatalogNoticeManager } from '@/features/chat/managers/provider-model-catalog-notice.manager';
 
+const MODEL_DISCOVERY_PREVIEW_PROVIDER_PREFIX = '__nextclaw-preview__';
+const MODEL_DISCOVERY_PREVIEW_GROUPS = [
+  {
+    providerId: 'opencode',
+    providerLabel: 'OpenCode Zen Free Trial',
+    models: [
+      'deepseek-v4-flash-free',
+      'laguna-s-2.1-free',
+      'longcat-2.0-free',
+      'mimo-v2.5-free',
+      'nemotron-3-ultra-free',
+      'north-mini-code-free',
+      'trinity-large-preview-free',
+    ],
+  },
+  {
+    providerId: 'openrouter',
+    providerLabel: 'OpenRouter',
+    models: [
+      'inclusionai/ling-3.0-tiny:free',
+      'qwen/qwen3-coder:free',
+      'deepseek/deepseek-r1:free',
+      'mistralai/mistral-small:free',
+      'google/gemma-3-27b-it:free',
+    ],
+  },
+  {
+    providerId: 'kimi',
+    providerLabel: 'Kimi',
+    models: ['kimi-k2.5-preview', 'kimi-dev-72b', 'moonshot-v1-128k-preview'],
+  },
+] as const;
+
+export function buildProviderModelDiscoveryPreviewOptions(params: {
+  enabled: boolean;
+  search: string;
+}): DiscoveredChatModelOption[] {
+  if (!params.enabled || new URLSearchParams(params.search).get('preview') !== 'model-discovery') {
+    return [];
+  }
+  return MODEL_DISCOVERY_PREVIEW_GROUPS.flatMap((group) =>
+    group.models.map((model) => ({
+      value: `${MODEL_DISCOVERY_PREVIEW_PROVIDER_PREFIX}${group.providerId}/${model}`,
+      providerId: `${MODEL_DISCOVERY_PREVIEW_PROVIDER_PREFIX}${group.providerId}`,
+      providerModel: model,
+      modelLabel: model,
+      providerLabel: group.providerLabel,
+      thinkingCapability: null,
+    })),
+  );
+}
+
+function isProviderModelDiscoveryPreviewOption(option: DiscoveredChatModelOption): boolean {
+  return option.providerId.startsWith(MODEL_DISCOVERY_PREVIEW_PROVIDER_PREFIX);
+}
+
 type UseSessionProviderModelCatalogParams = {
   readonly config: ConfigView | null;
   readonly providersView: ProvidersView | null;
@@ -29,6 +86,14 @@ export function useSessionProviderModelCatalog(params: UseSessionProviderModelCa
   const catalogQuery = useProviderModelCatalog();
   const { mutateAsync: updateProvider } = useUpdateProvider();
   const [noticeRevision, setNoticeRevision] = useState(0);
+  const [previewDismissed, setPreviewDismissed] = useState(false);
+  const previewModelOptions = useMemo(
+    () => buildProviderModelDiscoveryPreviewOptions({
+      enabled: import.meta.env.DEV && !import.meta.env.VITEST,
+      search: typeof window === 'undefined' ? '' : window.location.search,
+    }),
+    [],
+  );
   const catalogModelOptions = useMemo(
     () => buildNcpChatDiscoveredModelOptions({
       catalogView: catalogQuery.data ?? null,
@@ -44,16 +109,22 @@ export function useSessionProviderModelCatalog(params: UseSessionProviderModelCa
   const discoveredModelOptions = useMemo(
     () => {
       void noticeRevision;
+      if (previewModelOptions.length > 0 && !previewDismissed) {
+        return previewModelOptions;
+      }
       return filterNcpChatDiscoveredModelOptionsBySessionType({
         modelOptions: providerModelCatalogNoticeManager.filterUnseen(catalogModelOptions),
         modelSelectionMode,
         supportedModels,
       });
     },
-    [catalogModelOptions, modelSelectionMode, noticeRevision, supportedModels],
+    [catalogModelOptions, modelSelectionMode, noticeRevision, previewDismissed, previewModelOptions, supportedModels],
   );
   const addDiscoveredModel = useCallback(async (value: string) => {
     const option = discoveredModelOptions.find((candidate) => candidate.value === value);
+    if (option && isProviderModelDiscoveryPreviewOption(option)) {
+      return option;
+    }
     const provider = option ? providersView?.providers[option.providerId] : undefined;
     if (!option || !provider) {
       return null;
@@ -70,6 +141,10 @@ export function useSessionProviderModelCatalog(params: UseSessionProviderModelCa
     return option;
   }, [discoveredModelOptions, providersView, updateProvider]);
   const dismissDiscoveredModels = useCallback(() => {
+    if (discoveredModelOptions.some(isProviderModelDiscoveryPreviewOption)) {
+      setPreviewDismissed(true);
+      return;
+    }
     if (providerModelCatalogNoticeManager.acknowledge(discoveredModelOptions)) {
       setNoticeRevision((current) => current + 1);
     }

package/src/features/chat/features/conversation/utils/session-conversation-input-toolbar.utils.ts

@@ -46,7 +46,9 @@ type ToolbarSelectBuildParams = {
   readonly unfavoriteModelLabel: string;
 };
 
-export function buildSessionConversationToolbarSelects(params: ToolbarSelectBuildParams) {
+export function buildSessionConversationToolbarSelects(
+  params: ToolbarSelectBuildParams,
+) {
   const {
     allModelsLabel,
     favoriteModelLabel,
@@ -99,7 +101,10 @@ export function buildSessionConversationToolbarSelects(params: ToolbarSelectBuil
         discoveredModelsViewLabel: t('chatDiscoveredModelsView'),
         discoveredModelsGroupLabel: t('chatDiscoveredModelsGroup'),
         discoveredModelAddLabel: t('chatDiscoveredModelAdd'),
+        discoveredModelAddedLabel: t('chatDiscoveredModelAddedShort'),
         discoveredModelsDismissLabel: t('chatDiscoveredModelsDismiss'),
+        discoveredModelsDoneLabel: t('chatDiscoveredModelsDone'),
+        discoveredModelsCloseLabel: t('chatDiscoveredModelsClose'),
         recentModelsLabel,
         allModelsLabel,
       },

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

@@ -3,6 +3,7 @@ import {
   buildInlineTokensFromTextProtocol,
   buildInlineTokensFromComposer,
   CHAT_INLINE_TOKENS_METADATA_KEY,
+  createInlineTokensMetadata,
   readInlineTokensFromMetadata,
   resolveInlineTokensForText,
   resolveWorkspaceReferencePath,
@@ -278,6 +279,34 @@ describe('chat inline token workspace references', () => {
     ]);
   });
 
+  it('round-trips conversation excerpts with their immutable snapshot', () => {
+    const tokens = buildInlineTokensFromComposer([
+      createChatComposerTokenNode({
+        tokenKind: 'conversation_excerpt',
+        tokenKey: 'assistant-1#excerpt-demo',
+        label: 'AI reply',
+        data: {
+          messageId: 'assistant-1',
+          role: 'assistant',
+          excerpt: 'Keep the visible tag concise.',
+        },
+      }),
+    ]);
+
+    expect(tokens).toEqual([{
+      kind: 'conversation_excerpt',
+      key: 'assistant-1#excerpt-demo',
+      messageId: 'assistant-1',
+      role: 'assistant',
+      label: 'AI reply',
+      excerpt: 'Keep the visible tag concise.',
+      rawText: '@message-excerpt:assistant-1%23excerpt-demo',
+    }]);
+    expect(readInlineTokensFromMetadata({
+      ui_inline_tokens: createInlineTokensMetadata(tokens),
+    })).toEqual(tokens);
+  });
+
   it('resolves workspace token paths inside POSIX and Windows project roots', () => {
     expect(resolveWorkspaceReferencePath({
       projectRoot: '/tmp/project/',

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

@@ -28,7 +28,10 @@ function createModelTexts() {
     discoveredModelsViewLabel: 'View',
     discoveredModelsGroupLabel: 'New models',
     discoveredModelAddLabel: 'Add',
-    discoveredModelsDismissLabel: "Don't remind me about these",
+    discoveredModelAddedLabel: 'Added',
+    discoveredModelsDismissLabel: 'Dismiss this batch',
+    discoveredModelsDoneLabel: 'Done',
+    discoveredModelsCloseLabel: 'Close new models',
     recentModelsLabel: 'Recent',
     allModelsLabel: 'All models'
   };
@@ -64,7 +67,6 @@ describe('buildModelStateHint', () => {
     });
   });
 });
-
 describe('buildChatSlashItems', () => {
   const texts = {
     slashSkillSubtitle: 'Skill',
@@ -316,7 +318,12 @@ describe('buildModelToolbarSelect', () => {
       groupLabel: 'New models',
       allGroupLabel: 'All models',
       actionLabel: 'Add',
-      dismissLabel: "Don't remind me about these",
+      addedLabel: 'Added',
+      dismissLabel: 'Dismiss this batch',
+      doneLabel: 'Done',
+      closeLabel: 'Close new models',
+      searchPlaceholder: 'Search models',
+      searchEmptyLabel: 'No matching models',
       groups: [
         {
           key: 'opencode',
@@ -340,7 +347,9 @@ describe('buildModelToolbarSelect', () => {
     });
     expect(select.onOpen).toBe(onOpen);
   });
+});
 
+describe('buildModelToolbarSelect selection', () => {
   it('falls back to the first available option when the selected model is missing', () => {
     const onValueChange = vi.fn();
     const select = buildModelToolbarSelect({

package/src/features/chat/features/input/utils/chat-composer-token-protocol.utils.ts

@@ -1,4 +1,5 @@
 import {
+  CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
   CHAT_PROJECT_TOKEN_KIND,
   CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND,
   CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
@@ -11,6 +12,7 @@ const CHAT_PROJECT_TOKEN_PREFIX = '@project:';
 const CHAT_WORKSPACE_FILE_TOKEN_PREFIX = '@file:';
 const CHAT_WORKSPACE_DIRECTORY_TOKEN_PREFIX = '@folder:';
 const CHAT_WORKSPACE_EXCERPT_TOKEN_PREFIX = '@excerpt:';
+const CHAT_CONVERSATION_EXCERPT_TOKEN_PREFIX = '@message-excerpt:';
 
 export function serializeChatComposerTokenText(params: {
   label?: string;
@@ -36,5 +38,8 @@ export function serializeChatComposerTokenText(params: {
   if (tokenKind === CHAT_WORKSPACE_EXCERPT_TOKEN_KIND) {
     return `${CHAT_WORKSPACE_EXCERPT_TOKEN_PREFIX}${encodeURIComponent(tokenKey)}`;
   }
+  if (tokenKind === CHAT_CONVERSATION_EXCERPT_TOKEN_KIND) {
+    return `${CHAT_CONVERSATION_EXCERPT_TOKEN_PREFIX}${encodeURIComponent(tokenKey)}`;
+  }
   return null;
 }

package/src/features/chat/features/input/utils/chat-conversation-excerpt-token.utils.ts

@@ -0,0 +1,59 @@
+import type { ChatComposerNode } from '@nextclaw/agent-chat-ui';
+import {
+  CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
+  type ChatConversationExcerptInlineTokenMetadata,
+} from '@nextclaw/shared';
+
+type ComposerTokenNode = Extract<ChatComposerNode, { type: 'token' }>;
+
+function readRequiredString(value: unknown): string | null {
+  return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+function readConversationExcerptFields(source: Record<string, unknown>): {
+  messageId: string;
+  role: 'assistant' | 'user';
+  excerpt: string;
+} | null {
+  const messageId = readRequiredString(source.messageId);
+  const excerpt = readRequiredString(source.excerpt);
+  const { role } = source;
+  return messageId && excerpt && (role === 'assistant' || role === 'user')
+    ? { messageId, role, excerpt }
+    : null;
+}
+
+export function buildConversationExcerptInlineToken(
+  node: ComposerTokenNode,
+  rawText: string,
+): ChatConversationExcerptInlineTokenMetadata | null {
+  const fields = readConversationExcerptFields(node.data ?? {});
+  return fields
+    ? {
+        kind: CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
+        key: node.tokenKey,
+        label: node.label,
+        rawText,
+        ...fields,
+      }
+    : null;
+}
+
+export function readConversationExcerptInlineToken(params: {
+  entry: Record<string, unknown>;
+  label: string;
+  rawText: string;
+}): ChatConversationExcerptInlineTokenMetadata | null {
+  const { entry, label, rawText } = params;
+  const key = readRequiredString(entry.key);
+  const fields = readConversationExcerptFields(entry);
+  return key && fields
+    ? {
+        kind: CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
+        key,
+        label,
+        rawText,
+        ...fields,
+      }
+    : null;
+}

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

@@ -1,5 +1,6 @@
 import type { ChatComposerNode } from '@nextclaw/agent-chat-ui';
 import {
+  CHAT_CONVERSATION_EXCERPT_TOKEN_KIND,
   CHAT_INLINE_TOKENS_METADATA_KEY,
   CHAT_INLINE_TOKENS_SCHEMA_VERSION,
   CHAT_PROJECT_TOKEN_KIND,
@@ -11,6 +12,7 @@ import {
   type ChatSkillSource,
 } from '@nextclaw/shared';
 import { serializeChatComposerTokenText } from './chat-composer-token-protocol.utils';
+import { buildConversationExcerptInlineToken, readConversationExcerptInlineToken } from './chat-conversation-excerpt-token.utils';
 
 export { CHAT_INLINE_TOKENS_METADATA_KEY };
 const CHAT_PANEL_APP_TOKEN_PREFIX = '@panel-app:';
@@ -36,6 +38,15 @@ export type ChatInlineTokenSource =
       label: string;
       rawText: string;
     }
+  | {
+      kind: typeof CHAT_CONVERSATION_EXCERPT_TOKEN_KIND;
+      key: string;
+      messageId: string;
+      role: 'assistant' | 'user';
+      label: string;
+      excerpt: string;
+      rawText: string;
+    }
   | {
       kind: typeof CHAT_WORKSPACE_EXCERPT_TOKEN_KIND;
       key: string;
@@ -103,6 +114,26 @@ function dedupeInlineTokens<T extends ChatInlineTokenSource>(tokens: readonly T[
   return output;
 }
 
+function appendWorkspaceExcerptToken(
+  tokens: ChatInlineTokenMetadata[],
+  node: Extract<ChatComposerNode, { type: 'token' }>,
+  rawText: string,
+): void {
+  const path = readOptionalString(node.data?.path);
+  const excerpt = readOptionalString(node.data?.excerpt);
+  if (!path || !excerpt) return;
+  tokens.push({
+    kind: CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
+    key: node.tokenKey,
+    path,
+    label: node.label,
+    excerpt,
+    startLine: readOptionalLine(node.data?.startLine),
+    endLine: readOptionalLine(node.data?.endLine),
+    rawText,
+  });
+}
+
 export function buildInlineTokensFromComposer(
   nodes: readonly ChatComposerNode[],
   skillRecords: readonly ChatSkillReferenceSnapshot[] = [],
@@ -118,7 +149,8 @@ export function buildInlineTokensFromComposer(
       node.tokenKind !== CHAT_PROJECT_TOKEN_KIND &&
       node.tokenKind !== CHAT_WORKSPACE_FILE_TOKEN_KIND &&
       node.tokenKind !== CHAT_WORKSPACE_DIRECTORY_TOKEN_KIND &&
-      node.tokenKind !== CHAT_WORKSPACE_EXCERPT_TOKEN_KIND
+      node.tokenKind !== CHAT_WORKSPACE_EXCERPT_TOKEN_KIND &&
+      node.tokenKind !== CHAT_CONVERSATION_EXCERPT_TOKEN_KIND
     ) {
       continue;
     }
@@ -152,21 +184,12 @@ export function buildInlineTokensFromComposer(
       continue;
     }
     if (node.tokenKind === CHAT_WORKSPACE_EXCERPT_TOKEN_KIND) {
-      const path = readOptionalString(node.data?.path);
-      const excerpt = readOptionalString(node.data?.excerpt);
-      if (!path || !excerpt) {
-        continue;
-      }
-      tokens.push({
-        kind: CHAT_WORKSPACE_EXCERPT_TOKEN_KIND,
-        key: node.tokenKey,
-        path,
-        label: node.label,
-        excerpt,
-        startLine: readOptionalLine(node.data?.startLine),
-        endLine: readOptionalLine(node.data?.endLine),
-        rawText,
-      });
+      appendWorkspaceExcerptToken(tokens, node, rawText);
+      continue;
+    }
+    if (node.tokenKind === CHAT_CONVERSATION_EXCERPT_TOKEN_KIND) {
+      const token = buildConversationExcerptInlineToken(node, rawText);
+      if (token) tokens.push(token);
       continue;
     }
     const workspaceKind = node.tokenKind === CHAT_WORKSPACE_FILE_TOKEN_KIND
@@ -314,6 +337,9 @@ function readInlineTokenEntry(entry: unknown): ChatInlineTokenSource | null {
   if (kind === CHAT_WORKSPACE_EXCERPT_TOKEN_KIND) {
     return readWorkspaceExcerptInlineToken({ entry, label, rawText });
   }
+  if (kind === CHAT_CONVERSATION_EXCERPT_TOKEN_KIND) {
+    return readConversationExcerptInlineToken({ entry, label, rawText });
+  }
   const key = readOptionalString(entry.key);
   return key ? { kind, key, rawText, label } : null;
 }

package/src/features/chat/features/input/utils/chat-input-toolbar.utils.ts

@@ -14,7 +14,6 @@ function formatModelOptionLabel(option: ChatModelRecord): string {
   const providerLabel = option.providerLabel.trim();
   return providerLabel ? `${providerLabel}/${modelLabel}` : modelLabel;
 }
-
 function buildDiscoveredModelGroups(options: ChatModelRecord[]) {
   const groups = new Map<string, { key: string; label: string; options: Array<{ value: string; label: string }> }>();
   for (const option of options) {
@@ -81,6 +80,47 @@ export function buildModelStateHint(params: {
   };
 }
 
+function buildModelDiscovery(params: {
+  options: ChatModelRecord[];
+  onDismiss?: () => void;
+  onSelect?: (value: string) => Promise<void> | void;
+  texts: Pick<
+    ChatInputBarAdapterTexts,
+    | "allModelsLabel"
+    | "discoveredModelAddLabel"
+    | "discoveredModelAddedLabel"
+    | "discoveredModelsCloseLabel"
+    | "discoveredModelsDismissLabel"
+    | "discoveredModelsDoneLabel"
+    | "discoveredModelsGroupLabel"
+    | "discoveredModelsSummaryLabel"
+    | "discoveredModelsViewLabel"
+    | "modelSearchEmptyLabel"
+    | "modelSearchPlaceholder"
+  >;
+}): ChatToolbarSelect["discovery"] {
+  const { onDismiss, onSelect, options, texts } = params;
+  if (!onDismiss || !onSelect || options.length === 0) {
+    return undefined;
+  }
+  return {
+    summaryLabel: texts.discoveredModelsSummaryLabel.replace('{count}', String(options.length)),
+    viewLabel: texts.discoveredModelsViewLabel,
+    groupLabel: texts.discoveredModelsGroupLabel,
+    allGroupLabel: texts.allModelsLabel,
+    actionLabel: texts.discoveredModelAddLabel,
+    addedLabel: texts.discoveredModelAddedLabel,
+    dismissLabel: texts.discoveredModelsDismissLabel,
+    doneLabel: texts.discoveredModelsDoneLabel,
+    closeLabel: texts.discoveredModelsCloseLabel,
+    searchPlaceholder: texts.modelSearchPlaceholder,
+    searchEmptyLabel: texts.modelSearchEmptyLabel,
+    groups: buildDiscoveredModelGroups(options),
+    onDismiss,
+    onSelect,
+  };
+}
+
 export function buildModelToolbarSelect({
   modelOptions,
   discoveredModelOptions,
@@ -122,7 +162,10 @@ export function buildModelToolbarSelect({
     | "discoveredModelsViewLabel"
     | "discoveredModelsGroupLabel"
     | "discoveredModelAddLabel"
+    | "discoveredModelAddedLabel"
     | "discoveredModelsDismissLabel"
+    | "discoveredModelsDoneLabel"
+    | "discoveredModelsCloseLabel"
     | "recentModelsLabel"
     | "allModelsLabel"
   >;
@@ -210,19 +253,12 @@ export function buildModelToolbarSelect({
           onToggle: onFavoriteToggle,
         }
       : undefined,
-    discovery: onDiscoveredModelSelect && onDiscoveredModelsDismiss && discoveryOptions.length > 0
-      ? {
-          summaryLabel: texts.discoveredModelsSummaryLabel.replace('{count}', String(discoveryOptions.length)),
-          viewLabel: texts.discoveredModelsViewLabel,
-          groupLabel: texts.discoveredModelsGroupLabel,
-          allGroupLabel: texts.allModelsLabel,
-          actionLabel: texts.discoveredModelAddLabel,
-          dismissLabel: texts.discoveredModelsDismissLabel,
-          groups: buildDiscoveredModelGroups(discoveryOptions),
-          onDismiss: onDiscoveredModelsDismiss,
-          onSelect: onDiscoveredModelSelect,
-        }
-      : undefined,
+    discovery: buildModelDiscovery({
+      options: discoveryOptions,
+      onDismiss: onDiscoveredModelsDismiss,
+      onSelect: onDiscoveredModelSelect,
+      texts,
+    }),
     manageLabel: texts.manageModelsLabel,
     manageHref: "/providers",
     onOpen,

package/src/features/chat/features/message/components/chat-message-list.container.tsx

@@ -7,6 +7,7 @@ import {
 } from "react";
 import type { NcpMessage } from "@nextclaw/ncp";
 import {
+  ChatTextSelectionAction,
   type ChatInlineDisplayViewModel,
   type ChatMessageViewModel,
   type ChatPanelAppCardViewModel,
@@ -176,6 +177,16 @@ const renderChatPanelAppCard = (panelApp: ChatPanelAppCardViewModel) => (
   <ChatInlinePanelAppCard panelApp={panelApp} />
 );
 
+const CONVERSATION_EXCERPT_MAX_CHARACTERS = 8_000;
+
+function findSelectableMessageElement(range: Range): HTMLElement | null {
+  const commonAncestor = range.commonAncestorContainer;
+  const element = commonAncestor instanceof Element
+    ? commonAncestor
+    : commonAncestor.parentElement;
+  return element?.closest<HTMLElement>('[data-chat-message-selectable="true"]') ?? null;
+}
+
 export { ChatContextCompactionDivider } from "@/features/chat/features/message/components/chat-message-timeline-dividers";
 
 function isAwaitingAssistantOutputRow(
@@ -299,6 +310,27 @@ export function ChatMessageListContainer({
     () => buildChatMessageTexts(language),
     [language],
   );
+  const isConversationSelectionAllowed = useCallback(
+    ({ range }: { range: Range }) => Boolean(findSelectableMessageElement(range)),
+    [],
+  );
+  const handleConversationSelectionAdd = useCallback(
+    ({ range, text }: { range: Range; text: string }) => {
+      const messageElement = findSelectableMessageElement(range);
+      const messageId = messageElement?.dataset.chatMessageId?.trim();
+      const role = messageElement?.dataset.chatMessageRole;
+      const label = messageElement?.dataset.chatMessageRoleLabel?.trim();
+      if (!messageId || !label || (role !== "assistant" && role !== "user")) return;
+      presenter.chatComposerIntentManager.requestConversationExcerptReference({
+        targetSessionKey: sessionKey,
+        messageId,
+        role,
+        label,
+        excerpt: text,
+      });
+    },
+    [presenter.chatComposerIntentManager, sessionKey],
+  );
   const timelineItems = useMemo(
     () => buildChatMessageTimelineItems({ rawMessages, messages }),
     [messages, rawMessages],
@@ -341,6 +373,13 @@ export function ChatMessageListContainer({
     [],
   );
   return (
+    <ChatTextSelectionAction
+      actionLabel={messageTexts.addSelectionToChatLabel ?? t("chatWorkspaceAddToChat")}
+      isSelectionAllowed={isConversationSelectionAllowed}
+      maxCharacters={CONVERSATION_EXCERPT_MAX_CHARACTERS}
+      onAddToChat={handleConversationSelectionAdd}
+      selectionTooLongLabel={messageTexts.selectionTooLongLabel ?? t("chatWorkspaceExcerptSelectionTooLong")}
+    >
     <div className={cn("relative", className)} ref={containerRef}>
       {virtualizer.getVirtualItems().map((virtualRow) => {
         const item = virtualRows[virtualRow.index];
@@ -388,5 +427,6 @@ export function ChatMessageListContainer({
         );
       })}
     </div>
+    </ChatTextSelectionAction>
   );
 }

package/src/features/chat/features/message/utils/chat-message-texts.utils.ts

@@ -145,6 +145,8 @@ export function buildChatMessageTexts(
 ): ChatMessageTexts {
   void language;
   return {
+    addSelectionToChatLabel: t("chatWorkspaceAddToChat"),
+    selectionTooLongLabel: t("chatWorkspaceExcerptSelectionTooLong"),
     copyCodeLabel: t("chatCodeCopy"),
     copiedCodeLabel: t("chatCodeCopied"),
     copyMessageLabel: t("chatMessageCopy"),
@@ -154,6 +156,9 @@ export function buildChatMessageTexts(
     mermaidExpandLabel: t("chatMermaidExpand"),
     mermaidLoadingLabel: t("chatMermaidLoading"),
     mermaidRenderErrorLabel: t("chatMermaidRenderError"),
+    previewZoomInLabel: t("chatPreviewZoomIn"),
+    previewZoomOutLabel: t("chatPreviewZoomOut"),
+    previewResetZoomLabel: t("chatPreviewResetZoom"),
     typingLabel: t("chatTyping"),
     reasoningCharacterCountTemplates: {
       inProgress: t("chatReasoningInProgressCharacterCount"),

package/src/features/chat/features/workspace/components/__tests__/workspace-text-selection-menu.test.tsx

@@ -17,7 +17,9 @@ describe("WorkspaceTextSelectionMenu", () => {
       </WorkspaceTextSelectionMenu>,
     );
 
-    const textNode = screen.getByText("selected text").firstChild;
+    const selectedText = screen.getByText("selected text");
+    fireEvent.pointerDown(selectedText);
+    const textNode = selectedText.firstChild;
     expect(textNode).toBeTruthy();
     const range = document.createRange();
     range.selectNodeContents(textNode!);
@@ -34,9 +36,14 @@ describe("WorkspaceTextSelectionMenu", () => {
     });
     window.getSelection()?.removeAllRanges();
     window.getSelection()?.addRange(range);
+    document.dispatchEvent(new Event("selectionchange"));
+    expect(screen.queryByRole("button", { name: /Add to chat|添加到聊天/ })).toBeNull();
 
-    fireEvent.mouseUp(screen.getByText("selected text"));
-    fireEvent.click(await screen.findByRole("button", { name: /Add to chat|添加到聊天/ }));
+    fireEvent.pointerUp(selectedText);
+    const menu = await screen.findByRole("button", { name: /Add to chat|添加到聊天/ });
+    await waitFor(() => expect(menu.style.visibility).toBe("visible"));
+    expect(menu.style.top).toBe("50px");
+    fireEvent.click(menu);
 
     expect(onAddToChat).toHaveBeenCalledWith({
       path: "docs/guide.md",
@@ -91,7 +98,7 @@ describe("WorkspaceTextSelectionMenu", () => {
 
     const menu = await screen.findByRole("button", { name: /Add to chat|添加到聊天/ });
     await waitFor(() => expect(menu.style.visibility).toBe("visible"));
-    expect(menu.style.left).toBe("188px");
+    expect(menu.style.left).toBe("110px");
     expect(menu.style.top).toBe("130px");
     expect(menu.className).toContain("whitespace-nowrap");