@crowley/rag-mcp 1.5.0 → 1.6.0

package/dist/tools/search.js

@@ -2,7 +2,7 @@
  * Search tools module - codebase search, similarity search, grouped/hybrid search,
  * documentation search, and project statistics.
  */
-import { formatCodeResults, formatNavigationResults, truncate } from "../formatters.js";
+import { formatCodeResults, formatNavigationResults, truncate, } from "../formatters.js";
 import { z } from "zod";
 import { TOOL_ANNOTATIONS } from "../annotations.js";
 /**
@@ -15,15 +15,30 @@ export function createSearchTools(projectName) {
             description: `Search the ${projectName} codebase. Returns file locations, symbols, and graph connections. Use Read tool to view the actual code at returned locations.`,
             schema: z.object({
                 query: z.string().describe("Search query for finding code"),
-                limit: z.coerce.number().optional().describe("Max results to return (default: 5)"),
-                language: z.string().optional().describe("Filter by language (typescript, python, vue, etc.)"),
-                path: z.string().optional().describe("Filter by path pattern (e.g., 'src/modules/*')"),
-                layer: z.string().optional().describe("Filter by architectural layer (api, service, util, model, middleware, test, parser, types, config, other)"),
-                service: z.string().optional().describe("Filter by service/class name (e.g., 'EmbeddingService')"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max results to return (default: 5)"),
+                language: z
+                    .string()
+                    .optional()
+                    .describe("Filter by language (typescript, python, vue, etc.)"),
+                path: z
+                    .string()
+                    .optional()
+                    .describe("Filter by path pattern (e.g., 'src/modules/*')"),
+                layer: z
+                    .string()
+                    .optional()
+                    .describe("Filter by architectural layer (api, service, util, model, middleware, test, parser, types, config, other)"),
+                service: z
+                    .string()
+                    .optional()
+                    .describe("Filter by service/class name (e.g., 'EmbeddingService')"),
             }),
             annotations: TOOL_ANNOTATIONS["search_codebase"],
             handler: async (args, ctx) => {
-                const { query, limit = 5, language, path, layer, service } = args;
+                const { query, limit = 5, language, path, layer, service, } = args;
                 const response = await ctx.api.post("/api/search", {
                     collection: `${ctx.collectionPrefix}codebase`,
                     query,
@@ -43,7 +58,10 @@ export function createSearchTools(projectName) {
             description: "Find code similar to a given snippet.",
             schema: z.object({
                 code: z.string().describe("Code snippet to find similar code for"),
-                limit: z.coerce.number().optional().describe("Max results (default: 5)"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max results (default: 5)"),
             }),
             annotations: TOOL_ANNOTATIONS["search_similar"],
             handler: async (args, ctx) => {
@@ -65,17 +83,30 @@ export function createSearchTools(projectName) {
             description: `Search ${projectName} codebase grouped by file. Returns file locations with symbols and connections. Use Read tool to view the actual code.`,
             schema: z.object({
                 query: z.string().describe("Search query"),
-                groupBy: z.string().optional().describe("Field to group by (default: 'file')"),
-                limit: z.coerce.number().optional().describe("Max groups to return (default: 10)"),
+                groupBy: z
+                    .string()
+                    .optional()
+                    .describe("Field to group by (default: 'file')"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max groups to return (default: 10)"),
                 language: z.string().optional().describe("Filter by language"),
-                layer: z.string().optional().describe("Filter by architectural layer (api, service, util, etc.)"),
+                layer: z
+                    .string()
+                    .optional()
+                    .describe("Filter by architectural layer (api, service, util, etc.)"),
                 service: z.string().optional().describe("Filter by service/class name"),
             }),
             annotations: TOOL_ANNOTATIONS["grouped_search"],
             handler: async (args, ctx) => {
-                const { query, groupBy = "file", limit = 10, language, layer, service } = args;
-                const filters = { language, layer, service };
-                const hasFilters = Object.values(filters).some(v => v !== undefined);
+                const { query, groupBy = "file", limit = 10, language, layer, service, } = args;
+                const filters = {
+                    language,
+                    layer,
+                    service,
+                };
+                const hasFilters = Object.values(filters).some((v) => v !== undefined);
                 const response = await ctx.api.post("/api/search-grouped", {
                     collection: `${ctx.collectionPrefix}codebase`,
                     query,
@@ -97,17 +128,30 @@ export function createSearchTools(projectName) {
             description: `Hybrid search combining keyword matching and semantic similarity for ${projectName}. Returns file locations with symbols and connections. Use Read tool to view code.`,
             schema: z.object({
                 query: z.string().describe("Search query"),
-                limit: z.coerce.number().optional().describe("Max results (default: 10)"),
-                semanticWeight: z.coerce.number().optional().describe("Weight for semantic vs keyword (0-1, default: 0.7)"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max results (default: 10)"),
+                semanticWeight: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Weight for semantic vs keyword (0-1, default: 0.7)"),
                 language: z.string().optional().describe("Filter by language"),
-                layer: z.string().optional().describe("Filter by architectural layer (api, service, util, etc.)"),
+                layer: z
+                    .string()
+                    .optional()
+                    .describe("Filter by architectural layer (api, service, util, etc.)"),
                 service: z.string().optional().describe("Filter by service/class name"),
             }),
             annotations: TOOL_ANNOTATIONS["hybrid_search"],
             handler: async (args, ctx) => {
-                const { query, limit = 10, semanticWeight = 0.7, language, layer, service } = args;
-                const filters = { language, layer, service };
-                const hasFilters = Object.values(filters).some(v => v !== undefined);
+                const { query, limit = 10, semanticWeight = 0.7, language, layer, service, } = args;
+                const filters = {
+                    language,
+                    layer,
+                    service,
+                };
+                const hasFilters = Object.values(filters).some((v) => v !== undefined);
                 const response = await ctx.api.post("/api/search-hybrid", {
                     collection: `${ctx.collectionPrefix}codebase`,
                     query,
@@ -128,7 +172,10 @@ export function createSearchTools(projectName) {
             description: `Search documentation in the ${projectName} project.`,
             schema: z.object({
                 query: z.string().describe("Search query"),
-                limit: z.coerce.number().optional().describe("Max results (default: 5)"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max results (default: 5)"),
             }),
             annotations: TOOL_ANNOTATIONS["search_docs"],
             handler: async (args, ctx) => {
@@ -143,8 +190,7 @@ export function createSearchTools(projectName) {
                     return "No documentation found for this query.";
                 }
                 return results
-                    .map((r) => `**${r.file}**\n` +
-                    truncate(r.content, 500))
+                    .map((r) => `**${r.file}**\n` + truncate(r.content, 500))
                     .join("\n\n---\n\n");
             },
         },
@@ -192,9 +238,17 @@ export function createSearchTools(projectName) {
             name: "find_symbol",
             description: `Find a function, class, type, or interface by name in ${projectName}. Fast symbol lookup without full-text search.`,
             schema: z.object({
-                symbol: z.string().describe("Symbol name to find (function, class, type, etc.)"),
-                kind: z.string().optional().describe("Filter by kind: function, class, interface, type, enum, const"),
-                limit: z.coerce.number().optional().describe("Max results (default: 10)"),
+                symbol: z
+                    .string()
+                    .describe("Symbol name to find (function, class, type, etc.)"),
+                kind: z
+                    .string()
+                    .optional()
+                    .describe("Filter by kind: function, class, interface, type, enum, const"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max results (default: 10)"),
             }),
             outputSchema: z.object({
                 symbols: z.array(z.object({
@@ -209,7 +263,7 @@ export function createSearchTools(projectName) {
             }),
             annotations: TOOL_ANNOTATIONS["find_symbol"],
             handler: async (args, ctx) => {
-                const { symbol, kind, limit = 10 } = args;
+                const { symbol, kind, limit = 10, } = args;
                 const response = await ctx.api.post("/api/find-symbol", {
                     projectName: ctx.projectName,
                     symbol,
@@ -246,12 +300,18 @@ export function createSearchTools(projectName) {
             description: `Search ${projectName} codebase with graph expansion. Returns file locations plus connected files via import/call relationships. Use Read tool to view code.`,
             schema: z.object({
                 query: z.string().describe("Search query"),
-                limit: z.coerce.number().optional().describe("Max direct results (default: 5)"),
-                expandHops: z.coerce.number().optional().describe("Number of graph hops to expand (default: 1)"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max direct results (default: 5)"),
+                expandHops: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Number of graph hops to expand (default: 1)"),
             }),
             annotations: TOOL_ANNOTATIONS["search_graph"],
             handler: async (args, ctx) => {
-                const { query, limit = 5, expandHops = 1 } = args;
+                const { query, limit = 5, expandHops = 1, } = args;
                 const response = await ctx.api.post("/api/search-graph", {
                     collection: `${ctx.collectionPrefix}codebase`,
                     query,
@@ -260,7 +320,8 @@ export function createSearchTools(projectName) {
                     mode: "navigate",
                 });
                 const { results, graphExpanded, expandedFiles } = response.data;
-                if ((!results || results.length === 0) && (!graphExpanded || graphExpanded.length === 0)) {
+                if ((!results || results.length === 0) &&
+                    (!graphExpanded || graphExpanded.length === 0)) {
                     return "No results found.";
                 }
                 let output = "";

package/dist/tools/session.js

@@ -15,7 +15,10 @@ export function createSessionTools(projectName, sharedCtx) {
             name: "summarize_context",
             description: `Summarize the current working context for ${projectName}. Shows recently used tools, active features, recent queries, and suggested next steps.`,
             schema: z.object({
-                sessionId: z.string().optional().describe("Session ID to get context for. If omitted, returns the latest context."),
+                sessionId: z
+                    .string()
+                    .optional()
+                    .describe("Session ID to get context for. If omitted, returns the latest context."),
             }),
             annotations: TOOL_ANNOTATIONS["summarize_context"],
             handler: async (args, ctx) => {
@@ -26,16 +29,12 @@ export function createSessionTools(projectName, sharedCtx) {
                 let result = `**Context Summary for ${ctx.projectName}**\n\n`;
                 if (data.recentTools && data.recentTools.length > 0) {
                     result += `**Recently Used Tools:**\n`;
-                    result += data.recentTools
-                        .map((t) => `- ${t}`)
-                        .join("\n");
+                    result += data.recentTools.map((t) => `- ${t}`).join("\n");
                     result += "\n\n";
                 }
                 if (data.activeFeatures && data.activeFeatures.length > 0) {
                     result += `**Active Features:**\n`;
-                    result += data.activeFeatures
-                        .map((f) => `- ${f}`)
-                        .join("\n");
+                    result += data.activeFeatures.map((f) => `- ${f}`).join("\n");
                     result += "\n\n";
                 }
                 if (data.recentQueries && data.recentQueries.length > 0) {
@@ -61,7 +60,10 @@ export function createSessionTools(projectName, sharedCtx) {
             description: `Summarize changes made during a session for ${projectName}. Shows what was modified, tools used, and key actions taken.`,
             schema: z.object({
                 sessionId: z.string().describe("Session ID to summarize changes for."),
-                includeCode: z.boolean().optional().describe("Whether to include code snippets in the summary (default: false)."),
+                includeCode: z
+                    .boolean()
+                    .optional()
+                    .describe("Whether to include code snippets in the summary (default: false)."),
             }),
             annotations: TOOL_ANNOTATIONS["summarize_changes"],
             handler: async (args, ctx) => {
@@ -102,7 +104,10 @@ export function createSessionTools(projectName, sharedCtx) {
             name: "analyze_usage_patterns",
             description: `Analyze tool usage patterns for ${projectName}. Shows common workflows, detected patterns, and recommendations for improving productivity.`,
             schema: z.object({
-                days: z.coerce.number().optional().describe("Number of days to analyze (default: 7)."),
+                days: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Number of days to analyze (default: 7)."),
             }),
             annotations: TOOL_ANNOTATIONS["analyze_usage_patterns"],
             handler: async (args, ctx) => {
@@ -147,7 +152,9 @@ export function createSessionTools(projectName, sharedCtx) {
             schema: z.object({}),
             annotations: TOOL_ANNOTATIONS["get_developer_profile"],
             handler: async (_args, ctx) => {
-                const response = await ctx.api.get(`/api/developer-profile`, { headers: { "X-Project-Name": ctx.projectName } });
+                const response = await ctx.api.get(`/api/developer-profile`, {
+                    headers: { "X-Project-Name": ctx.projectName },
+                });
                 const p = response.data;
                 if (!p.totalToolCalls) {
                     return "No usage data yet. Use tools to build your developer profile.";
@@ -155,22 +162,33 @@ export function createSessionTools(projectName, sharedCtx) {
                 let result = `**Developer Profile** (${p.totalSessions} sessions, ${p.totalToolCalls} tool calls)\n\n`;
                 if (p.frequentFiles.length > 0) {
                     result += "**Frequent Files:**\n";
-                    result += p.frequentFiles.slice(0, 10).map((f) => `- ${f.file} (${f.count}x)`).join("\n");
+                    result += p.frequentFiles
+                        .slice(0, 10)
+                        .map((f) => `- ${f.file} (${f.count}x)`)
+                        .join("\n");
                     result += "\n\n";
                 }
                 if (p.preferredTools.length > 0) {
                     result += "**Preferred Tools:**\n";
-                    result += p.preferredTools.slice(0, 8).map((t) => `- ${t.tool}: ${t.count}x (avg ${Math.round(t.avgDurationMs)}ms)`).join("\n");
+                    result += p.preferredTools
+                        .slice(0, 8)
+                        .map((t) => `- ${t.tool}: ${t.count}x (avg ${Math.round(t.avgDurationMs)}ms)`)
+                        .join("\n");
                     result += "\n\n";
                 }
                 if (p.peakHours.length > 0) {
                     result += "**Peak Hours:** ";
-                    result += p.peakHours.map((h) => `${h.hour}:00 (${h.count})`).join(", ");
+                    result += p.peakHours
+                        .map((h) => `${h.hour}:00 (${h.count})`)
+                        .join(", ");
                     result += "\n\n";
                 }
                 if (p.commonPatterns.length > 0) {
                     result += "**Common Patterns:**\n";
-                    result += p.commonPatterns.slice(0, 5).map((q) => `- "${truncate(q, 60)}"`).join("\n");
+                    result += p.commonPatterns
+                        .slice(0, 5)
+                        .map((q) => `- "${truncate(q, 60)}"`)
+                        .join("\n");
                     result += "\n";
                 }
                 return result;
@@ -180,9 +198,18 @@ export function createSessionTools(projectName, sharedCtx) {
             name: "start_session",
             description: `Start a new working session for ${projectName}. Tracks tool usage, file changes, and learnings throughout the session.`,
             schema: z.object({
-                sessionId: z.string().optional().describe("Custom session ID. If omitted, one will be generated."),
-                initialContext: z.string().optional().describe("Description of what this session is about (e.g., 'fixing auth bug', 'adding new API endpoint')."),
-                resumeFrom: z.string().optional().describe("Session ID to resume from. Carries over context from the previous session."),
+                sessionId: z
+                    .string()
+                    .optional()
+                    .describe("Custom session ID. If omitted, one will be generated."),
+                initialContext: z
+                    .string()
+                    .optional()
+                    .describe("Description of what this session is about (e.g., 'fixing auth bug', 'adding new API endpoint')."),
+                resumeFrom: z
+                    .string()
+                    .optional()
+                    .describe("Session ID to resume from. Carries over context from the previous session."),
             }),
             annotations: TOOL_ANNOTATIONS["start_session"],
             handler: async (args, ctx) => {
@@ -212,9 +239,7 @@ export function createSessionTools(projectName, sharedCtx) {
                 }
                 if (initialFiles && initialFiles.length > 0) {
                     result += `\n**Initial Files:**\n`;
-                    result += initialFiles
-                        .map((f) => `- ${f}`)
-                        .join("\n");
+                    result += initialFiles.map((f) => `- ${f}`).join("\n");
                     result += "\n";
                 }
                 // Include prefetch stats if available
@@ -259,9 +284,7 @@ export function createSessionTools(projectName, sharedCtx) {
                 }
                 if (data.activeFeatures && data.activeFeatures.length > 0) {
                     result += `\n**Active Features:**\n`;
-                    result += data.activeFeatures
-                        .map((f) => `- ${f}`)
-                        .join("\n");
+                    result += data.activeFeatures.map((f) => `- ${f}`).join("\n");
                     result += "\n";
                 }
                 if (data.pendingLearnings && data.pendingLearnings.length > 0) {
@@ -283,9 +306,18 @@ export function createSessionTools(projectName, sharedCtx) {
             description: `End a working session for ${projectName}. Saves a summary and optionally extracts learnings for future sessions.`,
             schema: z.object({
                 sessionId: z.string().describe("Session ID to end."),
-                summary: z.string().optional().describe("Summary of what was accomplished during the session."),
-                autoSaveLearnings: z.boolean().optional().describe("Automatically save detected learnings to memory (default: true)."),
-                feedback: z.string().optional().describe("Optional feedback about the session (e.g., 'productive', 'too many context switches')."),
+                summary: z
+                    .string()
+                    .optional()
+                    .describe("Summary of what was accomplished during the session."),
+                autoSaveLearnings: z
+                    .boolean()
+                    .optional()
+                    .describe("Automatically save detected learnings to memory (default: true)."),
+                feedback: z
+                    .string()
+                    .optional()
+                    .describe("Optional feedback about the session (e.g., 'productive', 'too many context switches')."),
             }),
             annotations: TOOL_ANNOTATIONS["end_session"],
             handler: async (args, ctx) => {

package/dist/tools/suggestions.js

@@ -86,7 +86,10 @@ export function createSuggestionTools(projectName) {
             description: `REQUIRED before code changes. Parallel lookup of recall + search + patterns + ADRs + graph for ${projectName}. One call replaces 5 separate RAG lookups.`,
             schema: z.object({
                 task: z.string().describe("What you will implement/change"),
-                files: z.array(z.string()).optional().describe("Files you plan to modify"),
+                files: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Files you plan to modify"),
             }),
             annotations: TOOL_ANNOTATIONS["context_briefing"],
             handler: async (args, ctx) => {
@@ -176,7 +179,9 @@ export function createSuggestionTools(projectName) {
                 if (patterns.length > 0) {
                     result += `## Patterns (${patterns.length})\n`;
                     for (const p of patterns) {
-                        const name = p.memory?.metadata?.patternName || p.memory?.relatedTo || "Pattern";
+                        const name = p.memory?.metadata?.patternName ||
+                            p.memory?.relatedTo ||
+                            "Pattern";
                         result += `- **${name}**: ${truncate(p.memory?.content || "", 120)}\n`;
                     }
                     result += "\n";
@@ -191,7 +196,9 @@ export function createSuggestionTools(projectName) {
                     result += "\n";
                 }
                 const graphResults = graphRes?.data?.results || graphRes?.data?.directResults || [];
-                const connectedFiles = graphRes?.data?.connectedFiles || graphRes?.data?.expandedResults || [];
+                const connectedFiles = graphRes?.data?.connectedFiles ||
+                    graphRes?.data?.expandedResults ||
+                    [];
                 if (graphResults.length > 0 || connectedFiles.length > 0) {
                     result += `## Dependencies\n`;
                     for (const g of graphResults) {
@@ -203,7 +210,8 @@ export function createSuggestionTools(projectName) {
                     result += "\n";
                 }
                 if (result.endsWith(`# Context Briefing: ${task}\n\n`)) {
-                    result += "_No relevant context found. Proceed with implementation._\n";
+                    result +=
+                        "_No relevant context found. Proceed with implementation._\n";
                 }
                 return result;
             },
@@ -213,8 +221,14 @@ export function createSuggestionTools(projectName) {
             description: `Intelligent task routing for ${projectName}. LLM analyzes your task and runs only the needed lookups (2-5 of 7 available) in parallel. More efficient than context_briefing for narrow tasks.`,
             schema: z.object({
                 task: z.string().describe("What you will implement/change"),
-                files: z.array(z.string()).optional().describe("Files you plan to modify"),
-                intent: z.enum(["code", "research", "debug", "review", "architecture"]).optional().describe("Task intent for better routing"),
+                files: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Files you plan to modify"),
+                intent: z
+                    .enum(["code", "research", "debug", "review", "architecture"])
+                    .optional()
+                    .describe("Task intent for better routing"),
             }),
             annotations: TOOL_ANNOTATIONS["context_briefing"], // Same annotations as context_briefing
             handler: async (args, ctx) => {
@@ -232,9 +246,18 @@ export function createSuggestionTools(projectName) {
             name: "get_contextual_suggestions",
             description: `Get contextual suggestions based on current work context for ${projectName}. Returns relevant suggestions, triggers, and related memories.`,
             schema: z.object({
-                currentFile: z.string().optional().describe("Currently active file path"),
-                currentCode: z.string().optional().describe("Currently selected or visible code"),
-                recentFiles: z.array(z.string()).optional().describe("Recently opened file paths"),
+                currentFile: z
+                    .string()
+                    .optional()
+                    .describe("Currently active file path"),
+                currentCode: z
+                    .string()
+                    .optional()
+                    .describe("Currently selected or visible code"),
+                recentFiles: z
+                    .array(z.string())
+                    .optional()
+                    .describe("Recently opened file paths"),
                 task: z.string().optional().describe("Current task description"),
             }),
             annotations: TOOL_ANNOTATIONS["get_contextual_suggestions"],
@@ -288,13 +311,22 @@ export function createSuggestionTools(projectName) {
             name: "suggest_related_code",
             description: `Find code related to a given file or snippet in ${projectName}. Shows similar implementations and related modules.`,
             schema: z.object({
-                file: z.string().optional().describe("File path to find related code for"),
-                code: z.string().optional().describe("Code snippet to find related code for"),
-                limit: z.coerce.number().optional().describe("Max results (default: 5)"),
+                file: z
+                    .string()
+                    .optional()
+                    .describe("File path to find related code for"),
+                code: z
+                    .string()
+                    .optional()
+                    .describe("Code snippet to find related code for"),
+                limit: z.coerce
+                    .number()
+                    .optional()
+                    .describe("Max results (default: 5)"),
             }),
             annotations: TOOL_ANNOTATIONS["suggest_related_code"],
             handler: async (args, ctx) => {
-                const { file, code, limit = 5 } = args;
+                const { file, code, limit = 5, } = args;
                 const response = await ctx.api.post("/api/code/related", {
                     projectName: ctx.projectName,
                     file,
@@ -315,7 +347,10 @@ export function createSuggestionTools(projectName) {
                         result += ` | Line ${r.line}`;
                     result += "\n";
                     if (r.content || r.code) {
-                        result += "```\n" + truncate(r.content || r.code, PREVIEW.MEDIUM) + "\n```\n";
+                        result +=
+                            "```\n" +
+                                truncate(r.content || r.code, PREVIEW.MEDIUM) +
+                                "\n```\n";
                     }
                     result += "\n";
                 }
@@ -371,7 +406,10 @@ export function createSuggestionTools(projectName) {
             schema: z.object({
                 file: z.string().optional().describe("File to suggest tests for"),
                 code: z.string().optional().describe("Code to suggest tests for"),
-                framework: z.string().optional().describe("Test framework preference (jest, mocha, pytest, etc.)"),
+                framework: z
+                    .string()
+                    .optional()
+                    .describe("Test framework preference (jest, mocha, pytest, etc.)"),
             }),
             annotations: TOOL_ANNOTATIONS["suggest_tests"],
             handler: async (args, ctx) => {
@@ -401,7 +439,8 @@ export function createSuggestionTools(projectName) {
                     if (t.coverage)
                         result += `**Coverage:** ${t.coverage}\n`;
                     if (t.content || t.code) {
-                        result += "```\n" + truncate(t.content || t.code, PREVIEW.LONG) + "\n```\n";
+                        result +=
+                            "```\n" + truncate(t.content || t.code, PREVIEW.LONG) + "\n```\n";
                     }
                     result += "\n";
                 }
@@ -461,10 +500,21 @@ export function createSuggestionTools(projectName) {
             description: "Configure Claude Code for RAG integration. Creates/updates .mcp.json, adds RAG instructions to CLAUDE.md, and configures permissions. Call after index_codebase on a new project.",
             schema: z.object({
                 projectPath: z.string().describe("Absolute path to project root"),
-                projectName: z.string().describe("Project name in Qdrant (collection prefix)"),
-                ragApiUrl: z.string().optional().describe("RAG API URL (default: from MCP env)"),
-                ragApiKey: z.string().optional().describe("RAG API key (default: from MCP env)"),
-                updateClaudeMd: z.boolean().optional().describe("Add RAG section to CLAUDE.md (default: true)"),
+                projectName: z
+                    .string()
+                    .describe("Project name in Qdrant (collection prefix)"),
+                ragApiUrl: z
+                    .string()
+                    .optional()
+                    .describe("RAG API URL (default: from MCP env)"),
+                ragApiKey: z
+                    .string()
+                    .optional()
+                    .describe("RAG API key (default: from MCP env)"),
+                updateClaudeMd: z
+                    .boolean()
+                    .optional()
+                    .describe("Add RAG section to CLAUDE.md (default: true)"),
             }),
             annotations: TOOL_ANNOTATIONS["setup_project"],
             handler: async (args, ctx) => {
@@ -524,7 +574,9 @@ After completing significant changes:
                         changes.push("CLAUDE.md — RAG section already exists, skipped");
                     }
                     else {
-                        claudeMd = claudeMd ? claudeMd.trimEnd() + "\n" + ragSection : `# CLAUDE.md\n${ragSection}`;
+                        claudeMd = claudeMd
+                            ? claudeMd.trimEnd() + "\n" + ragSection
+                            : `# CLAUDE.md\n${ragSection}`;
                         fs.writeFileSync(claudeMdPath, claudeMd);
                         changes.push("CLAUDE.md — added RAG Integration section");
                     }
@@ -563,7 +615,8 @@ After completing significant changes:
                     indexInfo = `\n## Index Status\n- **Vectors:** ${data.vectorCount ?? "N/A"}\n- **Status:** ${data.status || "unknown"}\n`;
                 }
                 catch {
-                    indexInfo = "\n## Index Status\n_Not indexed yet. Run `index_codebase` first._\n";
+                    indexInfo =
+                        "\n## Index Status\n_Not indexed yet. Run `index_codebase` first._\n";
                 }
                 let result = `# Project Setup: ${targetProject}\n\n`;
                 result += `## Files Updated\n`;

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared types for the MCP server tool modules.
  */
-import type { AxiosInstance } from "axios";
+import type { ApiClient } from "./api-client.js";
 import type { z } from "zod";
 import type { ToolAnnotations } from "./annotations.js";
 /** MCP tool input schema shape (raw JSON Schema) */
@@ -19,7 +19,7 @@ export interface ToolDefinition {
 }
 /** Context passed to every tool handler */
 export interface ToolContext {
-    api: AxiosInstance;
+    api: ApiClient;
     projectName: string;
     projectPath: string;
     collectionPrefix: string;