Files
twenty/packages/twenty-front/src/modules/mention/components/MentionSuggestionMenu.tsx
T
Félix Malfait 6f251a6f8e Add @mention support in AI Chat input (#17943)
## Summary
- Add `@mention` support to the AI Chat text input by replacing the
plain textarea with a minimal Tiptap editor and building a shared
`mention` module with reusable Tiptap extensions (`MentionTag`,
`MentionSuggestion`), search hook (`useMentionSearch`), and suggestion
menu — all shared with the existing BlockNote-based Notes mentions to
avoid code duplication
- Mentions are serialized as
`[[record:objectName:recordId:displayName]]` markdown (the format
already understood by the backend and rendered in chat messages), and
displayed using the existing `RecordLink` chip component for visual
consistency
- Fix images in chat messages overflowing their container by
constraining to `max-width: 100%`
- Fix web_search tool display showing literal `{query}` instead of the
actual query (ICU single-quote escaping issue in Lingui `t` tagged
templates)

## Test plan
- [ ] Open AI Chat, type `@` and verify the suggestion menu appears with
searchable records
- [ ] Select a mention from the dropdown (via click or keyboard
Enter/ArrowUp/Down) and verify the record chip renders inline
- [ ] Send a message containing a mention and verify it appears
correctly in the conversation as a clickable `RecordLink`
- [ ] Verify Enter sends the message when the suggestion menu is closed,
and selects a mention when the menu is open
- [ ] Verify images in AI chat responses are constrained to the
container width
- [ ] Verify the web_search tool step shows the actual search query
(e.g. "Searched the web for Salesforce") instead of `{query}`
- [ ] Verify Notes @mentions still work as before


Made with [Cursor](https://cursor.com)

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-14 14:37:33 +01:00

53 lines
1.4 KiB
TypeScript

import { forwardRef } from 'react';
import { AvatarChip } from 'twenty-ui/components';
import { MenuItemSuggestion } from 'twenty-ui/navigation';
import type { MentionSearchResult } from '@/mention/types/MentionSearchResult';
import type { MentionSuggestionMenuProps } from '@/mention/types/MentionSuggestionMenuProps';
import { SuggestionMenu } from '@/ui/suggestion/components/SuggestionMenu';
const getItemKey = (item: MentionSearchResult) =>
`${item.objectNameSingular}-${item.recordId}`;
const renderItem = (
item: MentionSearchResult,
isSelected: boolean,
onSelect: (item: MentionSearchResult) => void,
) => (
<MenuItemSuggestion
LeftIcon={() => (
<AvatarChip
placeholder={item.label}
placeholderColorSeed={item.recordId}
avatarType="rounded"
avatarUrl={item.imageUrl}
/>
)}
text={item.label}
contextualText={item.objectLabelSingular}
selected={isSelected}
onClick={() => {
onSelect(item);
}}
/>
);
export const MentionSuggestionMenu = forwardRef<
unknown,
MentionSuggestionMenuProps
>((props, ref) => {
const { items, onSelect, editor, range } = props;
return (
<SuggestionMenu
ref={ref}
items={items}
onSelect={onSelect}
editor={editor}
range={range}
getItemKey={getItemKey}
renderItem={(item, isSelected) => renderItem(item, isSelected, onSelect)}
/>
);
});