fix(chat): copy workspace links with real ids

Author: j15z

apps/sim/app/workspace/[workspaceId]/files/components/file-viewer/rich-markdown-editor/mention/mention-node.ts

@@ -1,6 +1,6 @@
 import type { JSONContent, MarkdownToken } from '@tiptap/core'
 import { InputRule, Node } from '@tiptap/core'
-import { toSimHref } from './sim-link'
+import { toSimMarkdownLink } from './sim-link'
 import type { MentionKind } from './types'
 
 export interface MentionAttrs {
@@ -16,12 +16,7 @@ export interface MentionAttrs {
  */
 const MENTION_MD_RE = /^\[((?:\\.|[^\]\\])+)\]\(sim:([a-z_]+)\/([^)\s]+)\)/
 
-/** Escape `\`, `[`, `]` in a mention label so brackets in entity names can't break the link syntax. */
-function escapeLabel(label: string): string {
-  return label.replace(/[\\[\]]/g, '\\$&')
-}
-
-/** Inverse of {@link escapeLabel}, applied when parsing a mention back from markdown. */
+/** Inverse of the label escaping applied by {@link toSimMarkdownLink}. */
 function unescapeLabel(label: string): string {
   return label.replace(/\\([\\[\]])/g, '$1')
 }
@@ -96,12 +91,12 @@ export const MarkdownMention = Node.create({
   },
   renderMarkdown: (node: JSONContent): string => {
     const { kind, id, label } = (node.attrs ?? {}) as MentionAttrs
-    return `[${escapeLabel(label)}](${toSimHref(kind, id)})`
+    return toSimMarkdownLink(kind, id, label)
   },
 
   renderText: ({ node }) => {
     const { kind, id, label } = node.attrs as MentionAttrs
-    return `[${escapeLabel(label)}](${toSimHref(kind, id)})`
+    return toSimMarkdownLink(kind, id, label)
   },
 
   /**

apps/sim/app/workspace/[workspaceId]/files/components/file-viewer/rich-markdown-editor/mention/sim-link.ts

@@ -9,6 +9,12 @@ export function toSimHref(kind: string, id: string): string {
   return `${SIM_LINK_SCHEME}:${kind}/${id}`
 }
 
+/** Builds portable mention Markdown while escaping characters that can break its label. */
+export function toSimMarkdownLink(kind: string, id: string, label: string): string {
+  const escapedLabel = label.replace(/[\\[\]]/g, '\\$&')
+  return `[${escapedLabel}](${toSimHref(kind, id)})`
+}
+
 /**
  * Resolves the in-app route for a clicked `sim:` mention, or `null` when the kind has no navigable
  * destination. Each path matches the entity's real route: files open the file detail view,

apps/sim/app/workspace/[workspaceId]/home/components/message-content/components/chat-content/workspace-resource-markdown.ts

@@ -11,7 +11,7 @@ function endsInlineWord(value: string): boolean {
   return /[A-Za-z0-9_)]$/.test(value)
 }
 
-function workspaceResourceLabel(data: WorkspaceResourceTagData): string {
+export function workspaceResourceLabel(data: WorkspaceResourceTagData): string {
   if (data.title) return data.title
   return data.type === 'file' ? (data.path ?? data.id ?? '') : (data.id ?? '')
 }

apps/sim/app/workspace/[workspaceId]/home/components/mothership-chat/copyable-markdown.test.ts

@@ -1,11 +1,27 @@
 import { describe, expect, it } from 'vitest'
+import type { WorkspaceFileRecord } from '@/lib/uploads/contexts/workspace'
 import {
   getCopyableMessageContent,
   hasCopyableMessageContent,
   toCopyableMarkdown,
 } from '@/app/workspace/[workspaceId]/home/components/mothership-chat/copyable-markdown'
 import type { ContentBlock } from '@/app/workspace/[workspaceId]/home/types'
 
+const WORKSPACE_FILES: WorkspaceFileRecord[] = [
+  {
+    id: 'file_bell',
+    workspaceId: 'workspace-1',
+    name: 'The Bell at Low Tide.md',
+    key: 'workspace/workspace-1/file_bell',
+    path: '/api/files/view/file_bell',
+    size: 0,
+    type: 'text/markdown',
+    uploadedBy: 'user-1',
+    uploadedAt: new Date(0),
+    updatedAt: new Date(0),
+  },
+]
+
 describe('toCopyableMarkdown', () => {
   it('preserves message Markdown, including fenced code and its language', () => {
     const message = [
@@ -50,15 +66,20 @@ describe('toCopyableMarkdown', () => {
     expect(toCopyableMarkdown(message)).toBe(message)
   })
 
-  it('preserves visible workspace resources as Markdown links', () => {
+  it('copies workspace resources as portable Markdown links with real ids', () => {
     const message = [
       'Read',
-      '<workspace_resource>{"type":"file","path":"files/notes.md","title":"notes.md"}</workspace_resource>',
-      'for details.',
+      '<workspace_resource>{"type":"file","path":"files/The%20Bell%20at%20Low%20Tide.md","title":"The Bell at Low Tide.md"}</workspace_resource>',
+      'and',
+      `<workspace_resource>${JSON.stringify({
+        type: 'table',
+        id: 'tbl_f26af6dae98d4222b014b250494d00fb',
+        title: 'Checked_[rare]\\portal',
+      })}</workspace_resource>.`,
     ].join(' ')
 
-    expect(toCopyableMarkdown(message)).toBe(
-      'Read [notes.md](<#wsres-file-files/notes.md>) for details.'
+    expect(toCopyableMarkdown(message, WORKSPACE_FILES)).toBe(
+      'Read [The Bell at Low Tide.md](sim:file/file_bell) and [Checked_\\[rare\\]\\\\portal](sim:table/tbl_f26af6dae98d4222b014b250494d00fb).'
     )
   })
 
@@ -75,9 +96,7 @@ describe('toCopyableMarkdown', () => {
 
     const content = getCopyableMessageContent(contentBlocks, 'Fallback without the resource.')
 
-    expect(toCopyableMarkdown(content)).toBe(
-      'Read [notes.md](<#wsres-file-files/notes.md>) for details.'
-    )
+    expect(toCopyableMarkdown(content, WORKSPACE_FILES)).toBe('Read notes.md for details.')
   })
 
   it('does not offer copy for blocks without visible text', () => {

apps/sim/app/workspace/[workspaceId]/home/components/mothership-chat/copyable-markdown.ts

@@ -1,9 +1,15 @@
+import type { WorkspaceFileRecord } from '@/lib/uploads/contexts/workspace'
+import { toSimMarkdownLink } from '@/app/workspace/[workspaceId]/files/components/file-viewer/rich-markdown-editor/mention/sim-link'
 import { sanitizeChatDisplayContent } from '@/app/workspace/[workspaceId]/home/components/message-content/components/chat-content/chat-sanitize'
 import {
   appendInlineReferenceMarkdown,
-  workspaceResourceReferenceMarkdown,
+  workspaceResourceLabel,
 } from '@/app/workspace/[workspaceId]/home/components/message-content/components/chat-content/workspace-resource-markdown'
-import { parseSpecialTags } from '@/app/workspace/[workspaceId]/home/components/message-content/components/special-tags'
+import {
+  parseSpecialTags,
+  type WorkspaceResourceTagData,
+} from '@/app/workspace/[workspaceId]/home/components/message-content/components/special-tags'
+import { resolveWorkspaceResourceRef } from '@/app/workspace/[workspaceId]/home/resolve-resource-ref'
 import type { ContentBlock } from '@/app/workspace/[workspaceId]/home/types'
 
 function isCopyableTextBlock(block: ContentBlock): boolean {
@@ -32,7 +38,19 @@ export function getCopyableMessageContent(
   return blockContent.trim() ? blockContent : fallbackContent
 }
 
-export function toCopyableMarkdown(raw: string): string {
+function portableWorkspaceResourceMarkdown(
+  data: WorkspaceResourceTagData,
+  workspaceFiles: readonly WorkspaceFileRecord[]
+): string {
+  const label = workspaceResourceLabel(data)
+  const resource = resolveWorkspaceResourceRef({ ...data, title: label }, workspaceFiles)
+  return resource ? toSimMarkdownLink(resource.type, resource.id, label) : label
+}
+
+export function toCopyableMarkdown(
+  raw: string,
+  workspaceFiles: readonly WorkspaceFileRecord[] = []
+): string {
   const displayContent = sanitizeChatDisplayContent(raw)
   const { segments } = parseSpecialTags(displayContent, false)
 
@@ -42,7 +60,7 @@ export function toCopyableMarkdown(raw: string): string {
       if (segment.type === 'workspace_resource') {
         return appendInlineReferenceMarkdown(
           markdown,
-          workspaceResourceReferenceMarkdown(segment.data),
+          portableWorkspaceResourceMarkdown(segment.data, workspaceFiles),
           segments[index + 1]
         )
       }

apps/sim/app/workspace/[workspaceId]/home/components/mothership-chat/mothership-chat.tsx

@@ -13,6 +13,7 @@ import {
 import { cn } from '@sim/emcn'
 import { defaultRangeExtractor, type Range, useVirtualizer } from '@tanstack/react-virtual'
 import { SMOOTH_CHASE_RATE } from '@/lib/core/utils/smooth-bottom-chase'
+import type { WorkspaceFileRecord } from '@/lib/uploads/contexts/workspace'
 import { MessageActions } from '@/app/workspace/[workspaceId]/components'
 import { ChatMessageAttachments } from '@/app/workspace/[workspaceId]/home/components/chat-message-attachments'
 import { ChatSurfaceProvider } from '@/app/workspace/[workspaceId]/home/components/chat-surface-context'
@@ -58,6 +59,7 @@ import { shouldShowAssistantMessageActions } from './message-actions-visibility'
 
 interface MothershipChatProps {
   messages: ChatMessage[]
+  workspaceFiles: readonly WorkspaceFileRecord[]
   isSending: boolean
   isReconnecting?: boolean
   isLoading?: boolean
@@ -190,6 +192,7 @@ const UserMessageRow = memo(function UserMessageRow({
 
 interface AssistantMessageRowProps {
   message: ChatMessage
+  workspaceFiles: readonly WorkspaceFileRecord[]
   isStreaming: boolean
   isLast: boolean
   precedingUserContent?: string
@@ -206,6 +209,7 @@ interface AssistantMessageRowProps {
 
 const AssistantMessageRow = memo(function AssistantMessageRow({
   message,
+  workspaceFiles,
   isStreaming,
   isLast,
   precedingUserContent,
@@ -234,6 +238,10 @@ const AssistantMessageRow = memo(function AssistantMessageRow({
     () => getCopyableMessageContent(blocks, message.content),
     [blocks, message.content]
   )
+  const prepareContentForCopy = useCallback(
+    (content: string) => toCopyableMarkdown(content, workspaceFiles),
+    [workspaceFiles]
+  )
 
   const hasRenderableAssistant = assistantMessageHasRenderableContent(blocks, message.content ?? '')
   if (!hasRenderableAssistant && !trimmedContent && !isStreaming) {
@@ -293,7 +301,7 @@ const AssistantMessageRow = memo(function AssistantMessageRow({
               content={message.content}
               getCopyContent={getCopyContent}
               hasCopyContent={hasCopyableMessageContent(blocks, message.content)}
-              prepareContentForCopy={toCopyableMarkdown}
+              prepareContentForCopy={prepareContentForCopy}
               userQuery={precedingUserContent}
               requestId={message.requestId}
               messageId={message.id}
@@ -307,6 +315,7 @@ const AssistantMessageRow = memo(function AssistantMessageRow({
 
 export function MothershipChat({
   messages: messagesProp,
+  workspaceFiles,
   isSending,
   isReconnecting = false,
   isLoading = false,
@@ -744,6 +753,7 @@ export function MothershipChat({
                     ) : (
                       <AssistantMessageRow
                         message={msg}
+                        workspaceFiles={workspaceFiles}
                         isStreaming={isStreamActive && isLast}
                         isLast={isLast}
                         precedingUserContent={precedingUserContentByIndex[index]}

apps/sim/app/workspace/[workspaceId]/home/home.tsx

@@ -644,6 +644,7 @@ export function Home({ chatId, userName, userId, tableViewsEnabled }: HomeProps)
         ) : (
           <MothershipChat
             messages={messages}
+            workspaceFiles={workspaceFiles}
             isSending={isSending}
             isReconnecting={isReconnecting}
             isLoading={showChatSkeleton}

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/panel.tsx

@@ -46,6 +46,7 @@ import {
   type MothershipSendMessageDetail,
 } from '@/lib/mothership/events'
 import { captureEvent } from '@/lib/posthog/client'
+import type { WorkspaceFileRecord } from '@/lib/uploads/contexts/workspace'
 import { generateWorkflowJson } from '@/lib/workflows/operations/import-export'
 import { ConversationListItem } from '@/app/workspace/[workspaceId]/components'
 import { MothershipChat } from '@/app/workspace/[workspaceId]/home/components'
@@ -79,6 +80,7 @@ import {
 import { useFolderMap } from '@/hooks/queries/folders'
 import { isWorkflowEffectivelyLocked } from '@/hooks/queries/utils/folder-tree'
 import { useDuplicateWorkflowMutation, useWorkflowMap } from '@/hooks/queries/workflows'
+import { useWorkspaceFiles } from '@/hooks/queries/workspace-files'
 import { useCollaborativeWorkflow } from '@/hooks/use-collaborative-workflow'
 import { usePermissionConfig } from '@/hooks/use-permission-config'
 import { useSettingsNavigation } from '@/hooks/use-settings-navigation'
@@ -96,6 +98,7 @@ import type { WorkflowState } from '@/stores/workflows/workflow/types'
 
 const logger = createLogger('Panel')
 const EMPTY_COPILOT_CHATS: readonly CopilotChatListItem[] = []
+const EMPTY_WORKSPACE_FILES: readonly WorkspaceFileRecord[] = []
 /**
  * Panel component with resizable width and tab navigation that persists across page refreshes.
  *
@@ -162,6 +165,11 @@ export const Panel = memo(function Panel() {
   const isCopilotTabAvailable = isChatEnabled && !permissionConfig.hideCopilot
   const activeTab: PanelTab =
     storedActiveTab === 'copilot' && !isCopilotTabAvailable ? 'toolbar' : storedActiveTab
+  const { data: copilotWorkspaceFiles = EMPTY_WORKSPACE_FILES } = useWorkspaceFiles(
+    workspaceId,
+    'active',
+    { enabled: activeTab === 'copilot' }
+  )
   const { isImporting, handleFileChange } = useImportWorkflow({ workspaceId })
   const duplicateWorkflowMutation = useDuplicateWorkflowMutation()
   const { data: workflows = {} } = useWorkflowMap(workspaceId)
@@ -930,6 +938,7 @@ export const Panel = memo(function Panel() {
                 <MothershipChat
                   className='min-h-0 flex-1'
                   messages={copilotMessages}
+                  workspaceFiles={copilotWorkspaceFiles}
                   isSending={copilotIsSending}
                   isReconnecting={copilotIsReconnecting}
                   onSubmit={handleCopilotSubmit}