@limeadelabs/clarabit-mcp 2.0.2 → 2.2.0

package/dist/index.js

@@ -99,9 +99,10 @@ var ClarabitClient = class {
   createPage(projectId, title, body) {
     return this.request("POST", `/projects/${projectId}/pages`, { page: { title, body } });
   }
-  updatePage(projectId, pageId, updates, changeSummary) {
+  updatePage(projectId, pageId, updates, changeSummary, verbose) {
     const body = { page: updates };
     if (changeSummary !== void 0) body.change_summary = changeSummary;
+    if (verbose !== void 0) body.verbose = verbose;
     return this.request("PATCH", `/projects/${projectId}/pages/${pageId}`, body);
   }
   listPageVersions(projectId, pageId) {
@@ -130,9 +131,10 @@ var ClarabitClient = class {
   getPageFlat(pageId) {
     return this.request("GET", `/pages/${pageId}`);
   }
-  updatePageFlat(pageId, updates, changeSummary) {
+  updatePageFlat(pageId, updates, changeSummary, verbose) {
     const body = { page: updates };
     if (changeSummary !== void 0) body.change_summary = changeSummary;
+    if (verbose !== void 0) body.verbose = verbose;
     return this.request("PATCH", `/pages/${pageId}`, body);
   }
   listPageVersionsFlat(pageId) {
@@ -159,6 +161,13 @@ var ClarabitClient = class {
       `/projects/${projectId}/pages/${pageId}/comments${query}`
     );
   }
+  listPageCommentsFlat(pageId, opts) {
+    const query = opts?.resolved === void 0 ? "" : `?resolved=${opts.resolved ? "true" : "false"}`;
+    return this.request(
+      "GET",
+      `/pages/${pageId}/comments${query}`
+    );
+  }
   createPageComment(projectId, pageId, body, opts) {
     return this.request(
       "POST",
@@ -207,6 +216,9 @@ var ClarabitClient = class {
   updateContextEntry(identifier, data) {
     return this.request("PATCH", `/contexts/${encodeURIComponent(identifier)}`, data);
   }
+  createContextEntry(data) {
+    return this.request("POST", "/contexts", data);
+  }
   createSession(taskId, agentType, agentId) {
     return this.request("POST", "/sessions", {
       task_id: taskId,
@@ -548,20 +560,21 @@ function registerPageTools(server2, client2) {
   );
   server2.tool(
     "cla_update_page",
-    "Update an existing spec/doc page in a Clarabit project. Every MCP edit creates a new PageVersion (no debounce). Optionally pass change_summary to label the snapshot.",
+    "Update an existing spec/doc page in a Clarabit project. Every MCP edit creates a new PageVersion (no debounce). Optionally pass change_summary to label the snapshot. Returns a minimal confirmation by default (id, title, version_number, change_summary) \u2014 pass verbose: true if you actually need the full body back (rare; the agent typically just sent it).",
     {
       project_id: z7.coerce.number().optional().describe("Project ID (optional \u2014 inferred if omitted)"),
       page_id: z7.coerce.number().describe("Page ID"),
       title: z7.string().optional().describe("New page title (optional)"),
       body: z7.string().optional().describe("New page body in markdown (optional)"),
-      change_summary: z7.string().optional().describe("Short note describing why this edit was made (shown in version history)")
+      change_summary: z7.string().optional().describe("Short note describing why this edit was made (shown in version history)"),
+      verbose: z7.boolean().optional().describe("Return the full page (including body) in the response. Default false \u2014 saves round-trip cost on long pages.")
     },
     async (params) => {
       try {
         const updates = {};
         if (params.title) updates.title = params.title;
         if (params.body) updates.body = params.body;
-        const result = params.project_id ? await client2.updatePage(params.project_id, params.page_id, updates, params.change_summary) : await client2.updatePageFlat(params.page_id, updates, params.change_summary);
+        const result = params.project_id ? await client2.updatePage(params.project_id, params.page_id, updates, params.change_summary, params.verbose) : await client2.updatePageFlat(params.page_id, updates, params.change_summary, params.verbose);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
       } catch (error) {
         return handleError(error, client2.timeoutMs);
@@ -648,6 +661,24 @@ function registerPageTools(server2, client2) {
 // src/tools/page-comments.ts
 import { z as z8 } from "zod";
 function registerPageCommentTools(server2, client2) {
+  server2.tool(
+    "cla_list_page_comments",
+    "List comments on a page. Returns root comments with their threaded replies. Use the resolved filter to focus on open threads (resolved=false) or only the resolved ones (resolved=true). Pass project_id to use the nested route; omit it and the server resolves the page via the api key\u2019s accessible_pages scope.",
+    {
+      page_id: z8.coerce.number().describe("Page ID to list comments for"),
+      project_id: z8.coerce.number().optional().describe("Project ID (optional \u2014 omit to use the flat route)"),
+      resolved: z8.boolean().optional().describe("Filter: true returns only resolved comments, false returns only unresolved")
+    },
+    async (params) => {
+      try {
+        const opts = params.resolved === void 0 ? void 0 : { resolved: params.resolved };
+        const result = params.project_id === void 0 ? await client2.listPageCommentsFlat(params.page_id, opts) : await client2.listPageComments(params.project_id, params.page_id, opts);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (error) {
+        return handleError(error, client2.timeoutMs);
+      }
+    }
+  );
   server2.tool(
     "cla_create_page_comment",
     "Post a comment on a page. Optionally thread under another comment via parent_comment_id, or anchor to a text selection via anchor_text/anchor_start/anchor_end.",
@@ -799,6 +830,26 @@ function registerContextTools(server2, client2) {
       }
     }
   );
+  server2.tool(
+    "cla_context_create",
+    "Create a new context entry. Required: name, entry_type, content. Optional: project_id (scope to project), workspace_id (when API key is not workspace-scoped), change_summary (initial commit message). Returns the new entry with id + slug.",
+    {
+      name: z9.string().describe("Display name of the entry"),
+      entry_type: z9.string().describe('Entry type (e.g., "instructions", "conventions", "architecture", "reference")'),
+      content: z9.string().describe("Initial markdown content"),
+      change_summary: z9.string().optional().describe("Initial commit message (defaults to a generic message if omitted)"),
+      project_id: z9.coerce.number().optional().describe("Scope entry to a project (omit for workspace-level)"),
+      workspace_id: z9.coerce.number().optional().describe("Workspace ID (only needed when API key is not workspace-scoped)")
+    },
+    async (params) => {
+      try {
+        const result = await client2.createContextEntry(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (error) {
+        return handleError(error, client2.timeoutMs);
+      }
+    }
+  );
   server2.tool(
     "cla_context_update",
     "Update a context entry's content (requires write access)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limeadelabs/clarabit-mcp",
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "Clarabit MCP server for Claude Code — AI-native project management integration",
   "type": "module",
   "exports": {