openalmanac 0.2.15 → 0.2.17

package/dist/server.js

@@ -48,9 +48,9 @@ export function createServer() {
             "create_stub with the image_url from the ![Profile Photo](url) line in the scraped markdown. " +
             "For topics/orgs/events: use descriptive kebab-case slugs (e.g. 'reinforcement-learning', 'openai').\n\n" +
             "## Images\n\n" +
-            "Use search_images to find images for articles. Syntax: `![Caption](url \"position\")` where position " +
-            "is 'right' (default), 'left', or 'center'. The caption (alt text) is displayed below the image — " +
-            "make it descriptive. Use 1-3 images per major section. " +
+            "Use search_images to find images, then view_image to verify candidates before using them. " +
+            "Syntax: `![Caption](url \"position\")` where position is 'right' (default), 'left', or 'center'. " +
+            "The caption (alt text) is displayed below the image — make it descriptive. Use 1-3 images per major section. " +
             "For the infobox hero image, set infobox.header.image_url in frontmatter. " +
             "External image URLs are auto-persisted on push — no extra steps needed.\n\n" +
             "After creating an article, always share the exact URL from the push response with the user. " +

package/dist/tools/research.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { imageContent } from "fastmcp";
 import { request } from "../auth.js";
 export function registerResearchTools(server) {
     server.addTool({
@@ -44,7 +45,7 @@ export function registerResearchTools(server) {
         name: "search_images",
         description: "Search for images to include in articles. Returns image URLs, titles, dimensions, and licensing info. " +
             "Two sources: 'wikimedia' (free, open-licensed images from Wikimedia Commons — preferred) and 'google' (broader web images via Google). " +
-            "Use descriptive search terms. Pick images based on their title and description. " +
+            "Use descriptive search terms. After searching, call view_image on promising candidates to see what they actually show before using them. " +
             "External image URLs are automatically persisted when you push the article — no extra steps needed.\n\n" +
             "## Using images in articles\n\n" +
             "Images render as figures with visible captions. The alt text becomes the caption — make it descriptive.\n\n" +
@@ -81,4 +82,25 @@ export function registerResearchTools(server) {
             return JSON.stringify(await resp.json(), null, 2);
         },
     });
+    server.addTool({
+        name: "view_image",
+        description: "View an image to verify it's suitable for an article. Use after search_images to inspect candidate images " +
+            "before including them. Returns the image so you can see what it actually shows and write an accurate caption.",
+        parameters: z.object({
+            url: z.string().url().describe("Image URL to view (use image_url or thumbnail_url from search_images results)"),
+        }),
+        async execute({ url }) {
+            try {
+                return {
+                    content: [
+                        await imageContent({ url }),
+                        { type: "text", text: `Image URL: ${url}` },
+                    ],
+                };
+            }
+            catch {
+                return `Failed to fetch image from ${url}. The URL may be invalid, inaccessible, or not an image.`;
+            }
+        },
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openalmanac",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {