The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
Fix markdown mention chips
dotta8232456ce842
diff --git a/packages/shared/src/index.ts b/packages/shared/src/index.tsindex 6a105d79de..8ba20ba9e3 100644--- a/packages/shared/src/index.ts+++ b/packages/shared/src/index.ts@@ -535,10 +535,15 @@ export { API_PREFIX, API } from "./api.js";export { normalizeAgentUrlKey, deriveAgentUrlKey, isUuidLike } from "./agent-url-key.js";export { deriveProjectUrlKey, normalizeProjectUrlKey } from "./project-url-key.js";export {+ AGENT_MENTION_SCHEME,PROJECT_MENTION_SCHEME,+ buildAgentMentionHref,buildProjectMentionHref,+ extractAgentMentionIds,+ parseAgentMentionHref,parseProjectMentionHref,extractProjectMentionIds,+ type ParsedAgentMention,type ParsedProjectMention,} from "./project-mentions.js";diff --git a/packages/shared/src/project-mentions.test.ts b/packages/shared/src/project-mentions.test.tsnew file mode 100644index 0000000000..55f27369b8--- /dev/null+++ b/packages/shared/src/project-mentions.test.ts@@ -0,0 +1,29 @@+import { describe, expect, it } from "vitest";+import {+ buildAgentMentionHref,+ buildProjectMentionHref,+ extractAgentMentionIds,+ extractProjectMentionIds,+ parseAgentMentionHref,+ parseProjectMentionHref,+} from "./project-mentions.js";++describe("project-mentions", () => {+ it("round-trips project mentions with color metadata", () => {+ const href = buildProjectMentionHref("project-123", "#336699");+ expect(parseProjectMentionHref(href)).toEqual({+ projectId: "project-123",+ color: "#336699",+ });+ expect(extractProjectMentionIds(`[@Paperclip App](${href})`)).toEqual(["project-123"]);+ });++ it("round-trips agent mentions with icon metadata", () => {+ const href = buildAgentMentionHref("agent-123", "code");+ expect(parseAgentMentionHref(href)).toEqual({+ agentId: "agent-123",+ icon: "code",+ });+ expect(extractAgentMentionIds(`[@CodexCoder](${href})`)).toEqual(["agent-123"]);+ });+});diff --git a/packages/shared/src/project-mentions.ts b/packages/shared/src/project-mentions.tsindex 2c1675179d..66be89483a 100644--- a/packages/shared/src/project-mentions.ts+++ b/packages/shared/src/project-mentions.ts@@ -1,16 +1,24 @@export const PROJECT_MENTION_SCHEME = "project://";+export const AGENT_MENTION_SCHEME = "agent://";const HEX_COLOR_RE = /^[0-9a-f]{6}$/i;const HEX_COLOR_SHORT_RE = /^[0-9a-f]{3}$/i;const HEX_COLOR_WITH_HASH_RE = /^#[0-9a-f]{6}$/i;const HEX_COLOR_SHORT_WITH_HASH_RE = /^#[0-9a-f]{3}$/i;const PROJECT_MENTION_LINK_RE = /\[[^\]]*]\((project:\/\/[^)\s]+)\)/gi;+const AGENT_MENTION_LINK_RE = /\[[^\]]*]\((agent:\/\/[^)\s]+)\)/gi;+const AGENT_ICON_NAME_RE = /^[a-z0-9-]+$/i;export interface ParsedProjectMention {projectId: string;color: string | null;}+export interface ParsedAgentMention {+ agentId: string;+ icon: string | null;+}+function normalizeHexColor(input: string | null | undefined): string | null {if (!input) return null;const trimmed = input.trim();@@ -65,6 +73,36 @@ export function parseProjectMentionHref(href: string): ParsedProjectMention | nu};}+export function buildAgentMentionHref(agentId: string, icon?: string | null): string {+ const trimmedAgentId = agentId.trim();+ const normalizedIcon = normalizeAgentIcon(icon ?? null);+ if (!normalizedIcon) {+ return `${AGENT_MENTION_SCHEME}${trimmedAgentId}`;+ }+ return `${AGENT_MENTION_SCHEME}${trimmedAgentId}?i=${encodeURIComponent(normalizedIcon)}`;+}++export function parseAgentMentionHref(href: string): ParsedAgentMention | null {+ if (!href.startsWith(AGENT_MENTION_SCHEME)) return null;++ let url: URL;+ try {+ url = new URL(href);+ } catch {+ return null;+ }++ if (url.protocol !== "agent:") return null;++ const agentId = `${url.hostname}${url.pathname}`.replace(/^\/+/, "").trim();+ if (!agentId) return null;++ return {+ agentId,+ icon: normalizeAgentIcon(url.searchParams.get("i") ?? url.searchParams.get("icon")),+ };+}+export function extractProjectMentionIds(markdown: string): string[] {if (!markdown) return [];const ids = new Set<string>();@@ -76,3 +114,22 @@ export function extractProjectMentionIds(markdown: string): string[] {}return [...ids];}++export function extractAgentMentionIds(markdown: string): string[] {+ if (!markdown) return [];+ const ids = new Set<string>();+ const re = new RegExp(AGENT_MENTION_LINK_RE);+ let match: RegExpExecArray | null;+ while ((match = re.exec(markdown)) !== null) {+ const parsed = parseAgentMentionHref(match[1]);+ if (parsed) ids.add(parsed.agentId);+ }+ return [...ids];+}++function normalizeAgentIcon(input: string | null | undefined): string | null {+ if (!input) return null;+ const trimmed = input.trim().toLowerCase();+ if (!trimmed || !AGENT_ICON_NAME_RE.test(trimmed)) return null;+ return trimmed;+}diff --git a/server/src/services/issues.ts b/server/src/services/issues.tsindex 681da27d70..02a0cb9efe 100644--- a/server/src/services/issues.ts+++ b/server/src/services/issues.ts@@ -19,7 +19,7 @@ import {projectWorkspaces,projects,} from "@paperclipai/db";-import { extractProjectMentionIds } from "@paperclipai/shared";+import { extractAgentMentionIds, extractProjectMentionIds } from "@paperclipai/shared";import { conflict, notFound, unprocessable } from "../errors.js";import {defaultIssueExecutionWorkspaceSettingsForProject,@@ -1462,10 +1462,19 @@ export function issueService(db: Db) {const tokens = new Set<string>();let m: RegExpExecArray | null;while ((m = re.exec(body)) !== null) tokens.add(m[1].toLowerCase());- if (tokens.size === 0) return [];++ const explicitAgentMentionIds = extractAgentMentionIds(body);+ if (tokens.size === 0 && explicitAgentMentionIds.length === 0) return [];+const rows = await db.select({ id: agents.id, name: agents.name }).from(agents).where(eq(agents.companyId, companyId));- return rows.filter(a => tokens.has(a.name.toLowerCase())).map(a => a.id);+ const resolved = new Set<string>(explicitAgentMentionIds);+ for (const agent of rows) {+ if (tokens.has(agent.name.toLowerCase())) {+ resolved.add(agent.id);+ }+ }+ return [...resolved];},findMentionedProjectIds: async (issueId: string) => {diff --git a/ui/src/components/AgentIconPicker.tsx b/ui/src/components/AgentIconPicker.tsxindex 8f53d87df6..06257fb9a5 100644--- a/ui/src/components/AgentIconPicker.tsx+++ b/ui/src/components/AgentIconPicker.tsx@@ -1,46 +1,5 @@import { useState, useMemo } from "react";import {- Bot,- Cpu,- Brain,- Zap,- Rocket,- Code,- Terminal,- Shield,- Eye,- Search,- Wrench,- Hammer,- Lightbulb,- Sparkles,- Star,- Heart,- Flame,- Bug,- Cog,- Database,- Globe,- Lock,- Mail,- MessageSquare,- FileCode,- GitBranch,- Package,- Puzzle,- Target,- Wand2,- Atom,- CircuitBoard,- Radar,- Swords,- Telescope,- Microscope,- Crown,- Gem,- Hexagon,- Pentagon,- Fingerprint,type LucideIcon,} from "lucide-react";import { AGENT_ICON_NAMES, type AgentIconName } from "@paperclipai/shared";@@ -51,60 +10,10 @@ import {} from "@/components/ui/popover";import { Input } from "@/components/ui/input";import { cn } from "@/lib/utils";--export const AGENT_ICONS: Record<AgentIconName, LucideIcon> = {- bot: Bot,- cpu: Cpu,- brain: Brain,- zap: Zap,- rocket: Rocket,- code: Code,- terminal: Terminal,- shield: Shield,- eye: Eye,- search: Search,- wrench: Wrench,- hammer: Hammer,- lightbulb: Lightbulb,- sparkles: Sparkles,- star: Star,- heart: Heart,- flame: Flame,- bug: Bug,- cog: Cog,- database: Database,- globe: Globe,- lock: Lock,- mail: Mail,- "message-square": MessageSquare,- "file-code": FileCode,- "git-branch": GitBranch,- package: Package,- puzzle: Puzzle,- target: Target,- wand: Wand2,- atom: Atom,- "circuit-board": CircuitBoard,- radar: Radar,- swords: Swords,- telescope: Telescope,- microscope: Microscope,- crown: Crown,- gem: Gem,- hexagon: Hexagon,- pentagon: Pentagon,- fingerprint: Fingerprint,-};+import { AGENT_ICONS, getAgentIcon } from "../lib/agent-icons";const DEFAULT_ICON: AgentIconName = "bot";-export function getAgentIcon(iconName: string | null | undefined): LucideIcon {- if (iconName && AGENT_ICON_NAMES.includes(iconName as AgentIconName)) {- return AGENT_ICONS[iconName as AgentIconName];- }- return AGENT_ICONS[DEFAULT_ICON];-}-interface AgentIconProps {icon: string | null | undefined;className?: string;diff --git a/ui/src/components/CommentThread.tsx b/ui/src/components/CommentThread.tsxindex eda2851867..cdf0ddd24c 100644--- a/ui/src/components/CommentThread.tsx+++ b/ui/src/components/CommentThread.tsx@@ -311,8 +311,11 @@ export function CommentThread({return Array.from(agentMap.values()).filter((a) => a.status !== "terminated").map((a) => ({- id: a.id,+ id: `agent:${a.id}`,name: a.name,+ kind: "agent",+ agentId: a.id,+ agentIcon: a.icon,}));}, [agentMap, providedMentions]);diff --git a/ui/src/components/MarkdownBody.test.tsx b/ui/src/components/MarkdownBody.test.tsxindex 06cfc70adc..5794f989db 100644--- a/ui/src/components/MarkdownBody.test.tsx+++ b/ui/src/components/MarkdownBody.test.tsx@@ -2,6 +2,7 @@import { describe, expect, it } from "vitest";import { renderToStaticMarkup } from "react-dom/server";+import { buildAgentMentionHref, buildProjectMentionHref } from "@paperclipai/shared";import { ThemeProvider } from "../context/ThemeContext";import { MarkdownBody } from "./MarkdownBody";@@ -28,4 +29,21 @@ describe("MarkdownBody", () => {expect(html).toContain('src="/resolved/images/org-chart.png"');expect(html).toContain('alt="Org chart"');});++ it("renders agent and project mentions as chips", () => {+ const html = renderToStaticMarkup(+ <ThemeProvider>+ <MarkdownBody>+ {`[@CodexCoder](${buildAgentMentionHref("agent-123", "code")}) [@Paperclip App](${buildProjectMentionHref("project-456", "#336699")})`}+ </MarkdownBody>+ </ThemeProvider>,+ );++ expect(html).toContain('href="/agents/agent-123"');+ expect(html).toContain('data-mention-kind="agent"');+ expect(html).toContain("--paperclip-mention-icon-mask");+ expect(html).toContain('href="/projects/project-456"');+ expect(html).toContain('data-mention-kind="project"');+ expect(html).toContain("--paperclip-mention-project-color:#336699");+ });});diff --git a/ui/src/components/MarkdownBody.tsx b/ui/src/components/MarkdownBody.tsxindex 0fbb52c4e9..e00afc84df 100644--- a/ui/src/components/MarkdownBody.tsx+++ b/ui/src/components/MarkdownBody.tsx@@ -1,9 +1,9 @@-import { isValidElement, useEffect, useId, useState, type CSSProperties, type ReactNode } from "react";+import { isValidElement, useEffect, useId, useState, type ReactNode } from "react";import Markdown, { type Components } from "react-markdown";import remarkGfm from "remark-gfm";-import { parseProjectMentionHref } from "@paperclipai/shared";import { cn } from "../lib/utils";import { useTheme } from "../context/ThemeContext";+import { mentionChipInlineStyle, parseMentionChipHref } from "../lib/mention-chips";interface MarkdownBodyProps {children: string;@@ -36,29 +36,6 @@ function extractMermaidSource(children: ReactNode): string | null {return flattenText(childProps.children).replace(/\n$/, "");}-function hexToRgb(hex: string): { r: number; g: number; b: number } | null {- const match = /^#([0-9a-f]{6})$/i.exec(hex.trim());- if (!match) return null;- const value = match[1];- return {- r: parseInt(value.slice(0, 2), 16),- g: parseInt(value.slice(2, 4), 16),- b: parseInt(value.slice(4, 6), 16),- };-}--function mentionChipStyle(color: string | null): CSSProperties | undefined {- if (!color) return undefined;- const rgb = hexToRgb(color);- if (!rgb) return undefined;- const luminance = (0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b) / 255;- return {- borderColor: color,- backgroundColor: `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, 0.22)`,- color: luminance > 0.55 ? "#111827" : "#f8fafc",- };-}-function MermaidDiagramBlock({ source, darkMode }: { source: string; darkMode: boolean }) {const renderId = useId().replace(/[^a-zA-Z0-9_-]/g, "");const [svg, setSvg] = useState<string | null>(null);@@ -125,16 +102,23 @@ export function MarkdownBody({ children, className, resolveImageSrc }: MarkdownBreturn <pre {...preProps}>{preChildren}</pre>;},a: ({ href, children: linkChildren }) => {- const parsed = href ? parseProjectMentionHref(href) : null;+ const parsed = href ? parseMentionChipHref(href) : null;if (parsed) {- const label = linkChildren;+ const targetHref = parsed.kind === "project"+ ? `/projects/${parsed.projectId}`+ : `/agents/${parsed.agentId}`;return (<a- href={`/projects/${parsed.projectId}`}- className="paperclip-project-mention-chip"- style={mentionChipStyle(parsed.color)}+ href={targetHref}+ className={cn(+ "paperclip-mention-chip",+ `paperclip-mention-chip--${parsed.kind}`,+ parsed.kind === "project" && "paperclip-project-mention-chip",+ )}+ data-mention-kind={parsed.kind}+ style={mentionChipInlineStyle(parsed)}>- {label}+ {linkChildren}</a>);}@@ -160,7 +144,7 @@ export function MarkdownBody({ children, className, resolveImageSrc }: MarkdownBclassName,)}>- <Markdown remarkPlugins={[remarkGfm]} components={components}>+ <Markdown remarkPlugins={[remarkGfm]} components={components} urlTransform={(url) => url}>{children}</Markdown></div>diff --git a/ui/src/components/MarkdownEditor.tsx b/ui/src/components/MarkdownEditor.tsxindex 29a57a3a0e..0f6bd402bc 100644--- a/ui/src/components/MarkdownEditor.tsx+++ b/ui/src/components/MarkdownEditor.tsx@@ -6,7 +6,6 @@ import {useMemo,useRef,useState,- type CSSProperties,type DragEvent,} from "react";import {@@ -27,7 +26,9 @@ import {thematicBreakPlugin,type RealmPlugin,} from "@mdxeditor/editor";-import { buildProjectMentionHref, parseProjectMentionHref } from "@paperclipai/shared";+import { buildAgentMentionHref, buildProjectMentionHref } from "@paperclipai/shared";+import { AgentIcon } from "./AgentIconPicker";+import { applyMentionChipDecoration, clearMentionChipDecoration, parseMentionChipHref } from "../lib/mention-chips";import { cn } from "../lib/utils";/* ---- Mention types ---- */@@ -36,6 +37,8 @@ export interface MentionOption {id: string;name: string;kind?: "agent" | "project";+ agentId?: string;+ agentIcon?: string | null;projectId?: string;projectColor?: string | null;}@@ -154,7 +157,8 @@ function mentionMarkdown(option: MentionOption): string {if (option.kind === "project" && option.projectId) {return `[@${option.name}](${buildProjectMentionHref(option.projectId, option.projectColor ?? null)}) `;}- return `@${option.name} `;+ const agentId = option.agentId ?? option.id.replace(/^agent:/, "");+ return `[@${option.name}](${buildAgentMentionHref(agentId, option.agentIcon ?? null)}) `;}/** Replace `@<query>` in the markdown string with the selected mention token. */@@ -166,31 +170,6 @@ function applyMention(markdown: string, query: string, option: MentionOption): sreturn markdown.slice(0, idx) + replacement + markdown.slice(idx + search.length);}-function hexToRgb(hex: string): { r: number; g: number; b: number } | null {- const trimmed = hex.trim();- const match = /^#([0-9a-f]{6})$/i.exec(trimmed);- if (!match) return null;- const value = match[1];- return {- r: parseInt(value.slice(0, 2), 16),- g: parseInt(value.slice(2, 4), 16),- b: parseInt(value.slice(4, 6), 16),- };-}--function mentionChipStyle(color: string | null): CSSProperties | undefined {- if (!color) return undefined;- const rgb = hexToRgb(color);- if (!rgb) return undefined;- const luminance = (0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b) / 255;- const textColor = luminance > 0.55 ? "#111827" : "#f8fafc";- return {- borderColor: color,- backgroundColor: `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, 0.22)`,- color: textColor,- };-}-/* ---- Component ---- */export const MarkdownEditor = forwardRef<MarkdownEditorRef, MarkdownEditorProps>(function MarkdownEditor({@@ -221,11 +200,15 @@ export const MarkdownEditor = forwardRef<MarkdownEditorRef, MarkdownEditorProps>const mentionStateRef = useRef<MentionState | null>(null);const [mentionIndex, setMentionIndex] = useState(0);const mentionActive = mentionState !== null && mentions && mentions.length > 0;- const projectColorById = useMemo(() => {- const map = new Map<string, string | null>();+ const mentionOptionByKey = useMemo(() => {+ const map = new Map<string, MentionOption>();for (const mention of mentions ?? []) {+ if (mention.kind === "agent") {+ const agentId = mention.agentId ?? mention.id.replace(/^agent:/, "");+ map.set(`agent:${agentId}`, mention);+ }if (mention.kind === "project" && mention.projectId) {- map.set(mention.projectId, mention.projectColor ?? null);+ map.set(`project:${mention.projectId}`, mention);}}return map;@@ -315,31 +298,28 @@ export const MarkdownEditor = forwardRef<MarkdownEditorRef, MarkdownEditorProps>const links = editable.querySelectorAll("a");for (const node of links) {const link = node as HTMLAnchorElement;- const parsed = parseProjectMentionHref(link.getAttribute("href") ?? "");+ const parsed = parseMentionChipHref(link.getAttribute("href") ?? "");if (!parsed) {- if (link.dataset.projectMention === "true") {- link.dataset.projectMention = "false";- link.classList.remove("paperclip-project-mention-chip");- link.removeAttribute("contenteditable");- link.style.removeProperty("border-color");- link.style.removeProperty("background-color");- link.style.removeProperty("color");- }+ clearMentionChipDecoration(link);continue;}- const color = parsed.color ?? projectColorById.get(parsed.projectId) ?? null;- link.dataset.projectMention = "true";- link.classList.add("paperclip-project-mention-chip");- link.setAttribute("contenteditable", "false");- const style = mentionChipStyle(color);- if (style) {- link.style.borderColor = style.borderColor ?? "";- link.style.backgroundColor = style.backgroundColor ?? "";- link.style.color = style.color ?? "";+ if (parsed.kind === "project") {+ const option = mentionOptionByKey.get(`project:${parsed.projectId}`);+ applyMentionChipDecoration(link, {+ ...parsed,+ color: parsed.color ?? option?.projectColor ?? null,+ });+ continue;}++ const option = mentionOptionByKey.get(`agent:${parsed.agentId}`);+ applyMentionChipDecoration(link, {+ ...parsed,+ icon: parsed.icon ?? option?.agentIcon ?? null,+ });}- }, [projectColorById]);+ }, [mentionOptionByKey]);// Mention detection: listen for selection changes and input eventsconst checkMention = useCallback(() => {@@ -395,94 +375,67 @@ export const MarkdownEditor = forwardRef<MarkdownEditorRef, MarkdownEditorProps>// update state between the last render and this callback firing).const state = mentionStateRef.current;if (!state) return;+ const current = latestValueRef.current;+ const next = applyMention(current, state.query, option);+ if (next !== current) {+ latestValueRef.current = next;+ ref.current?.setMarkdown(next);+ onChange(next);+ }- if (option.kind === "project" && option.projectId) {- const current = latestValueRef.current;- const next = applyMention(current, state.query, option);- if (next !== current) {- latestValueRef.current = next;- ref.current?.setMarkdown(next);- onChange(next);- }+ requestAnimationFrame(() => {requestAnimationFrame(() => {- ref.current?.focus(undefined, { defaultSelection: "rootEnd" });+ const editable = containerRef.current?.querySelector('[contenteditable="true"]');+ if (!(editable instanceof HTMLElement)) return;decorateProjectMentions();- });- mentionStateRef.current = null;- setMentionState(null);- return;- }+ editable.focus();- const replacement = mentionMarkdown(option);-- // Replace @query directly via DOM selection so the cursor naturally- // lands after the inserted text. Lexical picks up the change through- // its normal input-event handling.- const sel = window.getSelection();- if (sel && state.textNode.isConnected) {- const range = document.createRange();- range.setStart(state.textNode, state.atPos);- range.setEnd(state.textNode, state.endPos);- sel.removeAllRanges();- sel.addRange(range);- document.execCommand("insertText", false, replacement);-- // After Lexical reconciles the DOM, the cursor position set by- // execCommand may be lost. Explicitly reposition it after the- // inserted mention text.- const cursorTarget = state.atPos + replacement.length;- requestAnimationFrame(() => {- const newSel = window.getSelection();- if (!newSel) return;- // Try the original text node first (it may still be valid)- if (state.textNode.isConnected) {- const len = state.textNode.textContent?.length ?? 0;- if (cursorTarget <= len) {- const r = document.createRange();- r.setStart(state.textNode, cursorTarget);- r.collapse(true);- newSel.removeAllRanges();- newSel.addRange(r);+ const mentionHref = option.kind === "project" && option.projectId+ ? buildProjectMentionHref(option.projectId, option.projectColor ?? null)+ : buildAgentMentionHref(+ option.agentId ?? option.id.replace(/^agent:/, ""),+ option.agentIcon ?? null,+ );+ const matchingMentions = Array.from(editable.querySelectorAll("a"))+ .filter((node): node is HTMLAnchorElement => node instanceof HTMLAnchorElement)+ .filter((link) => {+ const href = link.getAttribute("href") ?? "";+ return href === mentionHref && link.textContent === `@${option.name}`;+ });+ const containerRect = containerRef.current?.getBoundingClientRect();+ const target = matchingMentions.sort((a, b) => {+ const rectA = a.getBoundingClientRect();+ const rectB = b.getBoundingClientRect();+ const leftA = containerRect ? rectA.left - containerRect.left : rectA.left;+ const topA = containerRect ? rectA.top - containerRect.top : rectA.top;+ const leftB = containerRect ? rectB.left - containerRect.left : rectB.left;+ const topB = containerRect ? rectB.top - containerRect.top : rectB.top;+ const distA = Math.hypot(leftA - state.left, topA - state.top);+ const distB = Math.hypot(leftB - state.left, topB - state.top);+ return distA - distB;+ })[0] ?? null;+ if (!target) return;++ const selection = window.getSelection();+ if (!selection) return;+ const range = document.createRange();+ const nextSibling = target.nextSibling;+ if (nextSibling?.nodeType === Node.TEXT_NODE) {+ const text = nextSibling.textContent ?? "";+ if (text.startsWith(" ")) {+ range.setStart(nextSibling, 1);+ range.collapse(true);+ selection.removeAllRanges();+ selection.addRange(range);return;}}- // Fallback: search for the replacement in text nodes- const editable = containerRef.current?.querySelector('[contenteditable="true"]');- if (!editable) return;- const walker = document.createTreeWalker(editable, NodeFilter.SHOW_TEXT);- let node: Text | null;- while ((node = walker.nextNode() as Text | null)) {- const text = node.textContent ?? "";- const idx = text.indexOf(replacement);- if (idx !== -1) {- const pos = idx + replacement.length;- if (pos <= text.length) {- const r = document.createRange();- r.setStart(node, pos);- r.collapse(true);- newSel.removeAllRanges();- newSel.addRange(r);- return;- }- }- }- });- } else {- // Fallback: full markdown replacement when DOM node is stale- const current = latestValueRef.current;- const next = applyMention(current, state.query, option);- if (next !== current) {- latestValueRef.current = next;- ref.current?.setMarkdown(next);- onChange(next);- }- requestAnimationFrame(() => {- ref.current?.focus(undefined, { defaultSelection: "rootEnd" });- });- }- requestAnimationFrame(() => {- decorateProjectMentions();+ range.setStartAfter(target);+ range.collapse(true);+ selection.removeAllRanges();+ selection.addRange(range);+ });});mentionStateRef.current = null;@@ -616,7 +569,10 @@ export const MarkdownEditor = forwardRef<MarkdownEditorRef, MarkdownEditorProps>style={{ backgroundColor: option.projectColor ?? "#64748b" }}/>) : (- <span className="text-muted-foreground">@</span>+ <AgentIcon+ icon={option.agentIcon}+ className="h-3.5 w-3.5 shrink-0 text-muted-foreground"+ />)}<span>{option.name}</span>{option.kind === "project" && option.projectId && (diff --git a/ui/src/components/NewIssueDialog.tsx b/ui/src/components/NewIssueDialog.tsxindex 727a54e650..0a35bd34d7 100644--- a/ui/src/components/NewIssueDialog.tsx+++ b/ui/src/components/NewIssueDialog.tsx@@ -376,6 +376,8 @@ export function NewIssueDialog() {id: `agent:${agent.id}`,name: agent.name,kind: "agent",+ agentId: agent.id,+ agentIcon: agent.icon,});}for (const project of orderedProjects) {diff --git a/ui/src/index.css b/ui/src/index.cssindex c8eb8366b2..d6b1d35913 100644--- a/ui/src/index.css+++ b/ui/src/index.css@@ -339,6 +339,7 @@margin-top: 1.1em;}+.paperclip-mdxeditor-content a.paperclip-mention-chip,.paperclip-mdxeditor-content a.paperclip-project-mention-chip {display: inline-flex;align-items: center;@@ -355,6 +356,35 @@user-select: none;}+.paperclip-mdxeditor-content a.paperclip-mention-chip::before,+a.paperclip-mention-chip::before {+ content: "";+ flex: none;+}++.paperclip-mdxeditor-content a.paperclip-mention-chip[data-mention-kind="project"]::before,+a.paperclip-mention-chip[data-mention-kind="project"]::before {+ width: 0.45rem;+ height: 0.45rem;+ border-radius: 999px;+ background-color: var(--paperclip-mention-project-color, currentColor);+}++.paperclip-mdxeditor-content a.paperclip-mention-chip[data-mention-kind="agent"]::before,+a.paperclip-mention-chip[data-mention-kind="agent"]::before {+ width: 0.75rem;+ height: 0.75rem;+ background-color: currentColor;+ -webkit-mask-image: var(--paperclip-mention-icon-mask);+ mask-image: var(--paperclip-mention-icon-mask);+ -webkit-mask-position: center;+ mask-position: center;+ -webkit-mask-repeat: no-repeat;+ mask-repeat: no-repeat;+ -webkit-mask-size: contain;+ mask-size: contain;+}+.paperclip-mdxeditor-content ul,.paperclip-mdxeditor-content ol {margin: 1.1em 0;@@ -700,6 +730,7 @@}/* Project mention chips rendered inside MarkdownBody */+a.paperclip-mention-chip,a.paperclip-project-mention-chip {display: inline-flex;align-items: center;diff --git a/ui/src/lib/agent-icons.ts b/ui/src/lib/agent-icons.tsnew file mode 100644index 0000000000..f57b760af9--- /dev/null+++ b/ui/src/lib/agent-icons.ts@@ -0,0 +1,98 @@+import {+ Atom,+ Bot,+ Brain,+ Bug,+ CircuitBoard,+ Code,+ Cog,+ Cpu,+ Crown,+ Database,+ Eye,+ FileCode,+ Fingerprint,+ Flame,+ Gem,+ GitBranch,+ Globe,+ Hammer,+ Heart,+ Hexagon,+ Lightbulb,+ Lock,+ Mail,+ MessageSquare,+ Microscope,+ Package,+ Pentagon,+ Puzzle,+ Radar,+ Rocket,+ Search,+ Shield,+ Sparkles,+ Star,+ Swords,+ Target,+ Telescope,+ Terminal,+ Wand2,+ Wrench,+ Zap,+ type LucideIcon,+} from "lucide-react";+import { AGENT_ICON_NAMES, type AgentIconName } from "@paperclipai/shared";++export const AGENT_ICONS: Record<AgentIconName, LucideIcon> = {+ bot: Bot,+ cpu: Cpu,+ brain: Brain,+ zap: Zap,+ rocket: Rocket,+ code: Code,+ terminal: Terminal,+ shield: Shield,+ eye: Eye,+ search: Search,+ wrench: Wrench,+ hammer: Hammer,+ lightbulb: Lightbulb,+ sparkles: Sparkles,+ star: Star,+ heart: Heart,+ flame: Flame,+ bug: Bug,+ cog: Cog,+ database: Database,+ globe: Globe,+ lock: Lock,+ mail: Mail,+ "message-square": MessageSquare,+ "file-code": FileCode,+ "git-branch": GitBranch,+ package: Package,+ puzzle: Puzzle,+ target: Target,+ wand: Wand2,+ atom: Atom,+ "circuit-board": CircuitBoard,+ radar: Radar,+ swords: Swords,+ telescope: Telescope,+ microscope: Microscope,+ crown: Crown,+ gem: Gem,+ hexagon: Hexagon,+ pentagon: Pentagon,+ fingerprint: Fingerprint,+};++const DEFAULT_ICON: AgentIconName = "bot";++export function getAgentIcon(iconName: string | null | undefined): LucideIcon {+ if (iconName && AGENT_ICON_NAMES.includes(iconName as AgentIconName)) {+ return AGENT_ICONS[iconName as AgentIconName];+ }+ return AGENT_ICONS[DEFAULT_ICON];+}diff --git a/ui/src/lib/mention-chips.ts b/ui/src/lib/mention-chips.tsnew file mode 100644index 0000000000..d082cd7fb9--- /dev/null+++ b/ui/src/lib/mention-chips.ts@@ -0,0 +1,160 @@+import type { CSSProperties } from "react";+import { parseAgentMentionHref, parseProjectMentionHref } from "@paperclipai/shared";+import { getAgentIcon } from "./agent-icons";++export type ParsedMentionChip =+ | {+ kind: "agent";+ agentId: string;+ icon: string | null;+ }+ | {+ kind: "project";+ projectId: string;+ color: string | null;+ };++const iconMaskCache = new Map<string, string>();++export function parseMentionChipHref(href: string): ParsedMentionChip | null {+ const agent = parseAgentMentionHref(href);+ if (agent) {+ return {+ kind: "agent",+ agentId: agent.agentId,+ icon: agent.icon,+ };+ }++ const project = parseProjectMentionHref(href);+ if (project) {+ return {+ kind: "project",+ projectId: project.projectId,+ color: project.color,+ };+ }++ return null;+}++export function mentionChipInlineStyle(mention: ParsedMentionChip): CSSProperties | undefined {+ const style: CSSProperties & Record<string, string> = {};++ if (mention.kind === "project" && mention.color) {+ const projectStyle = projectMentionColors(mention.color);+ Object.assign(style, projectStyle);+ style["--paperclip-mention-project-color"] = mention.color;+ }++ if (mention.kind === "agent") {+ const iconMask = buildAgentIconMask(mention.icon);+ if (iconMask) {+ style["--paperclip-mention-icon-mask"] = iconMask;+ }+ }++ return Object.keys(style).length > 0 ? (style as CSSProperties) : undefined;+}++export function applyMentionChipDecoration(element: HTMLElement, mention: ParsedMentionChip) {+ clearMentionChipDecoration(element);+ element.dataset.mentionKind = mention.kind;+ element.setAttribute("contenteditable", "false");+ element.classList.add("paperclip-mention-chip", `paperclip-mention-chip--${mention.kind}`);+ if (mention.kind === "project") {+ element.classList.add("paperclip-project-mention-chip");+ }++ const style = mentionChipInlineStyle(mention);+ if (!style) return;+ for (const [key, value] of Object.entries(style)) {+ if (typeof value === "string") {+ if (key.startsWith("--")) {+ element.style.setProperty(key, value);+ } else {+ (element.style as CSSStyleDeclaration & Record<string, string>)[key] = value;+ }+ }+ }+}++export function clearMentionChipDecoration(element: HTMLElement) {+ delete element.dataset.mentionKind;+ element.classList.remove(+ "paperclip-mention-chip",+ "paperclip-mention-chip--agent",+ "paperclip-mention-chip--project",+ "paperclip-project-mention-chip",+ );+ element.removeAttribute("contenteditable");+ element.style.removeProperty("border-color");+ element.style.removeProperty("background-color");+ element.style.removeProperty("color");+ element.style.removeProperty("--paperclip-mention-project-color");+ element.style.removeProperty("--paperclip-mention-icon-mask");+}++function projectMentionColors(color: string): Pick<CSSProperties, "borderColor" | "backgroundColor" | "color"> {+ const rgb = hexToRgb(color);+ if (!rgb) return {};+ const luminance = (0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b) / 255;+ return {+ borderColor: color,+ backgroundColor: `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, 0.22)`,+ color: luminance > 0.55 ? "#111827" : "#f8fafc",+ };+}++function hexToRgb(hex: string): { r: number; g: number; b: number } | null {+ const match = /^#([0-9a-f]{6})$/i.exec(hex.trim());+ if (!match) return null;+ const value = match[1];+ return {+ r: parseInt(value.slice(0, 2), 16),+ g: parseInt(value.slice(2, 4), 16),+ b: parseInt(value.slice(4, 6), 16),+ };+}++function buildAgentIconMask(iconName: string | null): string | null {+ const cacheKey = iconName ?? "__default__";+ const cached = iconMaskCache.get(cacheKey);+ if (cached) return cached;++ const Icon = getAgentIcon(iconName);+ const rendered = (+ Icon as unknown as {+ render: (+ props: Record<string, unknown>,+ ref: unknown,+ ) => { props?: { iconNode?: Array<[string, Record<string, string>]> } };+ }+ ).render({ size: 12, strokeWidth: 2 }, null);+ const iconNode = rendered?.props?.iconNode;+ if (!Array.isArray(iconNode) || iconNode.length === 0) return null;++ const body = iconNode.map(([tag, attrs]) => {+ const attrString = Object.entries(attrs)+ .filter(([key]) => key !== "key")+ .map(([key, value]) => `${key}="${escapeAttribute(String(value))}"`)+ .join(" ");+ return `<${tag}${attrString ? ` ${attrString}` : ""}></${tag}>`;+ }).join("");++ const svg =+ `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" ` ++ `fill="none" stroke="#000" stroke-width="2" stroke-linecap="round" ` ++ `stroke-linejoin="round">${body}</svg>`;+ const url = `url("data:image/svg+xml,${encodeURIComponent(svg)}")`;+ iconMaskCache.set(cacheKey, url);+ return url;+}++function escapeAttribute(value: string): string {+ return value+ .replaceAll("&", "&")+ .replaceAll('"', """)+ .replaceAll("<", "<")+ .replaceAll(">", ">");+}diff --git a/ui/src/pages/IssueDetail.tsx b/ui/src/pages/IssueDetail.tsxindex 2c6ae1043c..ecdba9883c 100644--- a/ui/src/pages/IssueDetail.tsx+++ b/ui/src/pages/IssueDetail.tsx@@ -341,6 +341,8 @@ export function IssueDetail() {id: `agent:${agent.id}`,name: agent.name,kind: "agent",+ agentId: agent.id,+ agentIcon: agent.icon,});}for (const project of orderedProjects) {