@floomhq/floom 5.0.6 → 5.0.8

package/dist/commands/support.js

@@ -0,0 +1,391 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createAuthenticatedClient, FloomApiError } from "../lib/api.js";
+import { getCommandName } from "../lib/command-name.js";
+import { log, printJson, renderTable } from "../lib/output.js";
+// #806 — `floom support` ticket commands + `floom feedback`, 1:1 with the
+// cloud member API (docs/SUPPORT-TICKETS.md, mounted at /api/support/*). The
+// FloomApiClient prepends /api in hosted (cloud) mode, so paths here start at
+// /support. Support is a cloud-only feature; against an OSS engine these routes
+// 404 (handled below as a clear "cloud-only" message).
+// Mirror the server-side caps (apps/api/support.py) so we fail fast and, for
+// `feedback`, fit the appended transcript under the body limit.
+const MAX_SUBJECT_LEN = 200;
+const MAX_BODY_LEN = 20_000;
+const VALID_SEVERITY = ["low", "normal", "high"];
+const VALID_STATUS = ["open", "resolved"];
+// The dashboard ticket URL printed on file. Cloud serves the dashboard under
+// /app on floom.dev; allow an env override rather than baking the host in.
+function deepLink(ticketId) {
+    const base = (process.env.WORKEROS_APP_BASE || "https://floom.dev/app").replace(/\/+$/, "");
+    return `${base}/support/${ticketId}`;
+}
+// Shared error mapping (mirrors runs.ts::handleAuthError). Returns an exit code
+// when it recognises the error, or null to let the caller rethrow.
+function handleAuthError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("Not logged in")) {
+        log.err("Not authenticated.");
+        process.stderr.write(`Run: ${getCommandName()} login\n`);
+        return 1;
+    }
+    if (error instanceof FloomApiError && (error.status === 401 || error.status === 403)) {
+        log.err("Your session expired.");
+        process.stderr.write(`Re-run: ${getCommandName()} login\n`);
+        return 1;
+    }
+    if (error instanceof FloomApiError && error.status && error.status >= 500) {
+        log.err(`API error: ${message}`);
+        process.stderr.write("Check API status, then retry.\n");
+        return 1;
+    }
+    return null;
+}
+// Support has no OSS counterpart: a 404 on a *collection* route means the engine
+// does not mount /api/support (self-hosted), not that a ticket is missing.
+function noteCloudOnlyOn404(error) {
+    if (error instanceof FloomApiError && error.status === 404) {
+        log.err("Support is a cloud-only feature.");
+        process.stderr.write(`Log in to the hosted product: ${getCommandName()} login --cloud\n`);
+        return true;
+    }
+    return false;
+}
+function validSeverity(value) {
+    return value !== undefined && VALID_SEVERITY.includes(value);
+}
+function renderThread(ticket) {
+    log.heading(ticket.subject);
+    log.kv("Ticket", ticket.id);
+    log.kv("Status", ticket.status);
+    log.kv("Severity", ticket.severity);
+    if (ticket.opened_via)
+        log.kv("Opened via", ticket.opened_via);
+    if (ticket.workspace_id)
+        log.kv("Workspace", ticket.workspace_id);
+    const messages = ticket.messages || [];
+    if (!messages.length) {
+        log.blank();
+        log.info("(no messages)");
+        return;
+    }
+    for (const m of messages) {
+        log.blank();
+        const who = m.author_kind === "staff" ? "Support" : "You";
+        log.info(`${who} · ${m.created_at}`);
+        process.stdout.write(`${m.body}\n`);
+    }
+}
+// --- support file -----------------------------------------------------------
+export async function supportFileCommand(options) {
+    const subject = (options.subject || "").trim();
+    if (!subject) {
+        log.err("--subject is required.");
+        return 1;
+    }
+    if (subject.length > MAX_SUBJECT_LEN) {
+        log.err(`--subject must be <= ${MAX_SUBJECT_LEN} characters.`);
+        return 1;
+    }
+    if (options.severity !== undefined && !validSeverity(options.severity)) {
+        log.err(`--severity must be one of: ${VALID_SEVERITY.join(", ")}.`);
+        return 1;
+    }
+    // The first message body is --body plus any structured agent context. At least
+    // one of these must be present (the API requires a non-empty body).
+    const parts = [];
+    if (options.body && options.body.trim())
+        parts.push(options.body.trim());
+    if (options.operation && options.operation.trim())
+        parts.push(`Operation: ${options.operation.trim()}`);
+    if (options.errorCode && options.errorCode.trim())
+        parts.push(`Error code: ${options.errorCode.trim()}`);
+    const body = parts.join("\n\n");
+    if (!body) {
+        log.err("Provide --body (or --operation / --error-code for context).");
+        return 1;
+    }
+    if (body.length > MAX_BODY_LEN) {
+        log.err(`Message body must be <= ${MAX_BODY_LEN} characters.`);
+        return 1;
+    }
+    try {
+        const { client } = await createAuthenticatedClient();
+        const ticket = (await client.requestJson("POST", "/support/tickets", {
+            body: { subject, body, severity: options.severity || "normal", opened_via: "cli" },
+        }));
+        if (options.json) {
+            printJson(ticket);
+            return 0;
+        }
+        log.ok(`Filed ticket ${ticket.id}`);
+        log.info(deepLink(ticket.id));
+        log.info("You'll be notified by email and on your next session when support replies.");
+        return 0;
+    }
+    catch (error) {
+        if (noteCloudOnlyOn404(error))
+            return 1;
+        const handled = handleAuthError(error);
+        if (handled !== null)
+            return handled;
+        throw error;
+    }
+}
+// --- support list -----------------------------------------------------------
+export async function supportListCommand(options) {
+    if (options.status !== undefined && !VALID_STATUS.includes(options.status)) {
+        log.err(`--status must be one of: ${VALID_STATUS.join(", ")}.`);
+        return 1;
+    }
+    if (options.limit !== undefined && (!Number.isInteger(options.limit) || options.limit < 1 || options.limit > 100)) {
+        log.err("--limit must be an integer between 1 and 100.");
+        return 1;
+    }
+    try {
+        const { client } = await createAuthenticatedClient();
+        const result = (await client.requestJson("GET", "/support/tickets", {
+            query: { status: options.status, limit: options.limit },
+        }));
+        if (options.json) {
+            printJson(result);
+            return 0;
+        }
+        const tickets = result.tickets || [];
+        if (!tickets.length) {
+            log.info("No tickets.");
+            return 0;
+        }
+        process.stdout.write(renderTable(tickets.map((t) => ({
+            id: t.id,
+            subject: t.subject.length > 48 ? `${t.subject.slice(0, 47)}…` : t.subject,
+            status: t.status,
+            severity: t.severity,
+            unread: t.unread_for_opener ? "•" : "",
+            updated: t.updated_at || "-",
+        })), [
+            { key: "id", label: "Ticket" },
+            { key: "subject", label: "Subject" },
+            { key: "status", label: "Status" },
+            { key: "severity", label: "Severity" },
+            { key: "unread", label: "Unread" },
+            { key: "updated", label: "Updated" },
+        ]) + "\n");
+        if (result.unread_count)
+            log.info(`${result.unread_count} ticket(s) with unread replies.`);
+        return 0;
+    }
+    catch (error) {
+        if (noteCloudOnlyOn404(error))
+            return 1;
+        const handled = handleAuthError(error);
+        if (handled !== null)
+            return handled;
+        throw error;
+    }
+}
+// --- support get ------------------------------------------------------------
+export async function supportGetCommand(ticketId, options) {
+    try {
+        const { client } = await createAuthenticatedClient();
+        const ticket = (await client.requestJson("GET", `/support/tickets/${encodeURIComponent(ticketId)}`));
+        if (options.json) {
+            printJson(ticket);
+            return 0;
+        }
+        renderThread(ticket);
+        return 0;
+    }
+    catch (error) {
+        // A 404 on a single-ticket route is genuinely "ticket not found" (the route
+        // exists), so don't shadow it with the cloud-only hint.
+        if (error instanceof FloomApiError && error.status === 404) {
+            log.err(`Ticket '${ticketId}' not found.`);
+            log.info(`List tickets: ${getCommandName()} support list`);
+            return 1;
+        }
+        const handled = handleAuthError(error);
+        if (handled !== null)
+            return handled;
+        throw error;
+    }
+}
+// --- support reply ----------------------------------------------------------
+export async function supportReplyCommand(ticketId, options) {
+    const body = (options.body || "").trim();
+    if (!body) {
+        log.err("--body is required.");
+        return 1;
+    }
+    if (body.length > MAX_BODY_LEN) {
+        log.err(`--body must be <= ${MAX_BODY_LEN} characters.`);
+        return 1;
+    }
+    try {
+        const { client } = await createAuthenticatedClient();
+        const ticket = (await client.requestJson("POST", `/support/tickets/${encodeURIComponent(ticketId)}/messages`, { body: { body } }));
+        if (options.json) {
+            printJson(ticket);
+            return 0;
+        }
+        log.ok(`Replied to ${ticketId}`);
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof FloomApiError && error.status === 404) {
+            log.err(`Ticket '${ticketId}' not found.`);
+            return 1;
+        }
+        const handled = handleAuthError(error);
+        if (handled !== null)
+            return handled;
+        throw error;
+    }
+}
+// --- support ack ------------------------------------------------------------
+export async function supportAckCommand(ticketId, options) {
+    try {
+        const { client } = await createAuthenticatedClient();
+        const ticket = (await client.requestJson("POST", `/support/tickets/${encodeURIComponent(ticketId)}/ack`));
+        if (options.json) {
+            printJson(ticket);
+            return 0;
+        }
+        log.ok(`Cleared unread flag on ${ticketId}`);
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof FloomApiError && error.status === 404) {
+            log.err(`Ticket '${ticketId}' not found.`);
+            return 1;
+        }
+        const handled = handleAuthError(error);
+        if (handled !== null)
+            return handled;
+        throw error;
+    }
+}
+// --- feedback ---------------------------------------------------------------
+// Locate the local session transcript to attach to `feedback`. Only the local
+// CLI can read the on-disk transcript (the MCP server can't), which is why this
+// lives here and not in the API. Resolution order: explicit path → env override
+// → newest *.jsonl under ~/.claude/projects. Returns null when none is found.
+async function findSessionTranscript(explicitPath) {
+    const direct = explicitPath || process.env.WORKEROS_SESSION_TRANSCRIPT || process.env.CLAUDE_SESSION_TRANSCRIPT;
+    if (direct) {
+        try {
+            await stat(direct);
+            return direct;
+        }
+        catch {
+            return null;
+        }
+    }
+    const root = join(homedir(), ".claude", "projects");
+    const candidates = [];
+    async function walk(dir, depth) {
+        if (depth > 4)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full, depth + 1);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+                try {
+                    const s = await stat(full);
+                    candidates.push({ path: full, mtime: s.mtimeMs });
+                }
+                catch {
+                    /* skip unreadable */
+                }
+            }
+        }
+    }
+    await walk(root, 0);
+    if (!candidates.length)
+        return null;
+    return candidates.reduce((a, b) => (b.mtime > a.mtime ? b : a)).path;
+}
+// Append the transcript tail to `message`, clamped so the whole body fits under
+// MAX_BODY_LEN (the API rejects longer). The tail is the most recent and most
+// relevant part of a session.
+function composeFeedbackBody(message, transcript) {
+    if (!transcript)
+        return message;
+    const header = "\n\n--- Session transcript (most recent, truncated) ---\n";
+    const budget = MAX_BODY_LEN - message.length - header.length;
+    if (budget <= 200)
+        return message; // no meaningful room left
+    const tail = transcript.length > budget ? transcript.slice(transcript.length - budget) : transcript;
+    return `${message}${header}${tail}`;
+}
+export async function feedbackCommand(options) {
+    const message = (options.message || "").trim();
+    if (!message) {
+        log.err("--message is required.");
+        return 1;
+    }
+    if (message.length > MAX_BODY_LEN) {
+        log.err(`--message must be <= ${MAX_BODY_LEN} characters.`);
+        return 1;
+    }
+    if (options.severity !== undefined && !validSeverity(options.severity)) {
+        log.err(`--severity must be one of: ${VALID_SEVERITY.join(", ")}.`);
+        return 1;
+    }
+    const explicitPath = typeof options.transcript === "string" ? options.transcript : undefined;
+    let transcript = null;
+    if (options.transcript !== false) {
+        const path = await findSessionTranscript(explicitPath);
+        if (path) {
+            try {
+                transcript = await readFile(path, "utf8");
+            }
+            catch {
+                transcript = null;
+            }
+        }
+        else if (explicitPath) {
+            log.warn(`Transcript not found at ${explicitPath}; filing feedback without it.`);
+        }
+    }
+    const subjectSource = message.split("\n")[0].trim() || "CLI feedback";
+    const subject = subjectSource.length > MAX_SUBJECT_LEN
+        ? subjectSource.slice(0, MAX_SUBJECT_LEN - 1) + "…"
+        : subjectSource;
+    const body = composeFeedbackBody(message, transcript);
+    try {
+        const { client } = await createAuthenticatedClient();
+        const ticket = (await client.requestJson("POST", "/support/tickets", {
+            body: { subject, body, severity: options.severity || "normal", opened_via: "cli" },
+        }));
+        if (options.json) {
+            printJson(ticket);
+            return 0;
+        }
+        log.ok(`Filed feedback ${ticket.id}`);
+        if (transcript)
+            log.step("Attached the local session transcript.");
+        log.info(deepLink(ticket.id));
+        log.info("You'll be notified by email and on your next session when support replies.");
+        return 0;
+    }
+    catch (error) {
+        if (noteCloudOnlyOn404(error))
+            return 1;
+        const handled = handleAuthError(error);
+        if (handled !== null)
+            return handled;
+        throw error;
+    }
+}
+//# sourceMappingURL=support.js.map

package/dist/commands/support.js.map

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

package/dist/commands/workers.d.ts

@@ -16,7 +16,18 @@ export declare function loadWorkerSource(dirArg: string): Promise<{
     source?: WorkerSource;
     errors: string[];
 }>;
-export declare function workersValidateCommand(dir: string): Promise<number>;
+export declare function workersContractCommand(options: {
+    json?: boolean;
+}): Promise<number>;
+export declare function workersTemplatesListCommand(options: {
+    json?: boolean;
+}): Promise<number>;
+export declare function workersTemplatesGetCommand(id: string, options: {
+    json?: boolean;
+}): Promise<number>;
+export declare function workersValidateCommand(dir: string, options?: {
+    json?: boolean;
+}): Promise<number>;
 export declare function workersPushCommand(dir: string): Promise<number>;
 export declare function workersListCommand(options: {
     json?: boolean;

package/dist/commands/workers.js

@@ -6,6 +6,7 @@ import { createAuthenticatedClient, FloomApiError, FloomConnectionError } from "
 import { getCommandName } from "../lib/command-name.js";
 import { log, printJson, renderTable } from "../lib/output.js";
 import { promptYesNo } from "../lib/prompt.js";
+import { WORKER_AUTHORING_CONTRACT, getWorkerTemplate, listWorkerTemplates, } from "../lib/worker-authoring.js";
 const SERVER_WORKER_RUNTIMES = new Set(["python311", "node22", "bash", "skill", "none"]);
 function emitError(message, hint, json) {
     if (json) {
@@ -537,11 +538,90 @@ function emitApiError(error) {
     }
     throw error;
 }
-export async function workersValidateCommand(dir) {
+export async function workersContractCommand(options) {
+    if (options.json) {
+        printJson(WORKER_AUTHORING_CONTRACT);
+        return 0;
+    }
+    log.heading("Floom worker authoring contract");
+    log.kv("Schema", WORKER_AUTHORING_CONTRACT.schema_version);
+    log.kv("Required files", WORKER_AUTHORING_CONTRACT.required_files.join(", "));
+    log.kv("Required fields", WORKER_AUTHORING_CONTRACT.required_top_level_fields.join(", "));
+    log.blank();
+    log.info("Recommended flow:");
+    for (const step of WORKER_AUTHORING_CONTRACT.validation_order) {
+        log.info(`  - ${step}`);
+    }
+    log.blank();
+    log.info(`List templates: ${getCommandName()} workers templates list`);
+    return 0;
+}
+export async function workersTemplatesListCommand(options) {
+    const templates = listWorkerTemplates();
+    if (options.json) {
+        printJson({ templates });
+        return 0;
+    }
+    process.stdout.write(renderTable(templates.map((template) => ({
+        id: template.id,
+        mode: template.mode,
+        title: template.title,
+        description: template.description,
+    })), [
+        { key: "id", label: "ID" },
+        { key: "mode", label: "Mode" },
+        { key: "title", label: "Title" },
+        { key: "description", label: "Description" },
+    ]) + "\n");
+    return 0;
+}
+export async function workersTemplatesGetCommand(id, options) {
+    const template = getWorkerTemplate(id);
+    if (!template) {
+        return emitError(`Unknown worker template '${id}'.`, `List available templates: ${getCommandName()} workers templates list`, options.json);
+    }
+    if (options.json) {
+        printJson(template);
+        return 0;
+    }
+    log.heading(template.title);
+    log.kv("ID", template.id);
+    log.kv("Mode", template.mode);
+    log.info(template.description);
+    log.blank();
+    log.info("worker.yml:");
+    process.stdout.write(`${template.worker_yml}\n`);
+    if (template.run_py) {
+        log.info("run.py:");
+        process.stdout.write(`${template.run_py}\n`);
+    }
+    if (template.skill_md) {
+        log.info("SKILL.md:");
+        process.stdout.write(`${template.skill_md}\n`);
+    }
+    return 0;
+}
+export async function workersValidateCommand(dir, options = {}) {
     const result = await loadWorkerSource(dir);
     if (!result.source) {
+        if (options.json) {
+            printJson({ valid: false, errors: result.errors });
+            return 1;
+        }
         return emitValidationErrors(result.errors);
     }
+    if (options.json) {
+        printJson({
+            valid: true,
+            errors: [],
+            worker_id: result.source.workerId,
+            directory: result.source.dir,
+            name: result.source.displayName,
+            runtime: result.source.runtime,
+            source: result.source.entrypoint === "SKILL.md" ? "SKILL.md" : result.source.runPy?.trim() ? "run.py" : "SKILL.md",
+        });
+        return 0;
+    }
     log.ok(`Validated ${result.source.workerId}`);
     log.kv("Directory", result.source.dir);
     log.kv("Name", result.source.displayName);