readonly hint

Author: brendan-kellam

packages/web/src/features/tools/adapters.ts

@@ -26,7 +26,13 @@ export function registerMcpTool<TName extends string, TShape extends z.ZodRawSha
     // type. def.inputSchema.parse() recovers the correctly typed value inside.
     server.registerTool(
         def.name,
-        { description: def.description, inputSchema: def.inputSchema.shape as z.ZodRawShape },
+        {
+            description: def.description,
+            inputSchema: def.inputSchema.shape as z.ZodRawShape,
+            annotations: {
+                readOnlyHint: def.isReadOnly,
+            },
+        },
         async (input) => {
             try {
                 const parsed = def.inputSchema.parse(input);

packages/web/src/features/tools/findSymbolDefinitions.ts

@@ -23,6 +23,7 @@ export const findSymbolDefinitionsDefinition: ToolDefinition<
     FindSymbolDefinitionsMetadata
 > = {
     name: 'find_symbol_definitions',
+    isReadOnly: true,
     description,
     inputSchema: z.object(findSymbolDefinitionsShape),
     execute: async ({ symbol, language, repo }, _context) => {

packages/web/src/features/tools/findSymbolReferences.ts

@@ -30,6 +30,7 @@ export const findSymbolReferencesDefinition: ToolDefinition<
     FindSymbolReferencesMetadata
 > = {
     name: 'find_symbol_references',
+    isReadOnly: true,
     description,
     inputSchema: z.object(findSymbolReferencesShape),
     execute: async ({ symbol, language, repo }, _context) => {

packages/web/src/features/tools/listCommits.ts

@@ -20,6 +20,7 @@ export type ListCommitsMetadata = SearchCommitsResult;
 
 export const listCommitsDefinition: ToolDefinition<"list_commits", typeof listCommitsShape, ListCommitsMetadata> = {
     name: "list_commits",
+    isReadOnly: true,
     description,
     inputSchema: z.object(listCommitsShape),
     execute: async (params, _context) => {

packages/web/src/features/tools/listRepos.ts

@@ -33,6 +33,7 @@ export const listReposDefinition: ToolDefinition<
     ListReposMetadata
 > = {
     name: 'list_repos',
+    isReadOnly: true,
     description,
     inputSchema: z.object(listReposShape),
     execute: async ({ page, perPage, sort, direction, query }, context) => {

packages/web/src/features/tools/listTree.ts

@@ -40,6 +40,7 @@ export type ListTreeMetadata = {
 
 export const listTreeDefinition: ToolDefinition<'list_tree', typeof listTreeShape, ListTreeMetadata> = {
     name: 'list_tree',
+    isReadOnly: true,
     description,
     inputSchema: z.object(listTreeShape),
     execute: async ({ repo, path = '', ref = 'HEAD', depth = DEFAULT_TREE_DEPTH, includeFiles = true, includeDirectories = true, maxEntries = DEFAULT_MAX_TREE_ENTRIES }, context) => {

packages/web/src/features/tools/readFile.ts

@@ -35,6 +35,7 @@ export type ReadFileMetadata = {
 
 export const readFileDefinition: ToolDefinition<"read_file", typeof readFileShape, ReadFileMetadata> = {
     name: "read_file",
+    isReadOnly: true,
     description,
     inputSchema: z.object(readFileShape),
     execute: async ({ path, repo, offset, limit }, context) => {

packages/web/src/features/tools/searchCode.ts

@@ -64,6 +64,7 @@ export type SearchCodeMetadata = {
 
 export const searchCodeDefinition: ToolDefinition<'search_code', typeof searchCodeShape, SearchCodeMetadata> = {
     name: 'search_code',
+    isReadOnly: true,
     description,
     inputSchema: z.object(searchCodeShape),
     execute: async ({

packages/web/src/features/tools/types.ts

@@ -12,6 +12,7 @@ export interface ToolDefinition<
     name: TName;
     description: string;
     inputSchema: z.ZodObject<TShape>;
+    isReadOnly: boolean;
     execute: (input: z.infer<z.ZodObject<TShape>>, context: ToolContext) => Promise<ToolResult<TMetadata>>;
 }