@nextclaw/ui 0.15.22 → 0.15.24

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

@@ -0,0 +1,159 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+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;
+  readonly templatesView: ProviderTemplatesView | null;
+  readonly modelSelectionMode?: RuntimeModelSelectionMode;
+  readonly supportedModels?: string[];
+};
+
+export function useSessionProviderModelCatalog(params: UseSessionProviderModelCatalogParams) {
+  const {
+    config,
+    modelSelectionMode,
+    providersView,
+    supportedModels,
+    templatesView,
+  } = params;
+  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,
+      config,
+      providersView,
+      templatesView,
+    }),
+    [catalogQuery.data, config, providersView, templatesView],
+  );
+  useEffect(() => {
+    providerModelCatalogNoticeManager.initializeLargeCatalogs(catalogModelOptions);
+  }, [catalogModelOptions]);
+  const discoveredModelOptions = useMemo(
+    () => {
+      void noticeRevision;
+      if (previewModelOptions.length > 0 && !previewDismissed) {
+        return previewModelOptions;
+      }
+      return filterNcpChatDiscoveredModelOptionsBySessionType({
+        modelOptions: providerModelCatalogNoticeManager.filterUnseen(catalogModelOptions),
+        modelSelectionMode,
+        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;
+    }
+    await updateProvider({
+      provider: option.providerId,
+      data: {
+        models: normalizeStringList([...(provider.models ?? []), option.providerModel]),
+      },
+      silentSuccess: true,
+    });
+    providerModelCatalogNoticeManager.acknowledge([option]);
+    setNoticeRevision((current) => current + 1);
+    return option;
+  }, [discoveredModelOptions, providersView, updateProvider]);
+  const dismissDiscoveredModels = useCallback(() => {
+    if (discoveredModelOptions.some(isProviderModelDiscoveryPreviewOption)) {
+      setPreviewDismissed(true);
+      return;
+    }
+    if (providerModelCatalogNoticeManager.acknowledge(discoveredModelOptions)) {
+      setNoticeRevision((current) => current + 1);
+    }
+  }, [discoveredModelOptions]);
+
+  return {
+    addDiscoveredModel,
+    dismissDiscoveredModels,
+    discoveredModelOptions,
+    refreshProviderModelCatalog: catalogQuery.refetch,
+  };
+}

package/src/features/chat/features/conversation/utils/__tests__/session-message-composer.utils.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vitest';
+
+import { buildSessionMessageComposerSnapshot } from '@/features/chat/features/conversation/utils/session-message-composer.utils';
+
+describe('buildSessionMessageComposerSnapshot', () => {
+  it('round-trips text, attachment and requested skill state into the shared composer', () => {
+    const snapshot = buildSessionMessageComposerSnapshot({
+      attachmentIdPrefix: 'edit-user-1',
+      availableSkills: [{ ref: 'skill://review', name: 'Review' }],
+      message: {
+        id: 'user-1',
+        sessionId: 'session-1',
+        role: 'user',
+        status: 'final',
+        timestamp: '2026-08-08T10:00:00.000Z',
+        metadata: { requested_skill_refs: ['skill://review'] },
+        parts: [
+          { type: 'text', text: 'check this' },
+          { type: 'file', name: 'notes.txt', mimeType: 'text/plain', sizeBytes: 12 },
+        ],
+      },
+    });
+
+    expect(snapshot.text).toContain('check this');
+    expect(snapshot.selectedSkills).toEqual(['skill://review']);
+    expect(snapshot.skillRecords).toEqual([{ ref: 'skill://review', name: 'Review' }]);
+    expect(snapshot.attachments).toEqual([
+      expect.objectContaining({ id: 'edit-user-1-1', name: 'notes.txt' }),
+    ]);
+    expect(snapshot.nodes).toEqual(expect.arrayContaining([
+      expect.objectContaining({ type: 'token', tokenKind: 'file' }),
+    ]));
+  });
+});

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

