@floomhq/floom-mcp-sync 1.0.0 → 1.0.1

package/README.md

@@ -6,7 +6,7 @@ Tiny MCP server for Floom skills. This package is part of the Floom Version 1 sy
 npx -y @floomhq/floom-mcp-sync
 ```
 
-On startup it reads `~/.floom/config.json`, fetches your own published Floom skills, and writes missing files to `~/.claude/skills/`. The background sync behavior is a Version 1 preview path.
+On startup it reads `~/.floom/config.json`, fetches published, saved, and subscribed library skills, and writes missing files to `~/.claude/skills/`. The background sync behavior is a Version 1 preview path.
 
 Sync stores a machine-local manifest next to the Floom CLI config at `~/.floom/sync-manifest.json`.
 Version 1 sync does not replace existing local Markdown files. Remote updates, existing untracked
@@ -25,4 +25,9 @@ Tools:
   - `installs_as`: `claude_skill`, `memory`, `rule`, `codex_instruction`, `opencode_instruction`, `cursor_rule`, or `other` (default `claude_skill`)
   - `version`: optional label like `1.0.0` or `v1-preview`
 
-Library management and share-invite tools are planned for a later Floom version.
+- `floom_list_libraries()` lists public Floom libraries.
+- `floom_subscribe_library(slug)` subscribes the signed-in user so the library syncs locally.
+- `floom_unsubscribe_library(slug)` removes that subscription.
+- `floom_move_skill(slug, folder, tags?)` sets the signed-in user's local folder/tags override.
+
+Team workspaces, share invites, and role-based library access are planned for a later Floom version.

package/dist/server.js

@@ -4,12 +4,14 @@ import { stdin, stdout } from "node:process";
 import { autoSync } from "./auto-sync.js";
 import { installSkill } from "./tools/install.js";
 import { publishSkill } from "./tools/publish.js";
-const SERVER_VERSION = "1.0.0";
+import { listLibraries, moveSkill, subscribeLibrary, unsubscribeLibrary, } from "./tools/libraries.js";
+const SERVER_VERSION = "1.0.1";
 const DEFAULT_INTERVAL_MS = 60_000;
 const MIN_INTERVAL_MS = 10_000;
 const VERSION_RE = /^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$/;
 const VISIBILITIES = new Set(["unlisted", "public", "private"]);
 const ASSET_TYPES = new Set(["knowledge", "instruction", "workflow", "skill"]);
+const FOLDER_RE = /^[a-z0-9][a-z0-9._-]*(\/[a-z0-9][a-z0-9._-]*)*$/;
 const INSTALL_TARGETS = new Set([
     "claude_skill",
     "memory",
@@ -29,7 +31,7 @@ Usage
 
 Behavior
   Starts a stdio MCP server.
-  Syncs your own published Floom skills into ~/.claude/skills/ on startup.
+  Syncs published, saved, and subscribed library skills into ~/.claude/skills/.
   Polls for updates while the MCP process is running.
 
 Options
@@ -120,6 +122,57 @@ function toolList() {
                     additionalProperties: false,
                 },
             },
+            {
+                name: "floom_list_libraries",
+                description: "List public Floom libraries.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    additionalProperties: false,
+                },
+            },
+            {
+                name: "floom_subscribe_library",
+                description: "Subscribe the signed-in user to a Floom library so it syncs locally.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        slug: { type: "string", minLength: 1, maxLength: 64 },
+                    },
+                    required: ["slug"],
+                    additionalProperties: false,
+                },
+            },
+            {
+                name: "floom_unsubscribe_library",
+                description: "Unsubscribe the signed-in user from a Floom library.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        slug: { type: "string", minLength: 1, maxLength: 64 },
+                    },
+                    required: ["slug"],
+                    additionalProperties: false,
+                },
+            },
+            {
+                name: "floom_move_skill",
+                description: "Set a signed-in user's local folder/tags override for a Floom skill.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        slug: { type: "string", minLength: 1, maxLength: 128 },
+                        folder: { type: ["string", "null"], maxLength: 256 },
+                        tags: {
+                            type: "array",
+                            items: { type: "string", minLength: 1, maxLength: 64 },
+                            maxItems: 32,
+                        },
+                    },
+                    required: ["slug", "folder"],
+                    additionalProperties: false,
+                },
+            },
         ],
     };
 }
@@ -157,6 +210,21 @@ function nullableEnumValue(value, label, allowed, fallback) {
         throw new Error(`Invalid ${label}.`);
     return value;
 }
+function optionalStringArray(value, label, maxItems, maxLength) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > maxItems)
+        throw new Error(`Invalid ${label}.`);
+    return value.map((item) => asString(item, label, 1, maxLength));
+}
+function nullableFolder(value) {
+    if (value === null)
+        return null;
+    const folder = asString(value, "folder", 1, 256);
+    if (!FOLDER_RE.test(folder))
+        throw new Error("Invalid folder.");
+    return folder;
+}
 async function callTool(params) {
     const parsed = asObject(params);
     const name = asString(parsed.name, "tool name", 1, 200);
@@ -170,6 +238,18 @@ async function callTool(params) {
             throw new Error("Invalid version.");
         return ok(await publishSkill(asString(args.name, "name", 1, 200), asString(args.content, "content", 1, 500_000), optionalString(args.description, "description", 1000), enumValue(args.visibility, "visibility", VISIBILITIES, "unlisted"), enumValue(args.asset_type, "asset_type", ASSET_TYPES, "skill"), nullableEnumValue(args.installs_as, "installs_as", INSTALL_TARGETS, "claude_skill"), version));
     }
+    if (name === "floom_list_libraries") {
+        return ok(await listLibraries());
+    }
+    if (name === "floom_subscribe_library") {
+        return ok(await subscribeLibrary(asString(args.slug, "slug", 1, 64)));
+    }
+    if (name === "floom_unsubscribe_library") {
+        return ok(await unsubscribeLibrary(asString(args.slug, "slug", 1, 64)));
+    }
+    if (name === "floom_move_skill") {
+        return ok(await moveSkill(asString(args.slug, "slug", 1, 128), nullableFolder(args.folder), optionalStringArray(args.tags, "tags", 32, 64)));
+    }
     throw new Error(`Unknown tool: ${name}`);
 }
 function response(id, result) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floomhq/floom-mcp-sync",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Lightweight Floom MCP server for installing, publishing, and startup-syncing skills.",
   "license": "MIT",
   "type": "module",