feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all \u003cpre\u003e\u003ccode\u003e blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks"); } } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); } })(); (function(){ try { var __m = "github.com"; var __re = new RegExp('^' + "github\\.com" + '
Skip to content

feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length \u003e 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

feat(chat): resolve embedded file links to full code-host URLs - #756

Closed
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links
Closed

feat(chat): resolve embedded file links to full code-host URLs#756
Cprakhar wants to merge 2 commits into
sourcebot-dev:mainfrom
Cprakhar:feat/resolve-embedded-links

Conversation

@Cprakhar

@CprakharCprakhar commented Jan 20, 2026

Copy link
Copy Markdown

Summary

Convert embedded LLM file citations (e.g. @file:{github.com/owner/repo::path/to/file.ext:10-20})
into portable, clickable URLs that point to a file on the originating code host.

This change ensures links emitted by the model are usable by users (not local paths).

Closes#576

What I changed

  • Updated link conversion logic in packages/web/src/features/chat/utils.ts
    • Added buildCodeHostFileUrl() to construct file URLs for GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit and generic git hosts.
    • convertLLMOutputToPortableMarkdown() now accepts an optional sources array so it can use the indexed revision for a file when available, falling back to main.
  • Added/updated tests in packages/web/src/features/chat/utils.test.ts covering multiple hosts, line anchors, ranges, .md/.mdx handling, and branch resolution from sources.

Why

LLM responses embed file references for traceability. Previously those produced local paths (e.g., /path/to/file), which are not portable when copying as Markdown. This change converts them into full remote URLs matching the code host's expected blob/src format and preserves line anchors.

Notes on platform support

Supported hosts and behaviors:

  • GitHub (github.com and GH Enterprise): .../blob/{branch}/{path}#L{n} (adds ?plain=1 for raw markdown views where appropriate)
  • GitLab: .../-/blob/{branch}/{path}#L{n}
  • Bitbucket: .../src/{branch}/{path}#lines-{n}
  • Azure DevOps: .../_git/{repo}?path=/{path}&version=GB{branch}&line={n}
  • Gitea, Gerrit, generic git hosts: reasonable fallbacks supported

If a file source (from the LLM retrieval metadata) is provided, the code will prefer the revision from that source to construct the URL instead of defaulting to main.

Summary by CodeRabbit

  • New Features

    • Answer cards can include file sources so file references are preserved and copied with context.
    • Markdown conversion now resolves file references to full code-host URLs across many providers, honoring revisions, line numbers, and ranges.
  • Tests

    • Extensive tests added for link generation and markdown conversion across multiple code hosts, branches, paths, and edge cases.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai

coderabbitaiBot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Walkthrough

Adds code-host-aware URL resolution for file references in assistant answers: new buildCodeHostFileUrl helper, convertLLMOutputToPortableMarkdown now accepts optional sources to resolve revisions, and AnswerCard components propagate file sources so copied Markdown contains absolute links.

Changes

Cohort / File(s)Summary
Component prop threading
packages/web/src/features/chat/components/chatThread/answerCard.tsx, packages/web/src/features/chat/components/chatThread/chatThreadListItem.tsx
Added sources?: FileSource[] to AnswerCard props; chatThreadListItem passes sources={sources.filter(source => source.type === 'file')}; copy handler now calls convertLLMOutputToPortableMarkdown(answerText, { sources }).
Core utility enhancements
packages/web/src/features/chat/utils.ts
Added buildCodeHostFileUrl(repo, fileName, revision, startLine?, endLine?); updated convertLLMOutputToPortableMarkdown(text, options?) to resolve file references to absolute code-host URLs using provided sources and resolved revisions; normalized file paths and display text.
Tests and exports
packages/web/src/features/chat/utils.test.ts
Exported and exercised convertLLMOutputToPortableMarkdown and buildCodeHostFileUrl; added comprehensive tests across GitHub, GitLab, Bitbucket, Azure DevOps, Gitea, Gerrit, and generic hosts, covering branches, line numbers/ranges, encoding, and edge cases.

Sequence Diagram(s)

