chromium-codesearch-mcp
Version:
MCP server for searching Chromium source code via source.chromium.org with advanced Code Search syntax support
959 lines ā¢ 249 kB
JavaScript
#!/usr/bin/env node
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
import fetch from "node-fetch";
import fs from "node:fs/promises";
import path from "node:path";
import { fileURLToPath } from "node:url";
import { chromium } from 'playwright';
// Custom error types for better error handling
class ChromiumSearchError extends Error {
cause;
constructor(message, cause) {
super(message);
this.cause = cause;
this.name = 'ChromiumSearchError';
}
}
class GerritAPIError extends Error {
statusCode;
cause;
constructor(message, statusCode, cause) {
super(message);
this.statusCode = statusCode;
this.cause = cause;
this.name = 'GerritAPIError';
}
}
// Dynamic version loading
const __filename = fileURLToPath(import.meta.url);
const packageRoot = path.resolve(path.dirname(__filename), '..');
const packageJsonPath = path.join(packageRoot, 'package.json');
let packageInfo;
try {
packageInfo = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));
}
catch (error) {
console.error("Failed to load package.json:", error);
packageInfo = { version: "0.0.0-error", name: "chromium-codesearch-mcp" };
}
/**
* Filter comments to only include unresolved threads.
* A thread is resolved if its last comment has unresolved=false.
* This correctly handles Gerrit's threading model where the root comment
* may have unresolved=true but a reply has resolved it.
*/
function filterUnresolvedThreads(commentsData) {
const filteredResults = {};
for (const [file, comments] of Object.entries(commentsData)) {
if (!Array.isArray(comments))
continue;
const commentArray = comments;
// Build a map of comment IDs for quick lookup
const commentMap = new Map();
commentArray.forEach(c => commentMap.set(c.id, c));
// Helper function to find the root of a thread
const getThreadRoot = (comment) => {
let current = comment;
while (current.in_reply_to) {
const parent = commentMap.get(current.in_reply_to);
if (!parent)
return null;
current = parent;
}
return current;
};
// Find root comments (those without in_reply_to)
const rootComments = commentArray.filter(c => !c.in_reply_to);
// For each root, find all its replies and check if thread is unresolved
const unresolvedThreadComments = [];
for (const root of rootComments) {
// Get all comments in this thread (root + all replies)
const threadComments = commentArray.filter(c => c.id === root.id || getThreadRoot(c)?.id === root.id);
// Sort thread comments by time
const sortedThread = [...threadComments].sort((a, b) => new Date(a.updated).getTime() - new Date(b.updated).getTime());
// A thread is resolved if the last comment that set resolution has unresolved=false
// Track resolution status through the thread
let threadResolved = false;
for (const c of sortedThread) {
if (c.unresolved === false) {
threadResolved = true;
}
else if (c.unresolved === true) {
threadResolved = false;
}
}
// If thread is unresolved, include all its comments
if (!threadResolved) {
unresolvedThreadComments.push(...threadComments);
}
}
if (unresolvedThreadComments.length > 0) {
// Remove duplicates and maintain order
const seen = new Set();
filteredResults[file] = unresolvedThreadComments.filter(c => {
if (seen.has(c.id))
return false;
seen.add(c.id);
return true;
});
}
}
return filteredResults;
}
class ChromiumCodeSearchServer {
server;
cache = new Map();
constructor() {
this.server = new Server({
name: "chromium-codesearch",
version: packageInfo.version,
}, {
capabilities: {
tools: {},
},
});
this.setupToolHandlers();
}
log(level, message, data) {
const timestamp = new Date().toISOString();
const logEntry = {
timestamp,
level: level.toUpperCase(),
message,
...data
};
// Output structured logs to stderr to avoid interfering with MCP protocol
console.error(JSON.stringify(logEntry));
}
handleError(error, toolName, args) {
// Determine error type and create appropriate response
if (error instanceof ChromiumSearchError) {
return `Chromium search failed: ${error.message}`;
}
if (error instanceof GerritAPIError) {
return `Gerrit API error: ${error.message}${error.statusCode ? ` (HTTP ${error.statusCode})` : ''}`;
}
// Handle fetch/network errors
if (error.name === 'FetchError' || error.code === 'ENOTFOUND') {
return `Network error: Unable to reach search API. Please check your internet connection.`;
}
// Handle timeout errors
if (error.name === 'TimeoutError' || error.message?.includes('timeout')) {
return `Request timeout: The search took too long to complete. Try a more specific query.`;
}
// Generic error handling
const errorMessage = error.message || 'Unknown error occurred';
return `Tool execution failed: ${errorMessage}`;
}
setupToolHandlers() {
this.server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: [
{
name: "search_chromium_code",
description: "Search for code in the Chromium source repository using Google's official Code Search syntax",
inputSchema: {
type: "object",
properties: {
query: {
type: "string",
description: "Search query using Code Search syntax. Examples: 'LOG(INFO)', 'class:Browser', 'function:CreateWindow', 'lang:cpp memory', 'file:*.cc content:\"base::\"', 'comment:\"TODO: fix\"'",
},
case_sensitive: {
type: "boolean",
description: "Make search case sensitive (adds 'case:yes' to query)",
default: false,
},
language: {
type: "string",
description: "Filter by programming language (e.g., 'cpp', 'javascript', 'python')",
},
file_pattern: {
type: "string",
description: "File pattern filter (e.g., '*.cc', '*.h', 'chrome/browser/*')",
},
search_type: {
type: "string",
enum: ["content", "function", "class", "symbol", "comment"],
description: "Specific search type: 'content' (file contents), 'function' (function names), 'class' (class names), 'symbol' (symbols), 'comment' (comments only)",
},
exclude_comments: {
type: "boolean",
description: "Exclude comments and string literals from search (uses 'usage:' filter)",
default: false,
},
limit: {
type: "number",
description: "Maximum number of results to return (default: 20)",
default: 20,
},
},
required: ["query"],
},
},
{
name: "find_chromium_symbol",
description: "Find symbol definition, references, and usage in Chromium source",
inputSchema: {
type: "object",
properties: {
symbol: {
type: "string",
description: "Symbol to find (function, class, method, etc.)",
},
file_path: {
type: "string",
description: "Optional file path context for better symbol resolution",
},
},
required: ["symbol"],
},
},
{
name: "get_chromium_file",
description: "Get contents of a specific file from Chromium source",
inputSchema: {
type: "object",
properties: {
file_path: {
type: "string",
description: "Path to the file in Chromium source (e.g., 'base/logging.cc')",
},
line_start: {
type: "number",
description: "Optional starting line number",
},
line_end: {
type: "number",
description: "Optional ending line number",
},
},
required: ["file_path"],
},
},
{
name: "get_gerrit_cl_status",
description: "Get status and test results for a Chromium Gerrit CL",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '6624568' or 'https://chromium-review.googlesource.com/c/chromium/src/+/6624568')",
},
},
required: ["cl_number"],
},
},
{
name: "get_gerrit_cl_comments",
description: "Get review comments for a Chromium Gerrit CL patchset",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '6624568' or 'https://chromium-review.googlesource.com/c/chromium/src/+/6624568')",
},
patchset: {
type: "number",
description: "Optional specific patchset number to get comments for (if not specified, gets comments for current patchset)",
},
include_resolved: {
type: "boolean",
description: "Include resolved comments (default: true)",
default: true,
},
},
required: ["cl_number"],
},
},
{
name: "get_gerrit_cl_diff",
description: "Get the diff/changes for a Chromium Gerrit CL patchset to understand what code was modified",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '6624568' or 'https://chromium-review.googlesource.com/c/chromium/src/+/6624568')",
},
patchset: {
type: "number",
description: "Optional specific patchset number to get diff for (if not specified, gets diff for current patchset)",
},
file_path: {
type: "string",
description: "Optional specific file path to get diff for (if not specified, gets diff for all files)",
},
},
required: ["cl_number"],
},
},
{
name: "get_gerrit_patchset_file",
description: "Get the content of a specific file from a Gerrit patchset for making code changes",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '6624568' or 'https://chromium-review.googlesource.com/c/chromium/src/+/6624568')",
},
file_path: {
type: "string",
description: "Path to the file to get content for (e.g., 'chrome/browser/ui/browser.cc')",
},
patchset: {
type: "number",
description: "Optional specific patchset number (if not specified, gets file from current patchset)",
},
},
required: ["cl_number", "file_path"],
},
},
{
name: "get_gerrit_cl_trybot_status",
description: "Get detailed try-bot status for a Chromium Gerrit CL, including individual bot results and pass/fail counts",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '6624568' or 'https://chromium-review.googlesource.com/c/chromium/src/+/6624568')",
},
patchset: {
type: "number",
description: "Optional specific patchset number to get bot status for (if not specified, gets status for latest patchset)",
},
failed_only: {
type: "boolean",
description: "Only return failed bots (default: false)",
default: false,
},
},
required: ["cl_number"],
},
},
{
name: "get_gerrit_cl_bot_errors",
description: "Get detailed error messages with stack traces from failed try-bots for a Chromium Gerrit CL. This includes the actual test failures, assertion errors, and full stack traces to diagnose why tests failed.",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '6624568' or 'https://chromium-review.googlesource.com/c/chromium/src/+/6624568')",
},
patchset: {
type: "number",
description: "Optional specific patchset number to get errors for (if not specified, gets errors for latest patchset)",
},
bot_filter: {
type: "string",
description: "Optional bot name filter for partial matching (e.g., 'linux' matches all linux bots, 'linux-rel' matches only linux-rel bot)",
},
failed_only: {
type: "boolean",
description: "Only check failed bots (default: true)",
default: true,
},
},
required: ["cl_number"],
},
},
{
name: "get_ci_build_errors",
description: "Get detailed error messages with stack traces from a specific CI build URL. This provides the actual test failures, assertion errors, and complete stack traces from a CI build.",
inputSchema: {
type: "object",
properties: {
build_url: {
type: "string",
description: "CI build URL (e.g., 'https://ci.chromium.org/ui/p/chromium/builders/try/linux-rel/2396535') or Buildbucket URL or build ID",
},
},
required: ["build_url"],
},
},
// PDFium Gerrit tools
{
name: "get_pdfium_gerrit_cl_status",
description: "Get status and test results for a PDFium Gerrit CL",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '12345' or 'https://pdfium-review.googlesource.com/c/pdfium/+/12345')",
},
},
required: ["cl_number"],
},
},
{
name: "get_pdfium_gerrit_cl_comments",
description: "Get review comments for a PDFium Gerrit CL patchset",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '12345' or 'https://pdfium-review.googlesource.com/c/pdfium/+/12345')",
},
patchset: {
type: "number",
description: "Optional specific patchset number to get comments for (if not specified, gets comments for current patchset)",
},
include_resolved: {
type: "boolean",
description: "Include resolved comments (default: true)",
default: true,
},
},
required: ["cl_number"],
},
},
{
name: "get_pdfium_gerrit_cl_diff",
description: "Get the diff/changes for a PDFium Gerrit CL patchset to understand what code was modified",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '12345' or 'https://pdfium-review.googlesource.com/c/pdfium/+/12345')",
},
patchset: {
type: "number",
description: "Optional specific patchset number to get diff for (if not specified, gets diff for current patchset)",
},
file_path: {
type: "string",
description: "Optional specific file path to get diff for (if not specified, gets diff for all files)",
},
},
required: ["cl_number"],
},
},
{
name: "get_pdfium_gerrit_patchset_file",
description: "Get the content of a specific file from a PDFium Gerrit patchset for making code changes",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '12345' or 'https://pdfium-review.googlesource.com/c/pdfium/+/12345')",
},
file_path: {
type: "string",
description: "Path to the file to get content for (e.g., 'core/fpdfapi/parser/cpdf_parser.cpp')",
},
patchset: {
type: "number",
description: "Optional specific patchset number (if not specified, gets file from current patchset)",
},
},
required: ["cl_number", "file_path"],
},
},
{
name: "get_pdfium_gerrit_cl_trybot_status",
description: "Get detailed try-bot status for a PDFium Gerrit CL, including individual bot results and pass/fail counts",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '12345' or 'https://pdfium-review.googlesource.com/c/pdfium/+/12345')",
},
patchset: {
type: "number",
description: "Optional specific patchset number to get bot status for (if not specified, gets status for latest patchset)",
},
failed_only: {
type: "boolean",
description: "Only return failed bots (default: false)",
default: false,
},
},
required: ["cl_number"],
},
},
{
name: "list_pdfium_gerrit_cls",
description: "List PDFium Gerrit CLs from PDFium dashboard (requires authentication cookie)",
inputSchema: {
type: "object",
properties: {
query: {
type: "string",
description: "Gerrit search query for PDFium (e.g., 'owner:me', 'status:open', 'change:12345 OR change:67890')",
},
auth_cookie: {
type: "string",
description: "Authentication cookie - just need ONE of: __Secure-1PSID=... OR __Secure-3PSID=...",
},
limit: {
type: "number",
description: "Maximum number of CLs to return (default: 25, max: 100)",
default: 25,
},
},
required: ["auth_cookie"],
},
},
{
name: "find_chromium_owners_file",
description: "Find OWNERS files for a given file path in Chromium source code by searching up the directory tree",
inputSchema: {
type: "object",
properties: {
file_path: {
type: "string",
description: "Path to the file to find OWNERS for (e.g., 'chrome/browser/ui/browser.cc')",
},
},
required: ["file_path"],
},
},
{
name: "search_chromium_commits",
description: "Search commit messages and metadata in the Chromium repository using Gitiles API",
inputSchema: {
type: "object",
properties: {
query: {
type: "string",
description: "Search query for commit messages, file paths, or metadata",
},
author: {
type: "string",
description: "Filter by author name or email (optional)",
},
since: {
type: "string",
description: "Only commits after this date (YYYY-MM-DD format, optional)",
},
until: {
type: "string",
description: "Only commits before this date (YYYY-MM-DD format, optional)",
},
limit: {
type: "number",
description: "Maximum number of commits to return (default: 20, max: 100)",
},
},
required: ["query"],
},
},
{
name: "get_chromium_issue",
description: "Get details for a specific Chromium issue/bug from issues.chromium.org",
inputSchema: {
type: "object",
properties: {
issue_id: {
type: "string",
description: "Issue ID or full URL (e.g., '422768753' or 'https://issues.chromium.org/issues/422768753')",
},
},
required: ["issue_id"],
},
},
{
name: "search_chromium_issues",
description: "Search for issues in the Chromium issue tracker with full-text search across titles, descriptions, and metadata",
inputSchema: {
type: "object",
properties: {
query: {
type: "string",
description: "Search query for issue titles, descriptions, or metadata (e.g., 'memory leak', 'pkasting', 'security')",
},
limit: {
type: "number",
description: "Maximum number of results to return (default: 50, max: 100)",
default: 50,
},
start_index: {
type: "number",
description: "Starting index for pagination (default: 0)",
default: 0,
},
},
required: ["query"],
},
},
{
name: "list_chromium_folder",
description: "List files and folders in a specific directory of the Chromium source tree",
inputSchema: {
type: "object",
properties: {
folder_path: {
type: "string",
description: "Path to the folder in Chromium source (e.g., 'third_party/blink/renderer/core/style')",
},
},
required: ["folder_path"],
},
},
{
name: "list_gerrit_cls",
description: "List Gerrit CLs from Chromium dashboard (requires authentication cookie)",
inputSchema: {
type: "object",
properties: {
query: {
type: "string",
description: "Gerrit search query (e.g., 'owner:me', 'status:open', 'change:1234 OR change:5678')",
},
auth_cookie: {
type: "string",
description: "Authentication cookie - just need ONE of: __Secure-1PSID=... OR __Secure-3PSID=...",
},
limit: {
type: "number",
description: "Maximum number of CLs to return (default: 25, max: 100)",
default: 25,
},
},
required: ["auth_cookie"],
},
},
{
name: "suggest_reviewers_for_cl",
description: "Find optimal reviewers for a Chromium CL. Analyzes OWNERS files and recent commit activity to suggest the minimal set of reviewers who can cover all changed files. Ranks reviewers by both OWNERS coverage and recent commit activity.",
inputSchema: {
type: "object",
properties: {
cl_number: {
type: "string",
description: "CL number or full Gerrit URL (e.g., '7186763' or 'https://chromium-review.googlesource.com/c/chromium/src/+/7186763')",
},
patchset: {
type: "number",
description: "Optional specific patchset number (if not specified, uses latest patchset)",
},
max_reviewers: {
type: "number",
description: "Maximum number of reviewers to suggest (default: 5)",
default: 5,
},
fast: {
type: "boolean",
description: "Skip activity analysis for faster results, using only OWNERS file coverage (default: false)",
default: false,
},
exclude_reviewers: {
type: "array",
items: { type: "string" },
description: "Email addresses of reviewers to exclude from suggestions",
},
},
required: ["cl_number"],
},
},
],
};
});
this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
const startTime = Date.now();
try {
this.log('info', `Executing tool: ${name}`, { args });
let result;
switch (name) {
case "search_chromium_code":
result = await this.searchChromiumCode(args);
break;
case "find_chromium_symbol":
result = await this.findChromiumSymbol(args);
break;
case "get_chromium_file":
result = await this.getChromiumFile(args);
break;
case "get_gerrit_cl_status":
result = await this.getGerritCLStatus(args);
break;
case "get_gerrit_cl_comments":
result = await this.getGerritCLComments(args);
break;
case "get_gerrit_cl_diff":
result = await this.getGerritCLDiff(args);
break;
case "get_gerrit_patchset_file":
result = await this.getGerritPatchsetFile(args);
break;
case "get_gerrit_cl_trybot_status":
result = await this.getGerritCLTrybotStatus(args);
break;
case "get_gerrit_cl_bot_errors":
result = await this.getGerritCLBotErrors(args);
break;
case "get_ci_build_errors":
result = await this.getCIBuildErrors(args);
break;
// PDFium Gerrit handlers
case "get_pdfium_gerrit_cl_status":
result = await this.getPDFiumGerritCLStatus(args);
break;
case "get_pdfium_gerrit_cl_comments":
result = await this.getPDFiumGerritCLComments(args);
break;
case "get_pdfium_gerrit_cl_diff":
result = await this.getPDFiumGerritCLDiff(args);
break;
case "get_pdfium_gerrit_patchset_file":
result = await this.getPDFiumGerritPatchsetFile(args);
break;
case "get_pdfium_gerrit_cl_trybot_status":
result = await this.getPDFiumGerritCLTrybotStatus(args);
break;
case "list_pdfium_gerrit_cls":
result = await this.listPDFiumGerritCLs(args);
break;
case "find_chromium_owners_file":
result = await this.findChromiumOwnersFile(args);
break;
case "search_chromium_commits":
result = await this.searchChromiumCommits(args);
break;
case "get_chromium_issue":
result = await this.getChromiumIssue(args);
break;
case "search_chromium_issues":
result = await this.searchChromiumIssues(args);
break;
case "list_chromium_folder":
result = await this.listChromiumFolder(args);
break;
case "list_gerrit_cls":
result = await this.listGerritCLs(args);
break;
case "suggest_reviewers_for_cl":
result = await this.suggestReviewersForCL(args);
break;
default:
throw new Error(`Unknown tool: ${name}`);
}
const executionTime = Date.now() - startTime;
this.log('info', `Tool executed successfully: ${name}`, { executionTime });
return result;
}
catch (error) {
const executionTime = Date.now() - startTime;
const errorMessage = this.handleError(error, name, args);
this.log('error', `Tool execution failed: ${name}`, {
error: error.message,
executionTime,
errorType: error.constructor.name
});
return {
content: [
{
type: "text",
text: errorMessage,
},
],
};
}
});
}
async searchChromiumCode(args) {
const { query, case_sensitive = false, language, file_pattern, search_type, exclude_comments = false, limit = 20 } = args;
// Build the enhanced search query using Code Search syntax
let searchQuery = query;
// Add case sensitivity if requested
if (case_sensitive) {
searchQuery = `case:yes ${searchQuery}`;
}
// Add language filter if specified
if (language) {
searchQuery = `lang:${language} ${searchQuery}`;
}
// Add file pattern filter if specified
if (file_pattern) {
searchQuery = `file:${file_pattern} ${searchQuery}`;
}
// Add search type filter if specified
if (search_type) {
switch (search_type) {
case 'content':
searchQuery = `content:${query}`;
break;
case 'function':
searchQuery = `function:${query}`;
break;
case 'class':
searchQuery = `class:${query}`;
break;
case 'symbol':
searchQuery = `symbol:${query}`;
break;
case 'comment':
searchQuery = `comment:${query}`;
break;
}
// Apply other filters to the type-specific query
if (case_sensitive)
searchQuery = `case:yes ${searchQuery}`;
if (language)
searchQuery = `lang:${language} ${searchQuery}`;
if (file_pattern)
searchQuery = `file:${file_pattern} ${searchQuery}`;
}
// Add usage filter to exclude comments if requested
if (exclude_comments && !search_type) {
searchQuery = `usage:${query}`;
if (case_sensitive)
searchQuery = `case:yes ${searchQuery}`;
if (language)
searchQuery = `lang:${language} ${searchQuery}`;
if (file_pattern)
searchQuery = `file:${file_pattern} ${searchQuery}`;
}
try {
const response = await this.callChromiumSearchAPI(searchQuery, limit);
const results = this.parseChromiumAPIResponse(response);
if (results.length === 0) {
const fallbackUrl = `https://source.chromium.org/search?q=${encodeURIComponent(query)}&ss=chromium%2Fchromium%2Fsrc`;
return {
content: [
{
type: "text",
text: `No results found for query: "${query}"\n\nš **Direct search URL:**\n${fallbackUrl}`,
},
],
};
}
// Format results with enhanced information
let resultText = `## Search Results for "${query}"\n\n`;
if (response.estimatedResultCount) {
resultText += `š **Total estimated matches:** ${response.estimatedResultCount}\n`;
resultText += `š **Showing:** ${results.length} results\n\n`;
}
resultText += results
.map((result, index) => {
const lineInfo = result.line > 0 ? `:${result.line}` : '';
return `### ${index + 1}. ${result.file}${lineInfo}\n` +
`\`\`\`\n${result.content.trim()}\n\`\`\`\n` +
`š [View in source.chromium.org](${result.url})\n`;
})
.join("\n");
// Add pagination info if available
if (response.nextPageToken) {
resultText += `\nš” **More results available** - Use the web interface to see additional matches.\n`;
}
resultText += `\nš **Direct search:** https://source.chromium.org/search?q=${encodeURIComponent(query)}&ss=chromium%2Fchromium%2Fsrc`;
return {
content: [
{
type: "text",
text: resultText,
},
],
};
}
catch (error) {
const fallbackUrl = `https://source.chromium.org/search?q=${encodeURIComponent(query)}&ss=chromium%2Fchromium%2Fsrc`;
return {
content: [
{
type: "text",
text: `Search failed: ${error.message}\n\nTry searching manually at: ${fallbackUrl}`,
},
],
};
}
}
async findChromiumSymbol(args) {
const { symbol, file_path } = args;
try {
// Search for symbol definitions using Code Search syntax
const symbolResults = await this.callChromiumSearchAPI(`symbol:${symbol}`, 10);
const symbolParsed = this.parseChromiumAPIResponse(symbolResults);
// Search for class definitions
const classResults = await this.callChromiumSearchAPI(`class:${symbol}`, 5);
const classParsed = this.parseChromiumAPIResponse(classResults);
// Search for function definitions
const functionResults = await this.callChromiumSearchAPI(`function:${symbol}`, 5);
const functionParsed = this.parseChromiumAPIResponse(functionResults);
// Search for general usage in content (excluding comments)
const usageResults = await this.callChromiumSearchAPI(`usage:${symbol}`, 10);
const usageParsed = this.parseChromiumAPIResponse(usageResults);
let resultText = `## Symbol: ${symbol}\n\n`;
if (file_path) {
resultText += `**Context file:** ${file_path}\n\n`;
}
// Symbol-specific results
if (symbolParsed.length > 0) {
resultText += `### šÆ Symbol Definitions:\n`;
symbolParsed.forEach((result, index) => {
resultText += `#### ${index + 1}. ${result.file}:${result.line}\n`;
resultText += `\`\`\`cpp\n${result.content.trim()}\n\`\`\`\n`;
resultText += `š [View source](${result.url})\n\n`;
});
}
// Class definitions
if (classParsed.length > 0) {
resultText += `### šļø Class Definitions:\n`;
classParsed.forEach((result, index) => {
resultText += `#### ${index + 1}. ${result.file}:${result.line}\n`;
resultText += `\`\`\`cpp\n${result.content.trim()}\n\`\`\`\n`;
resultText += `š [View source](${result.url})\n\n`;
});
}
// Function definitions
if (functionParsed.length > 0) {
resultText += `### āļø Function Definitions:\n`;
functionParsed.forEach((result, index) => {
resultText += `#### ${index + 1}. ${result.file}:${result.line}\n`;
resultText += `\`\`\`cpp\n${result.content.trim()}\n\`\`\`\n`;
resultText += `š [View source](${result.url})\n\n`;
});
}
// Usage examples
if (usageParsed.length > 0) {
resultText += `### š Usage Examples (excluding comments):\n`;
if (usageResults.estimatedResultCount) {
resultText += `*Found ${usageResults.estimatedResultCount} total usage matches across the codebase*\n\n`;
}
usageParsed.slice(0, 8).forEach((result, index) => {
resultText += `#### ${index + 1}. ${result.file}:${result.line}\n`;
resultText += `\`\`\`cpp\n${result.content.trim()}\n\`\`\`\n`;
resultText += `š [View source](${result.url})\n\n`;
});
if (usageParsed.length >= 8 && usageResults.estimatedResultCount > 8) {
resultText += `š” *Showing first 8 examples. Total usage matches: ${usageResults.estimatedResultCount}*\n\n`;
}
}
// Show if no results found
if (symbolParsed.length === 0 && classParsed.length === 0 && functionParsed.length === 0 && usageParsed.length === 0) {
resultText += `### ā No results found\n\nThis could mean:\n- The symbol doesn't exist in the current codebase\n- It might be spelled differently\n- Try searching with different capitalization or as a partial string\n\n`;
}
resultText += `### š Search URLs:\n`;
resultText += `- **Symbol:** https://source.chromium.org/search?q=${encodeURIComponent(`symbol:${symbol}`)}&ss=chromium%2Fchromium%2Fsrc\n`;
resultText += `- **Class:** https://source.chromium.org/search?q=${encodeURIComponent(`class:${symbol}`)}&ss=chromium%2Fchromium%2Fsrc\n`;
resultText += `- **Function:** https://source.chromium.org/search?q=${encodeURIComponent(`function:${symbol}`)}&ss=chromium%2Fchromium%2Fsrc\n`;
resultText += `- **Usage:** https://source.chromium.org/search?q=${encodeURIComponent(`usage:${symbol}`)}&ss=chromium%2Fchromium%2Fsrc`;
return {
content: [
{
type: "text",
text: resultText,
},
],
};
}
catch (error) {
const fallbackUrl = `https://source.chromium.org/search?q=${encodeURIComponent(symbol)}&ss=chromium%2Fchromium%2Fsrc`;
return {
content: [
{
type: "text",
text: `Symbol lookup failed: ${error.message}\n\nTry searching