@chapterai/mcp 0.1.4 → 0.1.7

package/dist/index.js

@@ -23567,6 +23567,15 @@ ${lines.join("\n")}`);
 }
 
 // src/tools/intelligence.ts
+function renderSnippet(snippet) {
+  if (!snippet) return "";
+  const padWidth = Math.max(4, String(snippet.endLine).length);
+  const body = snippet.lines.map((line, i) => `${String(snippet.startLine + i).padStart(padWidth, " ")} | ${line}`).join("\n");
+  return `
+\`\`\`
+${body}
+\`\`\``;
+}
 function registerIntelligenceTools(server2) {
   server2.tool(
     "scan_codebase",
@@ -23608,48 +23617,49 @@ function registerIntelligenceTools(server2) {
   );
   server2.tool(
     "query_codebase",
-    "Search the codebase index for files, symbols, routes, endpoints, and copy matching a query. Returns ranked results with file paths and line numbers. The index must exist (run scan_codebase first).",
+    "Search the codebase index for files, symbols, routes, endpoints, and copy matching a query. Returns ranked results with file paths, line numbers, and inline source snippets so you usually don't need a follow-up read_file call.",
     {
       workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
       workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
       query: external_exports.string().describe('Search query \u2014 e.g. "task creation", "auth middleware", "welcome page"'),
-      limit: external_exports.number().optional().describe("Max results per category (default 20)")
+      limit: external_exports.number().optional().describe("Max results per category (default 20)"),
+      contextLines: external_exports.number().int().min(0).max(20).default(6).describe("Lines of source to include around each hit. 0 disables snippets.")
     },
-    async ({ workspaceId, workspaceName, query, limit }) => {
+    async ({ workspaceId, workspaceName, query, limit, contextLines }) => {
       try {
         const id = await resolveWorkspaceId(workspaceId, workspaceName);
-        const result = await api.intelligence.query({ workspaceId: id, query, limit });
+        const result = await api.intelligence.query({ workspaceId: id, query, limit, contextLines });
         const sections = [];
         if (result.files.length > 0) {
           sections.push("## Files");
           for (const f of result.files) {
             const exports = f.exports.length > 0 ? ` (exports: ${f.exports.slice(0, 3).join(", ")})` : "";
-            sections.push(`- \`${f.path}\` [${f.category}]${exports}`);
+            sections.push(`- \`${f.path}\` [${f.category}]${exports}${renderSnippet(f.snippet)}`);
           }
         }
         if (result.symbols.length > 0) {
           sections.push("\n## Symbols");
           for (const s of result.symbols) {
             const sig = s.signature ? ` \u2014 \`${s.signature}\`` : "";
-            sections.push(`- \`${s.name}\` (${s.kind}) at \`${s.filePath}:${s.line}\`${sig}`);
+            sections.push(`- \`${s.name}\` (${s.kind}) at \`${s.filePath}:${s.line}\`${sig}${renderSnippet(s.snippet)}`);
           }
         }
         if (result.copy.length > 0) {
           sections.push("\n## Copy/Text");
           for (const c of result.copy) {
-            sections.push(`- "${c.text}" at \`${c.filePath}:${c.line}\` in ${c.context}`);
+            sections.push(`- "${c.text}" at \`${c.filePath}:${c.line}\` in ${c.context}${renderSnippet(c.snippet)}`);
           }
         }
         if (result.routes.length > 0) {
           sections.push("\n## Routes");
           for (const r of result.routes) {
-            sections.push(`- ${r.method ?? "ANY"} \`${r.path}\` \u2192 ${r.handler} at \`${r.filePath}:${r.line}\``);
+            sections.push(`- ${r.method ?? "ANY"} \`${r.path}\` \u2192 ${r.handler} at \`${r.filePath}:${r.line}\`${renderSnippet(r.snippet)}`);
           }
         }
         if (result.endpoints.length > 0) {
           sections.push("\n## API Endpoints");
           for (const e of result.endpoints) {
-            sections.push(`- \`${e.router ? e.router + "." : ""}${e.name}\` (${e.type}) at \`${e.filePath}:${e.line}\``);
+            sections.push(`- \`${e.router ? e.router + "." : ""}${e.name}\` (${e.type}) at \`${e.filePath}:${e.line}\`${renderSnippet(e.snippet)}`);
           }
         }
         if (sections.length === 0) {
@@ -23663,24 +23673,30 @@ function registerIntelligenceTools(server2) {
   );
   server2.tool(
     "find_symbol",
-    "Find a specific function, class, component, type, or other symbol by name. Returns exact file path and line number.",
+    "Find a specific function, class, component, type, or other symbol by name. Returns exact file path, line number, and an inline source snippet so the symbol body is right there.",
     {
       workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
       workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
       name: external_exports.string().describe('Symbol name to search for \u2014 e.g. "TaskCreateInline", "authorizeWorkspaceAccess"'),
-      kind: external_exports.string().optional().describe("Filter by kind: function, class, component, type, interface, enum, hook, struct, method")
+      kind: external_exports.string().optional().describe("Filter by kind: function, class, component, type, interface, enum, hook, struct, method"),
+      contextLines: external_exports.number().int().min(0).max(20).default(8).describe("Lines of source to include around each hit. 0 disables snippets.")
     },
-    async ({ workspaceId, workspaceName, name, kind }) => {
+    async ({ workspaceId, workspaceName, name, kind, contextLines }) => {
       try {
         const id = await resolveWorkspaceId(workspaceId, workspaceName);
-        const results = await api.intelligence.findSymbol({ workspaceId: id, name, kind });
+        const results = await api.intelligence.findSymbol({
+          workspaceId: id,
+          name,
+          kind,
+          contextLines
+        });
         if (results.length === 0) {
           return success(`No symbol found matching "${name}"${kind ? ` (kind: ${kind})` : ""}`);
         }
         const lines = results.map((s) => {
           const sig = s.signature ? `
     ${s.signature}` : "";
-          return `- \`${s.name}\` (${s.kind}) at \`${s.filePath}:${s.line}\`${s.exported ? " [exported]" : ""}${sig}`;
+          return `- \`${s.name}\` (${s.kind}) at \`${s.filePath}:${s.line}\`${s.exported ? " [exported]" : ""}${sig}${renderSnippet(s.snippet)}`;
         });
         return success(`Found ${results.length} match(es):
 ${lines.join("\n")}`);
@@ -23691,21 +23707,26 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "find_copy",
-    "Find user-facing text/copy in the codebase by content. Returns the file path, line number, and surrounding component context. Use this to quickly locate where a specific string appears in the UI.",
+    "Find user-facing text/copy in the codebase by content. Returns the file path, line number, surrounding component context, and an inline JSX/template snippet.",
     {
       workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
       workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
-      text: external_exports.string().describe('Text to search for \u2014 e.g. "Welcome to Chapter", "Sign in", "No tasks yet"')
+      text: external_exports.string().describe('Text to search for \u2014 e.g. "Welcome to Chapter", "Sign in", "No tasks yet"'),
+      contextLines: external_exports.number().int().min(0).max(20).default(4).describe("Lines of source to include around each hit. 0 disables snippets.")
     },
-    async ({ workspaceId, workspaceName, text }) => {
+    async ({ workspaceId, workspaceName, text, contextLines }) => {
       try {
         const id = await resolveWorkspaceId(workspaceId, workspaceName);
-        const results = await api.intelligence.findCopy({ workspaceId: id, text });
+        const results = await api.intelligence.findCopy({
+          workspaceId: id,
+          text,
+          contextLines
+        });
         if (results.length === 0) {
           return success(`No copy found matching "${text}"`);
         }
         const lines = results.map(
-          (c) => `- "${c.text}" at \`${c.filePath}:${c.line}\` in \`${c.context}\` (${c.type})`
+          (c) => `- "${c.text}" at \`${c.filePath}:${c.line}\` in \`${c.context}\` (${c.type})${renderSnippet(c.snippet)}`
         );
         return success(`Found ${results.length} match(es):
 ${lines.join("\n")}`);
@@ -23714,15 +23735,37 @@ ${lines.join("\n")}`);
       }
     }
   );
+  server2.tool(
+    "answer_about_codebase",
+    'Ask a question about the codebase and get a complete, cited answer in one call. Reads the most relevant ~8 files server-side and returns a synthesized markdown answer with inline path:line citations on every concrete claim. ASK FIRST for any "how does X work", "where is X created/used across the codebase", or "walk me through the flow from A to B" question \u2014 this replaces the typical query_codebase + 4-6 read_file slices loop with a single round trip. Only fall back to read_file when you need verbatim code beyond what the answer cites.',
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      taskDescription: external_exports.string().describe('Question or task \u2014 e.g. "how does the permission system work?", "where is sessionEnded emitted across the codebase?", "walk me through what happens when a user clicks Apply Changes"')
+    },
+    async ({ workspaceId, workspaceName, taskDescription }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.contextForTask({
+          workspaceId: id,
+          taskDescription
+        });
+        return success(result.context);
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
   server2.tool(
     "get_codebase_context",
-    "Ask a question about the codebase or describe a task \u2014 returns an AI-synthesized answer with specific file paths, function names, and implementation details. The answer is ready to use: start working immediately based on it. Only read files if you need to see exact code not covered in the answer.",
+    "(deprecated alias for answer_about_codebase) Ask a question about the codebase and get a cited answer. This name will be removed in 0.3.0; switch your callsites to answer_about_codebase.",
     {
       workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
       workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
-      taskDescription: external_exports.string().describe('Question or task description \u2014 e.g. "how does the permission system work?" or "change the welcome message on the home page"')
+      taskDescription: external_exports.string().describe("Question or task description")
     },
     async ({ workspaceId, workspaceName, taskDescription }) => {
+      console.error("get_codebase_context is deprecated; use answer_about_codebase");
       try {
         const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const result = await api.intelligence.contextForTask({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chapterai/mcp",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "Chapter MCP server — gives AI agents access to Chapter projects, files, changes, and history",
   "type": "module",
   "bin": {