sequenceDiagram
autonumber
participant User
participant AnswerCard
participant Utils as convertLLMOutputToPortableMarkdown
participant Builder as buildCodeHostFileUrl
participant CodeHost
User->>AnswerCard: Click "Copy answer"
AnswerCard->>Utils: convertLLMOutputToPortableMarkdown(answerText, { sources })
Utils->>Builder: resolve repo, path, revision, start/end
Builder->>CodeHost: construct provider-specific URL
CodeHost-->>Builder: URL string
Builder-->>Utils: resolved URL(s)
Utils-->>AnswerCard: portable Markdown with absolute links
AnswerCard-->>User: clipboard updated
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately summarizes the main change: converting embedded file links from relative paths to absolute code-host URLs.
Linked Issues check✅ PassedThe PR successfully implements all requirements from issue #576: converts relative file links to absolute URLs, preserves file paths and line references, uses host-specific formats, and resolves revisions from sources.
Out of Scope Changes check✅ PassedAll changes are directly scoped to resolving embedded file links: new URL-building functions, integration with AnswerCard component, and comprehensive tests.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 403-412: Normalize the referenced file path before matching and
URL construction: strip any leading slashes (or run a POSIX normalize) on
fileName before using it to find matchingSource in options?.sources and before
calling buildCodeHostFileUrl so revision lookup doesn’t miss entries when paths
include a leading slash; update the use of fileName in the matching logic and
the url call (references: matchingSource, options?.sources, fileName, repo,
revision, buildCodeHostFileUrl).
- Around line 260-365: The buildCodeHostFileUrl function constructs URLs by
interpolating raw filePath, revision and ownerRepo which can break for spaces or
special chars; update buildCodeHostFileUrl to percent-encode path and revision
components before interpolation (e.g., encode each segment of filePath and
ownerRepo via split('/').map(encodeURIComponent).join('/'), and encode revision
with encodeURIComponent) and ensure query parameter values used for Azure DevOps
(version, path, line, lineEnd) are encoded with encodeURIComponent; keep
line/anchor logic (startLine/endLine) intact but do not percent-encode the
leading “#L” or “:”-style anchors themselves.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts Outdated
@Cprakhar

Copy link
Copy Markdown
Author

@coderabbitai review

@coderabbitai

Copy link
Copy Markdown
Contributor
✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@packages/web/src/features/chat/utils.ts`:
- Around line 357-362: The Gerrit URL generation currently always prefixes the
revision with "refs/heads/", which breaks when the revision is a commit SHA or a
tag; update the host.includes('gerrit') branch in the URL builder to inspect
encodedRevision and choose the correct path: if encodedRevision matches a commit
SHA (e.g. 40 hex chars) use `/+/{encodedRevision}/{encodedFilePath}`, if it
represents a tag (e.g. starts with `refs/tags/` or otherwise detected as a tag)
use `/+/refs/tags/{tag}/{encodedFilePath}`, otherwise use
`/+/refs/heads/{encodedRevision}/{encodedFilePath}`; preserve the existing
startLine fragment logic (append `#${startLine}` when startLine is present) and
update any variable names (encodedRevision, encodedFilePath, startLine)
accordingly.
- Around line 330-347: The Azure DevOps branch/file query parameters are being
built using encodePathComponent (which preserves slashes), so values like
encodedFilePath and encodedRevision produce unencoded '/' in query params;
update the code that builds url (the Azure DevOps branch in the
host.includes('dev.azure.com') || host.includes('visualstudio.com') block) to
use full URL encoding for query parameter values (e.g., use encodeURIComponent
on the file path and revision instead of encodePathComponent) so that
encodedFilePath and encodedRevision become safe for query strings (slashes
become %2F) and then rebuild the url variable accordingly, preserving the
existing org/project/repoName assembly and the startLine/endLine logic.

Comment threadpackages/web/src/features/chat/utils.ts
Comment threadpackages/web/src/features/chat/utils.ts
@brendan-kellam
brendan-kellam self-requested a review January 22, 2026 19:32
@Cprakhar
Cprakharforce-pushed the feat/resolve-embedded-links branch from 19095e9 to 15fd8c3CompareFebruary 1, 2026 18:05
@brendan-kellam

Copy link
Copy Markdown
Contributor

@Cprakhar thanks for submitting this PR, but I ended up implementing it in #847

@Cprakhar
Cprakhar deleted the feat/resolve-embedded-links branch February 3, 2026 19:45
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FR] Resolve links embedded in Ask responses to URLs rather than relative paths

2 participants

@Cprakhar@brendan-kellam