symbols-mcp

/** * MCP Tool Schemas - shared schema definitions for all tools */ import { z } from 'zod'; import { createOneBasedPosition } from '../types/position.js'; import type { OneBasedPosition } from '../types/position.js'; // Note: OneBasedPosition transforms are defined inline in the schemas below // to avoid unused variable warnings while keeping the patterns clear const fileDescription = 'File path (either absolute or relative to cwd)'; const lineDescription = '1-based line number where the cursor will be placed'; const charDescription = '1-based character number where the cursor will be placed'; export const symbolPositionSchema = { file: z.string().describe(fileDescription), line: z.number().int().min(1).describe(lineDescription), character: z.number().int().min(1).describe(charDescription), } as const; // Schema that transforms to OneBasedPosition export const symbolPositionWithTransformSchema = z .object({ file: z.string().describe(fileDescription), line: z.number().int().min(1).describe(lineDescription), character: z.number().int().min(1).describe(charDescription), }) .transform(({ file, line, character }) => ({ file, position: createOneBasedPosition(line, character), })); // File-only schemas don't need transform versions since they don't have // line/character fields to convert into OneBasedPosition export const fileSchema = { file: z.string().describe(fileDescription), preview: z .boolean() .optional() .default(false) .describe( 'Include code preview snippets from symbol declarations. Default false for compact output.' ), } as const; export const diagnosticsSchema = { file: z.string().describe(fileDescription), } as const; export const searchSchema = { query: z.string().describe('Search query to find symbols by name or pattern'), } as const; export const renameSchema = { file: z.string().describe(fileDescription), line: z.number().int().min(1).describe(lineDescription), character: z.number().int().min(1).describe(charDescription), newName: z.string().describe('New name for the symbol'), } as const; // Schema that transforms to OneBasedPosition for rename export const renameWithTransformSchema = z .object({ file: z.string().describe(fileDescription), line: z.number().int().min(1).describe(lineDescription), character: z.number().int().min(1).describe(charDescription), newName: z.string().describe('New name for the symbol'), }) .transform(({ file, line, character, newName }) => ({ file, position: createOneBasedPosition(line, character), newName, })); // Type definitions for the transformed schemas export type SymbolPositionWithPosition = { file: string; position: OneBasedPosition; }; export type RenameWithPosition = { file: string; position: OneBasedPosition; newName: string; };