@sourcebot/mcp 1.0.15 → 1.0.16

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.16] - 2026-02-10
+
+### Added
+- Added `list_tree` tool for listing files/directories in a repository path with depth controls, suitable for both directory listings and repo-tree workflows. [#870](https://github.com/sourcebot-dev/sourcebot/pull/870)
+
 ## [1.0.15] - 2026-02-02
 
 ### Added
@@ -94,4 +99,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [1.0.0] - 2025-05-07
 
 ### Added
-- Initial release
+- Initial release

package/README.md

@@ -214,6 +214,25 @@ Reads the source code for a given file.
 | `ref`  | no       | Commit SHA, branch or tag name to fetch the source code for. If not provided, uses the default branch.         |
 </details>
 
+### list_tree
+
+Lists files and directories from a repository path. Can be used as a directory listing tool (`depth: 1`) or a repo-tree tool (`depth > 1`).
+
+<details>
+<summary>Parameters</summary>
+
+| Name                 | Required | Description                                                                                                   |
+|:---------------------|:---------|:--------------------------------------------------------------------------------------------------------------|
+| `repo`               | yes      | The name of the repository to list files from.                                                                |
+| `path`               | no       | Directory path (relative to repo root). If omitted, the repo root is used.                                    |
+| `ref`                | no       | Commit SHA, branch or tag name to list files from. If not provided, uses the default branch.                  |
+| `depth`              | no       | Number of directory levels to traverse below `path` (min 1, max 10, default: 1).                              |
+| `includeFiles`       | no       | Whether to include file entries in the output (default: true).                                                |
+| `includeDirectories` | no       | Whether to include directory entries in the output (default: true).                                           |
+| `maxEntries`         | no       | Maximum number of entries to return before truncating (min 1, max 10000, default: 1000).                      |
+
+</details>
+
 ### list_commits
 
 Get a list of commits for a given repository.

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { AskCodebaseRequest, AskCodebaseResponse, FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema, ListLanguageModelsResponse } from './types.js';
+import { AskCodebaseRequest, AskCodebaseResponse, FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema, ListLanguageModelsResponse, ListTreeApiRequest, ListTreeApiResponse } from './types.js';
 export declare const search: (request: SearchRequest) => Promise<{
     stats: {
         actualMatchCount: number;
@@ -121,6 +121,13 @@ export declare const listCommits: (queryParams: ListCommitsQueryParamsSchema) =>
     }[];
     totalCount: number;
 }>;
+/**
+ * Fetches a repository tree (or subtree union) from the Sourcebot tree API.
+ *
+ * @param request - Repository name, revision, and path selectors for the tree query
+ * @returns A tree response rooted at `tree` containing nested `tree`/`blob` nodes
+ */
+export declare const listTree: (request: ListTreeApiRequest) => Promise<ListTreeApiResponse>;
 /**
  * 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.

package/dist/client.js

@@ -1,5 +1,5 @@
 import { env } from './env.js';
-import { listReposResponseSchema, searchResponseSchema, fileSourceResponseSchema, listCommitsResponseSchema, askCodebaseResponseSchema, listLanguageModelsResponseSchema } from './schemas.js';
+import { listReposResponseSchema, searchResponseSchema, fileSourceResponseSchema, listCommitsResponseSchema, askCodebaseResponseSchema, listLanguageModelsResponseSchema, listTreeApiResponseSchema } from './schemas.js';
 import { isServiceError, ServiceErrorException } from './utils.js';
 const parseResponse = async (response, schema) => {
     const text = await response.text();
@@ -86,6 +86,24 @@ export const listCommits = async (queryParams) => {
     const totalCount = parseInt(response.headers.get('X-Total-Count') ?? '0', 10);
     return { commits, totalCount };
 };
+/**
+ * Fetches a repository tree (or subtree union) from the Sourcebot tree API.
+ *
+ * @param request - Repository name, revision, and path selectors for the tree query
+ * @returns A tree response rooted at `tree` containing nested `tree`/`blob` nodes
+ */
+export const listTree = async (request) => {
+    const response = await fetch(`${env.SOURCEBOT_HOST}/api/tree`, {
+        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, listTreeApiResponseSchema);
+};
 /**
  * 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.

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, 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"]}
+{"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, listTreeApiResponseSchema } from './schemas.js';\nimport { AskCodebaseRequest, AskCodebaseResponse, FileSourceRequest, ListReposQueryParams, SearchRequest, ListCommitsQueryParamsSchema, ListLanguageModelsResponse, ListTreeApiRequest, ListTreeApiResponse } 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 * Fetches a repository tree (or subtree union) from the Sourcebot tree API.\n *\n * @param request - Repository name, revision, and path selectors for the tree query\n * @returns A tree response rooted at `tree` containing nested `tree`/`blob` nodes\n */\nexport const listTree = async (request: ListTreeApiRequest): Promise<ListTreeApiResponse> => {\n    const response = await fetch(`${env.SOURCEBOT_HOST}/api/tree`, {\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, listTreeApiResponseSchema);\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,10 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import _dedent from "dedent";
 import escapeStringRegexp from 'escape-string-regexp';
 import { z } from 'zod';
-import { askCodebase, getFileSource, listCommits, listLanguageModels, listRepos, search } from './client.js';
+import { askCodebase, getFileSource, listCommits, listLanguageModels, listRepos, listTree, search } from './client.js';
 import { env, numberSchema } from './env.js';
-import { askCodebaseRequestSchema, fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema } from './schemas.js';
+import { askCodebaseRequestSchema, DEFAULT_MAX_TREE_ENTRIES, DEFAULT_TREE_DEPTH, fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema, listTreeRequestSchema, MAX_MAX_TREE_ENTRIES, MAX_TREE_DEPTH } from './schemas.js';
+import { buildTreeNodeIndex, joinTreePath, normalizeTreePath, sortTreeEntries } from './utils.js';
 const dedent = _dedent.withOptions({ alignValues: true });
 // Create MCP server
 const server = new McpServer({
@@ -174,6 +175,123 @@ server.tool("read_file", dedent `Reads the source code for a given file.`, fileS
             }]
     };
 });
+server.tool("list_tree", dedent `
+    Lists files and directories from a repository path. This can be used as a repo tree tool or directory listing tool.
+    Returns a flat list of entries with path metadata and depth relative to the requested path.
+    `, listTreeRequestSchema.shape, async ({ repo, path = '', ref = 'HEAD', depth = DEFAULT_TREE_DEPTH, includeFiles = true, includeDirectories = true, maxEntries = DEFAULT_MAX_TREE_ENTRIES, }) => {
+    const normalizedPath = normalizeTreePath(path);
+    const normalizedDepth = Math.min(depth, MAX_TREE_DEPTH);
+    const normalizedMaxEntries = Math.min(maxEntries, MAX_MAX_TREE_ENTRIES);
+    if (!includeFiles && !includeDirectories) {
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        repo,
+                        ref,
+                        path: normalizedPath,
+                        entries: [],
+                        totalReturned: 0,
+                        truncated: false,
+                    }),
+                }],
+        };
+    }
+    // BFS frontier of directories still to expand. Each item stores a repo-relative
+    // directory path plus the current depth from the requested root `path`.
+    const queue = [{ path: normalizedPath, depth: 0 }];
+    // Tracks directory paths that have already been enqueued.
+    // With the current single-root traversal duplicates are uncommon, but this
+    // prevents duplicate expansion if we later support overlapping multi-root
+    // inputs (e.g. ["src", "src/lib"]) or receive overlapping tree data.
+    const queuedPaths = new Set([normalizedPath]);
+    const seenEntries = new Set();
+    const entries = [];
+    let truncated = false;
+    // Traverse breadth-first by depth, batching all directories at the same
+    // depth into a single /api/tree request per iteration.
+    while (queue.length > 0 && !truncated) {
+        const currentDepth = queue[0].depth;
+        const currentLevelPaths = [];
+        // Drain only the current depth level so we can issue one API call
+        // for all sibling directories before moving deeper.
+        while (queue.length > 0 && queue[0].depth === currentDepth) {
+            const next = queue.shift();
+            currentLevelPaths.push(next.path);
+        }
+        // Ask Sourcebot for a tree spanning all requested paths at this level.
+        const treeResponse = await listTree({
+            repoName: repo,
+            revisionName: ref,
+            paths: currentLevelPaths.filter(Boolean),
+        });
+        const treeNodeIndex = buildTreeNodeIndex(treeResponse.tree);
+        for (const currentPath of currentLevelPaths) {
+            const currentNode = currentPath === '' ? treeResponse.tree : treeNodeIndex.get(currentPath);
+            if (!currentNode || currentNode.type !== 'tree') {
+                // Skip paths that are missing from the response or resolve to a
+                // file node. We only iterate children of directories.
+                continue;
+            }
+            for (const child of currentNode.children) {
+                if (child.type !== 'tree' && child.type !== 'blob') {
+                    // Skip non-standard git object types (e.g. unexpected entries)
+                    // since this tool only exposes directories and files.
+                    continue;
+                }
+                const childPath = joinTreePath(currentPath, child.name);
+                const childDepth = currentDepth + 1;
+                // Queue child directories for the next depth level only if
+                // they are within the requested depth bound.
+                if (child.type === 'tree' && childDepth < normalizedDepth && !queuedPaths.has(childPath)) {
+                    queue.push({ path: childPath, depth: childDepth });
+                    queuedPaths.add(childPath);
+                }
+                if ((child.type === 'blob' && !includeFiles) || (child.type === 'tree' && !includeDirectories)) {
+                    // Skip entries filtered out by caller preferences
+                    // (`includeFiles` / `includeDirectories`).
+                    continue;
+                }
+                const key = `${child.type}:${childPath}`;
+                if (seenEntries.has(key)) {
+                    // Skip duplicates when multiple requested paths overlap and
+                    // surface the same child entry.
+                    continue;
+                }
+                seenEntries.add(key);
+                // Stop collecting once the entry budget is exhausted.
+                if (entries.length >= normalizedMaxEntries) {
+                    truncated = true;
+                    break;
+                }
+                entries.push({
+                    type: child.type,
+                    path: childPath,
+                    name: child.name,
+                    parentPath: currentPath,
+                    depth: childDepth,
+                });
+            }
+            if (truncated) {
+                break;
+            }
+        }
+    }
+    const sortedEntries = sortTreeEntries(entries);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    repo,
+                    ref,
+                    path: normalizedPath,
+                    entries: sortedEntries,
+                    totalReturned: sortedEntries.length,
+                    truncated,
+                }),
+            }]
+    };
+});
 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 {

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 { 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"]}
+{"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, listTree, search } from './client.js';\nimport { env, numberSchema } from './env.js';\nimport { askCodebaseRequestSchema, DEFAULT_MAX_TREE_ENTRIES, DEFAULT_TREE_DEPTH, fileSourceRequestSchema, listCommitsQueryParamsSchema, listReposQueryParamsSchema, listTreeRequestSchema, MAX_MAX_TREE_ENTRIES, MAX_TREE_DEPTH } from './schemas.js';\nimport { AskCodebaseRequest, FileSourceRequest, ListCommitsQueryParamsSchema, ListReposQueryParams, ListTreeEntry, ListTreeRequest, TextContent } from './types.js';\nimport { buildTreeNodeIndex, joinTreePath, normalizeTreePath, sortTreeEntries } from './utils.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_tree\",\n    dedent`\n    Lists files and directories from a repository path. This can be used as a repo tree tool or directory listing tool.\n    Returns a flat list of entries with path metadata and depth relative to the requested path.\n    `,\n    listTreeRequestSchema.shape,\n    async ({\n        repo,\n        path = '',\n        ref = 'HEAD',\n        depth = DEFAULT_TREE_DEPTH,\n        includeFiles = true,\n        includeDirectories = true,\n        maxEntries = DEFAULT_MAX_TREE_ENTRIES,\n    }: ListTreeRequest) => {\n        const normalizedPath = normalizeTreePath(path);\n        const normalizedDepth = Math.min(depth, MAX_TREE_DEPTH);\n        const normalizedMaxEntries = Math.min(maxEntries, MAX_MAX_TREE_ENTRIES);\n\n        if (!includeFiles && !includeDirectories) {\n            return {\n                content: [{\n                    type: \"text\",\n                    text: JSON.stringify({\n                        repo,\n                        ref,\n                        path: normalizedPath,\n                        entries: [] as ListTreeEntry[],\n                        totalReturned: 0,\n                        truncated: false,\n                    }),\n                }],\n            };\n        }\n\n        // BFS frontier of directories still to expand. Each item stores a repo-relative\n        // directory path plus the current depth from the requested root `path`.\n        const queue: Array<{ path: string; depth: number }> = [{ path: normalizedPath, depth: 0 }];\n\n        // Tracks directory paths that have already been enqueued.\n        // With the current single-root traversal duplicates are uncommon, but this\n        // prevents duplicate expansion if we later support overlapping multi-root\n        // inputs (e.g. [\"src\", \"src/lib\"]) or receive overlapping tree data.\n        const queuedPaths = new Set<string>([normalizedPath]);\n\n        const seenEntries = new Set<string>();\n        const entries: ListTreeEntry[] = [];\n        let truncated = false;\n\n        // Traverse breadth-first by depth, batching all directories at the same\n        // depth into a single /api/tree request per iteration.\n        while (queue.length > 0 && !truncated) {\n            const currentDepth = queue[0]!.depth;\n            const currentLevelPaths: string[] = [];\n\n            // Drain only the current depth level so we can issue one API call\n            // for all sibling directories before moving deeper.\n            while (queue.length > 0 && queue[0]!.depth === currentDepth) {\n                const next = queue.shift()!;\n                currentLevelPaths.push(next.path);\n            }\n\n            // Ask Sourcebot for a tree spanning all requested paths at this level.\n            const treeResponse = await listTree({\n                repoName: repo,\n                revisionName: ref,\n                paths: currentLevelPaths.filter(Boolean),\n            });\n            const treeNodeIndex = buildTreeNodeIndex(treeResponse.tree);\n\n            for (const currentPath of currentLevelPaths) {\n                const currentNode = currentPath === '' ? treeResponse.tree : treeNodeIndex.get(currentPath);\n                if (!currentNode || currentNode.type !== 'tree') {\n                    // Skip paths that are missing from the response or resolve to a\n                    // file node. We only iterate children of directories.\n                    continue;\n                }\n\n                for (const child of currentNode.children) {\n                    if (child.type !== 'tree' && child.type !== 'blob') {\n                        // Skip non-standard git object types (e.g. unexpected entries)\n                        // since this tool only exposes directories and files.\n                        continue;\n                    }\n\n                    const childPath = joinTreePath(currentPath, child.name);\n                    const childDepth = currentDepth + 1;\n\n                    // Queue child directories for the next depth level only if\n                    // they are within the requested depth bound.\n                    if (child.type === 'tree' && childDepth < normalizedDepth && !queuedPaths.has(childPath)) {\n                        queue.push({ path: childPath, depth: childDepth });\n                        queuedPaths.add(childPath);\n                    }\n\n                    if ((child.type === 'blob' && !includeFiles) || (child.type === 'tree' && !includeDirectories)) {\n                        // Skip entries filtered out by caller preferences\n                        // (`includeFiles` / `includeDirectories`).\n                        continue;\n                    }\n\n                    const key = `${child.type}:${childPath}`;\n                    if (seenEntries.has(key)) {\n                        // Skip duplicates when multiple requested paths overlap and\n                        // surface the same child entry.\n                        continue;\n                    }\n                    seenEntries.add(key);\n\n                    // Stop collecting once the entry budget is exhausted.\n                    if (entries.length >= normalizedMaxEntries) {\n                        truncated = true;\n                        break;\n                    }\n\n                    entries.push({\n                        type: child.type,\n                        path: childPath,\n                        name: child.name,\n                        parentPath: currentPath,\n                        depth: childDepth,\n                    });\n                }\n\n                if (truncated) {\n                    break;\n                }\n            }\n        }\n\n        const sortedEntries = sortTreeEntries(entries);\n\n        return {\n            content: [{\n                type: \"text\",\n                text: JSON.stringify({\n                    repo,\n                    ref,\n                    path: normalizedPath,\n                    entries: sortedEntries,\n                    totalReturned: sortedEntries.length,\n                    truncated,\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

@@ -921,6 +921,132 @@ export declare const fileSourceResponseSchema: z.ZodObject<{
     repoDisplayName?: string | undefined;
     repoExternalWebUrl?: string | undefined;
 }>;
+type TreeNode = {
+    type: string;
+    path: string;
+    name: string;
+    children: TreeNode[];
+};
+export declare const listTreeApiRequestSchema: z.ZodObject<{
+    repoName: z.ZodString;
+    revisionName: z.ZodString;
+    paths: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    repoName: string;
+    revisionName: string;
+    paths: string[];
+}, {
+    repoName: string;
+    revisionName: string;
+    paths: string[];
+}>;
+export declare const listTreeApiResponseSchema: z.ZodObject<{
+    tree: z.ZodType<TreeNode, z.ZodTypeDef, TreeNode>;
+}, "strip", z.ZodTypeAny, {
+    tree: TreeNode;
+}, {
+    tree: TreeNode;
+}>;
+export declare const DEFAULT_TREE_DEPTH = 1;
+export declare const MAX_TREE_DEPTH = 10;
+export declare const DEFAULT_MAX_TREE_ENTRIES = 1000;
+export declare const MAX_MAX_TREE_ENTRIES = 10000;
+export declare const listTreeRequestSchema: z.ZodObject<{
+    repo: z.ZodString;
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    ref: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    includeFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeDirectories: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxEntries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    repo: string;
+    ref: string;
+    depth: number;
+    includeFiles: boolean;
+    includeDirectories: boolean;
+    maxEntries: number;
+}, {
+    repo: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+    depth?: number | undefined;
+    includeFiles?: boolean | undefined;
+    includeDirectories?: boolean | undefined;
+    maxEntries?: number | undefined;
+}>;
+export declare const listTreeEntrySchema: z.ZodObject<{
+    type: z.ZodEnum<["tree", "blob"]>;
+    path: z.ZodString;
+    name: z.ZodString;
+    parentPath: z.ZodString;
+    depth: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "tree" | "blob";
+    name: string;
+    depth: number;
+    parentPath: string;
+}, {
+    path: string;
+    type: "tree" | "blob";
+    name: string;
+    depth: number;
+    parentPath: string;
+}>;
+export declare const listTreeResponseSchema: z.ZodObject<{
+    repo: z.ZodString;
+    ref: z.ZodString;
+    path: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["tree", "blob"]>;
+        path: z.ZodString;
+        name: z.ZodString;
+        parentPath: z.ZodString;
+        depth: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type: "tree" | "blob";
+        name: string;
+        depth: number;
+        parentPath: string;
+    }, {
+        path: string;
+        type: "tree" | "blob";
+        name: string;
+        depth: number;
+        parentPath: string;
+    }>, "many">;
+    totalReturned: z.ZodNumber;
+    truncated: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    entries: {
+        path: string;
+        type: "tree" | "blob";
+        name: string;
+        depth: number;
+        parentPath: string;
+    }[];
+    repo: string;
+    ref: string;
+    totalReturned: number;
+    truncated: boolean;
+}, {
+    path: string;
+    entries: {
+        path: string;
+        type: "tree" | "blob";
+        name: string;
+        depth: number;
+        parentPath: string;
+    }[];
+    repo: string;
+    ref: string;
+    totalReturned: number;
+    truncated: boolean;
+}>;
 export declare const serviceErrorSchema: z.ZodObject<{
     statusCode: z.ZodNumber;
     errorCode: z.ZodString;
@@ -1100,3 +1226,4 @@ export declare const askCodebaseResponseSchema: z.ZodObject<{
     chatId: string;
     chatUrl: string;
 }>;
+export {};

package/dist/schemas.js

@@ -182,6 +182,80 @@ export const fileSourceResponseSchema = z.object({
     webUrl: z.string(),
     externalWebUrl: z.string().optional(),
 });
+const treeNodeSchema = z.lazy(() => z.object({
+    type: z.string(),
+    path: z.string(),
+    name: z.string(),
+    children: z.array(treeNodeSchema),
+}));
+export const listTreeApiRequestSchema = z.object({
+    repoName: z.string(),
+    revisionName: z.string(),
+    paths: z.array(z.string()),
+});
+export const listTreeApiResponseSchema = z.object({
+    tree: treeNodeSchema,
+});
+export const DEFAULT_TREE_DEPTH = 1;
+export const MAX_TREE_DEPTH = 10;
+export const DEFAULT_MAX_TREE_ENTRIES = 1000;
+export const MAX_MAX_TREE_ENTRIES = 10000;
+export const listTreeRequestSchema = z.object({
+    repo: z
+        .string()
+        .describe("The name of the repository to list files from."),
+    path: z
+        .string()
+        .describe("Directory path (relative to repo root). If omitted, the repo root is used.")
+        .optional()
+        .default(''),
+    ref: z
+        .string()
+        .describe("Commit SHA, branch or tag name to list files from. If not provided, uses the default branch.")
+        .optional()
+        .default('HEAD'),
+    depth: z
+        .number()
+        .int()
+        .positive()
+        .max(MAX_TREE_DEPTH)
+        .describe(`How many directory levels to traverse below \`path\` (min 1, max ${MAX_TREE_DEPTH}, default ${DEFAULT_TREE_DEPTH}).`)
+        .optional()
+        .default(DEFAULT_TREE_DEPTH),
+    includeFiles: z
+        .boolean()
+        .describe("Whether to include files in the output (default: true).")
+        .optional()
+        .default(true),
+    includeDirectories: z
+        .boolean()
+        .describe("Whether to include directories in the output (default: true).")
+        .optional()
+        .default(true),
+    maxEntries: z
+        .number()
+        .int()
+        .positive()
+        .max(MAX_MAX_TREE_ENTRIES)
+        .describe(`Maximum number of entries to return (min 1, max ${MAX_MAX_TREE_ENTRIES}, default ${DEFAULT_MAX_TREE_ENTRIES}).`)
+        .optional()
+        .default(DEFAULT_MAX_TREE_ENTRIES),
+});
+export const listTreeEntrySchema = z.object({
+    type: z.enum(['tree', 'blob']),
+    path: z.string(),
+    name: z.string(),
+    parentPath: z.string(),
+    depth: z.number().int().positive(),
+});
+export const listTreeResponseSchema = z.object({
+    repo: z.string(),
+    ref: z.string(),
+    path: z.string(),
+    entries: z.array(listTreeEntrySchema),
+    totalReturned: z.number().int().nonnegative(),
+    truncated: z.boolean(),
+});
 export const serviceErrorSchema = z.object({
     statusCode: z.number(),
     errorCode: z.string(),