@chapterai/mcp 0.1.1 → 0.1.2

package/dist/index.js

@@ -22439,6 +22439,29 @@ var api = {
       return getClient().workspaces.getWorkspaceStats.query(input);
     }
   },
+  intelligence: {
+    scan(input) {
+      return getClient().intelligence.scan.mutate(input);
+    },
+    query(input) {
+      return getClient().intelligence.query.query(input);
+    },
+    findSymbol(input) {
+      return getClient().intelligence.findSymbol.query(input);
+    },
+    findCopy(input) {
+      return getClient().intelligence.findCopy.query(input);
+    },
+    contextForTask(input) {
+      return getClient().intelligence.contextForTask.query(input);
+    },
+    fileMap(input) {
+      return getClient().intelligence.fileMap.query(input);
+    },
+    deps(input) {
+      return getClient().intelligence.deps.query(input);
+    }
+  },
   sessions: {
     list(input) {
       return getClient().sessions.list.query(input);
@@ -23539,6 +23562,233 @@ ${lines.join("\n")}`);
   );
 }
 
+// src/tools/intelligence.ts
+function registerIntelligenceTools(server2) {
+  server2.tool(
+    "scan_codebase",
+    "Scan and index a codebase to build a structured map of all files, symbols, routes, endpoints, models, and copy. Run this once per workspace to enable fast lookups. Accepts an optional projectPath for local directories.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      projectPath: external_exports.string().optional().describe("Local filesystem path to scan (overrides workspace path)")
+    },
+    async ({ workspaceId, workspaceName, projectPath }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.scan({
+          workspaceId: id,
+          projectPath
+        });
+        const lines = [
+          `Codebase scanned in ${result.stats.durationMs}ms`,
+          ``,
+          `Files: ${result.fileCount}`,
+          `Symbols: ${result.symbolCount}`,
+          `Routes: ${result.routeCount}`,
+          `API endpoints: ${result.endpointCount}`,
+          `DB models: ${result.modelCount}`,
+          `Copy entries: ${result.copyCount}`,
+          `Dependencies: ${result.dependencyCount}`,
+          ``,
+          `Tech stack:`,
+          `  Languages: ${result.techStack.languages.join(", ")}`,
+          `  Frameworks: ${result.techStack.frameworks.join(", ")}`,
+          `  Databases: ${result.techStack.databases.join(", ")}`,
+          `  Package manager: ${result.techStack.packageManager ?? "unknown"}`
+        ];
+        return success(lines.join("\n"));
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  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).",
+    {
+      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)")
+    },
+    async ({ workspaceId, workspaceName, query, limit }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.query({ workspaceId: id, query, limit });
+        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}`);
+          }
+        }
+        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}`);
+          }
+        }
+        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}`);
+          }
+        }
+        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}\``);
+          }
+        }
+        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}\``);
+          }
+        }
+        if (sections.length === 0) {
+          return success(`No results found for "${query}". Try different keywords or run scan_codebase first.`);
+        }
+        return success(sections.join("\n"));
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "find_symbol",
+    "Find a specific function, class, component, type, or other symbol by name. Returns exact file path and line number.",
+    {
+      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")
+    },
+    async ({ workspaceId, workspaceName, name, kind }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const results = await api.intelligence.findSymbol({ workspaceId: id, name, kind });
+        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 success(`Found ${results.length} match(es):
+${lines.join("\n")}`);
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  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.",
+    {
+      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"')
+    },
+    async ({ workspaceId, workspaceName, text }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const results = await api.intelligence.findCopy({ workspaceId: id, text });
+        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})`
+        );
+        return success(`Found ${results.length} match(es):
+${lines.join("\n")}`);
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "get_codebase_context",
+    "Generate a structured context block for a task description. Returns relevant files, symbols, copy, routes, and endpoints that an agent should know about before starting work. This is the key tool for speeding up agent sessions \u2014 call it at the start of any task.",
+    {
+      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"')
+    },
+    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_file_map",
+    "Get a compact map of every file in the codebase with its category and key exports. Useful for understanding project structure at a glance.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)")
+    },
+    async ({ workspaceId, workspaceName }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.fileMap({ workspaceId: id });
+        const lines = [
+          `# File Map (${Object.keys(result.tree).length} files)`,
+          `Tech stack: ${result.techStack.frameworks.join(", ")} | ${result.techStack.languages.join(", ")}`,
+          ""
+        ];
+        for (const [path3, desc] of Object.entries(result.tree)) {
+          lines.push(`${path3} \u2014 ${desc}`);
+        }
+        return success(lines.join("\n"));
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "get_file_deps",
+    "Get the dependency graph for a specific file \u2014 what it imports (dependencies) or what imports it (dependents).",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      filePath: external_exports.string().describe('Relative file path \u2014 e.g. "src/components/task-card.tsx"'),
+      direction: external_exports.enum(["dependents", "dependencies"]).optional().describe('Direction: "dependents" (what imports this file) or "dependencies" (what this file imports). Default: dependents')
+    },
+    async ({ workspaceId, workspaceName, filePath, direction }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.deps({
+          workspaceId: id,
+          filePath,
+          direction
+        });
+        const label = direction === "dependencies" ? "depends on" : "is imported by";
+        if (result.files.length === 0) {
+          return success(`\`${filePath}\` ${label} no other files`);
+        }
+        const lines = [`\`${filePath}\` ${label}:`];
+        for (const f of result.files) {
+          lines.push(`  - \`${f}\``);
+        }
+        return success(lines.join("\n"));
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+}
+
 // src/tools/index.ts
 function registerAllTools(server2) {
   registerWorkspaceTools(server2);
@@ -23549,6 +23799,7 @@ function registerAllTools(server2) {
   registerSearchTools(server2);
   registerTaskTools(server2);
   registerActivityTools(server2);
+  registerIntelligenceTools(server2);
 }
 
 // src/index.ts

package/package.json

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