openalmanac 0.2.32 → 0.2.33

package/dist/tools/articles.js

@@ -6,6 +6,24 @@ import { request, ARTICLES_DIR, getAuthStatus } from "../auth.js";
 import { validateArticle, parseFrontmatter } from "../validate.js";
 import { openBrowser } from "../browser.js";
 const SLUG_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/**
+ * Workaround for Claude Agent SDK MCP transport bug (#18260):
+ * Array/object parameters are sometimes serialized as JSON strings
+ * instead of native values. This preprocessor coerces them back.
+ */
+function coerceJson(schema) {
+    return z.preprocess((val) => {
+        if (typeof val === "string") {
+            try {
+                return JSON.parse(val);
+            }
+            catch {
+                return val;
+            }
+        }
+        return val;
+    }, schema);
+}
 const WRITING_GUIDE = `
 ## Article structure
 
@@ -131,7 +149,7 @@ export function registerArticleTools(server) {
             "Use this to check if articles or stubs exist before creating them, or to find entity slugs for wikilinks. " +
             "Results include 'stub' field (true/false) and 'entity_type' field. No authentication needed.",
         parameters: z.object({
-            queries: z.array(z.string()).min(1).max(20).describe("Search queries (1-20)"),
+            queries: coerceJson(z.array(z.string()).min(1).max(20)).describe("Search queries (1-20)"),
             limit: z.number().default(5).describe("Max results per query (1-50, default 5)"),
             include_stubs: z.boolean().default(true).describe("Include stub articles in results (default true)"),
         }),
@@ -148,7 +166,7 @@ export function registerArticleTools(server) {
             "Use this to reference or summarize existing articles in conversation. " +
             "For editing articles locally, use 'download' instead. No authentication needed.",
         parameters: z.object({
-            slugs: z.array(z.string()).min(1).max(20).describe("Article slugs to read (1-20)"),
+            slugs: coerceJson(z.array(z.string()).min(1).max(20)).describe("Article slugs to read (1-20)"),
         }),
         async execute({ slugs }) {
             const resp = await request("POST", "/api/articles/batch", {
@@ -163,7 +181,7 @@ export function registerArticleTools(server) {
             "Use this for every entity (person, organization, topic, etc.) mentioned in an article. " +
             "Idempotent: existing slugs return their current status. Requires login.",
         parameters: z.object({
-            stubs: z.array(z.object({
+            stubs: coerceJson(z.array(z.object({
                 slug: z
                     .string()
                     .min(1)
@@ -187,7 +205,7 @@ export function registerArticleTools(server) {
                     .optional()
                     .describe("2-4 sentence summary of the entity. This becomes the stub page content. " +
                     "Be informative — include key facts, dates, and context."),
-            })).min(1).max(50).describe("Stubs to create (1-50)"),
+            })).min(1).max(50)).describe("Stubs to create (1-50)"),
         }),
         async execute({ stubs }) {
             const resp = await request("POST", "/api/articles/stubs", {
@@ -300,7 +318,11 @@ export function registerArticleTools(server) {
             });
             const data = (await resp.json());
             const articleUrl = `https://www.openalmanac.org/article/${slug}?celebrate=true`;
-            openBrowser(articleUrl);
+            const inGui = process.env.OPENALMANAC_GUI === "1";
+            // Skip browser open when running inside the GUI — it handles navigation itself
+            if (!inGui) {
+                openBrowser(articleUrl);
+            }
             // Clean up local files after successful publish
             let cleanupWarning = "";
             try {
@@ -319,7 +341,10 @@ export function registerArticleTools(server) {
                     cleanupWarning += `\nNote: could not remove original copy: ${e.message}`;
                 }
             }
