@ourroadmaps/mcp 0.30.1 → 0.31.0

package/dist/index.js

@@ -776,13 +776,8 @@ var SLIDE_TYPES = [
   "title",
   "section_header",
   "bullets",
-  "two_column",
-  "comparison",
-  "timeline",
   "image",
-  "quote",
   "code",
-  "thank_you",
   "mermaid",
   "paragraph"
 ];
@@ -799,46 +794,17 @@ var bulletsContentSchema = z13.object({
   title: z13.string().optional(),
   items: z13.array(z13.string()).default([])
 });
-var twoColumnContentSchema = z13.object({
-  title: z13.string().optional(),
-  left: z13.string().default(""),
-  right: z13.string().default("")
-});
-var comparisonContentSchema = z13.object({
-  leftLabel: z13.string().default(""),
-  leftContent: z13.string().default(""),
-  rightLabel: z13.string().default(""),
-  rightContent: z13.string().default("")
-});
-var timelineStepSchema = z13.object({
-  title: z13.string(),
-  description: z13.string().optional()
-});
-var timelineContentSchema = z13.object({
-  title: z13.string().optional(),
-  steps: z13.array(timelineStepSchema).default([])
-});
 var imageContentSchema = z13.object({
   title: z13.string().optional(),
   imageUrl: z13.string().optional(),
   caption: z13.string().optional()
 });
-var quoteContentSchema = z13.object({
-  quote: z13.string().default(""),
-  attribution: z13.string().optional()
-});
 var codeContentSchema = z13.object({
   title: z13.string().optional(),
   code: z13.string().default(""),
   language: z13.string().optional(),
   highlightLines: z13.array(z13.number()).optional()
 });
