@ourroadmaps/mcp 0.27.0 → 0.28.1

package/dist/index.js

@@ -527,7 +527,8 @@ var SLIDE_TYPES = [
   "quote",
   "code",
   "thank_you",
-  "mermaid"
+  "mermaid",
+  "paragraph"
 ];
 var slideTypeSchema = z12.enum(SLIDE_TYPES);
 var titleContentSchema = z12.object({
@@ -586,6 +587,10 @@ var mermaidContentSchema = z12.object({
   title: z12.string().optional(),
   code: z12.string().default("")
 });
+var paragraphContentSchema = z12.object({
+  title: z12.string().optional(),
+  body: z12.string().default("")
+});
 var typedSlideContentSchema = z12.discriminatedUnion("type", [
   z12.object({ type: z12.literal("title"), ...titleContentSchema.shape }),
   z12.object({ type: z12.literal("section_header"), ...sectionHeaderContentSchema.shape }),
@@ -597,7 +602,8 @@ var typedSlideContentSchema = z12.discriminatedUnion("type", [
   z12.object({ type: z12.literal("quote"), ...quoteContentSchema.shape }),
   z12.object({ type: z12.literal("code"), ...codeContentSchema.shape }),
   z12.object({ type: z12.literal("thank_you"), ...thankYouContentSchema.shape }),
-  z12.object({ type: z12.literal("mermaid"), ...mermaidContentSchema.shape })
+  z12.object({ type: z12.literal("mermaid"), ...mermaidContentSchema.shape }),
+  z12.object({ type: z12.literal("paragraph"), ...paragraphContentSchema.shape })
 ]);
 var slideContentSchema = z12.object({
   body: z12.string().optional()
@@ -1131,6 +1137,10 @@ class ApiClient {
     });
     return response.data;
   }
+  async getWorkflows() {
+    const response = await this.request("/v1/workflows");
+    return response.data;
+  }
   async updateReleaseDescription(roadmapId, description) {
     const response = await this.request(`/v1/releases/roadmaps/${roadmapId}/release`, {
       method: "PATCH",
@@ -1152,6 +1162,10 @@ class ApiClient {
     });
     return response.data;
   }
+  async listPrototypes(roadmapId) {
+    const response = await this.request(`/v1/roadmaps/${roadmapId}/prototypes`);
+    return response.data;
+  }
   async uploadFile(uploadUrl, content, contentType) {
     const response = await fetch(uploadUrl, {
       method: "PUT",
@@ -1314,6 +1328,28 @@ class ApiClient {
     });
     return response.data;
   }
+  async createFeedbackSession(prototypeId, data) {
+    const response = await this.request(`/v1/prototypes/${prototypeId}/feedback/sessions`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+    return response.data;
+  }
+  async listFeedbackSessions(prototypeId) {
+    const response = await this.request(`/v1/prototypes/${prototypeId}/feedback/sessions`);
+    return response.data;
+  }
+  async getFeedbackComments(prototypeId, sessionId, filter) {
+    const params = filter && filter !== "all" ? `?filter=${filter}` : "";
+    const response = await this.request(`/v1/prototypes/${prototypeId}/feedback/sessions/${sessionId}/comments${params}`);
+    return response.data;
+  }
+  async resolveFeedbackComment(prototypeId, sessionId, commentId) {
+    const response = await this.request(`/v1/prototypes/${prototypeId}/feedback/sessions/${sessionId}/comments/${commentId}/resolve`, {
+      method: "PATCH"
+    });
+    return response.data;
+  }
   async getVariantPresentationId(variantId) {
     const presentations = await this.listPresentations();
     for (const presentation2 of presentations.items) {
@@ -1409,6 +1445,12 @@ function registerAllTools(server) {
   registerUploadDesignWalkthrough(server);
   registerUploadReleaseWalkthrough(server);
   registerPublishPrototype(server);
+  registerListPrototypes(server);
+  registerCreateFeedbackSession(server);
+  registerListFeedbackSessions(server);
+  registerGetFeedbackSummary(server);
+  registerGetFeedbackDetail(server);
+  registerResolveFeedbackComment(server);
   registerSearchExports(server);
   registerGetExport(server);
   registerCreateExport(server);
@@ -1442,7 +1484,7 @@ function registerGetWorkflows(server) {
     inputSchema: {}
   }, async () => {
     const client2 = getApiClient();
-    const response = await client2.get("/v1/workflows");
+    const response = await client2.getWorkflows();
     return {
       content: [
         {
@@ -3537,6 +3579,8 @@ function registerPublishPrototype(server) {
           type: "text",
           text: `Published ${uploaded} files!
 
+Prototype ID: ${prototype.id}
+
 Share this link:
 ${prototype.publicUrl}
 
@@ -3546,6 +3590,54 @@ Expires: ${expiryDate}`
     };
   });
 }
+function registerListPrototypes(server) {
+  server.registerTool("list_prototypes", {
+    description: "List published prototypes for a roadmap item. Returns prototype IDs needed for creating feedback sessions.",
+    inputSchema: {
+      roadmapId: z15.string().uuid().describe("The UUID of the roadmap item")
+    }
+  }, async ({ roadmapId }) => {
+    const client2 = getApiClient();
+    const prototypes = await client2.listPrototypes(roadmapId);
+    if (prototypes.length === 0) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "No prototypes found for this roadmap item."
+          }
+        ]
+      };
+    }
+    const lines = prototypes.map((p) => {
+      const expiryDate = new Date(p.expiresAt).toLocaleDateString("en-US", {
+        month: "long",
+        day: "numeric",
+        year: "numeric"
+      });
+      const createdDate = new Date(p.createdAt).toLocaleDateString("en-US", {
+        month: "long",
+        day: "numeric",
+        year: "numeric"
+      });
+      return `ID: ${p.id}
+URL: ${p.publicUrl}
+Files: ${p.fileCount} | Created: ${createdDate} | Expires: ${expiryDate}`;
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Found ${prototypes.length} prototype(s):
+
+${lines.join(`
+
+`)}`
+        }
+      ]
+    };
+  });
+}
 var dateGranularitySchema2 = z15.enum(["day", "month", "quarter", "half-year", "year"]);
 function registerSearchInitiatives(server) {
   server.registerTool("search_initiatives", {
@@ -4313,7 +4405,7 @@ function registerGetSlide(server) {
 }
 function registerCreateSlide(server) {
   server.registerTool("create_slide", {
-    description: "Create a new slide in a variant. Slide types: title (title + subtitle), section_header (title + subtitle), bullets (title + items array), two_column (title + left/right text), comparison (leftLabel + leftContent + rightLabel + rightContent), timeline (title + steps array of {title, description}), image (title + imageUrl + caption), quote (quote + attribution), code (title + code + language), thank_you (title + subtitle), mermaid (title + code with mermaid diagram syntax).",
+    description: "Create a new slide in a variant. Slide types: title (title + subtitle), section_header (title + subtitle), bullets (title + items array), two_column (title + left/right text), comparison (leftLabel + leftContent + rightLabel + rightContent), timeline (title + steps array of {title, description}), image (title + imageUrl + caption), quote (quote + attribution), code (title + code + language), thank_you (title + subtitle), mermaid (title + code with mermaid diagram syntax), paragraph (title + body with markdown text).",
     inputSchema: {
       variantId: z15.string().describe("The UUID of the variant"),
       slideType: z15.enum([
@@ -4327,9 +4419,10 @@ function registerCreateSlide(server) {
         "quote",
         "code",
         "thank_you",
-        "mermaid"
+        "mermaid",
+        "paragraph"
       ]).default("bullets").describe("The type of slide to create"),
-      content: z15.record(z15.unknown()).optional().describe('Type-specific content object. For bullets: {title, items: ["..."]}. For title: {title, subtitle}. For two_column: {title, left, right}. For quote: {quote, attribution}. For mermaid: {title, code: "graph TD; A-->B"}. Etc.'),
+      content: z15.record(z15.unknown()).optional().describe('Type-specific content object. For bullets: {title, items: ["..."]}. For title: {title, subtitle}. For two_column: {title, left, right}. For quote: {quote, attribution}. For mermaid: {title, code: "graph TD; A-->B"}. For paragraph: {title, body}. Etc.'),
       speakerNotes: z15.string().nullable().optional().describe("Speaker notes for the slide")
     }
   }, async ({
@@ -4556,6 +4649,230 @@ function registerUploadSlideImage(server) {
     };
   });
 }
+function registerCreateFeedbackSession(server) {
+  server.registerTool("create_feedback_session", {
+    description: "Create a feedback session for a prototype and get a shareable review link. Reviewers who open the link can optionally enter their name before leaving pin-based feedback.",
+    inputSchema: {
+      prototypeId: z15.string().uuid().describe("The UUID of the prototype to create a feedback session for"),
+      name: z15.string().describe('Name for this feedback session (e.g., "Round 1 Review")'),
+      expiresInDays: z15.number().int().min(1).max(90).optional().describe("Number of days until the session expires (default 7)")
+    }
+  }, async ({
+    prototypeId,
+    name,
+    expiresInDays
+  }) => {
+    const client2 = getApiClient();
+    const days = expiresInDays ?? 7;
+    const expiresAt = new Date(Date.now() + days * 24 * 60 * 60 * 1000).toISOString();
+    const session = await client2.createFeedbackSession(prototypeId, {
+      name,
+      expiresAt,
+      reviewers: [{}]
+    });
+    const invite = session.invites[0];
+    if (!invite) {
+      return {
+        content: [{ type: "text", text: "Error: No invite was created for the session." }]
+      };
+    }
+    const reviewUrl = `https://app.ourroadmaps.com/prototype-review/${invite.token}`;
+    const expiryDate = new Date(session.expiresAt).toLocaleDateString("en-US", {
+      weekday: "long",
+      year: "numeric",
+      month: "long",
+      day: "numeric"
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            sessionId: session.id,
+            sessionName: session.name,
+            reviewUrl,
+            expiresAt: session.expiresAt,
+            expiryDate
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerListFeedbackSessions(server) {
+  server.registerTool("list_feedback_sessions", {
+    description: "List all feedback sessions for a prototype with comment counts and status.",
+    inputSchema: {
+      prototypeId: z15.string().uuid().describe("The UUID of the prototype")
+    }
+  }, async ({ prototypeId }) => {
+    const client2 = getApiClient();
+    const sessions = await client2.listFeedbackSessions(prototypeId);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            sessions: sessions.map((s) => ({
+              id: s.id,
+              name: s.name,
+              status: s.status,
+              totalComments: s.totalComments,
+              unresolvedComments: s.unresolvedComments,
+              inviteCount: s.inviteCount,
+              expiresAt: s.expiresAt,
+              createdAt: s.createdAt
+            }))
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function formatElementDesc(pinData) {
+  if (!pinData || typeof pinData !== "object")
+    return "";
+  const pd = pinData;
+  const el = pd.element;
+  if (!el)
+    return "";
+  const tag = el.tag || "";
+  const text = el.text ? ` "${String(el.text).slice(0, 80)}"` : "";
+  return ` → <${tag}>${text}`;
+}
+function formatCommentLine(c) {
+  const pin = c.pinNumber != null ? `Pin #${c.pinNumber}` : "General";
+  const status = c.resolved ? "[RESOLVED]" : "[OPEN]";
+  const reviewer = c.reviewerName || "Anonymous";
+  const elementDesc = formatElementDesc(c.pinData);
+  return `- **${pin}** ${status} by ${reviewer}${elementDesc}
+  ${c.commentText}
+
+`;
+}
+function registerGetFeedbackSummary(server) {
+  server.registerTool("get_feedback_summary", {
+    description: "Get a human-readable summary of feedback for a session, grouped by page. Shows pin numbers, reviewer names, comment text, and which element was pinned. Use this for a quick overview of feedback.",
+    inputSchema: {
+      prototypeId: z15.string().uuid().describe("The UUID of the prototype"),
+      sessionId: z15.string().uuid().describe("The UUID of the feedback session"),
+      filter: z15.enum(["all", "unresolved", "resolved"]).optional().describe("Filter comments by resolved status (default: unresolved)")
+    }
+  }, async ({
+    prototypeId,
+    sessionId,
+    filter
+  }) => {
+    const client2 = getApiClient();
+    const comments = await client2.getFeedbackComments(prototypeId, sessionId, filter ?? "unresolved");
+    if (comments.length === 0) {
+      return {
+        content: [{ type: "text", text: "No comments found matching the filter." }]
+      };
+    }
+    const byPage = new Map;
+    for (const c of comments) {
+      const page = c.pageUrl || "(no page)";
+      if (!byPage.has(page))
+        byPage.set(page, []);
+      byPage.get(page).push(c);
+    }
+    let summary = `## Feedback Summary (${comments.length} comment${comments.length !== 1 ? "s" : ""})
+
+`;
+    for (const [page, pageComments] of byPage) {
+      summary += `### Page: ${page}
+
+`;
+      for (const c of pageComments) {
+        summary += formatCommentLine(c);
+      }
+    }
+    return {
+      content: [{ type: "text", text: summary.trim() }]
+    };
+  });
+}
+function registerGetFeedbackDetail(server) {
+  server.registerTool("get_feedback_detail", {
+    description: "Get full raw pin data for feedback comments, including CSS selectors, bounding boxes, parent/sibling DOM context, and coordinates. Use this when you need exact element information to make targeted code changes.",
+    inputSchema: {
+      prototypeId: z15.string().uuid().describe("The UUID of the prototype"),
+      sessionId: z15.string().uuid().describe("The UUID of the feedback session"),
+      commentId: z15.string().uuid().optional().describe("Optional: get detail for a single comment"),
+      filter: z15.enum(["all", "unresolved", "resolved"]).optional().describe("Filter comments by resolved status (default: all). Ignored if commentId is provided.")
+    }
+  }, async ({
+    prototypeId,
+    sessionId,
+    commentId,
+    filter
+  }) => {
+    const client2 = getApiClient();
+    const comments = await client2.getFeedbackComments(prototypeId, sessionId, filter ?? "all");
+    let filtered = comments;
+    if (commentId) {
+      filtered = comments.filter((c) => c.id === commentId);
+      if (filtered.length === 0) {
+        return {
+          content: [
+            { type: "text", text: `Comment ${commentId} not found in this session.` }
+          ]
+        };
+      }
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            comments: filtered.map((c) => ({
+              id: c.id,
+              pinNumber: c.pinNumber,
+              reviewerName: c.reviewerName,
+              commentText: c.commentText,
+              pageUrl: c.pageUrl,
+              resolved: c.resolved,
+              pinData: c.pinData,
+              createdAt: c.createdAt
+            }))
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerResolveFeedbackComment(server) {
+  server.registerTool("resolve_feedback_comment", {
+    description: "Toggle the resolved status on a feedback comment. If currently unresolved, marks it as resolved. If already resolved, marks it as unresolved.",
+    inputSchema: {
+      prototypeId: z15.string().uuid().describe("The UUID of the prototype"),
+      sessionId: z15.string().uuid().describe("The UUID of the feedback session"),
+      commentId: z15.string().uuid().describe("The UUID of the comment to resolve/unresolve")
+    }
+  }, async ({
+    prototypeId,
+    sessionId,
+    commentId
+  }) => {
+    const client2 = getApiClient();
+    const result = await client2.resolveFeedbackComment(prototypeId, sessionId, commentId);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            commentId: result.id,
+            resolved: result.resolved,
+            resolvedAt: result.resolvedAt
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
 
 // src/index.ts
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ourroadmaps/mcp",
-  "version": "0.27.0",
+  "version": "0.28.1",
   "description": "MCP server for OurRoadmaps - manage roadmaps, features, and ideas from Claude Code",
   "type": "module",
   "bin": {