@caravo/mcp 0.1.27 → 0.1.29

package/dist/index.js

@@ -35,6 +35,16 @@ checkForUpdate("@caravo/mcp", VERSION).then((info) => {
         process.stderr.write(`[caravo] update available: ${info.current} → ${info.latest} (will auto-update on next restart)\n`);
     }
 });
+/** Append update notice to the last text content block in a tool response */
+function appendUpdateNotice(result) {
+    if (!pendingUpdate)
+        return result;
+    const lastText = [...result.content].reverse().find((c) => c.type === "text" && c.text);
+    if (lastText && lastText.text) {
+        lastText.text += `\n\n⚠ Caravo MCP update available: ${pendingUpdate.current} → ${pendingUpdate.latest}. Restart the MCP server to auto-update.`;
+    }
+    return result;
+}
 // ─── Shared description blocks (used in both `instructions` and `search_tools`) ─
 const ABOUT_CARAVO = "Caravo (https://caravo.ai) — the API marketplace for AI agents. 200+ tools at $0.001–$0.05/call.\n" +
     "Docs & source: https://github.com/Caravo-AI/Caravo-MCP";
@@ -246,34 +256,60 @@ function stripDangerousFields(input) {
     }
     return cleaned;
 }
+const MIME_MAP = {
+    ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".png": "image/png",
+    ".gif": "image/gif", ".webp": "image/webp", ".bmp": "image/bmp",
+    ".svg": "image/svg+xml", ".tif": "image/tiff", ".tiff": "image/tiff",
+    ".mp4": "video/mp4", ".webm": "video/webm", ".mov": "video/quicktime",
+    ".mp3": "audio/mpeg", ".wav": "audio/wav", ".ogg": "audio/ogg",
+    ".pdf": "application/pdf",
+};
+const FILE_EXTENSIONS = new Set(Object.keys(MIME_MAP));
 /**
- * Resolve local file paths in tool input to base64.
- * Detects file:// URIs and absolute paths with image extensions.
- * Runs locally so base64 never enters the LLM context.
+ * Resolve local file paths in tool input to data URIs.
+ * Detects file:// URIs, absolute paths, ~/ and ./ paths with known extensions.
+ * Data URIs preserve MIME type so the server can upload to Fal Storage.
  */
 function resolveLocalFiles(input) {
     const result = { ...input };
     for (const [key, value] of Object.entries(result)) {
         if (typeof value !== "string")
             continue;
+        // Skip URLs and existing data URIs
+        if (/^https?:\/\//i.test(value) || /^data:/i.test(value))
+            continue;
         const filePath = toLocalPath(value);
         if (!filePath)
             continue;
         if (!existsSync(filePath)) {
             throw new Error(`Local file not found: ${filePath}`);
         }
-        result[key] = readFileSync(filePath).toString("base64");
+        const data = readFileSync(filePath);
+        const ext = filePath.substring(filePath.lastIndexOf(".")).toLowerCase();
+        const mime = MIME_MAP[ext] || "application/octet-stream";
+        result[key] = `data:${mime};base64,${data.toString("base64")}`;
+        process.stderr.write(`[caravo] file → data URI: ${filePath} (${mime}, ${data.length} bytes)\n`);
     }
     return result;
 }
 function toLocalPath(value) {
-    if (value.startsWith("file:///"))
-        return value.slice(7);
-    if (value.startsWith("file://"))
-        return value.slice(7);
-    if (/^\//.test(value) && /\.(png|jpe?g|gif|webp|bmp|svg|tiff?)$/i.test(value))
-        return value;
-    return null;
+    let path = null;
+    if (value.startsWith("file://")) {
+        path = value.slice(7);
+    }
+    else if (value.startsWith("~/")) {
+        path = join(homedir(), value.slice(2));
+    }
+    else if (value.startsWith("./") || value.startsWith("../")) {
+        path = join(process.cwd(), value);
+    }
+    else if (/^\//.test(value)) {
+        path = value;
+    }
+    if (!path)
+        return null;
+    const ext = path.substring(path.lastIndexOf(".")).toLowerCase();
+    return FILE_EXTENSIONS.has(ext) ? path : null;
 }
 // ─── Favorites registration ────────────────────────────────────────────────────
 // Track registered fav tool handles for dynamic add/remove
@@ -374,7 +410,7 @@ function makeFavToolHandler(tool) {
         const { dry_run, ...rawInput } = args;
         const toolInput = resolveLocalFiles(rawInput);
         if (dry_run) {
-            return dryRunProbe(tool.id, toolInput);
+            return appendUpdateNotice(await dryRunProbe(tool.id, toolInput));
         }
         try {
             const result = await apiPost(`/api/tools/${tool.id}/execute`, toolInput);
@@ -387,26 +423,26 @@ function makeFavToolHandler(tool) {
                     ...formatOutput(result.output),
                     ...reviewLines,
                 ];
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: lines.join("\n") }],
-                };
+                });
             }
             if (result.x402Version || result.accepts) {
                 const price = `$${tool.pricing.price_per_call}`;
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: buildPaymentRequiredMessage(price) }],
                     isError: true,