-            return `Pushed successfully.\n\nArticle URL (share this exact link with the user): ${articleUrl}${cleanupWarning}\n\n${JSON.stringify(data, null, 2)}`;
+            const urlLine = inGui
+                ? "The article has been published! Let the user know it's live. Do not send them to a web URL."
+                : `Article URL (share this exact link with the user): ${articleUrl}`;
+            return `Pushed successfully.\n\n${urlLine}${cleanupWarning}\n\n${JSON.stringify(data, null, 2)}`;
         },
     });
     server.addTool({

package/dist/tools/communities.js

@@ -1,5 +1,23 @@
 import { z } from "zod";
 import { request } from "../auth.js";
+/**
+ * Workaround for Claude Agent SDK MCP transport bug (#18260):
+ * Array/object parameters are sometimes serialized as JSON strings
+ * instead of native values. This preprocessor coerces them back.
+ */
+function coerceJson(schema) {
+    return z.preprocess((val) => {
+        if (typeof val === "string") {
+            try {
+                return JSON.parse(val);
+            }
+            catch {
+                return val;
+            }
+        }
+        return val;
+    }, schema);
+}
 export function registerCommunityTools(server) {
     server.addTool({
         name: "search_communities",
@@ -98,10 +116,10 @@ export function registerCommunityTools(server) {
             "Idempotent — already-linked articles are reported but don't cause errors. Requires login.",
         parameters: z.object({
             article_id: z.string().describe("Article slug/ID to link (e.g. 'machine-learning')"),
-            community_slugs: z
+            community_slugs: coerceJson(z
                 .array(z.string())
                 .min(1)
-                .max(50)
+                .max(50))
                 .describe("List of community slugs to link the article to (max 50)"),
         }),
         async execute({ article_id, community_slugs }) {

package/dist/tools/research.js

@@ -1,6 +1,24 @@
 import { z } from "zod";
 import { imageContent } from "fastmcp";
 import { request } from "../auth.js";
+/**
+ * Workaround for Claude Agent SDK MCP transport bug (#18260):
+ * Array/object parameters are sometimes serialized as JSON strings
+ * instead of native values. This preprocessor coerces them back.
+ */
+function coerceJson(schema) {
+    return z.preprocess((val) => {
+        if (typeof val === "string") {
+            try {
+                return JSON.parse(val);
+            }
+            catch {
+                return val;
+            }
+        }
+        return val;
+    }, schema);
+}
 export function registerResearchTools(server) {
     server.addTool({
         name: "search_web",
@@ -70,7 +88,7 @@ export function registerResearchTools(server) {
             "- For the infobox hero image, set `infobox.header.image_url` in frontmatter instead\n\n" +
             "Requires login. Rate limit: 10/min.",
         parameters: z.object({
-            queries: z.array(z.string()).min(1).max(10).describe("Image search queries (1-10)"),
+            queries: coerceJson(z.array(z.string()).min(1).max(10)).describe("Image search queries (1-10)"),
             source: z.enum(["wikimedia", "google"]).default("wikimedia").describe("Image source: 'wikimedia' (free, open-licensed — preferred) or 'google' (broader coverage)"),
             limit: z.number().default(5).describe("Max results per query (1-10, default 5)"),
         }),
@@ -87,7 +105,7 @@ export function registerResearchTools(server) {
         description: "View images to verify they're suitable. Use after search_images to inspect candidates " +
             "before including them. Returns each image so you can see what it shows and write accurate captions.",
         parameters: z.object({
-            urls: z.array(z.string().url()).min(1).max(10).describe("Image URLs to view (1-10)"),
+            urls: coerceJson(z.array(z.string().url()).min(1).max(10)).describe("Image URLs to view (1-10)"),
         }),
         async execute({ urls }) {
             const results = await Promise.allSettled(urls.map(async (url) => {
@@ -118,11 +136,11 @@ export function registerResearchTools(server) {
             "Each source becomes a clickable citation bubble when you use [@key] markers in your text. " +
             "Collect sources from your read_webpage calls and any subagent results, then register them all in one call.",
         parameters: z.object({
-            sources: z.array(z.object({
+            sources: coerceJson(z.array(z.object({
                 key: z.string().describe("Citation key — kebab-case, BibTeX-style: {domain}-{title-words} (e.g. 'nytimes-climate-report')"),
                 url: z.string().describe("Source URL"),
                 title: z.string().describe("Source title — include publication name after em dash (e.g. 'Climate Report — The New York Times')"),
-            })).min(1).describe("Sources to register for citation"),
+            })).min(1)).describe("Sources to register for citation"),
         }),
         async execute({ sources }) {
             return `Registered ${sources.length} source${sources.length === 1 ? "" : "s"}. Use [@key] markers in your response to cite them.`;

package/package.json

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