@chapterai/mcp 0.1.3 → 0.1.5

package/dist/index.js

@@ -22749,20 +22749,24 @@ function registerFileTools(server2) {
   );
   server2.tool(
     "read_file",
-    "Read the content of a file in a workspace",
+    "Read the content of a file in a workspace. Use offset/limit to read a slice of a large file instead of the whole thing.",
     {
       workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
       workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       path: external_exports.string().describe("File path to read"),
-      ref: external_exports.string().optional().describe("Git ref (branch, tag, or commit SHA)")
+      ref: external_exports.string().optional().describe("Git ref (branch, tag, or commit SHA)"),
+      offset: external_exports.number().int().min(1).optional().describe("1-indexed line number to start reading from (omit to read from line 1)"),
+      limit: external_exports.number().int().min(1).optional().describe("Maximum number of lines to return (omit to read to end of file)")
     },
-    async ({ workspaceId, workspaceName, path: path3, ref }) => {
+    async ({ workspaceId, workspaceName, path: path3, ref, offset, limit }) => {
       try {
         const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const result = await api.workspaces.readFile({
           workspaceId: id,
           path: path3,
-          ref
+          ref,
+          offset,
+          limit
         });
         return success(result.content);
       } catch (error2) {
@@ -23563,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",
@@ -23604,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) {
@@ -23659,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")}`);
@@ -23687,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")}`);
@@ -23712,11 +23737,11 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "get_codebase_context",
-    "Get relevant source code and structure for a task. Returns matching files, symbols, endpoints, AND the actual source code of the top matching files. Use the returned content to answer questions or start work directly \u2014 only read additional files if you need more detail on a specific aspect, but do not repeat the search.",
+    "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.",
     {
       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('Description of the task \u2014 e.g. "change the welcome message on the home page"')
+      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"')
     },
     async ({ workspaceId, workspaceName, taskDescription }) => {
       try {

package/package.json

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