@post-ripple/mcp 0.3.0 → 0.5.0

package/dist/index.js

@@ -45,7 +45,7 @@ function toEpochMs(value, field) {
     }
     return parsed;
 }
-const server = new McpServer({ name: "postripple", version: "0.3.0" });
+const server = new McpServer({ name: "postripple", version: "0.5.0" });
 function register(name, description, shape, transform) {
     server.tool(name, description, shape, async (args) => {
         try {
@@ -143,14 +143,18 @@ const slideTextStyleSchema = z
 })
     .describe("Optional per-field style overrides; anything omitted uses the template slot's defaults");
 const slideSchema = z.object({
+    imageId: z
+        .string()
+        .optional()
+        .describe("A library image (from list_images / register_uploaded_image / import_image_from_url) used as the slide background; text is rendered on top server-side. Provide exactly one of imageId, prerenderedFileId, or backgroundFileId per slide."),
     prerenderedFileId: z
         .string()
         .optional()
-        .describe("A finished slide image (from get_image_upload_url or import_image_from_url) used as-is. JPEG at 1080x1350 recommended — other formats are re-encoded and cover-cropped to the canvas."),
+        .describe("A finished slide image (a fileId from get_image_upload_url, import_image_from_url, or list_images) used as-is. JPEG at 1080x1350 recommended — other formats are re-encoded and cover-cropped to the canvas."),
     backgroundFileId: z
         .string()
         .optional()
-        .describe("Background image for a template slide; text is rendered on top server-side."),
+        .describe("Background image (raw fileId) for a template slide; text is rendered on top server-side. Prefer imageId when the image is in the library."),
     textFields: z
         .array(z.object({
         key: z
@@ -180,9 +184,24 @@ register("list_videos", "List videos in the workspace library, newest first. Vid
 });
 register("list_video_groups", "List video groups (rotation playlists that auto-post on a schedule) with video/account counts and status.", { ...orgParam });
 register("get_video_group", "Get one video group in detail: its videos and the per-account posting rules (posts per day, posting windows, next scheduled post).", { ...orgParam, groupId: z.string() });
-register("list_slideshows", "List photo-carousel slideshows with status ('draft' = still being composed, 'ready' = publishable).", { ...orgParam, limit: z.number().min(1).max(200).optional() });
-register("list_slideshow_templates", "List the slideshow layout templates: canvas size, each template's text slots (keys, defaults), available fonts and text treatments, and the max slide count. Call before create_slideshow when composing template-based slides.", {});
-register("get_slideshow", "Get one slideshow: per-slide render state and overall status, plus server-side render progress ({state, error}). Poll this after create_slideshow returns status 'rendering' — publish once status is 'ready'.", { ...orgParam, slideshowId: z.string() });
+register("list_images", "List/search the workspace's image library, newest first (relevance order when text is passed). Every image ever uploaded, imported, or generated lives here until deleted — CHECK THIS BEFORE generating or re-uploading images; reusing an existing image is free and instant. Each result has an imageId (pass to create_slideshow slides), its raw fileId, a signed preview url (~1h), and its title/description/tags/prompt metadata.", {
+    ...orgParam,
+    text: z
+        .string()
+        .optional()
+        .describe("Free-text search over title, description, tags, and generation prompt"),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe("Only images carrying ALL of these tags"),
+    source: z
+        .enum(["upload", "agent_upload", "agent_import", "generated"])
+        .optional(),
+    limit: z.number().min(1).max(200).optional().describe("Default 100, max 200"),
+});
+register("list_slideshows", "List photo-carousel slideshows with status ('draft' = still being composed, 'ready' = publishable) and a signed coverUrl thumbnail (first rendered slide, or a background for drafts).", { ...orgParam, limit: z.number().min(1).max(200).optional() });
+register("list_slideshow_templates", "List the slideshow layout templates: canvas size, each template's text slots with exact geometry (x/y anchor, maxWidth, fontSize, lineHeight — all normalized to the canvas) and defaults (font, color, treatment), the template's default overlay scrim, available fonts and text treatments, and the max slide count. Call before create_slideshow when composing template-based slides — use the slot geometry rather than inventing your own placement.", {});
+register("get_slideshow", "Get one slideshow in full detail: per-slide render state, each text field's text AND its style overrides (font, color, treatment, fontScale, x/y position, maxWidth, align, rotation — null style means the template slot defaults apply), the slide's overlay scrim, and signed image URLs (renderedUrl = the finished slide, backgroundUrl = the photo behind it; both expire in ~1h). Use it to study how existing slides are actually styled before composing new ones, or poll it after create_slideshow returns status 'rendering' — publish once status is 'ready'.", { ...orgParam, slideshowId: z.string() });
 register("list_posts", "List posts (scheduled, publishing, published, failed, canceled), newest first. Scheduled posts include scheduledFor; published posts include platformPostId and publishedAt.", {
     ...orgParam,
     status: postStatusEnum.optional(),
@@ -240,9 +259,34 @@ register("update_group_schedule", "Attach a social account to a group or update
     status: z.enum(["active", "paused"]).optional(),
     postingWindows: z.array(postingWindowSchema).optional(),
 });
-register("get_image_upload_url", "Get a presigned upload URL for pushing a slide image into storage. PUT the raw image bytes to the returned uploadUrl with a Content-Type header, then use the returned fileId in create_slideshow. JPEG at 1080x1350 (4:5) strongly recommended.", { ...orgParam });
-register("import_image_from_url", "Import an image into storage from a public URL (synchronous — the returned fileId is immediately usable in create_slideshow). Accepts JPEG/PNG/WebP up to 15MB; JPEG is recommended since other formats get re-encoded and cover-cropped to the 1080x1350 canvas.", { ...orgParam, url: z.string().url() });
-register("create_slideshow", "Create a photo slideshow (1-10 slides). Each slide is EITHER {prerenderedFileId} — a finished image you composed — OR {backgroundFileId, textFields, overlay} rendered server-side using templateId's layout. Pre-rendered JPEG slides are ready instantly; template slides return status 'rendering' — poll get_slideshow until 'ready', then call publish_slideshow. Requires the slideshows plan feature.", {
+register("get_image_upload_url", "Get a presigned upload URL for pushing an image into the workspace library. PUT the raw image bytes to the returned uploadUrl with a Content-Type header, then call register_uploaded_image with the returned fileId (plus a title/tags so the image is findable later). JPEG at 1080x1350 (4:5) strongly recommended.", { ...orgParam });
+register("register_uploaded_image", "Register an image after uploading its bytes to a presigned URL from get_image_upload_url. This saves it to the workspace image library — it persists until deleted and can be reused in any slideshow (via list_images). Give it a descriptive title and tags so it's easy to find again.", {
+    ...orgParam,
+    fileId: z.string().describe("The fileId returned by get_image_upload_url"),
+    title: z.string().optional().describe("Descriptive title — strongly recommended for later discovery"),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional().describe("Lowercase keywords for filtering in list_images"),
+});
+register("import_image_from_url", "Import an image into the workspace library from a public URL (synchronous — the returned imageId/fileId are immediately usable in create_slideshow, and the image persists in the library for reuse via list_images). Accepts JPEG/PNG/WebP up to 15MB; JPEG is recommended since other formats get re-encoded and cover-cropped to the 1080x1350 canvas. Give it a title/tags so it's findable later.", {
+    ...orgParam,
+    url: z.string().url(),
+    title: z.string().optional().describe("Descriptive title — strongly recommended for later discovery"),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional().describe("Lowercase keywords for filtering in list_images"),
+});
+register("update_image", "Update a library image's title, description, or tags (e.g. to make older images easier to rediscover via list_images).", {
+    ...orgParam,
+    imageId: z.string(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional().describe("Replaces the existing tag list"),
+});
+register("delete_image", "Delete a library image and its stored file. If the image is still used as a slide background or character thumbnail, the call returns the references instead of deleting; retry with force: true to delete anyway (those draft slides lose their background). Images that ARE a slideshow's final rendered content can't be deleted at all — delete the slideshow first.", {
+    ...orgParam,
+    imageId: z.string(),
+    force: z.boolean().optional(),
+});
+register("create_slideshow", "Create a photo slideshow (1-10 slides). Each slide is EXACTLY ONE OF: {imageId} — a library image (see list_images) as the background, optionally with textFields/overlay; {prerenderedFileId} — a finished image you composed, used as-is; or {backgroundFileId, textFields, overlay} rendered server-side using templateId's layout. Reuse library images via list_images before generating or uploading new ones. Pre-rendered JPEG slides are ready instantly; other slides return status 'rendering' — poll get_slideshow until 'ready', then call publish_slideshow. Requires the slideshows plan feature.", {
     ...orgParam,
     title: z.string().optional(),
     templateId: z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@post-ripple/mcp",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "MCP server that lets AI agents (Claude Code, Codex, opencode) manage a Post Ripple workspace: content, scheduling, publishing, and analytics.",
   "type": "module",
   "bin": {