feat(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@brendan-kellam
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 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(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@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(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@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 > 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(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@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(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@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(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@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(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@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(web): expose get_diff on MCP server - #1142

Merged
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968
Apr 21, 2026
Merged

feat(web): expose get_diff on MCP server#1142
msukkari merged 3 commits into
mainfrom
michael/expose-mcp-get-diff-sou-968

Conversation

@msukkari

@msukkarimsukkari commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Fixes SOU-968

Summary

  • add a new get_diff MCP tool that returns structured git diff data between base and head
  • register get_diff in the Sourcebot MCP server toolset
  • document get_diff in MCP docs with parameters aligned to the public API diff schema

Test plan

  • run yarn workspace @sourcebot/web lint
  • verify MCP descriptor includes get_diff with repo, base, head
  • call MCP get_diff for main~1..main and verify non-empty diff output
  • compare MCP get_diff output for HEAD~5..HEAD with git diff file set and stats

Made with Cursor

Summary by CodeRabbit

  • New Features
    • Added a new MCP tool, "get_diff", to return structured git diffs between two refs (repo, base, head), including changed files, hunks, line ranges, and patch content.
  • UI
    • Chat now displays a compact "Compared base to head in repo" summary with changed-file counts and a dedicated tool output renderer.
  • Documentation
    • Added user docs and changelog entry describing the new get_diff tool.

Add a new get_diff MCP tool backed by the existing git diff API so agents can request structured diffs between refs. Document the tool in MCP docs with parameters aligned to the public API spec.
Made-with: Cursor
@mintlify

mintlifyBot commented Apr 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
sourcebot🟢 ReadyView PreviewApr 21, 2026, 5:24 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions

This comment has been minimized.

@coderabbitai

coderabbitaiBot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 278f62cc-74d6-4442-bb7a-414d44b0eee3

📥 Commits

Reviewing files that changed from the base of the PR and between f401c24 and a7511d7.

📒 Files selected for processing (4)
  • packages/web/src/features/chat/agent.ts
  • packages/web/src/features/chat/components/chatThread/detailsCard.tsx
  • packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx
  • packages/web/src/features/chat/tools.ts

Walkthrough

Adds a new MCP tool get_diff that returns a structured git diff between two refs; includes tool implementation, schema, MCP registration, UI rendering, docs, and changelog entry. (50 words)

Changes

Cohort / File(s)Summary
Documentation
docs/docs/features/mcp-server.mdx, packages/web/src/features/tools/getDiff.txt
Added documentation for the get_diff tool, describing purpose and required parameters: repo, base, head.
Tool Implementation
packages/web/src/features/tools/getDiff.ts
New tool definition getDiffDefinition with request schema, logging, call to getDiff, service-error handling, JSON-stringified output, and enriched metadata.
Tool Barrel & Server Registration
packages/web/src/features/tools/index.ts, packages/web/src/features/mcp/server.ts
Re-exported getDiff from tools barrel and registered get_diff with the MCP server.
Chat Integration & UI
packages/web/src/features/chat/tools.ts, packages/web/src/features/chat/components/chatThread/detailsCard.tsx, packages/web/src/features/chat/components/chatThread/tools/getDiffToolComponent.tsx, packages/web/src/features/chat/agent.ts
Added chat/tool mapping, UI part type, rendering case for tool-get_diff, new GetDiffToolComponent, and updated system prompt examples to include get_diff.
Changelog
CHANGELOG.md
Added Unreleased note recording the new get_diff MCP tool (#1142).

Sequence Diagram(s)

sequenceDiagram
participant Client as Client
participant MCP as MCP Server
participant Tool as get_diff Tool
participant DiffSvc as Diff Service
Client->>MCP: Request get_diff(repo, base, head)
MCP->>Tool: invoke handler with params
Tool->>DiffSvc: getDiff(repo, base, head)
DiffSvc-->>Tool: diff result / error
alt success
Tool-->>MCP: return JSON output + metadata
MCP-->>Client: 200 + diff payload
else service error
Tool-->>MCP: throw Error(response.message)
MCP-->>Client: 5xx error
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • brendan-kellam
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title 'feat(web): expose get_diff on MCP server' clearly and concisely summarizes the main change: adding and exposing the get_diff tool to the MCP server.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch michael/expose-mcp-get-diff-sou-968

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.

Document the new MCP get_diff capability under Unreleased using the repository changelog format and PR link.
Made-with: Cursor

@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.

🧹 Nitpick comments (1)
packages/web/src/features/tools/getDiff.ts (1)

21-39: Consider size limits for large diffs.

JSON.stringify(response) returns the full diff with no truncation or size cap. For large base..head ranges this could produce very large outputs that exceed MCP client limits or consume excessive tokens. Consider adding a max file/hunk cap or a size guard, similar to the limit parameters on other tools (grep, glob, list_commits).

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@packages/web/src/features/tools/getDiff.ts` around lines 21 - 39, The execute
handler currently returns the full diff (JSON.stringify(response)) which can be
arbitrarily large; update the execute implementation in getDiff.ts (the execute
function that calls getDiff and uses isServiceError) to enforce a size/entry
cap: either pass a new limit parameter into getDiff (e.g., file/hunk limit) or
truncate the response before stringifying (e.g., keep first N files/hunks and
set a truncated=true flag), and include metadata that indicates truncation along
with repo/base/head; ensure you still throw on isServiceError(response) and
preserve the existing metadata merge but replace output with the
capped/truncated JSON to avoid oversized payloads.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Nitpick comments:
In `@packages/web/src/features/tools/getDiff.ts`:
- Around line 21-39: The execute handler currently returns the full diff
(JSON.stringify(response)) which can be arbitrarily large; update the execute
implementation in getDiff.ts (the execute function that calls getDiff and uses
isServiceError) to enforce a size/entry cap: either pass a new limit parameter
into getDiff (e.g., file/hunk limit) or truncate the response before
stringifying (e.g., keep first N files/hunks and set a truncated=true flag), and
include metadata that indicates truncation along with repo/base/head; ensure you
still throw on isServiceError(response) and preserve the existing metadata merge
but replace output with the capped/truncated JSON to avoid oversized payloads.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 53057228-4605-4cf8-8dea-8558c9bc0381

📥 Commits

Reviewing files that changed from the base of the PR and between 48ad44d and a23c35a.

📒 Files selected for processing (5)
  • docs/docs/features/mcp-server.mdx
  • packages/web/src/features/mcp/server.ts
  • packages/web/src/features/tools/getDiff.ts
  • packages/web/src/features/tools/getDiff.txt
  • packages/web/src/features/tools/index.ts

brendan-kellam
brendan-kellam previously approved these changes Apr 21, 2026
Register get_diff in the Ask agent toolset and render its output in the details panel so chat workflows can compare refs directly.
Made-with: Cursor
@msukkari
msukkari merged commit 14ca65d into mainApr 21, 2026
6 of 7 checks passed
@github-actionsgithub-actionsBot mentioned this pull request Apr 21, 2026
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.

2 participants

@msukkari@brendan-kellam