@floomhq/floom 1.0.36 → 1.0.38

package/dist/cli.js

@@ -126,6 +126,75 @@ function commandUsage() {
 `;
     process.stdout.write(out);
 }
+function shareUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} share`)} ${c.dim("<slug> [flags]")}
+
+ ${c.bold("Manage email access for one of your skills.")}
+   ${c.cyan(`${CLI_COMMAND} share support-tone --add person@example.com`)}
+   ${c.cyan(`${CLI_COMMAND} share support-tone --remove person@example.com`)}
+   ${c.cyan(`${CLI_COMMAND} share support-tone --list`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan("--add <email>")}       Grant access
+   ${c.cyan("--remove <email>")}    Revoke access
+   ${c.cyan("--list")}              Show who can access the skill
+`);
+}
+function libraryUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} library`)} ${c.dim("<command> [args] [flags]")}
+
+ ${c.bold("Commands")}
+   ${c.cyan("list")}                              Browse public libraries
+   ${c.cyan("create <slug> --name <name>")}       Create a library
+   ${c.cyan("add <library> <skill>")}             Add a skill to a library
+   ${c.cyan("remove <library> <skill>")}          Remove a skill from a library
+   ${c.cyan("subscribe <library>")}               Follow a library
+   ${c.cyan("unsubscribe <library>")}             Stop following a library
+
+ ${c.bold("Examples")}
+   ${c.cyan(`${CLI_COMMAND} library list --json`)}
+   ${c.cyan(`${CLI_COMMAND} library create team-onboarding --name "Team onboarding" --public`)}
+   ${c.cyan(`${CLI_COMMAND} library add team-onboarding support-tone --folder support --tags support,tone`)}
+`);
+}
+function moveUsage() {
+    process.stdout.write(`
+ ${c.bold("Usage:")} ${c.cyan(`${CLI_COMMAND} move`)} ${c.dim("<slug> --folder <path> [--tag <tag>]")}
+
+ ${c.bold("Place a saved or subscribed skill in a local folder.")}
+   ${c.cyan(`${CLI_COMMAND} move support-tone --folder support/tone`)}
+   ${c.cyan(`${CLI_COMMAND} move support-tone --root`)}
+   ${c.cyan(`${CLI_COMMAND} move support-tone --folder support --tags support,tone`)}
+
+ ${c.bold("Flags")}
+   ${c.cyan("--folder <path>")}     Folder path for synced installs
+   ${c.cyan("--root")}              Put the skill at the root
+   ${c.cyan("--tag <tag>")}         Add one tag, repeatable
+   ${c.cyan("--tags a,b")}          Add comma-separated tags
+`);
+}
+function isHelpArg(value) {
+    return value === "--help" || value === "-h" || value === "help";
+}
+function subcommandUsage(cmd) {
+    switch (cmd) {
+        case "share":
+            shareUsage();
+            return true;
+        case "library":
+        case "lib":
+            libraryUsage();
+            return true;
+        case "move":
+            moveUsage();
+            return true;
+        default:
+            commandUsage();
+            return true;
+    }
+}
 const ASSET_TYPES = new Set(["knowledge", "instruction", "workflow", "skill"]);
 const INSTALL_TARGETS = new Set([
     "claude_skill",
@@ -695,10 +764,8 @@ async function main() {
             // never block on update-notifier
         }
     }
-    // Subcommand --help: any rest arg = --help/-h/help → show top-level usage.
-    // Subcommands are simple enough that one help screen is fine for Version 1.
-    if (rest.includes("--help") || rest.includes("-h") || rest.includes("help")) {
-        usage();
+    if (rest.some(isHelpArg)) {
+        subcommandUsage(cmd);
         return;
     }
     try {

package/dist/errors.js

@@ -12,7 +12,7 @@ export class FloomError extends Error {
             this.hint = hint;
     }
 }
-export function friendlyHttp(status, action) {
+export function friendlyHttp(status, action, detail) {
     if (status === 401) {
         return new FloomError("Your token expired.", "Run `npx -y @floomhq/floom login` to refresh.");
     }
@@ -34,6 +34,9 @@ export function friendlyHttp(status, action) {
     if (status >= 500) {
         return new FloomError("Floom is having trouble right now.", "Try again in a moment.");
     }
+    if (detail) {
+        return new FloomError(detail);
+    }
     return new FloomError(`Request failed (HTTP ${status}) while trying to ${action}.`);
 }
 export function friendlyNetwork(err) {

package/dist/lib/api.js

@@ -39,7 +39,7 @@ export async function floomFetch(url, action, opts = {}) {
             continue;
         }
         if (opts.checkOk !== false && !res.ok) {
-            throw friendlyHttp(res.status, action);
+            throw friendlyHttp(res.status, action, await responseErrorDetail(res));
         }
         return res;
     }
@@ -94,6 +94,29 @@ async function drainResponse(res) {
         // Ignore bodies from rate-limit responses; the retry decision is header-based.
     }
 }
+async function responseErrorDetail(res) {
+    try {
+        const text = await res.text();
+        if (!text.trim())
+            return null;
+        try {
+            const json = JSON.parse(text);
+            const detail = typeof json.error === "string"
+                ? json.error
+                : typeof json.message === "string"
+                    ? json.message
+                    : null;
+            const hint = typeof json.hint === "string" ? json.hint : null;
+            return [detail, hint].filter(Boolean).join("\n") || null;
+        }
+        catch {
+            return text.trim().slice(0, 400);
+        }
+    }
+    catch {
+        return null;
+    }
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/sync.js

@@ -270,7 +270,7 @@ export async function sync(opts = {}) {
     const spinner = opts.spinner === false ? null : ora({ text: c.dim("Syncing skills..."), color: "yellow" }).start();
     let payload;
     try {
-        payload = await getJson(`${apiUrl}/api/v1/me/skills`, "load your skills", cfg.accessToken);
+        payload = await loadSyncPayload(apiUrl, cfg.accessToken);
     }
     catch (err) {
         spinner?.stop();
@@ -442,3 +442,28 @@ export async function sync(opts = {}) {
         throw err;
     }
 }
+async function loadSyncPayload(apiUrl, token) {
+    const all = [];
+    let fullSync = false;
+    let cursor;
+    const seenCursors = new Set();
+    for (let page = 0; page < 1000; page += 1) {
+        const url = new URL(`${apiUrl}/api/v1/me/skills`);
+        url.searchParams.set("limit", "25");
+        if (cursor)
+            url.searchParams.set("cursor", cursor);
+        const payload = await getJson(url.toString(), "load your skills", token);
+        if (!Array.isArray(payload.skills))
+            throw new FloomError("Invalid sync response.");
+        all.push(...payload.skills);
+        fullSync = payload.full_sync === true;
+        if (!payload.next_cursor) {
+            return { skills: all, full_sync: fullSync };
+        }
+        if (seenCursors.has(payload.next_cursor))
+            throw new FloomError("Invalid sync response.");
+        seenCursors.add(payload.next_cursor);
+        cursor = payload.next_cursor;
+    }
+    throw new FloomError("Invalid sync response.");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floomhq/floom",
-  "version": "1.0.36",
+  "version": "1.0.38",
   "description": "Sync AI skills across agents and machines.",
   "license": "MIT",
   "type": "module",