-var thankYouContentSchema = z13.object({
-  title: z13.string().default("Thank You"),
-  subtitle: z13.string().optional(),
-  ctaText: z13.string().optional(),
-  ctaUrl: z13.string().optional()
-});
 var mermaidContentSchema = z13.object({
   title: z13.string().optional(),
   code: z13.string().default("")
@@ -851,13 +817,8 @@ var typedSlideContentSchema = z13.discriminatedUnion("type", [
   z13.object({ type: z13.literal("title"), ...titleContentSchema.shape }),
   z13.object({ type: z13.literal("section_header"), ...sectionHeaderContentSchema.shape }),
   z13.object({ type: z13.literal("bullets"), ...bulletsContentSchema.shape }),
-  z13.object({ type: z13.literal("two_column"), ...twoColumnContentSchema.shape }),
-  z13.object({ type: z13.literal("comparison"), ...comparisonContentSchema.shape }),
-  z13.object({ type: z13.literal("timeline"), ...timelineContentSchema.shape }),
   z13.object({ type: z13.literal("image"), ...imageContentSchema.shape }),
-  z13.object({ type: z13.literal("quote"), ...quoteContentSchema.shape }),
   z13.object({ type: z13.literal("code"), ...codeContentSchema.shape }),
-  z13.object({ type: z13.literal("thank_you"), ...thankYouContentSchema.shape }),
   z13.object({ type: z13.literal("mermaid"), ...mermaidContentSchema.shape }),
   z13.object({ type: z13.literal("paragraph"), ...paragraphContentSchema.shape })
 ]);
@@ -983,6 +944,18 @@ var updateBrainstormNotesInput = {
   roadmapId: idField("roadmap item"),
   notes: z15.string().describe("The brainstorm notes content")
 };
+var presentOptionsInput = {
+  question: z15.string().describe("The decision or question being presented to the user"),
+  options: z15.array(z15.object({
+    key: z15.string().describe("Short key like A, B, C"),
+    title: z15.string().describe("Option title"),
+    description: z15.string().describe("1-2 sentence description of the option")
+  })).min(2).max(5).describe("The options to present (2-5)"),
+  recommendation: z15.object({
+    key: z15.string().describe("Key of the recommended option"),
+    reason: z15.string().describe("Brief reason for the recommendation")
+  }).optional().describe("Which option is recommended and why")
+};
 var searchFeaturesInput = {
   query: z15.string().optional().describe("Search query to match against name"),
   type: featureTypeSchema.optional().describe("Filter by type (feature or area)")
@@ -1089,16 +1062,7 @@ var deleteAudienceInput = {
 var getHistoryInput = {
   startDate: yyyyMmDdField("Start date in YYYY-MM-DD format"),
   endDate: yyyyMmDdField("End date in YYYY-MM-DD format"),
-  entityType: z15.enum([
-    "roadmap",
-    "feature",
-    "idea",
-    "prd",
-    "wireframe",
-    "product",
-    "audience",
-    "scenario"
-  ]).optional().describe("Filter to specific entity type")
+  entityType: z15.enum(["roadmap", "feature", "idea", "prd", "wireframe", "product", "audience", "scenario"]).optional().describe("Filter to specific entity type")
 };
 var getHistorySummaryInput = {
   startDate: yyyyMmDdField("Start date in YYYY-MM-DD format"),
@@ -1143,7 +1107,18 @@ var createInitiativeInput = {
   horizon: horizonSchema.optional().describe('Planning horizon (defaults to "inbox")'),
   dateGranularity: dateGranularitySchema.optional().describe("Target date granularity: day, month, quarter, half-year, or year"),
   dateValue: z15.string().optional().describe('Target date value matching granularity (e.g., "2024-Q1", "2024-03")'),
-  targetDate: z15.string().optional().describe("Target date in YYYY-MM-DD format")
+  targetDate: z15.string().optional().describe("Target date in YYYY-MM-DD format"),
+  status: z15.enum(["on_track", "at_risk", "blocked", "paused"]).optional().describe("Project health status"),
+  value: z15.number().int().min(1).max(3).optional().describe("Value rating (1-3 stars)"),
+  effort: z15.enum(["xs", "s", "m", "l", "xl"]).optional().describe("Effort estimate (t-shirt size)"),
+  target: z15.object({
+    granularity: dateGranularitySchema,
+    value: z15.string()
+  }).optional().describe("Flexible target date"),
+  deadline: z15.object({
+    granularity: dateGranularitySchema,
+    value: z15.string()
+  }).optional().describe("Flexible deadline date")
 };
 var updateInitiativeInput = {
   id: idField("initiative to update"),
@@ -1153,7 +1128,18 @@ var updateInitiativeInput = {
   dateGranularity: dateGranularitySchema.nullable().optional().describe("New target date granularity (null to clear)"),
   dateValue: z15.string().nullable().optional().describe("New target date value (null to clear)"),
   targetDate: z15.string().nullable().optional().describe("New target date in YYYY-MM-DD format (null to clear)"),
-  order: z15.number().int().min(0).optional().describe("Sort order for prioritization (lower numbers appear first)")
+  order: z15.number().int().min(0).optional().describe("Sort order for prioritization (lower numbers appear first)"),
+  status: z15.enum(["on_track", "at_risk", "blocked", "paused"]).nullable().optional().describe("Project health status (null to clear)"),
+  value: z15.number().int().min(1).max(3).nullable().optional().describe("Value rating (null to clear)"),
+  effort: z15.enum(["xs", "s", "m", "l", "xl"]).nullable().optional().describe("Effort estimate (null to clear)"),
+  target: z15.object({
+    granularity: dateGranularitySchema,
+    value: z15.string()
+  }).nullable().optional().describe("Flexible target date (null to clear)"),
+  deadline: z15.object({
+    granularity: dateGranularitySchema,
+    value: z15.string()
+  }).nullable().optional().describe("Flexible deadline date (null to clear)")
 };
 var deleteInitiativeInput = {
   id: idField("initiative to delete")
@@ -1241,6 +1227,44 @@ var resolveFeedbackCommentInput = {
   sessionId: uuidField("feedback session"),
   commentId: uuidField("comment to resolve/unresolve")
 };
+var createPresentationFeedbackSessionInput = {
+  presentationId: uuidField("presentation"),
+  variantId: uuidField("variant to create feedback session for"),
+  message: z15.string().optional().describe("Message shown to reviewers"),
+  expiresInDays: z15.number().int().min(1).max(90).optional().describe("Number of days until the session expires (default 14)")
+};
+var listPresentationFeedbackSessionsInput = {
+  presentationId: uuidField("presentation"),
+  variantId: uuidField("variant")
+};
+var getPresentationFeedbackSummaryInput = {
+  presentationId: uuidField("presentation"),
+  variantId: uuidField("variant"),
+  sessionId: uuidField("feedback session"),
+  filter: z15.enum(["all", "unresolved", "resolved"]).optional().describe("Filter by resolved status (default: unresolved)")
+};
+var getPresentationFeedbackDetailInput = {
+  presentationId: uuidField("presentation"),
+  variantId: uuidField("variant"),
+  sessionId: uuidField("feedback session"),
+  feedbackId: z15.string().uuid().optional().describe("Optional: get detail for a single feedback item"),
+  filter: z15.enum(["all", "unresolved", "resolved"]).optional().describe("Filter by resolved status (default: all). Ignored if feedbackId provided.")
+};
+var resolvePresentationFeedbackInput = {
+  presentationId: uuidField("presentation"),
+  variantId: uuidField("variant"),
+  sessionId: uuidField("feedback session"),
+  feedbackId: uuidField("feedback item to resolve/unresolve"),
+  type: z15.enum(["slide", "overall"]).describe("Type of feedback item"),
+  resolved: z15.boolean().describe("Set to true to resolve, false to unresolve")
+};
+var addPresentationReviewerInput = {
+  presentationId: uuidField("presentation"),
+  variantId: uuidField("variant"),
+  sessionId: uuidField("feedback session"),
+  name: z15.string().min(1).max(200).describe("Reviewer name"),
+  email: z15.string().email().optional().describe("Reviewer email")
+};
 var searchExportsInput = {
   roadmapId: z15.string().uuid().optional().describe("Filter by roadmap item ID"),
   externalSystem: externalSystemSchema.optional().describe("Filter by external system"),
@@ -1330,8 +1354,8 @@ var getSlideInput = {
 };
 var createSlideInput = {
   variantId: idField("variant"),
-  slideType: slideTypeSchema.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"}. For paragraph: {title, body}. Etc.'),
+  slideType: z15.enum(SLIDE_TYPES).default("bullets").describe("The type of slide to create: title, section_header, bullets, image, code, mermaid, paragraph"),
+  content: z15.record(z15.unknown()).optional().describe('Type-specific content object. For bullets: {title, items: ["..."]}. For title: {title, subtitle}. For image: {title, imageUrl, caption}. For code: {title, code, language}. For mermaid: {title, code: "graph TD; A-->B"}. For paragraph: {title, body}. For section_header: {title, subtitle}.'),
   speakerNotes: z15.string().nullable().optional().describe("Speaker notes for the slide")
 };
 var updateSlideInput = {
@@ -2055,6 +2079,39 @@ class ApiClient {
     });
     return response.data;
   }
+  async createPresentationFeedbackSession(presentationId, variantId, data) {
+    const response = await this.request(`/v1/presentations/${presentationId}/variants/${variantId}/feedback-sessions`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+    return response.data;
+  }
+  async listPresentationFeedbackSessions(presentationId, variantId) {
+    const response = await this.request(`/v1/presentations/${presentationId}/variants/${variantId}/feedback-sessions`);
+    return response.data;
+  }
+  async getPresentationFeedback(presentationId, variantId, sessionId) {
+    const response = await this.request(`/v1/presentations/${presentationId}/variants/${variantId}/feedback-sessions/${sessionId}/feedback`);
+    return response.data;
+  }
+  async getPresentationFeedbackStats(presentationId, variantId, sessionId) {
+    const response = await this.request(`/v1/presentations/${presentationId}/variants/${variantId}/feedback-sessions/${sessionId}/stats`);
+    return response.data;
+  }
+  async resolvePresentationFeedback(presentationId, variantId, sessionId, feedbackId, data) {
+    const response = await this.request(`/v1/presentations/${presentationId}/variants/${variantId}/feedback-sessions/${sessionId}/feedback/${feedbackId}/resolve`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+    return response.data;
+  }
+  async addPresentationReviewer(presentationId, variantId, sessionId, data) {
+    const response = await this.request(`/v1/presentations/${presentationId}/variants/${variantId}/feedback-sessions/${sessionId}/invites`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+    return response.data;
+  }
   async getVariantPresentationId(variantId) {
     const presentations = await this.listPresentations();
     for (const presentation2 of presentations.items) {
@@ -2182,6 +2239,12 @@ function registerAllTools(server) {
   registerDeleteSlide(server);
   registerReorderSlides(server);
   registerUploadSlideImage(server);
+  registerCreatePresentationFeedbackSession(server);
+  registerListPresentationFeedbackSessions(server);
+  registerGetPresentationFeedbackSummary(server);
+  registerGetPresentationFeedbackDetail(server);
+  registerResolvePresentationFeedback(server);
+  registerAddPresentationReviewer(server);
 }
 function registerGetWorkflows(server) {
   server.registerTool("get_workflows", {
@@ -4794,7 +4857,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), paragraph (title + body with markdown text).",
+    description: "Create a new slide in a variant. Slide types: title (title + subtitle), section_header (title + subtitle), bullets (title + items array), image (title + imageUrl + caption), code (title + code + language), mermaid (title + code with mermaid diagram syntax), paragraph (title + body with markdown text).",
     inputSchema: createSlideInput
   }, async ({
     variantId,
@@ -5021,7 +5084,9 @@ function registerCreateFeedbackSession(server) {
     const invite = session.invites[0];
     if (!invite) {
       return {
-        content: [{ type: "text", text: "Error: No invite was created for the session." }]
+        content: [
+          { type: "text", text: "Error: No invite was created for the session." }
+        ]
       };
     }
     const reviewUrl = `https://app.ourroadmaps.com/prototype-review/${invite.token}`;
@@ -5206,6 +5271,253 @@ function registerResolveFeedbackComment(server) {
     };
   });
 }
+function registerCreatePresentationFeedbackSession(server) {
+  server.registerTool("create_presentation_feedback_session", {
+    description: "Create a feedback session for a presentation variant and get a shareable review link. Reviewers can leave per-slide comments and emoji reactions.",
+    inputSchema: createPresentationFeedbackSessionInput
+  }, async ({
+    presentationId,
+    variantId,
+    message,
+    expiresInDays
+  }) => {
+    const client2 = getApiClient();
+    const session = await client2.createPresentationFeedbackSession(presentationId, variantId, {
+      message,
+      reviewerVisibility: true,
+      expiresInDays,
+      reviewers: [{ name: "Anonymous" }]
+    });
+    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/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 registerListPresentationFeedbackSessions(server) {
+  server.registerTool("list_presentation_feedback_sessions", {
+    description: "List all feedback sessions for a presentation variant with invite counts and status.",
+    inputSchema: listPresentationFeedbackSessionsInput
+  }, async ({ presentationId, variantId }) => {
+    const client2 = getApiClient();
+    const sessions = await client2.listPresentationFeedbackSessions(presentationId, variantId);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            sessions: sessions.map((s) => ({
+              id: s.id,
+              name: s.name,
+              status: s.status,
+              inviteCount: s.invites.length,
+              expiresAt: s.expiresAt,
+              createdAt: s.createdAt
+            }))
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerGetPresentationFeedbackSummary(server) {
+  server.registerTool("get_presentation_feedback_summary", {
+    description: "Get a human-readable summary of presentation feedback, grouped by slide. Shows reviewer names, comments, emoji reactions, and resolved status. Use this for a quick overview.",
+    inputSchema: getPresentationFeedbackSummaryInput
+  }, async ({
+    presentationId,
+    variantId,
+    sessionId,
+    filter
+  }) => {
+    const client2 = getApiClient();
+    const [stats, feedback] = await Promise.all([
+      client2.getPresentationFeedbackStats(presentationId, variantId, sessionId),
+      client2.getPresentationFeedback(presentationId, variantId, sessionId)
+    ]);
+    const resolvedFilter = filter ?? "unresolved";
+    const filtered = resolvedFilter === "all" ? feedback : feedback.filter((f) => resolvedFilter === "resolved" ? f.resolved : !f.resolved);
+    if (filtered.length === 0) {
+      return {
+        content: [{ type: "text", text: "No feedback found matching the filter." }]
+      };
+    }
+    const slideFeedback = filtered.filter((f) => f.type === "slide");
+    const overallFeedback = filtered.filter((f) => f.type === "overall");
+    const bySlide = new Map;
+    for (const f of slideFeedback) {
+      const key = f.slideId ?? "(unknown)";
+      if (!bySlide.has(key))
+        bySlide.set(key, []);
+      bySlide.get(key).push(f);
+    }
+    let summary = `## Session (${stats.respondedCount}/${stats.totalInvites} responded, ${stats.unresolvedCount} unresolved)
+
+`;
+    const sortedSlides = [...bySlide.entries()].sort((a, b) => {
+      const orderA = a[1][0]?.slideOrder ?? 0;
+      const orderB = b[1][0]?.slideOrder ?? 0;
+      return orderA - orderB;
+    });
+    for (const [, comments] of sortedSlides) {
+      const first = comments[0];
+      summary += `### Slide ${(first.slideOrder ?? 0) + 1}: "${first.slideTitle ?? "Untitled"}"
+`;
+      for (const c of comments) {
+        const status = c.resolved ? "RESOLVED" : "OPEN";
+        summary += `- [${status}] by "${c.reviewerName}" — "${c.commentText ?? ""}"
+`;
+        if (c.emojiReactions && c.emojiReactions.length > 0) {
+          summary += `  Reactions: ${c.emojiReactions.join(", ")}
+`;
+        }
+      }
+      summary += `
+`;
+    }
+    if (overallFeedback.length > 0) {
+      summary += `### Overall Feedback
+`;
+      for (const c of overallFeedback) {
+        const status = c.resolved ? "RESOLVED" : "OPEN";
+        summary += `- [${status}] by "${c.reviewerName}" — "${c.commentText ?? ""}"
+`;
+      }
+    }
+    return {
+      content: [{ type: "text", text: summary.trim() }]
+    };
+  });
+}
+function registerGetPresentationFeedbackDetail(server) {
+  server.registerTool("get_presentation_feedback_detail", {
+    description: "Get full raw feedback data for a presentation session, including slide IDs, emoji reactions, and resolved status. Use this when you need exact data to make targeted slide updates.",
+    inputSchema: getPresentationFeedbackDetailInput
+  }, async ({
+    presentationId,
+    variantId,
+    sessionId,
+    feedbackId,
+    filter
+  }) => {
+    const client2 = getApiClient();
+    const feedback = await client2.getPresentationFeedback(presentationId, variantId, sessionId);
+    let filtered = feedback;
+    if (feedbackId) {
+      filtered = feedback.filter((f) => f.id === feedbackId);
+      if (filtered.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Feedback item ${feedbackId} not found in this session.`
+            }
+          ]
+        };
+      }
+    } else {
+      const resolvedFilter = filter ?? "all";
+      if (resolvedFilter !== "all") {
+        filtered = feedback.filter((f) => resolvedFilter === "resolved" ? f.resolved : !f.resolved);
+      }
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ feedback: filtered }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerResolvePresentationFeedback(server) {
+  server.registerTool("resolve_presentation_feedback", {
+    description: "Set the resolved status on a presentation feedback item. Requires the feedback type (slide or overall) and the desired resolved state.",
+    inputSchema: resolvePresentationFeedbackInput
+  }, async ({
+    presentationId,
+    variantId,
+    sessionId,
+    feedbackId,
+    type,
+    resolved
+  }) => {
+    const client2 = getApiClient();
+    const result = await client2.resolvePresentationFeedback(presentationId, variantId, sessionId, feedbackId, { type, resolved });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            feedbackId: result.id,
+            resolved: result.resolved
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
+function registerAddPresentationReviewer(server) {
+  server.registerTool("add_presentation_reviewer", {
+    description: "Add a reviewer to an active presentation feedback session. Returns a unique review URL for the new reviewer.",
+    inputSchema: addPresentationReviewerInput
+  }, async ({
+    presentationId,
+    variantId,
+    sessionId,
+    name,
+    email
+  }) => {
+    const client2 = getApiClient();
+    const invite = await client2.addPresentationReviewer(presentationId, variantId, sessionId, {
+      name,
+      email
+    });
+    const reviewUrl = `https://app.ourroadmaps.com/review/${invite.token}`;
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            inviteId: invite.id,
+            reviewUrl,
+            reviewerName: invite.reviewerName,
+            reviewerEmail: invite.reviewerEmail
+          }, null, 2)
+        }
+      ]
+    };
+  });
+}
 
 // src/index.ts
 async function main() {

package/package.json

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