lobstercage-cli 0.1.0

package/dist/commands/tunnel.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * Tunnel Commands
+ *
+ * tunnel, ssh
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tunnelHandler = tunnelHandler;
+exports.sshHandler = sshHandler;
+exports.createTunnelCommands = createTunnelCommands;
+const ora_1 = __importDefault(require("ora"));
+const ws_1 = __importDefault(require("ws"));
+const net = __importStar(require("net"));
+const api = __importStar(require("../lib/api"));
+const output = __importStar(require("../lib/output"));
+const utils_1 = require("../lib/utils");
+const error_handler_1 = require("../lib/error-handler");
+/**
+ * Creates a WebSocket tunnel connection
+ */
+async function createTunnel(wsUrl, token, localPort, remotePort) {
+    return new Promise((resolve, reject) => {
+        // Create local TCP server
+        const server = net.createServer((socket) => {
+            // Connect to WebSocket tunnel
+            const ws = new ws_1.default(wsUrl, {
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'X-Remote-Port': remotePort.toString(),
+                },
+            });
+            let connected = false;
+            ws.on('open', () => {
+                connected = true;
+                output.info(`Connection established to remote port ${remotePort}`);
+            });
+            ws.on('message', (data) => {
+                if (socket.writable) {
+                    socket.write(data);
+                }
+            });
+            ws.on('close', () => {
+                if (!socket.destroyed) {
+                    socket.end();
+                }
+            });
+            ws.on('error', (err) => {
+                output.error(`WebSocket error: ${err.message}`);
+                if (!socket.destroyed) {
+                    socket.destroy();
+                }
+            });
+            socket.on('data', (data) => {
+                if (ws.readyState === ws_1.default.OPEN) {
+                    ws.send(data);
+                }
+            });
+            socket.on('close', () => {
+                if (ws.readyState === ws_1.default.OPEN) {
+                    ws.close();
+                }
+            });
+            socket.on('error', (err) => {
+                if (err.code !== 'ECONNRESET') {
+                    output.error(`Socket error: ${err.message}`);
+                }
+                if (ws.readyState === ws_1.default.OPEN) {
+                    ws.close();
+                }
+            });
+        });
+        server.on('error', (err) => {
+            output.error(`Server error: ${err.message}`);
+            reject(err);
+        });
+        server.listen(localPort, '127.0.0.1', () => {
+            output.success(`Tunnel listening on localhost:${localPort} -> cage:${remotePort}`);
+            output.info('Press Ctrl+C to close the tunnel');
+            // Don't resolve - keep running until Ctrl+C
+        });
+        // Handle graceful shutdown
+        process.on('SIGINT', () => {
+            output.info('\nClosing tunnel...');
+            server.close(() => {
+                resolve();
+                process.exit(0);
+            });
+        });
+    });
+}
+/**
+ * Tunnel command handler
+ */
+async function tunnelHandler(nameOrId, options) {
+    // Determine tunnel type and ports
+    let tunnelType = options.ssh ? 'ssh' : 'port';
+    let remotePort = options.ssh ? 22 : parseInt(options.port || '80', 10);
+    let localPort = options.localPort ? parseInt(options.localPort, 10) : remotePort;
+    if (tunnelType === 'port' && !options.port) {
+        output.error('Remote port is required. Use --port <port> or --ssh');
+        process.exit(1);
+    }
+    if (isNaN(remotePort) || remotePort < 1 || remotePort > 65535) {
+        output.error('Invalid remote port number');
+        process.exit(1);
+    }
+    if (isNaN(localPort) || localPort < 1 || localPort > 65535) {
+        output.error('Invalid local port number');
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Initiating tunnel...').start();
+    try {
+        (0, utils_1.requireAuth)();
+        const cageId = await (0, utils_1.resolveCageId)(nameOrId);
+        // Get tunnel token
+        const tunnel = await api.initiateTunnel(cageId, {
+            type: tunnelType,
+            port: remotePort,
+        });
+        spinner.stop();
+        if (options.json) {
+            output.json({
+                localPort,
+                remotePort,
+                wsUrl: tunnel.wsUrl,
+                expiresAt: tunnel.expiresAt,
+            });
+            return;
+        }
+        // Establish the tunnel
+        await createTunnel(tunnel.wsUrl, tunnel.token, localPort, remotePort);
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { spinner, json: options.json, context: 'initiating tunnel' });
+    }
+}
+/**
+ * SSH command handler
+ *
+ * This is a convenience wrapper around tunnel --ssh
+ */
+async function sshHandler(nameOrId, options) {
+    const localPort = options.localPort ? parseInt(options.localPort, 10) : 2222;
+    if (isNaN(localPort) || localPort < 1 || localPort > 65535) {
+        output.error('Invalid local port number');
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Setting up SSH tunnel...').start();
+    try {
+        (0, utils_1.requireAuth)();
+        const cageId = await (0, utils_1.resolveCageId)(nameOrId);
+        // Get SSH tunnel token
+        const tunnel = await api.initiateTunnel(cageId, {
+            type: 'ssh',
+        });
+        spinner.stop();
+        if (options.json) {
+            output.json({
+                command: `ssh -p ${localPort} root@localhost`,
+                localPort,
+                remotePort: 22,
+                wsUrl: tunnel.wsUrl,
+                expiresAt: tunnel.expiresAt,
+            });
+            return;
+        }
+        output.info(`SSH tunnel will be available at localhost:${localPort}`);
+        output.info(`Connect with: ssh -p ${localPort} root@localhost`);
+        console.log();
+        // Establish the SSH tunnel
+        await createTunnel(tunnel.wsUrl, tunnel.token, localPort, 22);
+    }
+    catch (err) {
+        (0, error_handler_1.handleError)(err, { spinner, json: options.json, context: 'setting up SSH tunnel' });
+    }
+}
+/**
+ * Create tunnel commands
+ */
+function createTunnelCommands(program) {
+    program
+        .command('tunnel <name>')
+        .description('Create a secure tunnel to a cage')
+        .option('-p, --port <port>', 'Remote port to tunnel')
+        .option('-l, --local-port <port>', 'Local port to listen on (default: same as remote)')
+        .option('--ssh', 'Shorthand for --port 22')
+        .option('--json', 'Output tunnel info as JSON (don\'t start tunnel)')
+        .action(tunnelHandler);
+    program
+        .command('ssh <name>')
+        .description('SSH into a cage (shorthand for tunnel --ssh)')
+        .option('-l, --local-port <port>', 'Local port to listen on (default: 2222)')
+        .option('--json', 'Output tunnel info as JSON')
+        .action(sshHandler);
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/commands/tunnel.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * LobsterCage CLI
+ *
+ * Secure AI Agent Sandboxes
+ *
+ * Usage:
+ *   lobster login                     Login to LobsterCage
+ *   lobster login --browser           Login via browser OAuth
+ *   lobster deploy <name>             Create and start a new cage
+ *   lobster list                      List all cages
+ *   lobster status <name>             Get cage status
+ *   lobster start <name>              Start a stopped cage
+ *   lobster stop <name>               Stop a running cage
+ *   lobster hibernate <name>          Hibernate a cage (preserves state)
+ *   lobster wake <name>               Wake a hibernated cage
+ *   lobster destroy <name>            Delete a cage permanently
+ *   lobster logs <name>               View cage logs
+ *   lobster env list <cage>           List environment variables
+ *   lobster env set <cage> KEY=VAL    Set environment variables
+ *   lobster env get <cage> <name>     Get environment variable value
+ *   lobster env delete <cage> <name>  Delete environment variable
+ *   lobster env scan <cage>           Scan for security issues
+ *   lobster tunnel <name> --port 80   Tunnel to a port
+ *   lobster ssh <name>                SSH into a cage
+ *   lobster billing                   View billing status
+ *   lobster billing portal            Open billing portal
+ *   lobster upgrade                   Upgrade to Pro plan
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * LobsterCage CLI
+ *
+ * Secure AI Agent Sandboxes
+ *
+ * Usage:
+ *   lobster login                     Login to LobsterCage
+ *   lobster login --browser           Login via browser OAuth
+ *   lobster deploy <name>             Create and start a new cage
+ *   lobster list                      List all cages
+ *   lobster status <name>             Get cage status
+ *   lobster start <name>              Start a stopped cage
+ *   lobster stop <name>               Stop a running cage
+ *   lobster hibernate <name>          Hibernate a cage (preserves state)
+ *   lobster wake <name>               Wake a hibernated cage
+ *   lobster destroy <name>            Delete a cage permanently
+ *   lobster logs <name>               View cage logs
+ *   lobster env list <cage>           List environment variables
+ *   lobster env set <cage> KEY=VAL    Set environment variables
+ *   lobster env get <cage> <name>     Get environment variable value
+ *   lobster env delete <cage> <name>  Delete environment variable
+ *   lobster env scan <cage>           Scan for security issues
+ *   lobster tunnel <name> --port 80   Tunnel to a port
+ *   lobster ssh <name>                SSH into a cage
+ *   lobster billing                   View billing status
+ *   lobster billing portal            Open billing portal
+ *   lobster upgrade                   Upgrade to Pro plan
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const auth_1 = require("./commands/auth");
+const cages_1 = require("./commands/cages");
+const env_1 = require("./commands/env");
+const tunnel_1 = require("./commands/tunnel");
+const exec_1 = require("./commands/exec");
+const billing_1 = require("./commands/billing");
+const output = __importStar(require("./lib/output"));
+const api_1 = require("./lib/api");
+const error_handler_1 = require("./lib/error-handler");
+// Read version from package.json at build time (resolveJsonModule)
+const package_json_1 = require("../package.json");
+// Create the main program
+const program = new commander_1.Command();
+program
+    .name('lobster')
+    .description('LobsterCage CLI - Secure AI Agent Sandboxes')
+    .version(package_json_1.version)
+    .enablePositionalOptions()
+    .option('--api-url <url>', 'Override API URL')
+    .option('--debug', 'Show detailed error information and stack traces')
+    .hook('preAction', (thisCommand) => {
+    const options = thisCommand.opts();
+    if (options.apiUrl) {
+        // Set custom API URL
+        const { setApiUrl } = require('./lib/config');
+        setApiUrl(options.apiUrl);
+    }
+});
+// Register all command modules
+(0, auth_1.createAuthCommands)(program);
+(0, cages_1.createCageCommands)(program);
+(0, env_1.createEnvCommands)(program);
+(0, tunnel_1.createTunnelCommands)(program);
+(0, exec_1.createExecCommand)(program);
+(0, billing_1.createBillingCommands)(program);
+// Global error handling
+process.on('uncaughtException', (err) => {
+    if (err instanceof api_1.ApiClientError) {
+        output.error(err.message);
+        if (err.code === 'NETWORK_ERROR') {
+            output.info('Check your internet connection and try again.');
+        }
+    }
+    else {
+        output.error(`Unexpected error: ${err.message}`);
+    }
+    if ((0, error_handler_1.isDebug)() && err.stack) {
+        console.error(err.stack);
+    }
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    if (reason instanceof api_1.ApiClientError) {
+        output.error(reason.message);
+    }
+    else if (reason instanceof Error) {
+        output.error(`Unexpected error: ${reason.message}`);
+        if ((0, error_handler_1.isDebug)() && reason.stack) {
+            console.error(reason.stack);
+        }
+    }
+    else {
+        output.error(`Unexpected error: ${reason}`);
+    }
+    process.exit(1);
+});
+// Parse and execute
+program.parse(process.argv);
+// Show help if no command provided
+if (process.argv.length === 2) {
+    program.help();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/api.d.ts

@@ -0,0 +1,96 @@
+/**
+ * LobsterCage API Client
+ *
+ * Handles all HTTP communication with the LobsterCage API.
+ * Includes automatic token refresh and error handling.
+ */
+import { AxiosInstance } from 'axios';
+import type { AuthResponse, Cage, CreateCageRequest, UpdateCageRequest, EnvVar, SetEnvRequest, SecurityWarning, TunnelRequest, TunnelResponse, LogEntry, Account, Usage, ApiKey, ApiKeyCreated, BillingStatus } from '../types';
+/**
+ * Custom error class for API errors
+ */
+export declare class ApiClientError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: string, statusCode: number, details?: Record<string, unknown>);
+}
+/**
+ * Creates and configures the API client
+ */
+export declare function createApiClient(): AxiosInstance;
+/**
+ * Gets the API client instance (creates if needed)
+ */
+export declare function getApiClient(): AxiosInstance;
+/**
+ * Resets the API client (useful for testing or after URL change)
+ */
+export declare function resetApiClient(): void;
+export declare function register(email: string, password: string, name?: string): Promise<AuthResponse>;
+export declare function login(email: string, password: string): Promise<AuthResponse>;
+export declare function refreshToken(token: string): Promise<AuthResponse>;
+export declare function logout(): Promise<void>;
+export declare function listApiKeys(): Promise<ApiKey[]>;
+export declare function createApiKey(name: string, scopes?: string[], expiresAt?: string): Promise<ApiKeyCreated>;
+export declare function revokeApiKey(keyId: string): Promise<void>;
+export interface ListCagesOptions {
+    status?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface ListCagesResponse {
+    cages: Cage[];
+    nextCursor?: string;
+}
+export declare function listCages(options?: ListCagesOptions): Promise<ListCagesResponse>;
+export declare function getCage(cageId: string): Promise<Cage>;
+export declare function createCage(request: CreateCageRequest): Promise<Cage>;
+export declare function updateCage(cageId: string, request: UpdateCageRequest): Promise<Cage>;
+export declare function deleteCage(cageId: string): Promise<void>;
+export declare function startCage(cageId: string): Promise<Cage>;
+export declare function stopCage(cageId: string, force?: boolean): Promise<Cage>;
+export declare function restartCage(cageId: string): Promise<Cage>;
+export declare function hibernateCage(cageId: string): Promise<Cage>;
+export declare function wakeCage(cageId: string): Promise<Cage>;
+export interface GetLogsOptions {
+    since?: string;
+    until?: string;
+    tail?: number;
+}
+export interface GetLogsResponse {
+    logs: LogEntry[];
+    nextToken?: string;
+}
+export declare function getCageLogs(cageId: string, options?: GetLogsOptions): Promise<GetLogsResponse>;
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function execInCage(cageId: string, command: string[]): Promise<ExecResult>;
+export declare function listEnvVars(cageId: string): Promise<EnvVar[]>;
+export interface SetEnvResponse {
+    variables: EnvVar[];
+    securityWarnings?: SecurityWarning[];
+}
+export declare function setEnvVars(cageId: string, request: SetEnvRequest): Promise<SetEnvResponse>;
+export declare function getEnvVar(cageId: string, varName: string): Promise<{
+    name: string;
+    value: string;
+}>;
+export declare function deleteEnvVar(cageId: string, varName: string): Promise<void>;
+export declare function scanEnvVars(cageId: string): Promise<{
+    warnings: SecurityWarning[];
+}>;
+export declare function initiateTunnel(cageId: string, request: TunnelRequest): Promise<TunnelResponse>;
+export declare function getAccount(): Promise<Account>;
+export declare function getUsage(period?: 'day' | 'week' | 'month'): Promise<Usage>;
+export declare function getBillingStatus(): Promise<BillingStatus>;
+export declare function createCheckoutSession(successUrl: string, cancelUrl: string): Promise<{
+    url: string;
+}>;
+export declare function createPortalSession(returnUrl: string): Promise<{
+    url: string;
+}>;
+//# sourceMappingURL=api.d.ts.map

package/dist/lib/api.d.ts.map

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