@runloop/rl-cli 1.7.1 → 1.9.0

package/README.md

@@ -6,7 +6,7 @@
 
 A **TUI + CLI** for the [Runloop.ai](https://runloop.ai) platform. Use it as an **interactive TUI** (Terminal User Interface) with rich UI components, or as a **traditional CLI** for scripting and automation.
 
-📖 **[Full Documentation](https://docs.runloop.ai/docs/tools/cli)**
+📖 **[Full Documentation](https://docs.runloop.ai/docs/tools/rl-cli)**
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/runloopai/rl-cli/main/misc/demo.gif" alt="Runloop CLI Demo" width="800">
@@ -36,10 +36,12 @@ rli devbox delete <devbox-id>
 
 ## Installation
 
-Install globally via npm:
+Install globally via npm or pnpm:
 
 ```bash
 npm install -g @runloop/rl-cli
+# or
+pnpm add -g @runloop/rl-cli
 ```
 
 ## Setup
@@ -107,6 +109,7 @@ rli snapshot list                        # List all snapshots
 rli snapshot create <devbox-id>          # Create a snapshot of a devbox
 rli snapshot delete <id>                 # Delete a snapshot
 rli snapshot get <id>                    # Get snapshot details
+rli snapshot prune <devbox-id>           # Delete old snapshots for a devbox, ke...
 rli snapshot status <snapshot-id>        # Get snapshot operation status
 ```
 
@@ -117,6 +120,7 @@ rli blueprint list                       # List all blueprints
 rli blueprint create                     # Create a new blueprint
 rli blueprint get <name-or-id>           # Get blueprint details by name or ID (...
 rli blueprint logs <name-or-id>          # Get blueprint build logs by name or I...
+rli blueprint delete <id>                # Delete a blueprint by ID
 rli blueprint prune <name>               # Delete old blueprint builds, keeping ...
 rli blueprint from-dockerfile            # Create a blueprint from a Dockerfile ...
 ```
@@ -150,6 +154,16 @@ rli secret update <name>                 # Update a secret value (value from std
 rli secret delete <name>                 # Delete a secret
 ```
 
+### Gateway-config Commands (alias: `gwc`)
+
+```bash
+rli gateway-config list                  # List gateway configurations
+rli gateway-config create                # Create a new gateway configuration
+rli gateway-config get <id>              # Get gateway configuration details
+rli gateway-config update <id>           # Update a gateway configuration
+rli gateway-config delete <id>           # Delete a gateway configuration
+```
+
 ### Mcp Commands
 
 ```bash
@@ -197,13 +211,13 @@ The TUI supports both light and dark terminal themes and will automatically sele
 
 ```bash
 # Install dependencies
-npm install
+pnpm install
 
 # Build
-npm run build
+pnpm run build
 
 # Watch mode
-npm run dev
+pnpm run dev
 
 ## Contributing
 

package/dist/commands/blueprint/delete.js

@@ -0,0 +1,21 @@
+/**
+ * Delete blueprint command
+ */
+import { getClient } from "../../utils/client.js";
+import { output, outputError } from "../../utils/output.js";
+export async function deleteBlueprint(id, options = {}) {
+    try {
+        const client = getClient();
+        await client.blueprints.delete(id);
+        // Default: just output the ID for easy scripting
+        if (!options.output || options.output === "text") {
+            console.log(id);
+        }
+        else {
+            output({ id, status: "deleted" }, { format: options.output, defaultFormat: "json" });
+        }
+    }
+    catch (error) {
+        outputError("Failed to delete blueprint", error);
+    }
+}

package/dist/commands/blueprint/list.js

@@ -1,6 +1,6 @@
 import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import React from "react";
-import { Box, Text, useInput, useApp } from "ink";
+import { Box, Text, useApp } from "ink";
 import TextInput from "ink-text-input";
 import figures from "figures";
 import { getClient } from "../../utils/client.js";
@@ -23,6 +23,8 @@ import { useExitOnCtrlC } from "../../hooks/useExitOnCtrlC.js";
 import { useViewportHeight } from "../../hooks/useViewportHeight.js";
 import { useCursorPagination } from "../../hooks/useCursorPagination.js";
 import { useListSearch } from "../../hooks/useListSearch.js";
+import { openInBrowser } from "../../utils/browser.js";
+import { useInputHandler, } from "../../hooks/useInputHandler.js";
 import { useNavigation } from "../../store/navigationStore.js";
 import { ConfirmationPrompt } from "../../components/ConfirmationPrompt.js";
 const DEFAULT_PAGE_SIZE = 10;
@@ -281,192 +283,242 @@ const ListBlueprintsUI = ({ onBack, onExit, }) => {
             return true;
         })
         : allOperations;
-    // Handle input for all views
-    useInput((input, key) => {
-        // Handle search mode input
-        if (search.searchMode) {
-            if (key.escape) {
-                search.cancelSearch();
-            }
-            return;
-        }
-        // Handle operation input mode
-        if (executingOperation && !operationResult && !operationError) {
-            // Allow escape/q to cancel any operation, even during loading
-            if (input === "q" || key.escape) {
-                setExecutingOperation(null);
-                setOperationInput("");
-                setOperationLoading(false);
-                return;
-            }
-            const currentOp = allOperations.find((op) => op.key === executingOperation);
-            if (currentOp?.needsInput) {
-                if (key.return) {
-                    executeOperation();
-                }
-            }
-            return;
-        }
-        // Handle operation result display
-        if (operationResult || operationError) {
-            if (input === "q" || key.escape || key.return) {
-                setOperationResult(null);
-                setOperationError(null);
-                setExecutingOperation(null);
-                setOperationInput("");
-            }
-            return;
-        }
-        // Handle create devbox view
-        if (showCreateDevbox) {
-            return;
+    // --- Callbacks for input modes ---
+    const cancelOperation = React.useCallback(() => {
+        setExecutingOperation(null);
+        setOperationInput("");
+        setOperationLoading(false);
+    }, []);
+    const dismissResult = React.useCallback(() => {
+        setOperationResult(null);
+        setOperationError(null);
+        setExecutingOperation(null);
+        setOperationInput("");
+    }, []);
+    const closePopup = React.useCallback(() => {
+        setShowPopup(false);
+        setSelectedOperation(0);
+    }, []);
+    const executePopupSelection = React.useCallback(() => {
+        setShowPopup(false);
+        const operationKey = allOperations[selectedOperation].key;
+        if (operationKey === "view_details") {
+            navigate("blueprint-detail", {
+                blueprintId: selectedBlueprintItem.id,
+            });
         }
-        // Handle actions popup overlay
-        if (showPopup) {
-            if (key.upArrow && selectedOperation > 0) {
-                setSelectedOperation(selectedOperation - 1);
-            }
-            else if (key.downArrow &&
-                selectedOperation < allOperations.length - 1) {
-                setSelectedOperation(selectedOperation + 1);
-            }
-            else if (key.return) {
-                setShowPopup(false);
-                const operationKey = allOperations[selectedOperation].key;
-                if (operationKey === "view_details") {
-                    navigate("blueprint-detail", {
-                        blueprintId: selectedBlueprintItem.id,
-                    });
-                }
-                else if (operationKey === "create_devbox") {
-                    setSelectedBlueprint(selectedBlueprintItem);
-                    setShowCreateDevbox(true);
-                }
-                else if (operationKey === "delete") {
-                    // Show delete confirmation
-                    setSelectedBlueprint(selectedBlueprintItem);
-                    setShowDeleteConfirm(true);
-                }
-                else {
-                    setSelectedBlueprint(selectedBlueprintItem);
-                    setExecutingOperation(operationKey);
-                    executeOperation(selectedBlueprintItem, operationKey);
-                }
-            }
-            else if (input === "v" && selectedBlueprintItem) {
-                // View details hotkey
-                setShowPopup(false);
-                navigate("blueprint-detail", {
-                    blueprintId: selectedBlueprintItem.id,
-                });
-            }
-            else if (key.escape || input === "q") {
-                setShowPopup(false);
-                setSelectedOperation(0);
-            }
-            else if (input === "c") {
-                if (selectedBlueprintItem &&
-                    (selectedBlueprintItem.status === "build_complete" ||
-                        selectedBlueprintItem.status === "building_complete")) {
-                    setShowPopup(false);
-                    setSelectedBlueprint(selectedBlueprintItem);
-                    setShowCreateDevbox(true);
-                }
-            }
-            else if (input === "d") {
-                const deleteIndex = allOperations.findIndex((op) => op.key === "delete");
-                if (deleteIndex >= 0) {
-                    // Show delete confirmation
-                    setShowPopup(false);
-                    setSelectedBlueprint(selectedBlueprintItem);
-                    setShowDeleteConfirm(true);
-                }
-            }
-            else if (input === "l") {
-                const logsIndex = allOperations.findIndex((op) => op.key === "view_logs");
-                if (logsIndex >= 0) {
-                    setShowPopup(false);
-                    setSelectedBlueprint(selectedBlueprintItem);
-                    setExecutingOperation("view_logs");
-                    executeOperation(selectedBlueprintItem, "view_logs");
-                }
-            }
-            return;
+        else if (operationKey === "create_devbox") {
+            setSelectedBlueprint(selectedBlueprintItem);
+            setShowCreateDevbox(true);
         }
-        // Handle list navigation
-        const pageBlueprints = blueprints.length;
-        if (key.upArrow && selectedIndex > 0) {
-            setSelectedIndex(selectedIndex - 1);
+        else if (operationKey === "delete") {
+            setSelectedBlueprint(selectedBlueprintItem);
+            setShowDeleteConfirm(true);
         }
-        else if (key.downArrow && selectedIndex < pageBlueprints - 1) {
-            setSelectedIndex(selectedIndex + 1);
+        else {
+            setSelectedBlueprint(selectedBlueprintItem);
+            setExecutingOperation(operationKey);
+            executeOperation(selectedBlueprintItem, operationKey);
         }
-        else if ((input === "n" || key.rightArrow) &&
-            !loading &&
-            !navigating &&
-            hasMore) {
+    }, [
+        allOperations,
+        selectedOperation,
+        selectedBlueprintItem,
+        navigate,
+        executeOperation,
+    ]);
+    const goToNextPage = React.useCallback(() => {
+        if (!loading && !navigating && hasMore) {
             nextPage();
             setSelectedIndex(0);
         }
-        else if ((input === "p" || key.leftArrow) &&
-            !loading &&
-            !navigating &&
-            hasPrev) {
+    }, [loading, navigating, hasMore, nextPage]);
+    const goToPrevPage = React.useCallback(() => {
+        if (!loading && !navigating && hasPrev) {
             prevPage();
             setSelectedIndex(0);
         }
-        else if (key.return && selectedBlueprintItem) {
-            // Enter key navigates to detail view
-            navigate("blueprint-detail", {
-                blueprintId: selectedBlueprintItem.id,
-            });
-        }
-        else if (input === "a") {
-            setShowPopup(true);
-            setSelectedOperation(0);
-        }
-        else if (input === "l" && selectedBlueprintItem) {
-            setSelectedBlueprint(selectedBlueprintItem);
-            setExecutingOperation("view_logs");
-            executeOperation(selectedBlueprintItem, "view_logs");
+    }, [loading, navigating, hasPrev, prevPage]);
+    const handleListEscape = React.useCallback(() => {
+        if (search.handleEscape())
+            return;
+        if (onBack) {
+            onBack();
         }
-        else if (input === "o" && blueprints[selectedIndex]) {
-            const url = getBlueprintUrl(blueprints[selectedIndex].id);
-            const openBrowser = async () => {
-                const { exec } = await import("child_process");
-                const platform = process.platform;
-                let openCommand;
-                if (platform === "darwin") {
-                    openCommand = `open "${url}"`;
-                }
-                else if (platform === "win32") {
-                    openCommand = `start "${url}"`;
-                }
-                else {
-                    openCommand = `xdg-open "${url}"`;
-                }
-                exec(openCommand);
-            };
-            openBrowser();
+        else if (onExit) {
+            onExit();
         }
-        else if (input === "/") {
-            search.enterSearchMode();
+        else {
+            inkExit();
         }
-        else if (key.escape) {
-            if (search.handleEscape()) {
-                return;
-            }
-            if (onBack) {
-                onBack();
-            }
-            else if (onExit) {
-                onExit();
-            }
-            else {
-                inkExit();
-            }
-        }
-    });
+    }, [search, onBack, onExit, inkExit]);
+    const handleOpenInBrowser = React.useCallback(() => {
+        const bp = blueprints[selectedIndex];
+        if (!bp)
+            return;
+        openInBrowser(getBlueprintUrl(bp.id));
+    }, [blueprints, selectedIndex]);
+    // --- Declarative input modes ---
+    const inputModes = React.useMemo(() => [
+        // Search mode: only escape to cancel, swallow everything else
+        {
+            name: "search",
+            active: () => search.searchMode,
+            bindings: {
+                escape: () => search.cancelSearch(),
+            },
+            captureAll: true,
+        },
+        // Operation input mode: escape/q to cancel, enter to submit
+        {
+            name: "operationInput",
+            active: () => !!executingOperation && !operationResult && !operationError,
+            bindings: {
+                q: cancelOperation,
+                escape: cancelOperation,
+                enter: () => {
+                    const currentOp = allOperations.find((op) => op.key === executingOperation);
+                    if (currentOp?.needsInput) {
+                        executeOperation();
+                    }
+                },
+            },
+            captureAll: true,
+        },
+        // Operation result display: any dismiss key
+        {
+            name: "operationResult",
+            active: () => !!operationResult || !!operationError,
+            bindings: {
+                q: dismissResult,
+                escape: dismissResult,
+                enter: dismissResult,
+            },
+            captureAll: true,
+        },
+        // Create devbox subview: swallow all input
+        {
+            name: "createDevbox",
+            active: () => showCreateDevbox,
+            bindings: {},
+            captureAll: true,
+        },
+        // Actions popup overlay
+        {
+            name: "popup",
+            active: () => showPopup,
+            bindings: {
+                up: () => {
+                    if (selectedOperation > 0)
+                        setSelectedOperation(selectedOperation - 1);
+                },
+                down: () => {
+                    if (selectedOperation < allOperations.length - 1)
+                        setSelectedOperation(selectedOperation + 1);
+                },
+                enter: executePopupSelection,
+                escape: closePopup,
+                q: closePopup,
+                v: () => {
+                    if (selectedBlueprintItem) {
+                        setShowPopup(false);
+                        navigate("blueprint-detail", {
+                            blueprintId: selectedBlueprintItem.id,
+                        });
+                    }
+                },
+                c: () => {
+                    if (selectedBlueprintItem &&
+                        (selectedBlueprintItem.status === "build_complete" ||
+                            selectedBlueprintItem.status === "building_complete")) {
+                        setShowPopup(false);
+                        setSelectedBlueprint(selectedBlueprintItem);
+                        setShowCreateDevbox(true);
+                    }
+                },
+                d: () => {
+                    const deleteIndex = allOperations.findIndex((op) => op.key === "delete");
+                    if (deleteIndex >= 0) {
+                        setShowPopup(false);
+                        setSelectedBlueprint(selectedBlueprintItem);
+                        setShowDeleteConfirm(true);
+                    }
+                },
+                l: () => {
+                    const logsIndex = allOperations.findIndex((op) => op.key === "view_logs");
+                    if (logsIndex >= 0) {
+                        setShowPopup(false);
+                        setSelectedBlueprint(selectedBlueprintItem);
+                        setExecutingOperation("view_logs");
+                        executeOperation(selectedBlueprintItem, "view_logs");
+                    }
+                },
+            },
+        },
+        // List navigation (default mode)
+        {
+            name: "list",
+            active: () => true,
+            bindings: {
+                up: () => {
+                    if (selectedIndex > 0)
+                        setSelectedIndex(selectedIndex - 1);
+                },
+                down: () => {
+                    if (selectedIndex < blueprints.length - 1)
+                        setSelectedIndex(selectedIndex + 1);
+                },
+                n: goToNextPage,
+                right: goToNextPage,
+                p: goToPrevPage,
+                left: goToPrevPage,
+                enter: () => {
+                    if (selectedBlueprintItem) {
+                        navigate("blueprint-detail", {
+                            blueprintId: selectedBlueprintItem.id,
+                        });
+                    }
+                },
+                a: () => {
+                    setShowPopup(true);
+                    setSelectedOperation(0);
+                },
+                l: () => {
+                    if (selectedBlueprintItem) {
+                        setSelectedBlueprint(selectedBlueprintItem);
+                        setExecutingOperation("view_logs");
+                        executeOperation(selectedBlueprintItem, "view_logs");
+                    }
+                },
+                o: handleOpenInBrowser,
+                "/": () => search.enterSearchMode(),
+                escape: handleListEscape,
+            },
+        },
+    ], [
+        search,
+        executingOperation,
+        operationResult,
+        operationError,
+        cancelOperation,
+        allOperations,
+        executeOperation,
+        dismissResult,
+        showCreateDevbox,
+        showPopup,
+        selectedOperation,
+        executePopupSelection,
+        closePopup,
+        selectedBlueprintItem,
+        navigate,
+        selectedIndex,
+        blueprints.length,
+        goToNextPage,
+        goToPrevPage,
+        handleOpenInBrowser,
+        handleListEscape,
+    ]);
+    useInputHandler(inputModes);
     // Delete confirmation
     if (showDeleteConfirm && selectedBlueprint) {
         return (_jsx(ConfirmationPrompt, { title: "Delete Blueprint", message: `Are you sure you want to delete "${selectedBlueprint.name || selectedBlueprint.id}"?`, details: "This action cannot be undone.", breadcrumbItems: [

package/dist/commands/blueprint/prune.js

@@ -4,6 +4,7 @@
 import * as readline from "readline";
 import { getClient } from "../../utils/client.js";
 import { output, outputError } from "../../utils/output.js";
+import { formatRelativeTime } from "../../utils/time.js";
 /**
  * Fetch all blueprints with a given name (handles pagination)
  */
@@ -48,6 +49,7 @@ function categorizeBlueprints(blueprints, keepCount) {
     // Sort successful by create_time_ms descending (newest first)
     successful.sort((a, b) => (b.create_time_ms || 0) - (a.create_time_ms || 0));
     // Determine what to keep and delete
+    // keepCount of 0 means delete all (including successful builds)
     const toKeep = successful.slice(0, keepCount);
     const toDelete = [...successful.slice(keepCount), ...failed];
     return {
@@ -57,28 +59,6 @@ function categorizeBlueprints(blueprints, keepCount) {
         failed,
     };
 }
-/**
- * Format a timestamp for display
- */
-function formatTimestamp(createTimeMs) {
-    if (!createTimeMs) {
-        return "unknown time";
-    }
-    const now = Date.now();
-    const diffMs = now - createTimeMs;
-    const diffMinutes = Math.floor(diffMs / 60000);
-    const diffHours = Math.floor(diffMs / 3600000);
-    const diffDays = Math.floor(diffMs / 86400000);
-    if (diffMinutes < 60) {
-        return `${diffMinutes} minute${diffMinutes !== 1 ? "s" : ""} ago`;
-    }
-    else if (diffHours < 24) {
-        return `${diffHours} hour${diffHours !== 1 ? "s" : ""} ago`;
-    }
-    else {
-        return `${diffDays} day${diffDays !== 1 ? "s" : ""} ago`;
-    }
-}
 /**
  * Display a summary of what will be kept and deleted
  */
@@ -91,11 +71,16 @@ function displaySummary(name, result, isDryRun) {
     // Show what will be kept
     console.log(`\nKeeping (${result.toKeep.length} most recent successful):`);
     if (result.toKeep.length === 0) {
-        console.log("  (none - no successful builds found)");
+        if (result.successful.length === 0) {
+            console.log("  (none - no successful builds found)");
+        }
+        else {
+            console.log("  (none)");
+        }
     }
     else {
         for (const blueprint of result.toKeep) {
-            console.log(`  ✓ ${blueprint.id} - Created ${formatTimestamp(blueprint.create_time_ms)}`);
+            console.log(`  ✓ ${blueprint.id} - Created ${formatRelativeTime(blueprint.create_time_ms)}`);
         }
     }
     // Show what will be deleted
@@ -108,7 +93,7 @@ function displaySummary(name, result, isDryRun) {
         for (const blueprint of result.toDelete) {
             const icon = blueprint.status === "build_complete" ? "✓" : "⚠";
             const statusLabel = blueprint.status === "build_complete" ? "successful" : "failed";
-            console.log(`  ${icon} ${blueprint.id} - Created ${formatTimestamp(blueprint.create_time_ms)} (${statusLabel})`);
+            console.log(`  ${icon} ${blueprint.id} - Created ${formatRelativeTime(blueprint.create_time_ms)} (${statusLabel})`);
         }
     }
 }
@@ -123,7 +108,7 @@ function displayDeletedBlueprints(deleted) {
     for (const blueprint of deleted) {
         const icon = blueprint.status === "build_complete" ? "✓" : "⚠";
         const statusLabel = blueprint.status === "build_complete" ? "successful" : "failed";
-        console.log(`  ${icon} ${blueprint.id} - Created ${formatTimestamp(blueprint.create_time_ms)} (${statusLabel})`);
+        console.log(`  ${icon} ${blueprint.id} - Created ${formatRelativeTime(blueprint.create_time_ms)} (${statusLabel})`);
     }
 }
 /**
@@ -173,8 +158,8 @@ export async function pruneBlueprints(name, options = {}) {
         const isDryRun = options.dryRun || false;
         const autoConfirm = options.yes || false;
         const keepCount = parseInt(options.keep || "1", 10);
-        if (isNaN(keepCount) || keepCount < 1) {
-            outputError("--keep must be a positive integer");
+        if (isNaN(keepCount) || keepCount < 0) {
+            outputError("--keep must be a non-negative integer");
         }
         // Fetch all blueprints with the given name
         console.log(`Fetching blueprints named "${name}"...`);