openalmanac 0.2.31 → 0.2.33

package/dist/auth.js

@@ -42,13 +42,13 @@ export async function getAuthStatus() {
     if (!key)
         return { loggedIn: false };
     try {
-        const resp = await fetch(`${API_BASE}/api/agents/me`, {
+        const resp = await fetch(`${API_BASE}/api/users/me`, {
             headers: { Authorization: `Bearer ${key}` },
             signal: AbortSignal.timeout(10_000),
         });
         if (resp.ok) {
             const data = (await resp.json());
-            return { loggedIn: true, name: data.name ?? "unknown" };
+            return { loggedIn: true, name: data.display_name ?? data.username ?? "unknown" };
         }
     }
     catch {

package/dist/login-core.js

@@ -7,7 +7,7 @@ function callbackPage(success) {
     // These values are hardcoded — never interpolate user input here.
     const title = success ? "You\u2019re connected" : "Something went wrong";
     const messageLine1 = success
-        ? "Your agent is registered and ready to go."
+        ? "Your account is connected and a personal API key is ready to go."
         : "Invalid token. Please return to your terminal and try again.";
     const messageLine2 = success
         ? "You can close this tab and return to your terminal."
@@ -160,13 +160,13 @@ export async function performLogin(options) {
         const existingKey = getApiKey();
         if (existingKey) {
             try {
-                const resp = await fetch(`${API_BASE}/api/agents/me`, {
+                const resp = await fetch(`${API_BASE}/api/users/me`, {
                     headers: { Authorization: `Bearer ${existingKey}` },
                     signal: AbortSignal.timeout(10_000),
                 });
                 if (resp.ok) {
                     const data = (await resp.json());
-                    return { status: "already_logged_in", name: data.name ?? "unknown" };
+                    return { status: "already_logged_in", name: data.display_name ?? data.username ?? "unknown" };
                 }
             }
             catch {

package/dist/login.js

@@ -6,7 +6,7 @@ export async function runLogin() {
         console.log(`Already logged in as ${result.name}.`);
     }
     else {
-        console.log("Logged in. Your agent is registered and contributions will be attributed to your account.");
+        console.log("Logged in. A personal API key was created for this installation and contributions will be attributed to your account.");
     }
 }
 export async function runLogout() {

package/dist/server.js

@@ -124,7 +124,7 @@ export function createServer() {
             "",
             "## Technical workflow",
             "",
-            "Reading and searching articles is open. Writing requires an API key (from login). Login registers an agent linked to your human user, so contributions are attributed to both.",
+            "Reading and searching articles is open. Writing requires an API key (from login). Login creates a personal API key linked to your user account, so contributions are attributed to you.",
             "",
             "Core flow: login (once) → search_articles (check if exists) → search_web + read_webpage (research) → new (scaffold) or download (existing) → edit ~/.openalmanac/articles/{slug}.md → publish (validate & publish).",
             "",

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/auth.js

@@ -3,7 +3,7 @@ import { performLogin } from "../login-core.js";
 export function registerAuthTools(server) {
     server.addTool({
         name: "login",
-        description: "Log in via browser to register an agent and get an API key. This is the required " +
+        description: "Log in via browser to connect your account and get a personal API key. This is the required " +
             "first step before creating or updating articles. Only needs to be called once.\n\n" +
             "If you already have a valid API key, this returns immediately without opening a browser.",
         async execute() {
@@ -11,7 +11,7 @@ export function registerAuthTools(server) {
             if (result.status === "already_logged_in") {
                 return `Already logged in as ${result.name}.`;
             }
-            return "Logged in. Your agent is registered and contributions will be attributed to your account.";
+            return "Logged in. A personal API key was created for this installation and contributions will be attributed to your account.";
         },
     });
     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) => {
@@ -112,4 +130,20 @@ export function registerResearchTools(server) {
             return { content };
         },
     });
+    server.addTool({
+        name: "register_sources",
+        description: "Register sources you plan to cite in your response. Call this BEFORE writing your response text. " +
+            "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: 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"),
+        }),
+        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.31",
+  "version": "0.2.33",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {