@imbrace/cli 0.1.0 → 0.3.0

package/dist/commands/docs.js

@@ -0,0 +1,39 @@
+import { Command, Flags } from "@oclif/core";
+import { readFileSync, existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+export default class Docs extends Command {
+    static description = "Print the bundled llms.txt — a comprehensive command reference designed to be fed into a coding agent's context (Claude, Cursor, ...). Pipe to a file: `imbrace docs > llms.txt`.";
+    static examples = [
+        "imbrace docs                          # print full llms.txt to stdout",
+        "imbrace docs --path                   # print absolute path to bundled llms.txt",
+        "imbrace docs > /tmp/imbrace-llms.txt  # save for an AI agent's context",
+    ];
+    static flags = {
+        path: Flags.boolean({ description: "Print only the absolute path to llms.txt (don't print contents)" }),
+        json: Flags.boolean({ description: "Output as JSON: { path, content }" }),
+    };
+    async run() {
+        const { flags } = await this.parse(Docs);
+        const here = dirname(fileURLToPath(import.meta.url));
+        const candidates = [
+            resolve(here, "../../llms.txt"),
+            resolve(here, "../llms.txt"),
+            resolve(here, "../../../llms.txt"),
+        ];
+        const llmsPath = candidates.find((p) => existsSync(p));
+        if (!llmsPath) {
+            this.error(`llms.txt not found. Looked in:\n${candidates.map((p) => `  - ${p}`).join("\n")}\n\nReinstall the package or fetch from https://github.com/imbraceltd/imbrace-cli/blob/main/llms.txt`);
+        }
+        if (flags.path && !flags.json) {
+            this.log(llmsPath);
+            return;
+        }
+        const content = readFileSync(llmsPath, "utf8");
+        if (flags.json) {
+            this.log(JSON.stringify({ path: llmsPath, content }, null, 2));
+            return;
+        }
+        this.log(content);
+    }
+}

package/dist/commands/workflow/conn/create.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowConnCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        piece: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        value: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        "display-name": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "external-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "id-only": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/conn/create.js

@@ -0,0 +1,69 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowConnCreate extends BaseCommand {
+    static description = "Create a connection (save credential for an external service)";
+    static examples = [
+        'imbrace workflow conn create --piece slack --type SECRET_TEXT --value "xoxb-..." --json',
+        'imbrace workflow conn create --piece openai --type SECRET_TEXT --value "sk-..." --display-name "Production OpenAI" --json',
+    ];
+    static flags = {
+        piece: Flags.string({
+            description: "Piece name (e.g. 'slack' or '@activepieces/piece-slack')",
+            required: true,
+        }),
+        type: Flags.string({
+            description: "Auth type",
+            options: ["SECRET_TEXT", "OAUTH2", "CLOUD_OAUTH2", "BASIC_AUTH", "CUSTOM_AUTH"],
+            required: true,
+        }),
+        value: Flags.string({
+            description: "Credential value. For SECRET_TEXT: the raw token. For other types: JSON string with type-specific fields.",
+            required: true,
+        }),
+        "display-name": Flags.string({ description: "Human-readable name (default: auto-generated)" }),
+        "external-id": Flags.string({ description: "Unique external ID (default: auto-generated cli_<timestamp>)" }),
+        json: Flags.boolean({ description: "Output as JSON" }),
+        "id-only": Flags.boolean({ description: "Print only the new connection ID" }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowConnCreate);
+        // For non-SECRET_TEXT types, parse value as JSON
+        let value = flags.value;
+        if (flags.type !== "SECRET_TEXT") {
+            try {
+                value = JSON.parse(flags.value);
+            }
+            catch (e) {
+                this.error(`--value must be valid JSON for type ${flags.type}: ${e.message}`);
+            }
+        }
+        const body = {
+            piece: flags.piece,
+            type: flags.type,
+            value,
+        };
+        if (flags["display-name"])
+            body.displayName = flags["display-name"];
+        if (flags["external-id"])
+            body.externalId = flags["external-id"];
+        try {
+            const res = await apiRequest("/workflow/conn/create", { method: "POST", body });
+            if (flags["id-only"]) {
+                this.log(res.data?.id ?? "");
+                return;
+            }
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n✅ ${res.message}`);
+            if (res.data?.id)
+                this.log(`   ID: ${res.data.id}`);
+            this.log("");
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/conn/delete.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowConnDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        connId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/conn/delete.js

@@ -0,0 +1,39 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { confirm } from "@inquirer/prompts";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowConnDelete extends BaseCommand {
+    static description = "Delete a connection";
+    static examples = [
+        "imbrace workflow conn delete <connId> --yes",
+        "imbrace workflow conn delete <connId> --yes --json",
+    ];
+    static args = {
+        connId: Args.string({ description: "Connection ID", required: true }),
+    };
+    static flags = {
+        yes: Flags.boolean({ char: "y", description: "Skip confirmation" }),
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkflowConnDelete);
+        if (!flags.yes && !flags.json) {
+            const ok = await confirm({ message: `Delete connection ${args.connId}?`, default: false });
+            if (!ok) {
+                this.log("Cancelled.");
+                return;
+            }
+        }
+        try {
+            const res = await apiRequest(`/workflow/conn/${args.connId}`, { method: "DELETE" });
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n✅ ${res.message}\n`);
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/conn/get.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowConnGet extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        connId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/conn/get.js

@@ -0,0 +1,42 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { input } from "@inquirer/prompts";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowConnGet extends BaseCommand {
+    static description = "Get details of a single connection (credential metadata, status, piece info)";
+    static examples = [
+        "imbrace workflow conn get <connId>",
+        "imbrace workflow conn get <connId> --json",
+    ];
+    static args = {
+        connId: Args.string({ description: "Connection ID" }),
+    };
+    static flags = {
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkflowConnGet);
+        const connId = args.connId ?? (flags.json ? this.error("Connection ID is required") : await input({ message: "Connection ID:" }));
+        try {
+            const res = await apiRequest(`/workflow/conn/${connId}`);
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            const c = res.data || {};
+            this.log(`\n  ID:            ${c.id || ""}`);
+            this.log(`  Display name:  ${c.displayName || ""}`);
+            this.log(`  External ID:   ${c.externalId || ""}`);
+            this.log(`  Piece:         ${c.pieceName || ""}`);
+            this.log(`  Type:          ${c.type || ""}`);
+            this.log(`  Status:        ${c.status || ""}`);
+            this.log(`  Project ID:    ${c.projectId || ""}`);
+            this.log(`  Created:       ${c.created || ""}`);
+            this.log(`  Updated:       ${c.updated || ""}`);
+            this.log("");
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/conn/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowConnList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/conn/list.js

@@ -0,0 +1,37 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowConnList extends BaseCommand {
+    static description = "List all connections (saved credentials for external services)";
+    static examples = [
+        "imbrace workflow conn list",
+        "imbrace workflow conn list --json",
+    ];
+    static flags = {
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowConnList);
+        try {
+            const res = await apiRequest("/workflow/conn/list");
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n  Found ${res.count} connection(s):\n`);
+            this.log("  ID                              DISPLAY NAME                  PIECE                       TYPE");
+            this.log("  ─────────────────────────────────────────────────────────────────────────────────────────────");
+            for (const c of res.data || []) {
+                const id = (c.id || "").padEnd(31);
+                const name = (c.displayName || "").padEnd(28);
+                const piece = (c.pieceName || "").padEnd(28);
+                const type = c.type || "";
+                this.log(`  ${id} ${name} ${piece} ${type}`);
+            }
+            this.log("");
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/create.d.ts

@@ -5,6 +5,7 @@ export default class WorkflowCreate extends BaseCommand {
     static flags: {
         name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "project-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "folder-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "id-only": import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

package/dist/commands/workflow/create.js

@@ -7,10 +7,12 @@ export default class WorkflowCreate extends BaseCommand {
     static examples = [
         'imbrace workflow create --name "My Flow" --json',
         'imbrace workflow create --name "Slack Bot" --id-only',
+        'imbrace workflow create --name "Lead handler" --folder-id <folderId>',
     ];
     static flags = {
         name: Flags.string({ char: "n", description: "Workflow display name (required)" }),
         "project-id": Flags.string({ description: "Project ID. Auto-discovered from existing flows if omitted." }),
+        "folder-id": Flags.string({ description: "Place the flow in this folder (use 'imbrace workflow folder list' to discover)." }),
         json: Flags.boolean({ description: "Output as JSON" }),
         "id-only": Flags.boolean({ description: "Print only the new workflow ID (pipe-friendly)" }),
     };
@@ -21,6 +23,8 @@ export default class WorkflowCreate extends BaseCommand {
         const body = { name };
         if (flags["project-id"])
             body.projectId = flags["project-id"];
+        if (flags["folder-id"])
+            body.folderId = flags["folder-id"];
         try {
             const res = await apiRequest("/workflow/create", { method: "POST", body });
             if (flags["id-only"]) {

package/dist/commands/workflow/disable.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "../../base-command.js";
+export default class WorkflowDisable extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        flowId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/disable.js

@@ -0,0 +1,30 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { apiRequest } from "../../http.js";
+export default class WorkflowDisable extends BaseCommand {
+    static description = "Stop auto-trigger on a workflow (keeps published version intact)";
+    static examples = [
+        "imbrace workflow disable <flowId>",
+        "imbrace workflow disable <flowId> --json",
+    ];
+    static args = {
+        flowId: Args.string({ description: "Workflow ID", required: true }),
+    };
+    static flags = {
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkflowDisable);
+        try {
+            const res = await apiRequest(`/workflow/${args.flowId}/disable`, { method: "POST", body: {} });
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n✅ ${res.message}\n`);
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/enable.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "../../base-command.js";
+export default class WorkflowEnable extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        flowId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/enable.js

@@ -0,0 +1,34 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../base-command.js";
+import { apiRequest } from "../../http.js";
+export default class WorkflowEnable extends BaseCommand {
+    static description = "Enable auto-trigger on a workflow. Requires `workflow publish` first.";
+    static examples = [
+        "imbrace workflow enable <flowId>",
+        "imbrace workflow enable <flowId> --json",
+    ];
+    static args = {
+        flowId: Args.string({ description: "Workflow ID", required: true }),
+    };
+    static flags = {
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkflowEnable);
+        try {
+            const res = await apiRequest(`/workflow/${args.flowId}/enable`, { method: "POST", body: {} });
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n✅ ${res.message}\n`);
+        }
+        catch (error) {
+            // Common error: trying to enable before publish
+            if (/publishedFlowVersionId/.test(error.message || "")) {
+                this.error(`Cannot enable an unpublished workflow. Run 'imbrace workflow publish ${args.flowId}' first.`);
+            }
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/folder/create.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowFolderCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "project-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "id-only": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/folder/create.js

@@ -0,0 +1,43 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { input } from "@inquirer/prompts";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowFolderCreate extends BaseCommand {
+    static description = "Create a new folder for organizing workflows";
+    static examples = [
+        'imbrace workflow folder create --name "Sales Automations" --json',
+        'imbrace workflow folder create --name "Internal Tools" --id-only',
+    ];
+    static flags = {
+        name: Flags.string({ char: "n", description: "Folder name (required)" }),
+        "project-id": Flags.string({ description: "Project ID. Auto-discovered if omitted." }),
+        json: Flags.boolean({ description: "Output as JSON" }),
+        "id-only": Flags.boolean({ description: "Print only the new folder ID (pipe-friendly)" }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowFolderCreate);
+        const nonInteractive = flags.json || flags["id-only"];
+        const name = flags.name ?? (nonInteractive ? this.error("--name is required with --json or --id-only") : await input({ message: "Folder name:" }));
+        const body = { name };
+        if (flags["project-id"])
+            body.projectId = flags["project-id"];
+        try {
+            const res = await apiRequest("/workflow/folder/create", { method: "POST", body });
+            if (flags["id-only"]) {
+                this.log(res.data?.id ?? "");
+                return;
+            }
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n✅ ${res.message}`);
+            if (res.data?.id)
+                this.log(`   ID: ${res.data.id}`);
+            this.log("");
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/folder/delete.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowFolderDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        folderId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/folder/delete.js

@@ -0,0 +1,39 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { confirm } from "@inquirer/prompts";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowFolderDelete extends BaseCommand {
+    static description = "Delete a folder. Flows inside the folder are NOT deleted — they become unfiled.";
+    static examples = [
+        "imbrace workflow folder delete <folderId> --yes",
+        "imbrace workflow folder delete <folderId> --yes --json",
+    ];
+    static args = {
+        folderId: Args.string({ description: "Folder ID", required: true }),
+    };
+    static flags = {
+        yes: Flags.boolean({ char: "y", description: "Skip confirmation" }),
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkflowFolderDelete);
+        if (!flags.yes && !flags.json) {
+            const ok = await confirm({ message: `Delete folder ${args.folderId}?`, default: false });
+            if (!ok) {
+                this.log("Cancelled.");
+                return;
+            }
+        }
+        try {
+            const res = await apiRequest(`/workflow/folder/${args.folderId}`, { method: "DELETE" });
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n✅ ${res.message}\n`);
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/folder/get.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowFolderGet extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        folderId: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/folder/get.js

@@ -0,0 +1,38 @@
+import { Args, Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { input } from "@inquirer/prompts";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowFolderGet extends BaseCommand {
+    static description = "Get details of a single folder";
+    static examples = [
+        "imbrace workflow folder get <folderId>",
+        "imbrace workflow folder get <folderId> --json",
+    ];
+    static args = {
+        folderId: Args.string({ description: "Folder ID" }),
+    };
+    static flags = {
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkflowFolderGet);
+        const folderId = args.folderId ?? (flags.json ? this.error("Folder ID is required") : await input({ message: "Folder ID:" }));
+        try {
+            const res = await apiRequest(`/workflow/folder/${folderId}`);
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            const f = res.data || {};
+            this.log(`\n  ID:           ${f.id || ""}`);
+            this.log(`  Name:         ${f.displayName || ""}`);
+            this.log(`  Project ID:   ${f.projectId || ""}`);
+            this.log(`  Created:      ${f.created || ""}`);
+            this.log(`  Updated:      ${f.updated || ""}`);
+            this.log("");
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/folder/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowFolderList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/workflow/folder/list.js

@@ -0,0 +1,35 @@
+import { Flags } from "@oclif/core";
+import { BaseCommand } from "../../../base-command.js";
+import { apiRequest } from "../../../http.js";
+export default class WorkflowFolderList extends BaseCommand {
+    static description = "List all folders (used to organize workflows)";
+    static examples = [
+        "imbrace workflow folder list",
+        "imbrace workflow folder list --json",
+    ];
+    static flags = {
+        json: Flags.boolean({ description: "Output as JSON" }),
+    };
+    async run() {
+        const { flags } = await this.parse(WorkflowFolderList);
+        try {
+            const res = await apiRequest("/workflow/folder/list");
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            this.log(`\n  Found ${res.count} folder(s):\n`);
+            this.log("  ID                       NAME");
+            this.log("  ─────────────────────────────────────────────────────");
+            for (const f of res.data || []) {
+                const id = (f.id || "").padEnd(24);
+                const name = f.displayName || "";
+                this.log(`  ${id} ${name}`);
+            }
+            this.log("");
+        }
+        catch (error) {
+            this.error(`Failed: ${error.message}`);
+        }
+    }
+}

package/dist/commands/workflow/folder/update.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from "../../../base-command.js";
+export default class WorkflowFolderUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        folderId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}