openalmanac 0.2.12 → 0.2.14

package/dist/server.js

@@ -43,8 +43,16 @@ export function createServer() {
             "or create it via create_stub. Links to non-existent slugs are stripped to plain text on push.\n\n" +
             "Workflow: For each entity mentioned → search_articles (check if exists) → if not, create_stub " +
             "with title, entity_type, headline, and a 2-4 sentence summary → then use [[slug|Display Text]] in your article.\n\n" +
-            "For people: call search_people to find their LinkedIn-backed slug, then create_stub. " +
+            "For people: call search_people to find their LinkedIn-backed slug and profile_url, then " +
+            "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. Place images inline using `![Descriptive caption](url)` " +
+            "on the line before the paragraph they illustrate. Images float right on desktop. " +
+            "Every image must have a descriptive caption. 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,27 @@ 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. Place them inline using standard markdown:
+
+\`\`\`markdown
+![Alan Turing in 1930, aged 18](https://upload.wikimedia.org/...)
+
+The early life of Alan Turing began...
+\`\`\`
+
+The image goes on the line BEFORE the paragraph it illustrates. It floats right on desktop.
+
+**Caption rules:**
+- Every image MUST have a descriptive caption (the alt text)
+- Describe what the image shows: "Alan Turing in 1930, aged 18" not "Photo"
+- For the infobox hero image, use \`infobox.header.image_url\` in frontmatter instead
+
+**Placement:** 1-3 images per major section, spread throughout. First image near the top.
+
+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 +251,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 +269,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}`;
             }
@@ -266,6 +291,21 @@ export function registerArticleTools(server) {
             return `Pushed successfully.\n\nArticle URL (share this exact link with the user): ${articleUrl}\n\n${JSON.stringify(data, null, 2)}`;
         },
     });
+    server.addTool({
+        name: "requested_articles",
+        description: "List requested articles — stubs that are referenced by the most articles but haven't been fully written yet. " +
+            "Use this to find high-demand topics to write about. No authentication needed.",
+        parameters: z.object({
+            limit: z.number().default(20).describe("Max results (1-200, default 20)"),
+            offset: z.number().default(0).describe("Pagination offset (default 0)"),
+        }),
+        async execute({ limit, offset }) {
+            const resp = await request("GET", "/api/articles/requested", {
+                params: { limit, offset },
+            });
+            return JSON.stringify(await resp.json(), null, 2);
+        },
+    });
     server.addTool({
         name: "status",
         description: "Show login status and list all article files in your local working directory (~/.openalmanac/articles/). " +

package/dist/tools/research.js

@@ -40,4 +40,37 @@ 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" +
+            "Add images inline using markdown: `![Descriptive caption](image_url)`\n\n" +
+            "Place the image on the line BEFORE the paragraph it illustrates. The image floats to the right of the text on desktop.\n\n" +
+            "**Caption rules:**\n" +
+            "- Every image MUST have a descriptive caption (the alt text in `![caption here](url)`)\n" +
+            "- Captions should describe what the image shows, not just name the subject\n" +
+            "- Bad: `![Logo](url)` — Good: `![The OpenAI logo, a stylized spiral](url)`\n" +
+            "- Bad: `![Photo](url)` — Good: `![Alan Turing in 1930, aged 18](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.12",
+  "version": "0.2.14",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {
@@ -32,7 +32,6 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "dist",
-    "skill"
+    "dist"
   ]
 }