@post-ripple/mcp 0.5.0 → 0.6.0

package/dist/index.js

@@ -45,7 +45,7 @@ function toEpochMs(value, field) {
     }
     return parsed;
 }
-const server = new McpServer({ name: "postripple", version: "0.5.0" });
+const server = new McpServer({ name: "postripple", version: "0.6.0" });
 function register(name, description, shape, transform) {
     server.tool(name, description, shape, async (args) => {
         try {
@@ -184,19 +184,20 @@ 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_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.", {
+register("list_images", "List or search the workspace's image library. Every image ever uploaded, imported, or generated lives here until deleted, and each is auto-captioned + tagged by AI on ingest — CHECK THIS BEFORE generating or re-uploading images; reusing an existing image is free and instant. Passing `text` runs hybrid SEMANTIC search (natural-language meaning + keyword), so 'cozy sunlit gym' finds matching photos even if those words aren't in the metadata — describe what you want. Without `text`, it lists newest-first and honors tags/source filters. Each result has an imageId (pass to create_slideshow slides), raw fileId, a signed preview url (~1h), and title/description/tags/aiCaption/prompt metadata.", {
     ...orgParam,
     text: z
         .string()
         .optional()
-        .describe("Free-text search over title, description, tags, and generation prompt"),
+        .describe("Natural-language / keyword query — runs hybrid semantic search over the image's caption, tags, description, and prompt. When set, tags/source filters are ignored."),
     tags: z
         .array(z.string())
         .optional()
-        .describe("Only images carrying ALL of these tags"),
+        .describe("Only images carrying ALL of these tags (ignored when text is set)"),
     source: z
         .enum(["upload", "agent_upload", "agent_import", "generated"])
-        .optional(),
+        .optional()
+        .describe("Filter by origin (ignored when text is set)"),
     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() });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@post-ripple/mcp",
-  "version": "0.5.0",
+  "version": "0.6.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": {