openalmanac 0.3.4 → 0.3.6

package/dist/tools/topics.js

@@ -1,18 +1,6 @@
 import { z } from "zod";
 import { request } from "../auth.js";
-function coerceJson(schema) {
-    return z.preprocess((val) => {
-        if (typeof val === "string") {
-            try {
-                return JSON.parse(val);
-            }
-            catch {
-                return val;
-            }
-        }
-        return val;
-    }, schema);
-}
+import { coerceJson } from "../utils.js";
 export function registerTopicTools(server) {
     server.addTool({
         name: "list_topics",
@@ -28,24 +16,6 @@ export function registerTopicTools(server) {
             return JSON.stringify(await resp.json(), null, 2);
         },
     });
-    server.addTool({
-        name: "create_topic",
-        description: "Create a topic in a wiki. Topics are lightweight categories — pages can belong to multiple topics. Requires wiki membership.",
-        parameters: z.object({
-            wiki_slug: z.string().describe("Wiki slug"),
-            title: z.string().describe("Topic title"),
-            description: z.string().default("").describe("Topic description"),
-            image_url: z.string().url().max(2048).optional().describe("Topic image URL (https:// or http://)"),
-            parent_slugs: coerceJson(z.array(z.string())).default([]).describe("Parent topic slugs"),
-        }),
-        async execute({ wiki_slug, title, description, image_url, parent_slugs }) {
-            const resp = await request("POST", `/api/w/${wiki_slug}/topics`, {
-                auth: true,
-                json: { title, description, image_url, parent_slugs },
-            });
-            return JSON.stringify(await resp.json(), null, 2);
-        },
-    });
     server.addTool({
         name: "update_topic",
         description: "Update a topic's title, description, or image. Requires wiki moderator role.",
@@ -75,8 +45,8 @@ export function registerTopicTools(server) {
         },
     });
     server.addTool({
-        name: "create_topics_batch",
-        description: "Batch create topics in a wiki. Useful for bootstrapping a topic hierarchy. Requires wiki membership.",
+        name: "create_topics",
+        description: "Create one or more topics in a wiki. Topics are lightweight categories — pages can belong to multiple topics. Pass a single-element array for one topic: `[{ title: \"Security Pins\" }]`. Useful for bootstrapping a topic hierarchy. Requires wiki membership.",
         parameters: z.object({
             wiki_slug: z.string().describe("Wiki slug"),
             topics: coerceJson(z.array(z.object({
@@ -84,7 +54,7 @@ export function registerTopicTools(server) {
                 description: z.string().default(""),
                 image_url: z.string().url().max(2048).optional(),
                 parent_slugs: z.array(z.string()).default([]),
-            })).min(1).max(100)).describe("Topics to create"),
+            })).min(1).max(100)).describe("Topics to create (N=1 is fully supported)"),
         }),
         async execute({ wiki_slug, topics }) {
             const resp = await request("POST", `/api/w/${wiki_slug}/topics/batch`, {

package/dist/tools/wikis.js

@@ -1,18 +1,6 @@
 import { z } from "zod";
 import { request } from "../auth.js";
-function coerceJson(schema) {
-    return z.preprocess((val) => {
-        if (typeof val === "string") {
-            try {
-                return JSON.parse(val);
-            }
-            catch {
-                return val;
-            }
-        }
-        return val;
-    }, schema);
-}
+import { coerceJson } from "../utils.js";
 // Mirrors backend `NavItem` in src/schemas/wiki_settings_schemas.py. The
 // refinement matches the `exactly_one_target` @model_validator there —
 // agents get a clear error pre-flight instead of a 422 round-trip.
@@ -94,7 +82,7 @@ export function registerWikiTools(server) {
     });
     server.addTool({
         name: "update_wiki_settings",
-        description: "Update a wiki's settings (nav, cover_image_url, theme). Each NavItem must have exactly one of `page`, `topic`, or `link`. Use `auto` (only on topic items) to auto-populate children from the topic DAG. Requires moderator access.",
+        description: "Update a wiki's settings. Pass any combination of `nav`, `cover_image_url`, and `theme` — omitted fields are preserved (the backend uses exclude_unset merge). For example, `{nav: [...]}` updates navigation only without touching theme or cover_image_url. Each NavItem must have exactly one of `page`, `topic`, or `link`. Use `auto` (only on topic items) to auto-populate children from the topic DAG. Requires moderator access.",
         parameters: z.object({
             wiki_slug: z.string().describe("Wiki slug"),
             settings: coerceJson(z.object({
@@ -112,22 +100,32 @@ export function registerWikiTools(server) {
         },
     });
     server.addTool({
-        name: "update_nav",
-        description: "Update just the navigation tree for a wiki. Shorthand for updating settings.nav. Requires moderator access.",
+        name: "join_wiki",
+        description: "Join a wiki as a member. After joining you can create and edit pages. Requires login.",
         parameters: z.object({
             wiki_slug: z.string().describe("Wiki slug"),
-            nav: coerceJson(z.array(navItemSchema)).describe("Nav items"),
         }),
-        async execute({ wiki_slug, nav }) {
-            // Single atomic PATCH — the backend's update_settings service uses
-            // model_dump(exclude_unset=True) to merge partial bodies, so sending
-            // only {nav} doesn't touch theme or cover_image_url. Previously this
-            // did a GET-then-PATCH, which raced with concurrent settings updates.
-            const resp = await request("PATCH", `/api/w/${wiki_slug}/settings`, {
-                auth: true,
-                json: { nav },
-            });
-            return JSON.stringify(await resp.json(), null, 2);
+        async execute({ wiki_slug }) {
+            const resp = await request("POST", `/api/w/${wiki_slug}/join`, { auth: true });
+            const data = (await resp.json());
+            const role = data.role ?? "member";
+            return `Joined wiki "${wiki_slug}" as ${role}.`;
+        },
+    });
+    server.addTool({
+        name: "get_wiki_membership",
+        description: "Check your membership status in a wiki. Returns your role if you are a member. Requires login.",
+        parameters: z.object({
+            wiki_slug: z.string().describe("Wiki slug"),
+        }),
+        async execute({ wiki_slug }) {
+            const resp = await request("GET", `/api/w/${wiki_slug}/membership/me`, { auth: true });
+            const data = (await resp.json());
+            if (!data.is_member) {
+                return `You are not a member of "${wiki_slug}".`;
+            }
+            const role = data.role ?? "member";
+            return `You are a member of "${wiki_slug}" as ${role}.`;
         },
     });
 }

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+/**
+ * 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.
+ */
+export declare function coerceJson<T extends z.ZodTypeAny>(schema: T): z.ZodEffects<T, T["_output"], unknown>;

package/dist/utils.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+/**
+ * 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.
+ */
+export function coerceJson(schema) {
+    return z.preprocess((val) => {
+        if (typeof val === "string") {
+            try {
+                return JSON.parse(val);
+            }
+            catch {
+                return val;
+            }
+        }
+        return val;
+    }, schema);
+}

package/package.json

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

package/dist/tools/articles.d.ts

@@ -1,2 +0,0 @@
-import { FastMCP } from "fastmcp";
-export declare function registerArticleTools(server: FastMCP): void;