@sourcebot/mcp 1.0.14 → 1.0.15

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.15] - 2026-02-02
+
+### Added
+- Added `ask_codebase` tool that can invoke the Ask subagent to explore a set of codebases and return a summarized answer. [#814](https://github.com/sourcebot-dev/sourcebot/pull/814)
+- Added `list_language_models` tool to discover available language models configured on the Sourcebot instance. [#814](https://github.com/sourcebot-dev/sourcebot/pull/814)
+
 ## [1.0.14] - 2026-01-27
 
 ### Changed

package/README.md

@@ -234,6 +234,32 @@ Get a list of commits for a given repository.
 
 </details>
 
+### list_language_models
+
+Lists the available language models configured on the Sourcebot instance. Use this to discover which models can be specified when calling `ask_codebase`.
+
+<details>
+<summary>Parameters</summary>
+
+This tool takes no parameters.
+
+</details>
+
+### ask_codebase
+
+Ask a natural language question about the codebase. This tool uses an AI agent to autonomously search code, read files, and find symbol references/definitions to answer your question. Returns a detailed answer in markdown format with code references, plus a link to view the full research session in the Sourcebot web UI.
+
+<details>
+<summary>Parameters</summary>
+
+| Name            | Required | Description                                                                                                                                    |
+|:----------------|:---------|:-----------------------------------------------------------------------------------------------------------------------------------------------|
+| `query`         | yes      | The query to ask about the codebase.                                                                                                           |
+| `repos`         | no       | The repositories that are accessible to the agent during the chat. If not provided, all repositories are accessible.                           |
+| `languageModel` | no       | The language model to use for answering the question. Object with `provider` and `model`. If not provided, defaults to the first model in the config. Use `list_language_models` to see available options. |
+
+</details>
+
 
 ## Supported Code Hosts
 Sourcebot supports the following code hosts:

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema } from './types.js';
+import { AskCodebaseRequest, AskCodebaseResponse, FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema, ListLanguageModelsResponse } from './types.js';
 export declare const search: (request: SearchRequest) => Promise<{
     stats: {
         actualMatchCount: number;
@@ -100,15 +100,14 @@ export declare const listRepos: (queryParams?: ListReposQueryParams) => Promise<
 }>;
 export declare const getFileSource: (request: FileSourceRequest) => Promise<{
     path: string;
-    source: string;
     webUrl: string;
     language: string;
     repo: string;
+    source: string;
     repoCodeHostType: string;
     externalWebUrl?: string | undefined;
     repoDisplayName?: string | undefined;
     repoExternalWebUrl?: string | undefined;
-    branch?: string | undefined;
 }>;
 export declare const listCommits: (queryParams: ListCommitsQueryParamsSchema) => Promise<{
     commits: {
@@ -122,3 +121,17 @@ export declare const listCommits: (queryParams: ListCommitsQueryParamsSchema) =>
     }[];
     totalCount: number;
 }>;
+/**
+ * Asks a natural language question about the codebase using the Sourcebot AI agent.
+ * This is a blocking call that runs the full agent loop and returns when complete.
+ *
+ * @param request - The question and optional repo filters
+ * @returns The agent's answer, chat URL, sources, and metadata
+ */
+export declare const askCodebase: (request: AskCodebaseRequest) => Promise<AskCodebaseResponse>;
+/**
+ * Lists the available language models configured on the Sourcebot instance.
+ *
+ * @returns Array of language model info objects
+ */
+export declare const listLanguageModels: () => Promise<ListLanguageModelsResponse>;

package/dist/client.js

@@ -1,5 +1,5 @@
 import { env } from './env.js';
-import { listReposResponseSchema, searchResponseSchema, fileSourceResponseSchema, listCommitsResponseSchema } from './schemas.js';
+import { listReposResponseSchema, searchResponseSchema, fileSourceResponseSchema, listCommitsResponseSchema, askCodebaseResponseSchema, listLanguageModelsResponseSchema } from './schemas.js';
 import { isServiceError, ServiceErrorException } from './utils.js';
 const parseResponse = async (response, schema) => {
     const text = await response.text();
@@ -25,6 +25,7 @@ export const search = async (request) => {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
+            'X-Sourcebot-Client-Source': 'mcp',
             ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
         },
         body: JSON.stringify(request)
@@ -42,6 +43,7 @@ export const listRepos = async (queryParams = {}) => {
         method: 'GET',
         headers: {
             'Content-Type': 'application/json',
+            'X-Sourcebot-Client-Source': 'mcp',
             ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
         },
     });
@@ -59,6 +61,7 @@ export const getFileSource = async (request) => {
     const response = await fetch(url, {
         method: 'GET',
         headers: {
+            'X-Sourcebot-Client-Source': 'mcp',
             ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
         },
     });
@@ -75,6 +78,7 @@ export const listCommits = async (queryParams) => {
         method: 'GET',
         headers: {
             'X-Org-Domain': '~',
+            'X-Sourcebot-Client-Source': 'mcp',
             ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
         },
     });
@@ -82,4 +86,39 @@ export const listCommits = async (queryParams) => {
     const totalCount = parseInt(response.headers.get('X-Total-Count') ?? '0', 10);
     return { commits, totalCount };
 };
+/**
+ * Asks a natural language question about the codebase using the Sourcebot AI agent.
+ * This is a blocking call that runs the full agent loop and returns when complete.
+ *
+ * @param request - The question and optional repo filters
+ * @returns The agent's answer, chat URL, sources, and metadata
+ */
+export const askCodebase = async (request) => {
+    const response = await fetch(`${env.SOURCEBOT_HOST}/api/chat/blocking`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Sourcebot-Client-Source': 'mcp',
+            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
+        },
+        body: JSON.stringify(request),
+    });
+    return parseResponse(response, askCodebaseResponseSchema);
+};
+/**
+ * Lists the available language models configured on the Sourcebot instance.
+ *
+ * @returns Array of language model info objects
+ */
+export const listLanguageModels = async () => {
+    const response = await fetch(`${env.SOURCEBOT_HOST}/api/models`, {
+        method: 'GET',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Sourcebot-Client-Source': 'mcp',
+            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})
+        },
+    });
+    return parseResponse(response, listLanguageModelsResponseSchema);
+};
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","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"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { env } from './env.js';\nimport { listReposResponseSchema, searchResponseSchema, fileSourceResponseSchema, listCommitsResponseSchema, askCodebaseResponseSchema, listLanguageModelsResponseSchema } from './schemas.js';\nimport { AskCodebaseRequest, AskCodebaseResponse, FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema, ListLanguageModelsResponse } 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            'X-Sourcebot-Client-Source': 'mcp',\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            'X-Sourcebot-Client-Source': 'mcp',\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            'X-Sourcebot-Client-Source': 'mcp',\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            'X-Sourcebot-Client-Source': 'mcp',\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\n/**\n * Asks a natural language question about the codebase using the Sourcebot AI agent.\n * This is a blocking call that runs the full agent loop and returns when complete.\n *\n * @param request - The question and optional repo filters\n * @returns The agent's answer, chat URL, sources, and metadata\n */\nexport const askCodebase = async (request: AskCodebaseRequest): Promise<AskCodebaseResponse> => {\n    const response = await fetch(`${env.SOURCEBOT_HOST}/api/chat/blocking`, {\n        method: 'POST',\n        headers: {\n            'Content-Type': 'application/json',\n            'X-Sourcebot-Client-Source': 'mcp',\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, askCodebaseResponseSchema);\n}\n\n/**\n * Lists the available language models configured on the Sourcebot instance.\n *\n * @returns Array of language model info objects\n */\nexport const listLanguageModels = async (): Promise<ListLanguageModelsResponse> => {\n    const response = await fetch(`${env.SOURCEBOT_HOST}/api/models`, {\n        method: 'GET',\n        headers: {\n            'Content-Type': 'application/json',\n            'X-Sourcebot-Client-Source': 'mcp',\n            ...(env.SOURCEBOT_API_KEY ? { 'X-Sourcebot-Api-Key': env.SOURCEBOT_API_KEY } : {})\n        },\n    });\n\n    return parseResponse(response, listLanguageModelsResponseSchema);\n}\n"]}

package/dist/index.js

@@ -5,9 +5,9 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import _dedent from "dedent";
 import escapeStringRegexp from 'escape-string-regexp';
 import { z } from 'zod';
-import { getFileSource, listCommits, listRepos, search } from './client.js';
+import { askCodebase, getFileSource, listCommits, listLanguageModels, listRepos, search } from './client.js';
 import { env, numberSchema } from './env.js';
-import { fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema } from './schemas.js';
+import { askCodebaseRequestSchema, fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema } from './schemas.js';
 const dedent = _dedent.withOptions({ alignValues: true });
 // Create MCP server
 const server = new McpServer({
@@ -77,7 +77,6 @@ server.tool("search_code", dedent `
         contextLines: env.DEFAULT_CONTEXT_LINES,
         isRegexEnabled: useRegex,
         isCaseSensitivityEnabled: caseSensitive,
-        source: 'mcp',
     });
     if (response.files.length === 0) {
         return {
@@ -175,6 +174,43 @@ server.tool("read_file", dedent `Reads the source code for a given file.`, fileS
             }]
     };
 });
+server.tool("list_language_models", dedent `Lists the available language models configured on the Sourcebot instance. Use this to discover which models can be specified when calling ask_codebase.`, {}, async () => {
+    const models = await listLanguageModels();
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(models),
+            }],
+    };
+});
+server.tool("ask_codebase", dedent `
+    Ask a natural language question about the codebase. This tool uses an AI agent to autonomously search code, read files, and find symbol references/definitions to answer your question.
+
+    The agent will:
+    - Analyze your question and determine what context it needs
+    - Search the codebase using multiple strategies (code search, symbol lookup, file reading)
+    - Synthesize findings into a comprehensive answer with code references
+
+    Returns a detailed answer in markdown format with code references, plus a link to view the full research session (including all tool calls and reasoning) in the Sourcebot web UI.
+
+    This is a blocking operation that may take 30-60+ seconds for complex questions as the agent researches the codebase.
+    `, askCodebaseRequestSchema.shape, async (request) => {
+    const response = await askCodebase(request);
+    // Format the response with the answer and a link to the chat
+    const formattedResponse = dedent `
+        ${response.answer}
+
+        ---
+        **View full research session:** ${response.chatUrl}
+        **Model used:** ${response.languageModel.model}
+        `;
+    return {
+        content: [{
+                type: "text",
+                text: formattedResponse,
+            }],
+    };
+});
 const runServer = async () => {
     const transport = new StdioServerTransport();
     await server.connect(transport);

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 _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"]}
+{"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 { askCodebase, getFileSource, listCommits, listLanguageModels, listRepos, search } from './client.js';\nimport { env, numberSchema } from './env.js';\nimport { askCodebaseRequestSchema, fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema } from './schemas.js';\nimport { AskCodebaseRequest, 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        });\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\nserver.tool(\n    \"list_language_models\",\n    dedent`Lists the available language models configured on the Sourcebot instance. Use this to discover which models can be specified when calling ask_codebase.`,\n    {},\n    async () => {\n        const models = await listLanguageModels();\n\n        return {\n            content: [{\n                type: \"text\",\n                text: JSON.stringify(models),\n            }],\n        };\n    }\n);\n\nserver.tool(\n    \"ask_codebase\",\n    dedent`\n    Ask a natural language question about the codebase. This tool uses an AI agent to autonomously search code, read files, and find symbol references/definitions to answer your question.\n\n    The agent will:\n    - Analyze your question and determine what context it needs\n    - Search the codebase using multiple strategies (code search, symbol lookup, file reading)\n    - Synthesize findings into a comprehensive answer with code references\n\n    Returns a detailed answer in markdown format with code references, plus a link to view the full research session (including all tool calls and reasoning) in the Sourcebot web UI.\n\n    This is a blocking operation that may take 30-60+ seconds for complex questions as the agent researches the codebase.\n    `,\n    askCodebaseRequestSchema.shape,\n    async (request: AskCodebaseRequest) => {\n        const response = await askCodebase(request);\n\n        // Format the response with the answer and a link to the chat\n        const formattedResponse = dedent`\n        ${response.answer}\n\n        ---\n        **View full research session:** ${response.chatUrl}\n        **Model used:** ${response.languageModel.model}\n        `;\n\n        return {\n            content: [{\n                type: \"text\",\n                text: formattedResponse,\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"]}

package/dist/schemas.d.ts

@@ -98,7 +98,6 @@ export declare const searchRequestSchema: z.ZodObject<{
     isRegexEnabled: z.ZodOptional<z.ZodBoolean>;
     isCaseSensitivityEnabled: z.ZodOptional<z.ZodBoolean>;
     query: z.ZodString;
-    source: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     matches: number;
     query: string;
@@ -106,7 +105,6 @@ export declare const searchRequestSchema: z.ZodObject<{
     whole?: boolean | undefined;
     isRegexEnabled?: boolean | undefined;
     isCaseSensitivityEnabled?: boolean | undefined;
-    source?: string | undefined;
 }, {
     matches: number;
     query: string;
@@ -114,7 +112,6 @@ export declare const searchRequestSchema: z.ZodObject<{
     whole?: boolean | undefined;
     isRegexEnabled?: boolean | undefined;
     isCaseSensitivityEnabled?: boolean | undefined;
-    source?: string | undefined;
 }>;
 export declare const repositoryInfoSchema: z.ZodObject<{
     id: z.ZodNumber;
@@ -901,31 +898,28 @@ export declare const fileSourceResponseSchema: z.ZodObject<{
     repoCodeHostType: z.ZodString;
     repoDisplayName: z.ZodOptional<z.ZodString>;
     repoExternalWebUrl: z.ZodOptional<z.ZodString>;
-    branch: z.ZodOptional<z.ZodString>;
     webUrl: z.ZodString;
     externalWebUrl: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     path: string;
-    source: string;
     webUrl: string;
     language: string;
     repo: string;
+    source: string;
     repoCodeHostType: string;
     externalWebUrl?: string | undefined;
     repoDisplayName?: string | undefined;
     repoExternalWebUrl?: string | undefined;
-    branch?: string | undefined;
 }, {
     path: string;
-    source: string;
     webUrl: string;
     language: string;
     repo: string;
+    source: string;
     repoCodeHostType: string;
     externalWebUrl?: string | undefined;
     repoDisplayName?: string | undefined;
     repoExternalWebUrl?: string | undefined;
-    branch?: string | undefined;
 }>;
 export declare const serviceErrorSchema: z.ZodObject<{
     statusCode: z.ZodNumber;
@@ -993,3 +987,116 @@ export declare const listCommitsResponseSchema: z.ZodArray<z.ZodObject<{
     author_name: string;
     author_email: string;
 }>, "many">;
+export declare const languageModelInfoSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    provider: string;
+    model: string;
+    displayName?: string | undefined;
+}, {
+    provider: string;
+    model: string;
+    displayName?: string | undefined;
+}>;
+export declare const listLanguageModelsResponseSchema: z.ZodArray<z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    provider: string;
+    model: string;
+    displayName?: string | undefined;
+}, {
+    provider: string;
+    model: string;
+    displayName?: string | undefined;
+}>, "many">;
+export declare const askCodebaseRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    repos: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    languageModel: z.ZodOptional<z.ZodObject<Omit<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+    }, "displayName">, "strip", z.ZodTypeAny, {
+        provider: string;
+        model: string;
+    }, {
+        provider: string;
+        model: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    repos?: string[] | undefined;
+    languageModel?: {
+        provider: string;
+        model: string;
+    } | undefined;
+}, {
+    query: string;
+    repos?: string[] | undefined;
+    languageModel?: {
+        provider: string;
+        model: string;
+    } | undefined;
+}>;
+export declare const sourceSchema: z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    repo: z.ZodString;
+    path: z.ZodString;
+    name: z.ZodString;
+    language: z.ZodString;
+    revision: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "file";
+    name: string;
+    language: string;
+    repo: string;
+    revision: string;
+}, {
+    path: string;
+    type: "file";
+    name: string;
+    language: string;
+    repo: string;
+    revision: string;
+}>;
+export declare const askCodebaseResponseSchema: z.ZodObject<{
+    answer: z.ZodString;
+    chatId: z.ZodString;
+    chatUrl: z.ZodString;
+    languageModel: z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        model: string;
+        displayName?: string | undefined;
+    }, {
+        provider: string;
+        model: string;
+        displayName?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    languageModel: {
+        provider: string;
+        model: string;
+        displayName?: string | undefined;
+    };
+    answer: string;
+    chatId: string;
+    chatUrl: string;
+}, {
+    languageModel: {
+        provider: string;
+        model: string;
+        displayName?: string | undefined;
+    };
+    answer: string;
+    chatId: string;
+    chatUrl: string;
+}>;

package/dist/schemas.js

@@ -26,7 +26,6 @@ export const searchOptionsSchema = z.object({
 });
 export const searchRequestSchema = z.object({
     query: z.string(), // The zoekt query to execute.
-    source: z.string().optional(), // The source of the search request.
     ...searchOptionsSchema.shape,
 });
 export const repositoryInfoSchema = z.object({
@@ -180,7 +179,6 @@ export const fileSourceResponseSchema = z.object({
     repoCodeHostType: z.string(),
     repoDisplayName: z.string().optional(),
     repoExternalWebUrl: z.string().optional(),
-    branch: z.string().optional(),
     webUrl: z.string(),
     externalWebUrl: z.string().optional(),
 });
@@ -238,4 +236,41 @@ export const listCommitsResponseSchema = z.array(z.object({
     author_name: z.string(),
     author_email: z.string(),
 }));
+export const languageModelInfoSchema = z.object({
+    provider: z.string().describe("The model provider (e.g., 'anthropic', 'openai')"),
+    model: z.string().describe("The model ID"),
+    displayName: z.string().optional().describe("Optional display name for the model"),
+});
+export const listLanguageModelsResponseSchema = z.array(languageModelInfoSchema);
+export const askCodebaseRequestSchema = z.object({
+    query: z
+        .string()
+        .describe("The query to ask about the codebase."),
+    repos: z
+        .array(z.string())
+        .optional()
+        .describe("The repositories that are accessible to the agent during the chat. If not provided, all repositories are accessible."),
+    languageModel: languageModelInfoSchema
+        .omit({ displayName: true })
+        .optional()
+        .describe("The language model to use for answering the question. If not provided, defaults to the first model in the config. Use list_language_models to see available options."),
+});
+export const sourceSchema = z.object({
+    type: z.literal('file'),
+    repo: z.string(),
+    path: z.string(),
+    name: z.string(),
+    language: z.string(),
+    revision: z.string(),
+});
+export const askCodebaseResponseSchema = z.object({
+    answer: z.string().describe("The agent's final answer in markdown format"),
+    chatId: z.string().describe("ID of the persisted chat session"),
+    chatUrl: z.string().describe("URL to view the chat in the web UI"),
+    languageModel: z.object({
+        provider: z.string().describe("The model provider (e.g., 'anthropic', 'openai')"),
+        model: z.string().describe("The model ID"),
+        displayName: z.string().optional().describe("Optional display name for the model"),
+    }).describe("The language model used to generate the response"),
+});
 //# sourceMappingURL=schemas.js.map