@@ -28,9 +28,13 @@ type ToolbarSelectBuildParams = {
   readonly hasModelOptions: boolean;
   readonly isModelOptionsLoading: boolean;
   readonly modelRecords: ChatModelRecord[];
+  readonly discoveredModelRecords: ChatModelRecord[];
   readonly modelSearchEmptyLabel: string;
   readonly modelSearchPlaceholder: string;
   readonly onFavoriteModelToggle: (value: string, favorite: boolean) => void;
+  readonly onDiscoveredModelSelect: (value: string) => Promise<void> | void;
+  readonly onDiscoveredModelsDismiss: () => void;
+  readonly onModelSelectOpen: () => void;
   readonly onModelChange: (value: string) => void;
   readonly onThinkingChange: (value: ChatThinkingLevel | null) => void;
   readonly recentModelValues: string[];
@@ -42,7 +46,9 @@ type ToolbarSelectBuildParams = {
   readonly unfavoriteModelLabel: string;
 };
 
-export function buildSessionConversationToolbarSelects(params: ToolbarSelectBuildParams) {
+export function buildSessionConversationToolbarSelects(
+  params: ToolbarSelectBuildParams,
+) {
   const {
     allModelsLabel,
     favoriteModelLabel,
@@ -51,9 +57,13 @@ export function buildSessionConversationToolbarSelects(params: ToolbarSelectBuil
     hasModelOptions,
     isModelOptionsLoading,
     modelRecords,
+    discoveredModelRecords,
     modelSearchEmptyLabel,
     modelSearchPlaceholder,
     onFavoriteModelToggle,
+    onDiscoveredModelSelect,
+    onDiscoveredModelsDismiss,
+    onModelSelectOpen,
     onModelChange,
     onThinkingChange,
     recentModelValues,
@@ -67,12 +77,16 @@ export function buildSessionConversationToolbarSelects(params: ToolbarSelectBuil
   return [
     buildModelToolbarSelect({
       modelOptions: modelRecords,
+      discoveredModelOptions: discoveredModelRecords,
       favoriteModelValues,
       recentModelValues,
       selectedModel,
       isModelOptionsLoading,
       hasModelOptions,
       onFavoriteToggle: onFavoriteModelToggle,
+      onDiscoveredModelSelect,
+      onDiscoveredModelsDismiss,
+      onOpen: onModelSelectOpen,
       onValueChange: onModelChange,
       texts: {
         modelSelectPlaceholder: t('chatSelectModel'),
@@ -83,6 +97,14 @@ export function buildSessionConversationToolbarSelects(params: ToolbarSelectBuil
         favoriteModelLabel,
         unfavoriteModelLabel,
         manageModelsLabel: t('chatManageModels'),
+        discoveredModelsSummaryLabel: t('chatDiscoveredModelsSummary'),
+        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/conversation/utils/session-message-composer.utils.ts

@@ -0,0 +1,117 @@
+import {
+  createChatComposerTextNode,
+  createChatComposerTokenNode,
+  normalizeChatComposerNodes,
+  type ChatComposerNode,
+} from '@nextclaw/agent-chat-ui';
+import type { NcpMessage } from '@nextclaw/ncp';
+import type { NcpDraftAttachment } from '@nextclaw/ncp-react';
+
+import { deriveChatComposerDraft } from '@/features/chat/features/input/utils/chat-composer-state.utils';
+import {
+  readInlineTokensFromMetadata,
+  resolveInlineTokensForText,
+  type ChatInlineTokenSource,
+} from '@/features/chat/features/input/utils/chat-inline-token.utils';
+import { normalizeRequestedSkills } from '@/features/chat/features/runtime/utils/chat-runtime.utils';
+import type { SessionConversationComposerState } from '@/features/chat/features/conversation/hooks/use-session-conversation-input-state';
+
+export type SessionMessageComposerSnapshot = SessionConversationComposerState & {
+  readonly attachments: readonly NcpDraftAttachment[];
+};
+
+function buildTextNodes(
+  text: string,
+  inlineTokens: readonly ChatInlineTokenSource[],
+): ChatComposerNode[] {
+  const nodes: ChatComposerNode[] = [];
+  let offset = 0;
+  while (offset < text.length) {
+    const nextToken = inlineTokens
+      .flatMap((token) => {
+        const index = text.indexOf(token.rawText, offset);
+        return index < 0 ? [] : [{ index, token }];
+      })
+      .sort((left, right) => left.index - right.index || right.token.rawText.length - left.token.rawText.length)[0];
+    if (!nextToken) {
+      nodes.push(createChatComposerTextNode(text.slice(offset)));
+      return nodes;
+    }
+    if (nextToken.index > offset) {
+      nodes.push(createChatComposerTextNode(text.slice(offset, nextToken.index)));
+    }
+    nodes.push(createChatComposerTokenNode({
+      tokenKind: nextToken.token.kind,
+      tokenKey: 'ref' in nextToken.token ? nextToken.token.ref : nextToken.token.key,
+      label: nextToken.token.label,
+    }));
+    offset = nextToken.index + nextToken.token.rawText.length;
+  }
+  return nodes;
+}
+
+function readRequestedSkills(metadata: Record<string, unknown>): string[] {
+  const raw = metadata.requested_skill_refs;
+  return normalizeRequestedSkills(
+    Array.isArray(raw)
+      ? raw.filter((value): value is string => typeof value === 'string')
+      : undefined,
+  );
+}
+
+export function buildSessionMessageComposerSnapshot(params: {
+  readonly attachmentIdPrefix: string;
+  readonly availableSkills: readonly { ref: string; name: string }[];
+  readonly message: NcpMessage;
+  readonly metadata?: Record<string, unknown>;
+}): SessionMessageComposerSnapshot {
+  const { attachmentIdPrefix, availableSkills, message } = params;
+  const metadata = params.metadata ?? message.metadata ?? {};
+  const metadataTokens = readInlineTokensFromMetadata(metadata);
+  const nodes: ChatComposerNode[] = [];
+  const attachments: NcpDraftAttachment[] = [];
+
+  message.parts.forEach((part, index) => {
+    if (part.type === 'text' || part.type === 'rich-text' || part.type === 'reasoning') {
+      nodes.push(...buildTextNodes(
+        part.text,
+        resolveInlineTokensForText(part.text, metadataTokens),
+      ));
+      return;
+    }
+    if (part.type !== 'file') {
+      return;
+    }
+    const id = `${attachmentIdPrefix}-${index}`;
+    const attachment: NcpDraftAttachment = {
+      id,
+      name: part.name ?? 'attachment',
+      mimeType: part.mimeType ?? 'application/octet-stream',
+      sizeBytes: part.sizeBytes ?? 0,
+      assetUri: part.assetUri,
+      url: part.url,
+      contentBase64: part.contentBase64,
+    };
+    attachments.push(attachment);
+    nodes.push(createChatComposerTokenNode({
+      tokenKind: 'file',
+      tokenKey: id,
+      label: attachment.name,
+      previewUrl: attachment.mimeType.startsWith('image/') ? attachment.url : undefined,
+    }));
+  });
+
+  const normalizedNodes = normalizeChatComposerNodes(nodes);
+  const selectedSkills = readRequestedSkills(metadata);
+  const skillNameByRef = new Map(availableSkills.map(({ ref, name }) => [ref, name]));
+  return {
+    text: deriveChatComposerDraft(normalizedNodes),
+    nodes: normalizedNodes,
+    selectedSkills,
+    skillRecords: selectedSkills.map((ref) => ({
+      ref,
+      name: skillNameByRef.get(ref) ?? ref,
+    })),
+    attachments,
+  };
+}

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

@@ -1,54 +1,14 @@
-import {
-  createChatComposerTextNode,
-  createChatComposerTokenNode,
-  normalizeChatComposerNodes,
-  type ChatComposerNode,
-} from '@nextclaw/agent-chat-ui';
 import type { UiNcpSessionQueuedInputView } from '@nextclaw/client-sdk';
-import type { NcpDraftAttachment } from '@nextclaw/ncp-react';
 
 import {
   readInlineTokensFromMetadata,
-  resolveInlineTokensForText,
-  type ChatInlineTokenSource,
 } from '@/features/chat/features/input/utils/chat-inline-token.utils';
-import { deriveChatComposerDraft } from '@/features/chat/features/input/utils/chat-composer-state.utils';
-import { normalizeRequestedSkills } from '@/features/chat/features/runtime/utils/chat-runtime.utils';
-import type { SessionConversationComposerState } from '@/features/chat/features/conversation/hooks/use-session-conversation-input-state';
-
-export type SessionQueuedInputComposerSnapshot = SessionConversationComposerState & {
-  readonly attachments: readonly NcpDraftAttachment[];
-};
+import {
+  buildSessionMessageComposerSnapshot,
+  type SessionMessageComposerSnapshot,
+} from '@/features/chat/features/conversation/utils/session-message-composer.utils';
 
-function buildTextNodes(
-  text: string,
-  inlineTokens: readonly ChatInlineTokenSource[],
-): ChatComposerNode[] {
-  const nodes: ChatComposerNode[] = [];
-  let offset = 0;
-  while (offset < text.length) {
-    const nextToken = inlineTokens
-      .flatMap((token) => {
-        const index = text.indexOf(token.rawText, offset);
-        return index < 0 ? [] : [{ index, token }];
-      })
-      .sort((left, right) => left.index - right.index || right.token.rawText.length - left.token.rawText.length)[0];
-    if (!nextToken) {
-      nodes.push(createChatComposerTextNode(text.slice(offset)));
-      return nodes;
-    }
-    if (nextToken.index > offset) {
-      nodes.push(createChatComposerTextNode(text.slice(offset, nextToken.index)));
-    }
-    nodes.push(createChatComposerTokenNode({
-      tokenKind: nextToken.token.kind,
-      tokenKey: "ref" in nextToken.token ? nextToken.token.ref : nextToken.token.key,
-      label: nextToken.token.label,
-    }));
-    offset = nextToken.index + nextToken.token.rawText.length;
-  }
-  return nodes;
-}
+export type SessionQueuedInputComposerSnapshot = SessionMessageComposerSnapshot;
 
 function readInputMetadata(input: UiNcpSessionQueuedInputView): Record<string, unknown> {
   return {
@@ -57,13 +17,6 @@ function readInputMetadata(input: UiNcpSessionQueuedInputView): Record<string, u
   };
 }
 
-function readRequestedSkills(input: UiNcpSessionQueuedInputView): string[] {
-  const raw = readInputMetadata(input).requested_skill_refs;
-  return normalizeRequestedSkills(
-    Array.isArray(raw) ? raw.filter((value): value is string => typeof value === 'string') : undefined,
-  );
-}
-
 export function buildSessionQueuedInputPreview(input: UiNcpSessionQueuedInputView): string {
   const inlineTokens = readInlineTokensFromMetadata(readInputMetadata(input));
   const text = input.message.parts.flatMap((part) =>
@@ -85,51 +38,10 @@ export function buildSessionQueuedInputComposerSnapshot(
   input: UiNcpSessionQueuedInputView,
   availableSkills: readonly { ref: string; name: string }[],
 ): SessionQueuedInputComposerSnapshot {
-  const nodes: ChatComposerNode[] = [];
-  const attachments: NcpDraftAttachment[] = [];
-  const metadataTokens = readInlineTokensFromMetadata(readInputMetadata(input));
-
-  input.message.parts.forEach((part, index) => {
-    if (part.type === 'text' || part.type === 'rich-text' || part.type === 'reasoning') {
-      nodes.push(...buildTextNodes(
-        part.text,
-        resolveInlineTokensForText(part.text, metadataTokens),
-      ));
-      return;
-    }
-    if (part.type !== 'file') {
-      return;
-    }
-    const id = `queued-attachment-${input.id}-${index}`;
-    const attachment: NcpDraftAttachment = {
-      id,
-      name: part.name ?? 'attachment',
-      mimeType: part.mimeType ?? 'application/octet-stream',
-      sizeBytes: part.sizeBytes ?? 0,
-      assetUri: part.assetUri,
-      url: part.url,
-      contentBase64: part.contentBase64,
-    };
-    attachments.push(attachment);
-    nodes.push(createChatComposerTokenNode({
-      tokenKind: 'file',
-      tokenKey: id,
-      label: attachment.name,
-      previewUrl: attachment.mimeType.startsWith('image/') ? attachment.url : undefined,
-    }));
+  return buildSessionMessageComposerSnapshot({
+    attachmentIdPrefix: `queued-attachment-${input.id}`,
+    availableSkills,
+    message: input.message,
+    metadata: readInputMetadata(input),
   });
-
-  const normalizedNodes = normalizeChatComposerNodes(nodes);
-  const selectedSkills = readRequestedSkills(input);
-  const skillNameByRef = new Map(availableSkills.map(({ ref, name }) => [ref, name]));
-  return {
-    text: deriveChatComposerDraft(normalizedNodes),
-    nodes: normalizedNodes,
-    selectedSkills,
-    skillRecords: selectedSkills.map((ref) => ({
-      ref,
-      name: skillNameByRef.get(ref) ?? ref,
-    })),
-    attachments,
-  };
 }

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

@@ -35,6 +35,7 @@ function createPlugin(
     commands: [
       {
         key: 'side-chat',
+        icon: 'message-square-plus',
         title: 'Side chat',
         description: 'Open side chat',
         detailLines: ['Creates a child session on first send'],
@@ -133,7 +134,7 @@ describe('createSlashCommandInputSurfacePlugin', () => {
       { key: 'panel-apps', label: 'Panel Apps', sectionKeys: ['panel-apps'] },
     ]);
     expect(state.panel?.items[0]).toMatchObject({
-      icon: 'command',
+      icon: 'message-square-plus',
       sectionKey: 'commands',
       sectionLabel: 'Commands',
       hintLabel: 'Run command',

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

@@ -2,6 +2,7 @@ import {
   CHAT_INPUT_SURFACE_SLASH_TRIGGER_SPEC,
   createInputSurfaceTriggeredPanelPlugin,
   type ChatInputSurfaceItem,
+  type ChatInputSurfaceItemIcon,
   type ChatInputSurfaceMenuTexts,
   type ChatInputSurfacePlugin,
 } from '@nextclaw/agent-chat-ui';
@@ -24,6 +25,7 @@ const SLASH_SKILL_SECTION_KEY = 'skills';
 
 export type ChatSlashCommandDescriptor = {
   key: string;
+  icon: ChatInputSurfaceItemIcon;
   title: string;
   description: string;
   detailLines?: readonly string[];
@@ -69,7 +71,7 @@ function buildSlashCommandItems(params: {
     })
     .map(({ command }) => ({
       key: `command:${command.key}`,
-      icon: 'command',
+      icon: command.icon,
       title: command.title,
       subtitle: params.texts.commandSubtitle,
       description: command.description,

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

@@ -56,7 +56,7 @@ describe('deriveNcpMessagePartsFromComposer', () => {
       },
       {
         type: 'text',
-        text: ' between $Web Searchafter'
+        text: ' between $Web Search after'
       },
       {
         type: 'file',
@@ -115,6 +115,27 @@ describe('deriveNcpMessagePartsFromComposer', () => {
     ]);
   });
 
+  it('separates workspace references from adjacent message text', () => {
+    expect(
+      deriveNcpMessagePartsFromComposer(
+        [
+          createChatComposerTokenNode({
+            tokenKind: 'workspace_file',
+            tokenKey: 'AGENTS.md',
+            label: 'AGENTS.md',
+          }),
+          createChatComposerTextNode('这里面有啥'),
+        ],
+        [],
+      ),
+    ).toEqual([
+      {
+        type: 'text',
+        text: '@file:AGENTS.md 这里面有啥',
+      },
+    ]);
+  });
+
   it('preserves uploaded attachment references when the attachment has a server uri', () => {
     const parts = deriveNcpMessagePartsFromComposer(
       [

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,
@@ -226,6 +227,29 @@ describe('chat inline token workspace references', () => {
     ]);
   });
 
+  it('prefers persisted token metadata over a greedy protocol fallback', () => {
+    expect(
+      resolveInlineTokensForText(
+        '@file:AGENTS.md这里面有啥',
+        [
+          {
+            kind: 'workspace_file',
+            key: 'AGENTS.md',
+            label: 'AGENTS.md',
+            rawText: '@file:AGENTS.md',
+          },
+        ],
+      ),
+    ).toEqual([
+      {
+        kind: 'workspace_file',
+        key: 'AGENTS.md',
+        label: 'AGENTS.md',
+        rawText: '@file:AGENTS.md',
+      },
+    ]);
+  });
+
   it('serializes project references with their registered path and display name', () => {
     expect(
       buildInlineTokensFromComposer([
@@ -255,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/',