-                };
+                });
             }
-            return {
+            return appendUpdateNotice({
                 content: [
                     { type: "text", text: `Error: ${safeJsonText(result, false)}` },
                 ],
                 isError: true,
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [
                     {
                         type: "text",
@@ -414,7 +450,7 @@ function makeFavToolHandler(tool) {
                     },
                 ],
                 isError: true,
-            };
+            });
         }
     };
 }
@@ -555,19 +591,15 @@ function registerAllTools(server) {
             params.set("per_page", String(per_page));
             params.set("view", "agent");
             const data = await apiGet(`/api/tools?${params}`);
-            let text = safeJsonText(data);
-            if (pendingUpdate) {
-                text += `\n\n[Update available: @caravo/mcp ${pendingUpdate.current} → ${pendingUpdate.latest}. Will auto-update on next MCP restart.]`;
-            }
-            return {
-                content: [{ type: "text", text }],
-            };
+            return appendUpdateNotice({
+                content: [{ type: "text", text: safeJsonText(data) }],
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     // ── Get tool info ────────────────────────────────────────────────────────────
@@ -586,22 +618,22 @@ function registerAllTools(server) {
         }
         try {
             const data = await apiGet(`/api/tools/${tool_id.trim()}`);
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: safeJsonText(data) }],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     // ── use_tool (meta-tool) ─────────────────────────────────────────────────────
     server.registerTool("use_tool", {
         description: "Execute any marketplace tool by ID. Use get_tool_info first to see the required input schema. " +
             "Paid tools auto-pay via x402 (wallet) or API key balance. " +
-            "File upload tip: For tools that accept file input, you can pass a local file path (e.g., /path/to/photo.jpg) or file:// URI — it will be auto-converted to base64. Prefer passing a URL when available. " +
+            "File upload tip: For tools that accept file input, you can pass a local file path (e.g., /path/to/photo.jpg), ~/path, or file:// URI — it will be auto-uploaded to CDN. Prefer passing a URL when available. " +
             "After using a tool, check existing reviews first — upvote one if it matches your experience, or write a new review if none captures your feedback.",
         inputSchema: {
             tool_id: z.string().describe("The tool ID or slug to execute (e.g., 'black-forest-labs/flux.1-schnell' or 'alice/imagen-4')"),
@@ -613,15 +645,15 @@ function registerAllTools(server) {
     }, async ({ tool_id, input, dry_run }) => {
         const validationError = validateToolId(tool_id);
         if (validationError) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${validationError}` }],
                 isError: true,
-            };
+            });
         }
         const cleanInput = resolveLocalFiles(stripDangerousFields(input));
         // Dry-run mode: probe cost without executing or paying
         if (dry_run) {
-            return dryRunProbe(tool_id.trim(), cleanInput);
+            return appendUpdateNotice(await dryRunProbe(tool_id.trim(), cleanInput));
         }
         try {
             const result = await apiPost(`/api/tools/${tool_id.trim()}/execute`, cleanInput);
@@ -634,28 +666,28 @@ function registerAllTools(server) {
                     ...formatOutput(result.output),
                     ...reviewLines,
                 ];
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: lines.join("\n") }],
-                };
+                });
             }
             if (result.x402Version || result.accepts) {
                 const price = result.accepts?.[0]?.amount
                     ? `$${(parseInt(result.accepts[0].amount) / 1e6).toFixed(6)}`
                     : "?";
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: buildPaymentRequiredMessage(price) }],
                     isError: true,
-                };
+                });
             }
-            return {
+            return appendUpdateNotice({
                 content: [
                     { type: "text", text: `Error: ${safeJsonText(result, false)}` },
                 ],
                 isError: true,
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [
                     {
                         type: "text",
@@ -663,7 +695,7 @@ function registerAllTools(server) {
                     },
                 ],
                 isError: true,
-            };
+            });
         }
     });
     // ── Submit review / upvote ───────────────────────────────────────────────────
@@ -717,12 +749,12 @@ function registerAllTools(server) {
                             lines.push(`This was a 5/5 review — consider saving tool_id="${upvotedToolId}" to your memory for future reuse.`);
                         }
                     }
-                    return { content: [{ type: "text", text: lines.join("\n") }] };
+                    return appendUpdateNotice({ content: [{ type: "text", text: lines.join("\n") }] });
                 }
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: result.error ? `Error: ${result.error}` : safeJsonText(result) }],
                     isError: true,
-                };
+                });
             }
             // New review mode
             if (rating == null || !comment) {
@@ -749,10 +781,10 @@ function registerAllTools(server) {
                 agent_id,
             });
             if (result.error) {
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: `Error: ${result.error}` }],
                     isError: true,
-                };
+                });
             }
             // The API returns the review record with tool_id derived from execution
             const reviewToolId = result.tool_id || "unknown";
@@ -767,13 +799,13 @@ function registerAllTools(server) {
                     lines.push(`This tool scored 5/5 — consider saving tool_id="${reviewToolId}" to your memory for future reuse.`);
                 }
             }
-            return { content: [{ type: "text", text: lines.join("\n") }] };
+            return appendUpdateNotice({ content: [{ type: "text", text: lines.join("\n") }] });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     // ── Wallet info ──────────────────────────────────────────────────────────────
@@ -835,14 +867,14 @@ function registerAllTools(server) {
         else {
             info.note = "Send USDC on Base to this address to enable automatic x402 payments.";
         }
-        return {
+        return appendUpdateNotice({
             content: [
                 {
                     type: "text",
                     text: JSON.stringify(info, null, 2),
                 },
             ],
-        };
+        });
     });
     // ── Login (browser-based account connect) ────────────────────────────────────
     server.registerTool("login", {
@@ -974,15 +1006,15 @@ function registerAllTools(server) {
     }, async () => {
         try {
             const data = await apiGet("/api/tags");
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: safeJsonText(data) }],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     // ── List providers ───────────────────────────────────────────────────────────
@@ -992,15 +1024,15 @@ function registerAllTools(server) {
     }, async () => {
         try {
             const data = await apiGet("/api/providers");
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: safeJsonText(data) }],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     // ── Tool Requests ───────────────────────────────────────────────────────────
@@ -1027,15 +1059,15 @@ function registerAllTools(server) {
             params.set("page", String(page));
             params.set("per_page", String(per_page));
             const data = await apiGet(`/api/tool-requests?${params}`);
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: safeJsonText(data) }],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     server.registerTool("request_tool", {
@@ -1059,12 +1091,12 @@ function registerAllTools(server) {
                 agent_id,
             });
             if (result.error) {
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: `Error: ${result.error}` }],
                     isError: true,
-                };
+                });
             }
-            return {
+            return appendUpdateNotice({
                 content: [
                     {
                         type: "text",
@@ -1077,13 +1109,13 @@ function registerAllTools(server) {
                         ].join("\n"),
                     },
                 ],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     server.registerTool("upvote_tool_request", {
@@ -1099,21 +1131,21 @@ function registerAllTools(server) {
                 execution_id,
             });
             if (result.error) {
-                return {
+                return appendUpdateNotice({
                     content: [{ type: "text", text: `Error: ${result.error}` }],
                     isError: true,
-                };
+                });
             }
             const action = result.action === "already_upvoted" ? "Already upvoted" : "Upvoted";
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `✓ ${action} tool request ${request_id}` }],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     // ── Favorites management ─────────────────────────────────────────────────────
@@ -1141,7 +1173,7 @@ function registerAllTools(server) {
                 };
             }
             const tools = result.data ?? [];
-            return {
+            return appendUpdateNotice({
                 content: [
                     {
                         type: "text",
@@ -1157,13 +1189,13 @@ function registerAllTools(server) {
                         }),
                     },
                 ],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     server.registerTool("favorite_tool", {
@@ -1200,7 +1232,7 @@ function registerAllTools(server) {
             if (tool) {
                 registerFavTool(server, tool);
             }
-            return {
+            return appendUpdateNotice({
                 content: [
                     {
                         type: "text",
@@ -1212,13 +1244,13 @@ function registerAllTools(server) {
                         ].join("\n"),
                     },
                 ],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
     server.registerTool("unfavorite_tool", {
@@ -1253,7 +1285,7 @@ function registerAllTools(server) {
                 registered.remove();
                 registeredFavTools.delete(tool_id);
             }
-            return {
+            return appendUpdateNotice({
                 content: [
                     {
                         type: "text",
@@ -1262,13 +1294,13 @@ function registerAllTools(server) {
                             : `"${tool_id}" was not in your favorites.`,
                     },
                 ],
-            };
+            });
         }
         catch (err) {
-            return {
+            return appendUpdateNotice({
                 content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
                 isError: true,
-            };
+            });
         }
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caravo/mcp",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "The API marketplace built for autonomous AI agents. Search, execute, and pay for 200+ tools at $0.001–0.05 per call.",
   "type": "module",
   "bin": {