openalmanac 0.2.13 → 0.2.15

package/dist/server.js

@@ -47,6 +47,12 @@ export function createServer() {
             "read_webpage(url=profile_url) to get their full profile with a high-resolution photo, then " +
             "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. " +
+            "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. " +
             "This URL includes a celebration page for the newly created article.\n\n" +
             "After pushing an article, call search_communities to find relevant communities. " +

package/dist/tools/articles.js

@@ -82,6 +82,32 @@ Include an infobox for any article about a person, place, organization, event, o
 - Every source in the sources list must be referenced at least once in the body
 - Every [N] marker must have a matching source
 
+## Images
+
+Use search_images to find relevant images. Images render as figures with visible captions.
+
+**Syntax:** \`![Caption text](url "position")\`
+
+Positions: \`"right"\` (default if omitted), \`"left"\`, \`"center"\`
+
+\`\`\`markdown
+![Alan Turing in 1930, aged 18](https://upload.wikimedia.org/...)
+
+The early life of Alan Turing began...
+
+![Panoramic view of Bletchley Park](https://upload.wikimedia.org/... "center")
+\`\`\`
+
+**Caption rules:**
+- Every image MUST have a descriptive caption — it is displayed below the image
+- Describe what the image shows: "Alan Turing in 1930, aged 18" not "Photo"
+- Include dates, context, or attribution when relevant
+
+**Placement:** 1-3 images per major section, spread throughout. First image near the top.
+For the infobox hero image, use \`infobox.header.image_url\` in frontmatter instead.
+
+External image URLs are auto-persisted on push — no extra steps needed.
+
 ## Writing quality
 
 - Every sentence should contain a specific fact the reader didn't know
@@ -230,9 +256,10 @@ export function registerArticleTools(server) {
             "validates locally (frontmatter, citations, sources), then pushes via the API. Requires login.",
         parameters: z.object({
             slug: z.string().describe("Article slug matching the filename (without .md)"),
-            change_summary: z.string().optional().describe("Brief description of changes"),
+            change_title: z.string().optional().describe("Short title for the change (e.g. 'Added early life section')"),
+            change_description: z.string().optional().describe("Longer description of what changed and why"),
         }),
-        async execute({ slug, change_summary }) {
+        async execute({ slug, change_title, change_description }) {
             const filePath = join(ARTICLES_DIR, `${slug}.md`);
             let raw;
             try {
@@ -247,11 +274,14 @@ export function registerArticleTools(server) {
                 const lines = errors.map((e) => `  ${e.field}: ${e.message}`);
                 throw new Error(`Validation failed (${errors.length} error${errors.length > 1 ? "s" : ""}):\n${lines.join("\n")}\n\nFix the file and try again.`);
             }
-            // Inject change_summary into frontmatter if provided
+            // Inject change_title/change_description into frontmatter if provided
             let body = raw;
-            if (change_summary) {
+            if (change_title || change_description) {
                 const { frontmatter, content } = parseFrontmatter(raw);
-                frontmatter.change_summary = change_summary;
+                if (change_title)
+                    frontmatter.change_title = change_title;
+                if (change_description)
+                    frontmatter.change_description = change_description;
                 const newFrontmatter = yamlStringify(frontmatter);
                 body = `---\n${newFrontmatter}---\n${content}`;
             }

package/dist/tools/research.js

@@ -40,4 +40,45 @@ export function registerResearchTools(server) {
             return JSON.stringify(data, null, 2);
         },
     });
+    server.addTool({
+        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. " +
+            "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" +
+            "**Syntax:** `![Caption text](url \"position\")`\n\n" +
+            "Position options (in the title/quotes):\n" +
+            "- `\"right\"` — float right (DEFAULT if omitted)\n" +
+            "- `\"left\"` — float left\n" +
+            "- `\"center\"` — full-width, centered\n\n" +
+            "**Examples:**\n" +
+            "- `![Alan Turing in 1930, aged 18](url)` — floats right (default)\n" +
+            "- `![The Apollo 11 crew before launch](url \"left\")` — floats left\n" +
+            "- `![Panoramic view of the Grand Canyon](url \"center\")` — full-width\n\n" +
+            "**Caption rules:**\n" +
+            "- Every image MUST have a descriptive caption — it is displayed below the image\n" +
+            "- Describe what the image shows: 'Alan Turing in 1930, aged 18' not 'Photo'\n" +
+            "- Include date, context, or attribution when relevant\n" +
+            "- Bad: `![Logo](url)` — Good: `![The OpenAI logo, a stylized spiral](url)`\n\n" +
+            "**Placement rules:**\n" +
+            "- Place 1-3 images per major section — don't overload\n" +
+            "- First image should appear near the top, illustrating the article's subject\n" +
+            "- Spread images throughout, not clustered together\n" +
+            "- For the infobox hero image, set `infobox.header.image_url` in frontmatter instead\n\n" +
+            "Requires login. Rate limit: 10/min.",
+        parameters: z.object({
+            query: z.string().describe("Descriptive search terms for the image (e.g. 'Apollo 11 moon landing photograph')"),
+            source: z.enum(["wikimedia", "google"]).default("wikimedia").describe("Image source: 'wikimedia' (free, open-licensed — preferred) or 'google' (broader coverage)"),
+            limit: z.number().default(10).describe("Max results (1-30, default 10)"),
+        }),
+        async execute({ query, source, limit }) {
+            const resp = await request("GET", "/api/research/images", {
+                auth: true,
+                params: { query, source, limit },
+            });
+            return JSON.stringify(await resp.json(), null, 2);
+        },
+    });
 }

package/package.json

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