@sourcebot/mcp 1.0.13 → 1.0.15

package/CHANGELOG.md

@@ -7,6 +7,17 @@ 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
+- Updated README.
+
 ## [1.0.13] - 2026-01-27
 
 ### Added

package/README.md

@@ -164,19 +164,22 @@ For a more detailed guide, checkout [the docs](https://docs.sourcebot.dev/docs/f
 
 ### search_code
 
-Fetches code that matches the provided regex pattern in `query`.
+Searches for code that matches the provided search query as a substring by default, or as a regular expression if `useRegex` is true.
 
 <details>
 <summary>Parameters</summary>
 
 | Name                  | Required | Description                                                                                                                       |
 |:----------------------|:---------|:----------------------------------------------------------------------------------------------------------------------------------|
-| `query`               | yes      | Regex pattern to search for. Escape special characters and spaces with a single backslash (e.g., 'console\.log', 'console\ log'). |
-| `filterByRepoIds`     | no       | Restrict search to specific repository IDs (from 'list_repos'). Leave empty to search all.                                        |
-| `filterByLanguages`   | no       | Restrict search to specific languages (GitHub linguist format, e.g., Python, JavaScript).                                         |
-| `caseSensitive`       | no       | Case sensitive search (default: false).                                                                                           |
-| `includeCodeSnippets` | no       | Include code snippets in results (default: false).                                                                                |
-| `maxTokens`           | no       | Max tokens to return (default: env.DEFAULT_MINIMUM_TOKENS).                                                                       |
+| `query`               | yes      | The search pattern to match against code contents. Do not escape quotes in your query.                                            |
+| `useRegex`            | no       | Whether to use regular expression matching. When false, substring matching is used (default: false).                              |
+| `filterByRepos`       | no       | Scope the search to specific repositories.                                                                                        |
+| `filterByLanguages`   | no       | Scope the search to specific languages.                                                                                           |
+| `filterByFilepaths`   | no       | Scope the search to specific filepaths.                                                                                           |
+| `caseSensitive`       | no       | Whether the search should be case sensitive (default: false).                                                                     |
+| `includeCodeSnippets` | no       | Whether to include code snippets in the response (default: false).                                                                |
+| `ref`                 | no       | Commit SHA, branch or tag name to search on. If not provided, defaults to the default branch.                                     |
+| `maxTokens`           | no       | The maximum number of tokens to return (default: 10000). Higher values provide more context but consume more tokens.              |
 </details>
 
 
@@ -187,42 +190,73 @@ Lists repositories indexed by Sourcebot with optional filtering and pagination.
 <details>
 <summary>Parameters</summary>
 
-| Name         | Required | Description                                                         |
-|:-------------|:---------|:--------------------------------------------------------------------|
-| `query`      | no       | Filter repositories by name (case-insensitive).                     |
-| `pageNumber` | no       | Page number (1-indexed, default: 1).                                |
-| `limit`      | no       | Number of repositories per page (default: 50).                      |
+| Name        | Required | Description                                                                     |
+|:------------|:---------|:--------------------------------------------------------------------------------|
+| `query`     | no       | Filter repositories by name (case-insensitive).                                 |
+| `page`      | no       | Page number for pagination (min 1, default: 1).                                 |
+| `perPage`   | no       | Results per page for pagination (min 1, max 100, default: 30).                  |
+| `sort`      | no       | Sort repositories by 'name' or 'pushed' (most recent commit). Default: 'name'. |
+| `direction` | no       | Sort direction: 'asc' or 'desc' (default: 'asc').                               |
 
 </details>
 
-### get_file_source
+### read_file
 
-Fetches the source code for a given file.
+Reads the source code for a given file.
 
 <details>
 <summary>Parameters</summary>
 
-| Name         | Required | Description                                                      |
-|:-------------|:---------|:-----------------------------------------------------------------|
-| `fileName`   | yes      | The file to fetch the source code for.                           |
-| `repoId`     | yes      | The Sourcebot repository ID.                                     |
+| Name   | Required | Description                                                                                                    |
+|:-------|:---------|:---------------------------------------------------------------------------------------------------------------|
+| `repo` | yes      | The repository name.                                                                                           |
+| `path` | yes      | The path to the file.                                                                                          |
+| `ref`  | no       | Commit SHA, branch or tag name to fetch the source code for. If not provided, uses the default branch.         |
 </details>
 
-### search_commits
+### list_commits
 
-Searches for commits in a specific repository based on actual commit time.
+Get a list of commits for a given repository.
 
 <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).                                             |
+| Name      | Required | Description                                                                                                                           |
+|:----------|:---------|:--------------------------------------------------------------------------------------------------------------------------------------|
+| `repo`    | yes      | The name of the repository to list commits for.                                                                                       |
+| `query`   | no       | Search query to filter commits by message content (case-insensitive).                                                                 |
+| `since`   | no       | Show commits more recent than this date. Supports ISO 8601 (e.g., '2024-01-01') or relative formats (e.g., '30 days ago').            |
+| `until`   | no       | Show commits older than this date. Supports ISO 8601 (e.g., '2024-12-31') or relative formats (e.g., 'yesterday').                    |
+| `author`  | no       | Filter commits by author name or email (case-insensitive).                                                                            |
+| `ref`     | no       | Commit SHA, branch or tag name to list commits of. If not provided, uses the default branch.                                          |
+| `page`    | no       | Page number for pagination (min 1, default: 1).                                                                                       |
+| `perPage` | no       | Results per page for pagination (min 1, max 100, default: 50).                                                                        |
+
+</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>
 

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;
+}>;