@floomhq/skills 0.2.0

package/dist/api-client.d.ts

@@ -0,0 +1,9 @@
+export interface ApiOptions {
+    method?: "GET" | "POST" | "PATCH" | "DELETE" | "PUT";
+    body?: unknown;
+    authRequired?: boolean;
+    query?: Record<string, string | number | boolean | undefined>;
+}
+export declare function api<T = unknown>(path: string, opts?: ApiOptions): Promise<T>;
+export declare function rawPut(url: string, body: Buffer | Uint8Array, contentType?: string): Promise<void>;
+export declare function rawGet(url: string): Promise<Buffer>;

package/dist/api-client.js

@@ -0,0 +1,61 @@
+import { FloomError } from "@floom/shared";
+import { getApiUrl, readAuth } from "./config.js";
+import { VERSION } from "./version.js";
+export async function api(path, opts = {}) {
+    const auth = await readAuth();
+    if (opts.authRequired && !auth) {
+        throw new FloomError("AUTH_REQUIRED", "Not logged in. Run: floom login");
+    }
+    const url = new URL((auth?.apiUrl ?? getApiUrl()) + path);
+    if (opts.query) {
+        for (const [k, v] of Object.entries(opts.query)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    const headers = {
+        "Content-Type": "application/json",
+        "User-Agent": `floom-cli/${VERSION}`,
+        "x-floom-cli-version": VERSION,
+    };
+    if (auth)
+        headers.Authorization = `Bearer ${auth.token}`;
+    const res = await fetch(url.toString(), {
+        method: opts.method ?? "GET",
+        headers,
+        body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+    });
+    const text = await res.text();
+    let json = null;
+    try {
+        json = text ? JSON.parse(text) : null;
+    }
+    catch { /* not JSON */ }
+    if (!res.ok) {
+        const err = json?.error ?? {};
+        throw new FloomError((err.code ?? "INTERNAL_ERROR"), err.message ?? `HTTP ${res.status} ${res.statusText}`, { status: res.status, requestId: err.request_id });
+    }
+    return json;
+}
+// Variants for binary upload/download to Supabase Storage signed URLs (no auth header)
+export async function rawPut(url, body, contentType = "application/octet-stream") {
+    // Convert to BufferSource that fetch accepts
+    const u8 = body instanceof Buffer ? new Uint8Array(body) : body;
+    const res = await fetch(url, {
+        method: "PUT",
+        headers: { "Content-Type": contentType },
+        body: u8,
+    });
+    if (!res.ok) {
+        throw new FloomError("UPLOAD_FAILED", `Upload failed: HTTP ${res.status} ${res.statusText}`);
+    }
+}
+export async function rawGet(url) {
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new FloomError("DOWNLOAD_FAILED", `Download failed: HTTP ${res.status} ${res.statusText}`);
+    }
+    const ab = await res.arrayBuffer();
+    return Buffer.from(ab);
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/commands/info.d.ts

@@ -0,0 +1 @@
+export declare function infoCommand(refStr: string): Promise<void>;

package/dist/commands/info.js

@@ -0,0 +1,24 @@
+import { parseSkillRef } from "@floom/shared";
+import { api } from "../api-client.js";
+import { log } from "../lib/output.js";
+export async function infoCommand(refStr) {
+    const ref = parseSkillRef(refStr);
+    if (!ref) {
+        log.err(`Invalid skill ref: ${refStr}`);
+        process.exit(1);
+    }
+    const r = await api(`/skills/${ref.owner}/${ref.slug}`);
+    log.heading(r.ref);
+    log.kv("Title", r.title);
+    log.kv("Description", r.description);
+    log.kv("Latest", r.latest_version);
+    log.kv("Visibility", r.visibility);
+    log.kv("Owner", `@${r.owner.handle}${r.owner.display_name ? ` (${r.owner.display_name})` : ""}`);
+    if (r.has_scripts) {
+        log.kv("Scripts", "yes (review before activating)");
+    }
+    log.blank();
+    log.info("Install:");
+    log.info(`  floom install ${r.ref}`);
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAavC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,CAAC,GAAG,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,GAAG,CAAe,WAAW,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IACrC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAClB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IACtD,CAAC;IACD,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrB,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function initCommand(): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,108 @@
+import { writeFile, stat } from "node:fs/promises";
+import { join, basename } from "node:path";
+import prompts from "prompts";
+import { isValidSlug, slugErrorMessage } from "@floom/shared";
+import { log } from "../lib/output.js";
+async function pathExists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function initCommand() {
+    const cwd = process.cwd();
+    const folderName = basename(cwd);
+    if (await pathExists(join(cwd, "skill.json"))) {
+        log.err("skill.json already exists in this folder. Edit it directly or run from a fresh directory.");
+        process.exit(1);
+    }
+    const defaultName = folderName.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    const answers = await prompts([
+        {
+            type: "text",
+            name: "name",
+            message: "Skill name (lowercase, hyphens):",
+            initial: isValidSlug(defaultName) ? defaultName : "",
+            validate: (v) => slugErrorMessage(v) ?? true,
+        },
+        {
+            type: "text",
+            name: "title",
+            message: "Title (human-readable):",
+            initial: (prev) => prev.split("-").map((w) => w[0]?.toUpperCase() + w.slice(1)).join(" "),
+            validate: (v) => v.trim().length > 0 ? true : "title required",
+        },
+        {
+            type: "text",
+            name: "description",
+            message: "One-line description:",
+            validate: (v) => v.trim().length > 0 ? true : "description required",
+        },
+        {
+            type: "text",
+            name: "version",
+            message: "Version:",
+            initial: "0.1.0",
+        },
+    ]);
+    if (!answers.name) {
+        log.err("Init cancelled.");
+        process.exit(1);
+    }
+    const manifest = {
+        schema_version: "0.1",
+        name: answers.name,
+        title: answers.title,
+        description: answers.description,
+        version: answers.version,
+        entrypoint: "SKILL.md",
+        targets: ["generic"],
+    };
+    const skillMd = `---
+name: ${answers.name}
+description: ${answers.description}
+---
+
+# ${answers.title}
+
+## Purpose
+
+${answers.description}
+
+## When to use
+
+(Describe when this skill should be activated.)
+
+## Process
+
+1. (Step one)
+2. (Step two)
+
+## Output
+
+(Describe what the skill produces.)
+`;
+    const floomIgnore = `# Floom CLI ignore patterns
+# One pattern per line, glob-style
+tmp/
+drafts/
+*.log
+`;
+    await writeFile(join(cwd, "skill.json"), JSON.stringify(manifest, null, 2) + "\n", "utf8");
+    await writeFile(join(cwd, "SKILL.md"), skillMd, "utf8");
+    await writeFile(join(cwd, ".floomignore"), floomIgnore, "utf8");
+    log.blank();
+    log.ok("Skill scaffolded.");
+    log.kv("skill.json", "manifest (edit metadata)");
+    log.kv("SKILL.md", "instructions for the agent");
+    log.kv(".floomignore", "patterns to exclude from publish");
+    log.blank();
+    log.info("Next:");
+    log.info("  1. Edit SKILL.md");
+    log.info("  2. floom validate");
+    log.info("  3. floom publish");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/install.d.ts

@@ -0,0 +1,8 @@
+import { type InstallTarget } from "@floom/shared";
+export interface InstallOptions {
+    for?: InstallTarget;
+    to?: string;
+    global?: boolean;
+    force?: boolean;
+}
+export declare function installCommand(refStr: string, opts?: InstallOptions): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,136 @@
+import { mkdir, readdir, rm, rename } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { parseSkillRef, formatSkillRef, resolveInstallDir, extractBundle, verifyBundleHash, FloomError, } from "@floom/shared";
+import { api, rawGet } from "../api-client.js";
+import { readAuth } from "../config.js";
+import { log } from "../lib/output.js";
+import { readLock, writeLock, setLockEntry, hashInstalledFolder } from "../lib/floom-lock.js";
+import { VERSION } from "../version.js";
+const CLI_VERSION = VERSION;
+function semverGte(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] ?? 0) > (pb[i] ?? 0))
+            return true;
+        if ((pa[i] ?? 0) < (pb[i] ?? 0))
+            return false;
+    }
+    return true;
+}
+export async function installCommand(refStr, opts = {}) {
+    const ref = parseSkillRef(refStr);
+    if (!ref) {
+        log.err(`Invalid skill ref: ${refStr}`);
+        log.info("Expected: @owner/slug, library-slug/slug, or with @version suffix");
+        process.exit(1);
+    }
+    // Get metadata (works anonymously for public skills)
+    let info;
+    try {
+        info = await api(`/skills/${ref.owner}/${ref.slug}`);
+    }
+    catch (e) {
+        if (e instanceof FloomError && e.code === "SKILL_ACCESS_DENIED") {
+            const auth = await readAuth();
+            if (!auth) {
+                log.err(`Cannot access ${formatSkillRef(ref)}.`);
+                log.info("Run `floom login` to install private or unlisted skills.");
+                process.exit(1);
+            }
+            log.err(`You do not have access to ${formatSkillRef(ref)}.`);
+            log.info(`Ask the owner to share it with: ${auth.email}`);
+            process.exit(1);
+        }
+        throw e;
+    }
+    if (info.min_floom_version && !semverGte(CLI_VERSION, info.min_floom_version)) {
+        log.err(`This skill requires Floom CLI >= ${info.min_floom_version} (you have ${CLI_VERSION}).`);
+        log.info("Upgrade:");
+        log.info("  npm install -g @floomhq/skills@latest");
+        process.exit(1);
+    }
+    // Resolve install destination
+    const target = resolveInstallDir({
+        target: opts.for ?? "generic",
+        to: opts.to,
+        global: opts.global,
+    });
+    const projectDir = opts.global ? process.cwd() : process.cwd();
+    const destFolder = join(target.dir, ref.slug);
+    // Conflict check
+    const lock = await readLock(projectDir);
+    const refKey = formatSkillRef({ owner: ref.owner, slug: ref.slug });
+    const existing = lock.skills[refKey];
+    let folderExists = false;
+    try {
+        const entries = await readdir(destFolder);
+        folderExists = entries.length > 0;
+    }
+    catch { /* not exists */ }
+    if (folderExists) {
+        if (existing && existing.path === destFolder.replace(projectDir + "/", "")) {
+            // Tracked. Check local edits.
+            const current = await hashInstalledFolder(destFolder);
+            // For V0 we don't have file-level hashes in lock; we conservatively warn unless --force.
+            if (!opts.force) {
+                log.warn(`Folder already exists at ${destFolder} and may contain local edits.`);
+                log.info(`Re-run with --force to overwrite, or remove the folder manually.`);
+                process.exit(1);
+            }
+        }
+        else if (!opts.force) {
+            log.err(`Folder already exists at ${destFolder} (not tracked by floom.lock).`);
+            log.info("Re-run with --force to overwrite, or remove the folder manually.");
+            process.exit(1);
+        }
+    }
+    // Download
+    log.step("Fetching skill metadata...");
+    const dl = await api(`/skills/${ref.owner}/${ref.slug}/download`, {
+        query: { version: ref.version },
+    });
+    log.step("Downloading bundle...");
+    const buf = await rawGet(dl.download.url);
+    if (!verifyBundleHash(buf, dl.bundle_sha256)) {
+        log.err("Bundle hash mismatch — refusing to extract.");
+        process.exit(1);
+    }
+    log.ok(`Bundle verified (${(buf.length / 1024).toFixed(1)} KB).`);
+    // Extract to temp, then swap
+    const tmp = await import("node:fs/promises").then((m) => m.mkdtemp(join(tmpdir(), `floom-install-${ref.slug}-`)));
+    try {
+        await extractBundle(buf, tmp);
+        await mkdir(target.dir, { recursive: true });
+        if (folderExists) {
+            await rm(destFolder, { recursive: true, force: true });
+        }
+        await rename(tmp, destFolder);
+    }
+    catch (e) {
+        await rm(tmp, { recursive: true, force: true }).catch(() => { });
+        throw e;
+    }
+    // Update floom.lock
+    const next = setLockEntry(lock, refKey, {
+        version: dl.version,
+        resolved: `${process.env.FLOOM_APP_URL ?? "https://floom-v0.vercel.app"}/${refKey}`,
+        bundle_sha256: dl.bundle_sha256,
+        installed_at: new Date().toISOString(),
+        path: destFolder.replace(projectDir + "/", ""),
+        preset: opts.for,
+    });
+    await writeLock(projectDir, next);
+    log.blank();
+    log.ok(`Installed ${refKey}@${dl.version}`);
+    log.kv("Path", destFolder);
+    log.kv("Target", target.target);
+    log.kv("Compatible with", target.compatibleAgents.join(", "));
+    if (dl.has_scripts) {
+        log.blank();
+        log.warn("This skill contains executable scripts. Floom does not run them; your agent may.");
+        log.warn("Review the scripts/ folder before activating.");
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/commands/installed.d.ts

@@ -0,0 +1,4 @@
+export interface InstalledOptions {
+    json?: boolean;
+}
+export declare function installedCommand(opts?: InstalledOptions): Promise<void>;

package/dist/commands/installed.js

@@ -0,0 +1,22 @@
+import { readLock } from "../lib/floom-lock.js";
+import { log } from "../lib/output.js";
+export async function installedCommand(opts = {}) {
+    const lock = await readLock(process.cwd());
+    const entries = Object.entries(lock.skills);
+    if (opts.json) {
+        console.log(JSON.stringify(lock, null, 2));
+        return;
+    }
+    if (entries.length === 0) {
+        log.info("No skills installed in this project.");
+        log.info("Get one: floom install @owner/slug");
+        return;
+    }
+    log.heading("Installed skills in this project");
+    for (const [ref, e] of entries) {
+        console.log(`  ${ref.padEnd(40)} ${e.version.padEnd(8)} ${(e.preset ?? "-").padEnd(8)} ${e.path}`);
+    }
+    log.blank();
+    log.info(`${entries.length} skill${entries.length === 1 ? "" : "s"} installed.`);
+}
+//# sourceMappingURL=installed.js.map

package/dist/commands/installed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed.js","sourceRoot":"","sources":["../../src/commands/installed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAMvC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAyB,EAAE;IAChE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,GAAG,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,SAAS,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;AACnF,CAAC"}

package/dist/commands/library.d.ts

@@ -0,0 +1,4 @@
+export declare function libraryListCommand(): Promise<void>;
+export declare function libraryCreateCommand(slug: string, name: string): Promise<void>;
+export declare function libraryInviteCommand(librarySlug: string, email: string, role?: string): Promise<void>;
+export declare function libraryLeaveCommand(librarySlug: string): Promise<void>;

package/dist/commands/library.js

@@ -0,0 +1,29 @@
+import { api } from "../api-client.js";
+import { log } from "../lib/output.js";
+export async function libraryListCommand() {
+    const resp = await api("/libraries", { authRequired: true });
+    if (!resp.libraries.length) {
+        log.info("No libraries.");
+        return;
+    }
+    for (const l of resp.libraries) {
+        console.log(`${l.slug.padEnd(24)} ${l.type.padEnd(8)} ${l.role.padEnd(6)} ${l.name}`);
+    }
+}
+export async function libraryCreateCommand(slug, name) {
+    const resp = await api("/libraries", { method: "POST", authRequired: true, body: { slug, name } });
+    log.ok(`Created library ${resp.slug}`);
+}
+export async function libraryInviteCommand(librarySlug, email, role = "viewer") {
+    await api(`/libraries/${librarySlug}/pending-invites`, {
+        method: "POST",
+        authRequired: true,
+        body: { email, role },
+    });
+    log.ok(`Invited ${email} to ${librarySlug} as ${role}`);
+}
+export async function libraryLeaveCommand(librarySlug) {
+    await api(`/libraries/${librarySlug}/members/me`, { method: "DELETE", authRequired: true });
+    log.ok(`Left library ${librarySlug}`);
+}
+//# sourceMappingURL=library.js.map

package/dist/commands/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../src/commands/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAWvC,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,IAAI,GAAG,MAAM,GAAG,CAA8B,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,IAAY;IACnE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAa,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/G,GAAG,CAAC,EAAE,CAAC,mBAAmB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,KAAa,EAAE,IAAI,GAAG,QAAQ;IAC5F,MAAM,GAAG,CAAC,cAAc,WAAW,kBAAkB,EAAE;QACrD,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,IAAI;QAClB,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;KACtB,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,WAAW,KAAK,OAAO,WAAW,OAAO,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,GAAG,CAAC,cAAc,WAAW,aAAa,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,GAAG,CAAC,EAAE,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC;AACxC,CAAC"}

package/dist/commands/list.d.ts

@@ -0,0 +1,7 @@
+export interface ListOptions {
+    query?: string;
+    library?: string;
+    folder?: string;
+    flat?: boolean;
+}
+export declare function listCommand(opts?: ListOptions): Promise<void>;

package/dist/commands/list.js

@@ -0,0 +1,32 @@
+import { api } from "../api-client.js";
+import { log } from "../lib/output.js";
+export async function listCommand(opts = {}) {
+    const resp = await api("/skills", {
+        authRequired: true,
+        query: { q: opts.query, library: opts.library, folder: opts.folder },
+    });
+    if (resp.skills.length === 0) {
+        log.info("No skills.");
+        return;
+    }
+    if (opts.flat) {
+        for (const s of resp.skills) {
+            console.log(`${s.library.slug}/${s.slug}`);
+        }
+        return;
+    }
+    const groups = new Map();
+    for (const skill of resp.skills) {
+        const k = `${skill.library.slug} (${skill.library.name})`;
+        const arr = groups.get(k) ?? [];
+        arr.push(skill);
+        groups.set(k, arr);
+    }
+    for (const [library, rows] of groups.entries()) {
+        log.heading(library);
+        for (const s of rows) {
+            console.log(`  ${`${s.library.slug}/${s.slug}`.padEnd(40)} ${s.visibility.padEnd(10)} ${s.title}`);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAyBvC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAoB,EAAE;IACtD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAe,SAAS,EAAE;QAC9C,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;KACrE,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/login.d.ts

@@ -0,0 +1 @@
+export declare function loginCommand(): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,57 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { api } from "../api-client.js";
+import { getApiUrl, writeAuth } from "../config.js";
+import { log } from "../lib/output.js";
+const sh = promisify(exec);
+async function openInBrowser(url) {
+    const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    try {
+        await sh(`${opener} ${JSON.stringify(url)}`);
+    }
+    catch { /* user can copy-paste */ }
+}
+export async function loginCommand() {
+    log.heading("Starting CLI login...");
+    const session = await api("/cli/sessions", {
+        method: "POST",
+        body: { client: "floom-cli", version: "0.0.1" },
+    });
+    log.info("");
+    log.info(`Open this URL in your browser:`);
+    log.info(`  ${session.verification_uri}`);
+    log.info("");
+    log.info(`Your code: ${session.user_code}`);
+    log.info("");
+    openInBrowser(session.verification_uri).catch(() => { });
+    const start = Date.now();
+    const deadline = new Date(session.expires_at).getTime();
+    const interval = Math.max(2, session.poll_interval_seconds) * 1000;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, interval));
+        const pollPath = `/cli/sessions/${session.session_id}?device_code=${encodeURIComponent(session.device_code)}`;
+        const poll = await api(pollPath);
+        if (poll.status === "approved" && poll.token && poll.handle && poll.email) {
+            await writeAuth({
+                token: poll.token,
+                handle: poll.handle,
+                email: poll.email,
+                apiUrl: getApiUrl(),
+            });
+            log.ok(`Logged in as @${poll.handle} (${poll.email})`);
+            return;
+        }
+        if (poll.status === "denied") {
+            log.err("Login denied.");
+            process.exit(1);
+        }
+        if (poll.status === "expired") {
+            log.err("Login session expired. Run `floom login` again.");
+            process.exit(1);
+        }
+        process.stdout.write(".");
+    }
+    log.err("Login timed out.");
+    process.exit(1);
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}

package/dist/commands/logout.d.ts

@@ -0,0 +1 @@
+export declare function logoutCommand(): Promise<void>;

package/dist/commands/logout.js

@@ -0,0 +1,19 @@
+import { clearAuth, readAuth } from "../config.js";
+import { api } from "../api-client.js";
+import { log } from "../lib/output.js";
+export async function logoutCommand() {
+    const auth = await readAuth();
+    if (!auth) {
+        log.info("Not logged in.");
+        return;
+    }
+    try {
+        await api("/cli/sessions/revoke", { method: "POST", authRequired: true });
+    }
+    catch {
+        // best effort; we still clear local token
+    }
+    await clearAuth();
+    log.ok("Logged out.");
+}
+//# sourceMappingURL=logout.js.map

package/dist/commands/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,MAAM,SAAS,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;AACxB,CAAC"}

package/dist/commands/outdated.d.ts

@@ -0,0 +1 @@
+export declare function outdatedCommand(): Promise<void>;