@sourcebot/mcp 1.0.12 → 1.0.13

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.13] - 2026-01-27
+
+### Added
+- Added `search_commits` tool to search a repos commit history. [#625](https://github.com/sourcebot-dev/sourcebot/pull/625)
+- Added `gitRevision` parameter to the `search_code` tool to allow for searching on different branches. [#625](https://github.com/sourcebot-dev/sourcebot/pull/625)
+- Added server side pagination support for `list_commits` and `list_repos`. [#795](https://github.com/sourcebot-dev/sourcebot/pull/795)
+- Added `filterByFilepaths` and `useRegex` params to the `search_code` tool. [#795](https://github.com/sourcebot-dev/sourcebot/pull/795)
+
+### Changed
+- Renamed `search_commits` tool to `list_commits`. [#795](https://github.com/sourcebot-dev/sourcebot/pull/795)
+- Renamed `gitRevision` param to `ref` on `search_code` tool. [#795](https://github.com/sourcebot-dev/sourcebot/pull/795)
+- Generally improved tool and tool param descriptions for all tools. [#795](https://github.com/sourcebot-dev/sourcebot/pull/795)
+
 ## [1.0.12] - 2026-01-13
 
 ### Fixed

package/README.md

@@ -208,6 +208,24 @@ Fetches the source code for a given file.
 | `repoId`     | yes      | The Sourcebot repository ID.                                     |
 </details>
 
+### search_commits
+
+Searches for commits in a specific repository based on actual commit time.
+
+<details>
+<summary>Parameters</summary>
+
+| Name       | Required | Description                                                                                    |
+|:-----------|:---------|:-----------------------------------------------------------------------------------------------|
+| `repoId`   | yes      | Repository identifier: either numeric database ID (e.g., 123) or full repository name (e.g., "github.com/owner/repo") as returned by `list_repos`. |
+| `query`    | no       | Search query to filter commits by message (case-insensitive).                                  |
+| `since`    | no       | Show commits after this date (by commit time). Supports ISO 8601 or relative formats.          |
+| `until`    | no       | Show commits before this date (by commit time). Supports ISO 8601 or relative formats.         |
+| `author`   | no       | Filter by author name or email (supports partial matches).                                     |
+| `maxCount` | no       | Maximum number of commits to return (default: 50).                                             |
+
+</details>
+
 
 ## Supported Code Hosts
 Sourcebot supports the following code hosts:

package/dist/client.d.ts

@@ -1,4 +1,124 @@
-import { FileSourceRequest, FileSourceResponse, ListRepositoriesResponse, SearchRequest, SearchResponse, ServiceError } from './types.js';
-export declare const search: (request: SearchRequest) => Promise<SearchResponse | ServiceError>;
-export declare const listRepos: () => Promise<ListRepositoriesResponse | ServiceError>;
-export declare const getFileSource: (request: FileSourceRequest) => Promise<FileSourceResponse | ServiceError>;
+import { FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema } from './types.js';
+export declare const search: (request: SearchRequest) => Promise<{
+    stats: {
+        actualMatchCount: number;
+        totalMatchCount: number;
+        duration: number;
+        fileCount: number;
+        filesSkipped: number;
+        contentBytesLoaded: number;
+        indexBytesLoaded: number;
+        crashes: number;
+        shardFilesConsidered: number;
+        filesConsidered: number;
+        filesLoaded: number;
+        shardsScanned: number;
+        shardsSkipped: number;
+        shardsSkippedFilter: number;
+        ngramMatches: number;
+        ngramLookups: number;
+        wait: number;
+        matchTreeConstruction: number;
+        matchTreeSearch: number;
+        regexpsConsidered: number;
+        flushReason: string;
+    };
+    files: {
+        webUrl: string;
+        fileName: {
+            text: string;
+            matchRanges: {
+                start: {
+                    byteOffset: number;
+                    lineNumber: number;
+                    column: number;
+                };
+                end: {
+                    byteOffset: number;
+                    lineNumber: number;
+                    column: number;
+                };
+            }[];
+        };
+        repository: string;
+        repositoryId: number;
+        language: string;
+        chunks: {
+            matchRanges: {
+                start: {
+                    byteOffset: number;
+                    lineNumber: number;
+                    column: number;
+                };
+                end: {
+                    byteOffset: number;
+                    lineNumber: number;
+                    column: number;
+                };
+            }[];
+            content: string;
+            contentStart: {
+                byteOffset: number;
+                lineNumber: number;
+                column: number;
+            };
+            symbols?: {
+                symbol: string;
+                kind: string;
+                parent?: {
+                    symbol: string;
+                    kind: string;
+                } | undefined;
+            }[] | undefined;
+        }[];
+        externalWebUrl?: string | undefined;
+        content?: string | undefined;
+        branches?: string[] | undefined;
+    }[];
+    repositoryInfo: {
+        id: number;
+        codeHostType: string;
+        name: string;
+        displayName?: string | undefined;
+        webUrl?: string | undefined;
+    }[];
+    isSearchExhaustive: boolean;
+}>;
+export declare const listRepos: (queryParams?: ListReposQueryParams) => Promise<{
+    repos: {
+        codeHostType: string;
+        webUrl: string;
+        repoId: number;
+        repoName: string;
+        externalWebUrl?: string | undefined;
+        repoDisplayName?: string | undefined;
+        imageUrl?: string | undefined;
+        indexedAt?: Date | undefined;
+        pushedAt?: Date | undefined;
+    }[];
+    totalCount: number;
+}>;
+export declare const getFileSource: (request: FileSourceRequest) => Promise<{
+    path: string;
+    source: string;
+    webUrl: string;
+    language: string;
+    repo: string;
+    repoCodeHostType: string;
+    externalWebUrl?: string | undefined;
+    repoDisplayName?: string | undefined;
+    repoExternalWebUrl?: string | undefined;
+    branch?: string | undefined;
+}>;
+export declare const listCommits: (queryParams: ListCommitsQueryParamsSchema) => Promise<{
+    commits: {
+        message: string;
+        date: string;
+        hash: string;
+        refs: string;
+        body: string;
+        author_name: string;
+        author_email: string;
+    }[];
+    totalCount: number;
+}>;

package/dist/client.js

@@ -1,45 +1,85 @@
 import { env } from './env.js';
-import { listRepositoriesResponseSchema, searchResponseSchema, fileSourceResponseSchema } from './schemas.js';
-import { isServiceError } from './utils.js';
+import { listReposResponseSchema, searchResponseSchema, fileSourceResponseSchema, listCommitsResponseSchema } from './schemas.js';
+import { isServiceError, ServiceErrorException } from './utils.js';
+const parseResponse = async (response, schema) => {
+    const text = await response.text();
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Invalid JSON response: ${text}`);
+    }
+    // Check if the response is already a service error from the API
+    if (isServiceError(json)) {
+        throw new ServiceErrorException(json);
+    }
+    const parsed = schema.safeParse(json);
+    if (!parsed.success) {
+        throw new Error(`Failed to parse response: ${parsed.error.message}`);
+    }
+    return parsed.data;
+};
 export const search = async (request) => {
-    const result = await fetch(`${env.SOURCEBOT_HOST}/api/search`, {
+    const response = await fetch(`${env.SOURCEBOT_HOST}/api/search`, {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
             ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
         },
         body: JSON.stringify(request)
-    }).then(response => response.json());
-    if (isServiceError(result)) {
-        return result;
-    }
-    return searchResponseSchema.parse(result);
+    });
+    return parseResponse(response, searchResponseSchema);
 };
-export const listRepos = async () => {
-    const result = await fetch(`${env.SOURCEBOT_HOST}/api/repos`, {
+export const listRepos = async (queryParams = {}) => {
+    const url = new URL(`${env.SOURCEBOT_HOST}/api/repos`);
+    for (const [key, value] of Object.entries(queryParams)) {
+        if (value) {
+            url.searchParams.set(key, value.toString());
+        }
+    }
+    const response = await fetch(url, {
         method: 'GET',
         headers: {
             'Content-Type': 'application/json',
             ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
         },
-    }).then(response => response.json());
-    if (isServiceError(result)) {
-        return result;
-    }
-    return listRepositoriesResponseSchema.parse(result);
+    });
+    const repos = await parseResponse(response, listReposResponseSchema);
+    const totalCount = parseInt(response.headers.get('X-Total-Count') ?? '0', 10);
+    return { repos, totalCount };
 };
 export const getFileSource = async (request) => {
-    const result = await fetch(`${env.SOURCEBOT_HOST}/api/source`, {
-        method: 'POST',
+    const url = new URL(`${env.SOURCEBOT_HOST}/api/source`);
+    for (const [key, value] of Object.entries(request)) {
+        if (value) {
+            url.searchParams.set(key, value.toString());
+        }
+    }
+    const response = await fetch(url, {
+        method: 'GET',
         headers: {
-            'Content-Type': 'application/json',
             ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
         },
-        body: JSON.stringify(request)
-    }).then(response => response.json());
-    if (isServiceError(result)) {
-        return result;
+    });
+    return parseResponse(response, fileSourceResponseSchema);
+};
+export const listCommits = async (queryParams) => {
+    const url = new URL(`${env.SOURCEBOT_HOST}/api/commits`);
+    for (const [key, value] of Object.entries(queryParams)) {
+        if (value) {
+            url.searchParams.set(key, value.toString());
+        }
     }
-    return fileSourceResponseSchema.parse(result);
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: {
+            'X-Org-Domain': '~',
+            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
+        },
+    });
+    const commits = await parseResponse(response, listCommitsResponseSchema);
+    const totalCount = parseInt(response.headers.get('X-Total-Count') ?? '0', 10);
+    return { commits, totalCount };
 };
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE9G,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EAAE,OAAsB,EAA0C,EAAE;IAC3F,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,cAAc,aAAa,EAAE;QAC3D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAChC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAErC,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,IAAsD,EAAE;IAClF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,cAAc,YAAY,EAAE;QAC1D,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF;KACJ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAErC,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO,8BAA8B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,OAA0B,EAA8C,EAAE;IAC1G,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,cAAc,aAAa,EAAE;QAC3D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAChC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAErC,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC,CAAA","sourcesContent":["import { env } from './env.js';\nimport { listRepositoriesResponseSchema, searchResponseSchema, fileSourceResponseSchema } from './schemas.js';\nimport { FileSourceRequest, FileSourceResponse, ListRepositoriesResponse, SearchRequest, SearchResponse, ServiceError } from './types.js';\nimport { isServiceError } from './utils.js';\n\nexport const search = async (request: SearchRequest): Promise<SearchResponse | ServiceError> => {\n    const result = await fetch(`${env.SOURCEBOT_HOST}/api/search`, {\n        method: 'POST',\n        headers: {\n            'Content-Type': 'application/json',\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n        body: JSON.stringify(request)\n    }).then(response => response.json());\n\n    if (isServiceError(result)) {\n        return result;\n    }\n\n    return searchResponseSchema.parse(result);\n}\n\nexport const listRepos = async (): Promise<ListRepositoriesResponse | ServiceError> => {\n    const result = await fetch(`${env.SOURCEBOT_HOST}/api/repos`, {\n        method: 'GET',\n        headers: {\n            'Content-Type': 'application/json',\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n    }).then(response => response.json());\n\n    if (isServiceError(result)) {\n        return result;\n    }\n\n    return listRepositoriesResponseSchema.parse(result);\n}\n\nexport const getFileSource = async (request: FileSourceRequest): Promise<FileSourceResponse | ServiceError> => {\n    const result = await fetch(`${env.SOURCEBOT_HOST}/api/source`, {\n        method: 'POST',\n        headers: {\n            'Content-Type': 'application/json',\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n        body: JSON.stringify(request)\n    }).then(response => response.json());\n\n    if (isServiceError(result)) {\n        return result;\n    }\n\n    return fileSourceResponseSchema.parse(result);\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAElI,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,aAAa,GAAG,KAAK,EACvB,QAAkB,EAClB,MAAS,EACU,EAAE;IACrB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnC,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,gEAAgE;IAChE,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EAAE,OAAsB,EAAE,EAAE;IACnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,cAAc,aAAa,EAAE;QAC7D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAChC,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AACzD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,cAAoC,EAAE,EAAE,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,cAAc,YAAY,CAAC,CAAC;IAEvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACR,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC9B,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF;KACJ,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,OAA0B,EAAE,EAAE;IAC9D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,cAAc,aAAa,CAAC,CAAC;IACxD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,EAAE,CAAC;YACR,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC9B,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACL,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF;KACJ,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;AAC7D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,WAAyC,EAAE,EAAE;IAC3E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,cAAc,cAAc,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACR,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC9B,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACL,cAAc,EAAE,GAAG;YACnB,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF;KACJ,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACnC,CAAC,CAAA","sourcesContent":["import { env } from './env.js';\nimport { listReposResponseSchema, searchResponseSchema, fileSourceResponseSchema, listCommitsResponseSchema } from './schemas.js';\nimport { FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema } from './types.js';\nimport { isServiceError, ServiceErrorException } from './utils.js';\nimport { z } from 'zod';\n\nconst parseResponse = async <T extends z.ZodTypeAny>(\n    response: Response,\n    schema: T\n): Promise<z.infer<T>> => {\n    const text = await response.text();\n\n    let json: unknown;\n    try {\n        json = JSON.parse(text);\n    } catch {\n        throw new Error(`Invalid JSON response: ${text}`);\n    }\n\n    // Check if the response is already a service error from the API\n    if (isServiceError(json)) {\n        throw new ServiceErrorException(json);\n    }\n\n    const parsed = schema.safeParse(json);\n    if (!parsed.success) {\n        throw new Error(`Failed to parse response: ${parsed.error.message}`);\n    }\n\n    return parsed.data;\n};\n\nexport const search = async (request: SearchRequest) => {\n    const response = await fetch(`${env.SOURCEBOT_HOST}/api/search`, {\n        method: 'POST',\n        headers: {\n            'Content-Type': 'application/json',\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n        body: JSON.stringify(request)\n    });\n\n    return parseResponse(response, searchResponseSchema);\n}\n\nexport const listRepos = async (queryParams: ListReposQueryParams = {}) => {\n    const url = new URL(`${env.SOURCEBOT_HOST}/api/repos`);\n\n    for (const [key, value] of Object.entries(queryParams)) {\n        if (value) {\n            url.searchParams.set(key, value.toString());\n        }\n    }\n\n    const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n            'Content-Type': 'application/json',\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n    });\n\n    const repos = await parseResponse(response, listReposResponseSchema);\n    const totalCount = parseInt(response.headers.get('X-Total-Count') ?? '0', 10);\n    return { repos, totalCount };\n}\n\nexport const getFileSource = async (request: FileSourceRequest) => {\n    const url = new URL(`${env.SOURCEBOT_HOST}/api/source`);\n    for (const [key, value] of Object.entries(request)) {\n        if (value) {\n            url.searchParams.set(key, value.toString());\n        }\n    }\n\n    const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n    });\n\n    return parseResponse(response, fileSourceResponseSchema);\n}\n\nexport const listCommits = async (queryParams: ListCommitsQueryParamsSchema) => {\n    const url = new URL(`${env.SOURCEBOT_HOST}/api/commits`);\n    for (const [key, value] of Object.entries(queryParams)) {\n        if (value) {\n            url.searchParams.set(key, value.toString());\n        }\n    }\n\n    const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n            'X-Org-Domain': '~',\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n    });\n\n    const commits = await parseResponse(response, listCommitsResponseSchema);\n    const totalCount = parseInt(response.headers.get('X-Total-Count') ?? '0', 10);\n    return { commits, totalCount };\n}\n"]}

package/dist/index.js

@@ -2,36 +2,45 @@
 // Entry point for the MCP server
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import _dedent from "dedent";
 import escapeStringRegexp from 'escape-string-regexp';
 import { z } from 'zod';
-import { listRepos, search, getFileSource } from './client.js';
+import { getFileSource, listCommits, listRepos, search } from './client.js';
 import { env, numberSchema } from './env.js';
-import { listReposRequestSchema } from './schemas.js';
-import { isServiceError } from './utils.js';
+import { fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema } from './schemas.js';
+const dedent = _dedent.withOptions({ alignValues: true });
 // Create MCP server
 const server = new McpServer({
     name: 'sourcebot-mcp-server',
     version: '0.1.0',
 });
-server.tool("search_code", `Fetches code that matches the provided regex pattern in \`query\`. This is NOT a semantic search.
-    Results are returned as an array of matching files, with the file's URL, repository, and language.
-    If you receive an error that indicates that you're not authenticated, please inform the user to set the SOURCEBOT_API_KEY environment variable.
-    If the \`includeCodeSnippets\` property is true, code snippets containing the matches will be included in the response. Only set this to true if the request requires code snippets (e.g., show me examples where library X is used).
-    When referencing a file in your response, **ALWAYS** include the file's external URL as a link. This makes it easier for the user to view the file, even if they don't have it locally checked out.
-    **ONLY USE** the \`filterByRepoIds\` property if the request requires searching a specific repo(s). Otherwise, leave it empty.`, {
+server.tool("search_code", dedent `
+    Searches for code that matches the provided search query as a substring by default, or as a regular expression if useRegex is true. Useful for exploring remote repositories by searching for exact symbols, functions, variables, or specific code patterns. To determine if a repository is indexed, use the \`list_repos\` tool. By default, searches are global and will search the default branch of all repositories. Searches can be scoped to specific repositories, languages, and branches. When referencing code outputted by this tool, always include the file's external URL as a link. This makes it easier for the user to view the file, even if they don't have it locally checked out.
+    `, {
     query: z
         .string()
-        .describe(`The regex pattern to search for. RULES:
-        1. When a regex special character needs to be escaped, ALWAYS use a single backslash (\) (e.g., 'console\.log')
-        2. **ALWAYS** escape spaces with a single backslash (\) (e.g., 'console\ log')
-        `),
-    filterByRepoIds: z
+        .describe(`The search pattern to match against code contents. Do not escape quotes in your query.`)
+        // Escape backslashes first, then quotes, and wrap in double quotes
+        // so the query is treated as a literal phrase (like grep).
+        .transform((val) => {
+        const escaped = val.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        return `"${escaped}"`;
+    }),
+    useRegex: z
+        .boolean()
+        .describe(`Whether to use regular expression matching to match the search query against code contents. When false, substring matching is used. (default: false)`)
+        .optional(),
+    filterByRepos: z
         .array(z.string())
-        .describe(`Scope the search to the provided repositories to the Sourcebot compatible repository IDs. **DO NOT** use this property if you want to search all repositories. **YOU MUST** call 'list_repos' first to obtain the exact repository ID.`)
+        .describe(`Scope the search to the provided repositories.`)
         .optional(),
     filterByLanguages: z
         .array(z.string())
-        .describe(`Scope the search to the provided languages. The language MUST be formatted as a GitHub linguist language. Examples: Python, JavaScript, TypeScript, Java, C#, C++, PHP, Go, Rust, Ruby, Swift, Kotlin, Shell, C, Dart, HTML, CSS, PowerShell, SQL, R`)
+        .describe(`Scope the search to the provided languages.`)
+        .optional(),
+    filterByFilepaths: z
+        .array(z.string())
+        .describe(`Scope the search to the provided filepaths.`)
         .optional(),
     caseSensitive: z
         .boolean()
@@ -39,35 +48,37 @@ server.tool("search_code", `Fetches code that matches the provided regex pattern
         .optional(),
     includeCodeSnippets: z
         .boolean()
-        .describe(`Whether to include the code snippets in the response (default: false). If false, only the file's URL, repository, and language will be returned. Set to false to get a more concise response.`)
+        .describe(`Whether to include the code snippets in the response. If false, only the file's URL, repository, and language will be returned. (default: false)`)
+        .optional(),
+    ref: z
+        .string()
+        .describe(`Commit SHA, branch or tag name to search on. If not provided, defaults to the default branch (usually 'main' or 'master').`)
         .optional(),
     maxTokens: numberSchema
         .describe(`The maximum number of tokens to return (default: ${env.DEFAULT_MINIMUM_TOKENS}). Higher values provide more context but consume more tokens. Values less than ${env.DEFAULT_MINIMUM_TOKENS} will be ignored.`)
         .transform((val) => (val < env.DEFAULT_MINIMUM_TOKENS ? env.DEFAULT_MINIMUM_TOKENS : val))
         .optional(),
-}, async ({ query, filterByRepoIds: repoIds = [], filterByLanguages: languages = [], maxTokens = env.DEFAULT_MINIMUM_TOKENS, includeCodeSnippets = false, caseSensitive = false, }) => {
-    if (repoIds.length > 0) {
-        query += ` ( repo:${repoIds.map(id => escapeStringRegexp(id)).join(' or repo:')} )`;
+}, async ({ query, filterByRepos: repos = [], filterByLanguages: languages = [], filterByFilepaths: filepaths = [], maxTokens = env.DEFAULT_MINIMUM_TOKENS, includeCodeSnippets = false, caseSensitive = false, ref, useRegex = false, }) => {
+    if (repos.length > 0) {
+        query += ` (repo:${repos.map(id => escapeStringRegexp(id)).join(' or repo:')})`;
     }
     if (languages.length > 0) {
-        query += ` ( lang:${languages.join(' or lang:')} )`;
+        query += ` (lang:${languages.join(' or lang:')})`;
+    }
+    if (filepaths.length > 0) {
+        query += ` (file:${filepaths.map(filepath => escapeStringRegexp(filepath)).join(' or file:')})`;
+    }
+    if (ref) {
+        query += ` ( rev:${ref} )`;
     }
     const response = await search({
         query,
         matches: env.DEFAULT_MATCHES,
         contextLines: env.DEFAULT_CONTEXT_LINES,
-        isRegexEnabled: true,
+        isRegexEnabled: useRegex,
         isCaseSensitivityEnabled: caseSensitive,
-        source: 'mcp'
+        source: 'mcp',
     });
-    if (isServiceError(response)) {
-        return {
-            content: [{
-                    type: "text",
-                    text: `Error searching code: ${response.message}`,
-                }],
-        };
-    }
     if (response.files.length === 0) {
         return {
             content: [{
@@ -81,8 +92,12 @@ server.tool("search_code", `Fetches code that matches the provided regex pattern
     let isResponseTruncated = false;
     for (const file of response.files) {
         const numMatches = file.chunks.reduce((acc, chunk) => acc + chunk.matchRanges.length, 0);
-        const fileIdentifier = file.webUrl ?? file.fileName.text;
-        let text = `file: ${fileIdentifier}\nnum_matches: ${numMatches}\nrepository: ${file.repository}\nlanguage: ${file.language}`;
+        let text = dedent `
+            file: ${file.webUrl}
+            num_matches: ${numMatches}
+            repo: ${file.repository}
+            language: ${file.language}
+            `;
         if (includeCodeSnippets) {
             const snippets = file.chunks.map(chunk => {
                 return `\`\`\`\n${chunk.content}\n\`\`\``;
@@ -124,76 +139,40 @@ server.tool("search_code", `Fetches code that matches the provided regex pattern
         content,
     };
 });
-server.tool("list_repos", "Lists repositories in the organization with optional filtering and pagination. If you receive an error that indicates that you're not authenticated, please inform the user to set the SOURCEBOT_API_KEY environment variable.", listReposRequestSchema.shape, async ({ query, pageNumber = 1, limit = 50 }) => {
-    const response = await listRepos();
-    if (isServiceError(response)) {
-        return {
-            content: [{
-                    type: "text",
-                    text: `Error listing repositories: ${response.message}`,
-                }],
-        };
-    }
-    // Apply query filter if provided
-    let filtered = response;
-    if (query) {
-        const lowerQuery = query.toLowerCase();
-        filtered = response.filter(repo => repo.repoName.toLowerCase().includes(lowerQuery) ||
-            repo.repoDisplayName?.toLowerCase().includes(lowerQuery));
-    }
-    // Sort alphabetically for consistent pagination
-    filtered.sort((a, b) => a.repoName.localeCompare(b.repoName));
-    // Apply pagination
-    const startIndex = (pageNumber - 1) * limit;
-    const endIndex = startIndex + limit;
-    const paginated = filtered.slice(startIndex, endIndex);
-    // Format output
-    const content = paginated.map(repo => {
-        const repoUrl = repo.webUrl ?? repo.repoCloneUrl;
-        return {
-            type: "text",
-            text: `id: ${repo.repoName}\nurl: ${repoUrl}`,
-        };
-    });
-    // Add pagination info
-    if (content.length === 0 && filtered.length > 0) {
-        content.push({
-            type: "text",
-            text: `No results on page ${pageNumber}. Total matching repositories: ${filtered.length}`,
-        });
-    }
-    else if (filtered.length > endIndex) {
-        content.push({
-            type: "text",
-            text: `Showing ${paginated.length} repositories (page ${pageNumber}). Total matching: ${filtered.length}. Use pageNumber ${pageNumber + 1} to see more.`,
-        });
-    }
+server.tool("list_commits", dedent `Get a list of commits for a given repository.`, listCommitsQueryParamsSchema.shape, async (request) => {
+    const result = await listCommits(request);
     return {
-        content,
+        content: [{
+                type: "text", text: JSON.stringify(result)
+            }],
     };
 });
-server.tool("get_file_source", "Fetches the source code for a given file. If you receive an error that indicates that you're not authenticated, please inform the user to set the SOURCEBOT_API_KEY environment variable.", {
-    fileName: z.string().describe("The file to fetch the source code for."),
-    repoId: z.string().describe("The repository to fetch the source code for. This is the Sourcebot compatible repository ID."),
-}, async ({ fileName, repoId }) => {
-    const response = await getFileSource({
-        fileName,
-        repository: repoId,
-    });
-    if (isServiceError(response)) {
-        return {
-            content: [{
-                    type: "text",
-                    text: `Error fetching file source: ${response.message}`,
-                }],
-        };
-    }
-    const content = [{
-            type: "text",
-            text: `file: ${fileName}\nrepository: ${repoId}\nlanguage: ${response.language}\nsource:\n${response.source}`,
-        }];
+server.tool("list_repos", dedent `Lists repositories in the organization with optional filtering and pagination.`, listReposQueryParamsSchema.shape, async (request) => {
+    const result = await listRepos(request);
     return {
-        content,
+        content: [{
+                type: "text", text: JSON.stringify({
+                    repos: result.repos.map((repo) => ({
+                        name: repo.repoName,
+                        url: repo.webUrl,
+                        pushedAt: repo.pushedAt,
+                    })),
+                    totalCount: result.totalCount,
+                })
+            }]
+    };
+});
+server.tool("read_file", dedent `Reads the source code for a given file.`, fileSourceRequestSchema.shape, async (request) => {
+    const response = await getFileSource(request);
+    return {
+        content: [{
+                type: "text", text: JSON.stringify({
+                    source: response.source,
+                    language: response.language,
+                    path: response.path,
+                    url: response.webUrl,
+                })
+            }]
     };
 });
 const runServer = async () => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\n// Entry point for the MCP server\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport escapeStringRegexp from 'escape-string-regexp';\nimport { z } from 'zod';\nimport { listRepos, search, getFileSource } from './client.js';\nimport { env, numberSchema } from './env.js';\nimport { listReposRequestSchema } from './schemas.js';\nimport { TextContent } from './types.js';\nimport { isServiceError } from './utils.js';\n\n// Create MCP server\nconst server = new McpServer({\n    name: 'sourcebot-mcp-server',\n    version: '0.1.0',\n});\n\n\nserver.tool(\n    \"search_code\",\n    `Fetches code that matches the provided regex pattern in \\`query\\`. This is NOT a semantic search.\n    Results are returned as an array of matching files, with the file's URL, repository, and language.\n    If you receive an error that indicates that you're not authenticated, please inform the user to set the SOURCEBOT_API_KEY environment variable.\n    If the \\`includeCodeSnippets\\` property is true, code snippets containing the matches will be included in the response. Only set this to true if the request requires code snippets (e.g., show me examples where library X is used).\n    When referencing a file in your response, **ALWAYS** include the file's external URL as a link. This makes it easier for the user to view the file, even if they don't have it locally checked out.\n    **ONLY USE** the \\`filterByRepoIds\\` property if the request requires searching a specific repo(s). Otherwise, leave it empty.`,\n    {\n        query: z\n            .string()\n            .describe(`The regex pattern to search for. RULES:\n        1. When a regex special character needs to be escaped, ALWAYS use a single backslash (\\) (e.g., 'console\\.log')\n        2. **ALWAYS** escape spaces with a single backslash (\\) (e.g., 'console\\ log')\n        `),\n        filterByRepoIds: z\n            .array(z.string())\n            .describe(`Scope the search to the provided repositories to the Sourcebot compatible repository IDs. **DO NOT** use this property if you want to search all repositories. **YOU MUST** call 'list_repos' first to obtain the exact repository ID.`)\n            .optional(),\n        filterByLanguages: z\n            .array(z.string())\n            .describe(`Scope the search to the provided languages. The language MUST be formatted as a GitHub linguist language. Examples: Python, JavaScript, TypeScript, Java, C#, C++, PHP, Go, Rust, Ruby, Swift, Kotlin, Shell, C, Dart, HTML, CSS, PowerShell, SQL, R`)\n            .optional(),\n        caseSensitive: z\n            .boolean()\n            .describe(`Whether the search should be case sensitive (default: false).`)\n            .optional(),\n        includeCodeSnippets: z\n            .boolean()\n            .describe(`Whether to include the code snippets in the response (default: false). If false, only the file's URL, repository, and language will be returned. Set to false to get a more concise response.`)\n            .optional(),\n        maxTokens: numberSchema\n            .describe(`The maximum number of tokens to return (default: ${env.DEFAULT_MINIMUM_TOKENS}). Higher values provide more context but consume more tokens. Values less than ${env.DEFAULT_MINIMUM_TOKENS} will be ignored.`)\n            .transform((val) => (val < env.DEFAULT_MINIMUM_TOKENS ? env.DEFAULT_MINIMUM_TOKENS : val))\n            .optional(),\n    },\n    async ({\n        query,\n        filterByRepoIds: repoIds = [],\n        filterByLanguages: languages = [],\n        maxTokens = env.DEFAULT_MINIMUM_TOKENS,\n        includeCodeSnippets = false,\n        caseSensitive = false,\n    }) => {\n        if (repoIds.length > 0) {\n            query += ` ( repo:${repoIds.map(id => escapeStringRegexp(id)).join(' or repo:')} )`;\n        }\n\n        if (languages.length > 0) {\n            query += ` ( lang:${languages.join(' or lang:')} )`;\n        }\n\n        const response = await search({\n            query,\n            matches: env.DEFAULT_MATCHES,\n            contextLines: env.DEFAULT_CONTEXT_LINES,\n            isRegexEnabled: true,\n            isCaseSensitivityEnabled: caseSensitive,\n            source: 'mcp'\n        });\n\n        if (isServiceError(response)) {\n            return {\n                content: [{\n                    type: \"text\",\n                    text: `Error searching code: ${response.message}`,\n                }],\n            };\n        }\n\n        if (response.files.length === 0) {\n            return {\n                content: [{\n                    type: \"text\",\n                    text: `No results found for the query: ${query}`,\n                }],\n            };\n        }\n\n        const content: TextContent[] = [];\n        let totalTokens = 0;\n        let isResponseTruncated = false;\n\n        for (const file of response.files) {\n            const numMatches = file.chunks.reduce(\n                (acc, chunk) => acc + chunk.matchRanges.length,\n                0,\n            );\n            const fileIdentifier = file.webUrl ?? file.fileName.text;\n            let text = `file: ${fileIdentifier}\\nnum_matches: ${numMatches}\\nrepository: ${file.repository}\\nlanguage: ${file.language}`;\n\n            if (includeCodeSnippets) {\n                const snippets = file.chunks.map(chunk => {\n                    return `\\`\\`\\`\\n${chunk.content}\\n\\`\\`\\``\n                }).join('\\n');\n                text += `\\n\\n${snippets}`;\n            }\n\n\n            // Rough estimate of the number of tokens in the text\n            // @see: https://help.openai.com/en/articles/4936856-what-are-tokens-and-how-to-count-them\n            const tokens = text.length / 4;\n\n            if ((totalTokens + tokens) > maxTokens) {\n                // Calculate remaining token budget\n                const remainingTokens = maxTokens - totalTokens;\n\n                if (remainingTokens > 100) {  // Only truncate if meaningful space left\n                    // Truncate text to fit remaining tokens (tokens ≈ chars/4)\n                    const maxLength = Math.floor(remainingTokens * 4);\n                    const truncatedText = text.substring(0, maxLength) + \"\\n\\n...[content truncated due to token limit]\";\n\n                    content.push({\n                        type: \"text\",\n                        text: truncatedText,\n                    });\n\n                    totalTokens += remainingTokens;\n                }\n\n                isResponseTruncated = true;\n                break;\n            }\n\n            totalTokens += tokens;\n            content.push({\n                type: \"text\",\n                text,\n            });\n        }\n\n        if (isResponseTruncated) {\n            content.push({\n                type: \"text\",\n                text: `The response was truncated because the number of tokens exceeded the maximum limit of ${maxTokens}.`,\n            });\n        }\n\n        return {\n            content,\n        }\n    }\n);\n\nserver.tool(\n    \"list_repos\",\n    \"Lists repositories in the organization with optional filtering and pagination. If you receive an error that indicates that you're not authenticated, please inform the user to set the SOURCEBOT_API_KEY environment variable.\",\n    listReposRequestSchema.shape,\n    async ({ query, pageNumber = 1, limit = 50 }: {\n        query?: string;\n        pageNumber?: number;\n        limit?: number;\n    }) => {\n        const response = await listRepos();\n        if (isServiceError(response)) {\n            return {\n                content: [{\n                    type: \"text\",\n                    text: `Error listing repositories: ${response.message}`,\n                }],\n            };\n        }\n\n        // Apply query filter if provided\n        let filtered = response;\n        if (query) {\n            const lowerQuery = query.toLowerCase();\n            filtered = response.filter(repo =>\n                repo.repoName.toLowerCase().includes(lowerQuery) ||\n                repo.repoDisplayName?.toLowerCase().includes(lowerQuery)\n            );\n        }\n\n        // Sort alphabetically for consistent pagination\n        filtered.sort((a, b) => a.repoName.localeCompare(b.repoName));\n\n        // Apply pagination\n        const startIndex = (pageNumber - 1) * limit;\n        const endIndex = startIndex + limit;\n        const paginated = filtered.slice(startIndex, endIndex);\n\n        // Format output\n        const content: TextContent[] = paginated.map(repo => {\n            const repoUrl = repo.webUrl ?? repo.repoCloneUrl;\n            return {\n                type: \"text\",\n                text: `id: ${repo.repoName}\\nurl: ${repoUrl}`,\n            }\n        });\n\n        // Add pagination info\n        if (content.length === 0 && filtered.length > 0) {\n            content.push({\n                type: \"text\",\n                text: `No results on page ${pageNumber}. Total matching repositories: ${filtered.length}`,\n            });\n        } else if (filtered.length > endIndex) {\n            content.push({\n                type: \"text\",\n                text: `Showing ${paginated.length} repositories (page ${pageNumber}). Total matching: ${filtered.length}. Use pageNumber ${pageNumber + 1} to see more.`,\n            });\n        }\n\n        return {\n            content,\n        };\n    }\n);\n\nserver.tool(\n    \"get_file_source\",\n    \"Fetches the source code for a given file. If you receive an error that indicates that you're not authenticated, please inform the user to set the SOURCEBOT_API_KEY environment variable.\",\n    {\n        fileName: z.string().describe(\"The file to fetch the source code for.\"),\n        repoId: z.string().describe(\"The repository to fetch the source code for. This is the Sourcebot compatible repository ID.\"),\n    },\n    async ({ fileName, repoId }) => {\n        const response = await getFileSource({\n            fileName,\n            repository: repoId,\n        });\n\n        if (isServiceError(response)) {\n            return {\n                content: [{\n                    type: \"text\",\n                    text: `Error fetching file source: ${response.message}`,\n                }],\n            };\n        }\n\n        const content: TextContent[] = [{\n            type: \"text\",\n            text: `file: ${fileName}\\nrepository: ${repoId}\\nlanguage: ${response.language}\\nsource:\\n${response.source}`,\n        }]\n\n        return {\n            content,\n        };\n    }\n);\n\n\n\nconst runServer = async () => {\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n}\n\nrunServer().catch((error) => {\n    console.error('Failed to start MCP server:', error);\n    process.exit(1);\n});\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\n// Entry point for the MCP server\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport _dedent from \"dedent\";\nimport escapeStringRegexp from 'escape-string-regexp';\nimport { z } from 'zod';\nimport { getFileSource, listCommits, listRepos, search } from './client.js';\nimport { env, numberSchema } from './env.js';\nimport { fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema } from './schemas.js';\nimport { FileSourceRequest, ListCommitsQueryParamsSchema, ListReposQueryParams, TextContent } from './types.js';\n\nconst dedent = _dedent.withOptions({ alignValues: true });\n\n// Create MCP server\nconst server = new McpServer({\n    name: 'sourcebot-mcp-server',\n    version: '0.1.0',\n});\n\n\nserver.tool(\n    \"search_code\",\n    dedent`\n    Searches for code that matches the provided search query as a substring by default, or as a regular expression if useRegex is true. Useful for exploring remote repositories by searching for exact symbols, functions, variables, or specific code patterns. To determine if a repository is indexed, use the \\`list_repos\\` tool. By default, searches are global and will search the default branch of all repositories. Searches can be scoped to specific repositories, languages, and branches. When referencing code outputted by this tool, always include the file's external URL as a link. This makes it easier for the user to view the file, even if they don't have it locally checked out.\n    `,\n    {\n        query: z\n            .string()\n            .describe(`The search pattern to match against code contents. Do not escape quotes in your query.`)\n            // Escape backslashes first, then quotes, and wrap in double quotes\n            // so the query is treated as a literal phrase (like grep).\n            .transform((val) => {\n                const escaped = val.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n                return `\"${escaped}\"`;\n            }),\n        useRegex: z\n            .boolean()\n            .describe(`Whether to use regular expression matching to match the search query against code contents. When false, substring matching is used. (default: false)`)\n            .optional(),\n        filterByRepos: z\n            .array(z.string())\n            .describe(`Scope the search to the provided repositories.`)\n            .optional(),\n        filterByLanguages: z\n            .array(z.string())\n            .describe(`Scope the search to the provided languages.`)\n            .optional(),\n        filterByFilepaths: z\n            .array(z.string())\n            .describe(`Scope the search to the provided filepaths.`)\n            .optional(),\n        caseSensitive: z\n            .boolean()\n            .describe(`Whether the search should be case sensitive (default: false).`)\n            .optional(),\n        includeCodeSnippets: z\n            .boolean()\n            .describe(`Whether to include the code snippets in the response. If false, only the file's URL, repository, and language will be returned. (default: false)`)\n            .optional(),\n        ref: z\n            .string()\n            .describe(`Commit SHA, branch or tag name to search on. If not provided, defaults to the default branch (usually 'main' or 'master').`)\n            .optional(),\n        maxTokens: numberSchema\n            .describe(`The maximum number of tokens to return (default: ${env.DEFAULT_MINIMUM_TOKENS}). Higher values provide more context but consume more tokens. Values less than ${env.DEFAULT_MINIMUM_TOKENS} will be ignored.`)\n            .transform((val) => (val < env.DEFAULT_MINIMUM_TOKENS ? env.DEFAULT_MINIMUM_TOKENS : val))\n            .optional(),\n    },\n    async ({\n        query,\n        filterByRepos: repos = [],\n        filterByLanguages: languages = [],\n        filterByFilepaths: filepaths = [],\n        maxTokens = env.DEFAULT_MINIMUM_TOKENS,\n        includeCodeSnippets = false,\n        caseSensitive = false,\n        ref,\n        useRegex = false,\n    }) => {\n        if (repos.length > 0) {\n            query += ` (repo:${repos.map(id => escapeStringRegexp(id)).join(' or repo:')})`;\n        }\n\n        if (languages.length > 0) {\n            query += ` (lang:${languages.join(' or lang:')})`;\n        }\n\n        if (filepaths.length > 0) {\n            query += ` (file:${filepaths.map(filepath => escapeStringRegexp(filepath)).join(' or file:')})`;\n        }\n\n        if (ref) {\n            query += ` ( rev:${ref} )`;\n        }\n\n        const response = await search({\n            query,\n            matches: env.DEFAULT_MATCHES,\n            contextLines: env.DEFAULT_CONTEXT_LINES,\n            isRegexEnabled: useRegex,\n            isCaseSensitivityEnabled: caseSensitive,\n            source: 'mcp',\n        });\n\n        if (response.files.length === 0) {\n            return {\n                content: [{\n                    type: \"text\",\n                    text: `No results found for the query: ${query}`,\n                }],\n            };\n        }\n\n        const content: TextContent[] = [];\n        let totalTokens = 0;\n        let isResponseTruncated = false;\n\n        for (const file of response.files) {\n            const numMatches = file.chunks.reduce(\n                (acc, chunk) => acc + chunk.matchRanges.length,\n                0,\n            );\n            let text = dedent`\n            file: ${file.webUrl}\n            num_matches: ${numMatches}\n            repo: ${file.repository}\n            language: ${file.language}\n            `;\n\n            if (includeCodeSnippets) {\n                const snippets = file.chunks.map(chunk => {\n                    return `\\`\\`\\`\\n${chunk.content}\\n\\`\\`\\``\n                }).join('\\n');\n                text += `\\n\\n${snippets}`;\n            }\n\n\n            // Rough estimate of the number of tokens in the text\n            // @see: https://help.openai.com/en/articles/4936856-what-are-tokens-and-how-to-count-them\n            const tokens = text.length / 4;\n\n            if ((totalTokens + tokens) > maxTokens) {\n                // Calculate remaining token budget\n                const remainingTokens = maxTokens - totalTokens;\n\n                if (remainingTokens > 100) {  // Only truncate if meaningful space left\n                    // Truncate text to fit remaining tokens (tokens ≈ chars/4)\n                    const maxLength = Math.floor(remainingTokens * 4);\n                    const truncatedText = text.substring(0, maxLength) + \"\\n\\n...[content truncated due to token limit]\";\n\n                    content.push({\n                        type: \"text\",\n                        text: truncatedText,\n                    });\n\n                    totalTokens += remainingTokens;\n                }\n\n                isResponseTruncated = true;\n                break;\n            }\n\n            totalTokens += tokens;\n            content.push({\n                type: \"text\",\n                text,\n            });\n        }\n\n        if (isResponseTruncated) {\n            content.push({\n                type: \"text\",\n                text: `The response was truncated because the number of tokens exceeded the maximum limit of ${maxTokens}.`,\n            });\n        }\n\n        return {\n            content,\n        }\n    }\n);\n\nserver.tool(\n    \"list_commits\",\n    dedent`Get a list of commits for a given repository.`,\n    listCommitsQueryParamsSchema.shape,\n    async (request: ListCommitsQueryParamsSchema) => {\n        const result = await listCommits(request);\n\n        return {\n            content: [{\n                type: \"text\", text: JSON.stringify(result)\n            }],\n        };\n    }\n);\n\nserver.tool(\n    \"list_repos\",\n    dedent`Lists repositories in the organization with optional filtering and pagination.`,\n    listReposQueryParamsSchema.shape,\n    async (request: ListReposQueryParams) => {\n        const result = await listRepos(request);\n\n        return {\n            content: [{\n                type: \"text\", text: JSON.stringify({\n                    repos: result.repos.map((repo) => ({\n                        name: repo.repoName,\n                        url: repo.webUrl,\n                        pushedAt: repo.pushedAt,\n                    })),\n                    totalCount: result.totalCount,\n                })\n            }]\n        };\n    }\n);\n\nserver.tool(\n    \"read_file\",\n    dedent`Reads the source code for a given file.`,\n    fileSourceRequestSchema.shape,\n    async (request: FileSourceRequest) => {\n        const response = await getFileSource(request);\n\n        return {\n            content: [{\n                type: \"text\", text: JSON.stringify({\n                    source: response.source,\n                    language: response.language,\n                    path: response.path,\n                    url: response.webUrl,\n                })\n            }]\n        };\n    }\n);\n\n\n\nconst runServer = async () => {\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n}\n\nrunServer().catch((error) => {\n    console.error('Failed to start MCP server:', error);\n    process.exit(1);\n});\n"]}