openalmanac 0.2.14 → 0.2.15

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. 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. " +
+            "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. " +

package/dist/tools/articles.js

@@ -84,22 +84,27 @@ Include an infobox for any article about a person, place, organization, event, o
 
 ## Images
 
-Use search_images to find relevant images. Place them inline using standard markdown:
+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...
-\`\`\`
 
-The image goes on the line BEFORE the paragraph it illustrates. It floats right on desktop.
+![Panoramic view of Bletchley Park](https://upload.wikimedia.org/... "center")
+\`\`\`
 
 **Caption rules:**
-- Every image MUST have a descriptive caption (the alt text)
+- 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"
-- For the infobox hero image, use \`infobox.header.image_url\` in frontmatter instead
+- 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.
 

package/dist/tools/research.js

@@ -47,13 +47,21 @@ export function registerResearchTools(server) {
             "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" +
+            "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 (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" +
+            "- 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" +

package/package.json

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