crewly 1.3.30 → 1.4.0

package/dist/cli/cli/src/commands/pair.js

@@ -0,0 +1,258 @@
+/**
+ * CLI Pair Command
+ *
+ * Enables two Crewly instances to pair via Cloud Relay for
+ * inter-node communication when direct connections are unavailable
+ * (NAT/firewall). Uses pairing codes and E2EE (AES-256-GCM).
+ *
+ * Usage:
+ *   crewly pair --cloud              # Generate a pairing code (orchestrator)
+ *   crewly pair --cloud --code ABC   # Join with existing code (agent)
+ *
+ * @module cli/commands/pair
+ */
+import chalk from 'chalk';
+import { randomBytes } from 'crypto';
+import { createInterface } from 'readline';
+import axios from 'axios';
+import { DEFAULT_WEB_PORT } from '../constants.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Backend base URL */
+const BACKEND_URL = `http://localhost:${DEFAULT_WEB_PORT}`;
+/** Relay API endpoint on the backend */
+const RELAY_CONNECT_ENDPOINT = '/api/relay/connect';
+/** Relay disconnect endpoint on the backend */
+const RELAY_DISCONNECT_ENDPOINT = '/api/relay/disconnect';
+/** Relay device list endpoint on the backend */
+const RELAY_DEVICES_ENDPOINT = '/api/relay/devices';
+/** Number of bytes for pairing code generation (produces 6-char hex string) */
+const PAIRING_CODE_BYTES = 3;
+/** Timeout for backend API requests (ms) */
+const API_TIMEOUT_MS = 15_000;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Generate a short, human-friendly pairing code.
+ *
+ * Produces a 6-character uppercase hex string formatted as XXX-XXX.
+ *
+ * @returns Formatted pairing code (e.g. "A3F-B12")
+ */
+export function generatePairingCode() {
+    const hex = randomBytes(PAIRING_CODE_BYTES).toString('hex').toUpperCase();
+    return `${hex.slice(0, 3)}-${hex.slice(3, 6)}`;
+}
+/**
+ * Prompt the user for text input on stdin.
+ *
+ * @param prompt - Text to display before the cursor
+ * @returns The user's input string
+ */
+function askQuestion(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Command implementation
+// ---------------------------------------------------------------------------
+/**
+ * Entry point for the `crewly pair` command.
+ *
+ * Handles three sub-flows:
+ * 1. `--disconnect` — Disconnect from an active relay session
+ * 2. `--devices` — List paired/connected devices
+ * 3. `--cloud` — Initiate or join a Cloud Relay pairing session
+ *
+ * When `--cloud` is used without `--code`, a new pairing code is generated
+ * and the node registers as an orchestrator. When `--code` is provided,
+ * the node joins as an agent using the given code.
+ *
+ * @param options - Command options from Commander.js
+ */
+export async function pairCommand(options) {
+    if (options.disconnect) {
+        await disconnectRelay();
+        return;
+    }
+    if (options.devices) {
+        await listDevices();
+        return;
+    }
+    if (!options.cloud) {
+        console.log(chalk.red('Please specify a pairing method.'));
+        console.log(chalk.gray('Usage: crewly pair --cloud'));
+        console.log(chalk.gray('       crewly pair --cloud --code <CODE>'));
+        console.log(chalk.gray('       crewly pair --disconnect'));
+        console.log(chalk.gray('       crewly pair --devices'));
+        process.exit(1);
+    }
+    await cloudPair(options);
+}
+/**
+ * Initiate or join a Cloud Relay pairing session.
+ *
+ * If no `--code` is provided, generates a new pairing code and registers
+ * as an orchestrator, then waits for an agent to pair.
+ * If `--code` is provided, joins as an agent using the existing code.
+ *
+ * @param options - Command options including optional code, role, and secret
+ */
+async function cloudPair(options) {
+    let pairingCode = options.code || '';
+    let role;
+    if (pairingCode) {
+        // Joining an existing session as an agent
+        role = options.role || 'agent';
+        console.log(chalk.blue(`Joining Cloud Relay with code: ${chalk.bold(pairingCode)}`));
+    }
+    else {
+        // Creating a new session as an orchestrator
+        role = options.role || 'orchestrator';
+        pairingCode = generatePairingCode();
+        console.log('');
+        console.log(chalk.blue('Cloud Relay Pairing'));
+        console.log(chalk.gray('─'.repeat(40)));
+        console.log('');
+        console.log(chalk.white('Your pairing code:'));
+        console.log('');
+        console.log(chalk.bold.cyan(`    ${pairingCode}`));
+        console.log('');
+        console.log(chalk.gray('Share this code with the other machine.'));
+        console.log(chalk.gray('Run on the other machine:'));
+        console.log(chalk.gray(`  crewly pair --cloud --code ${pairingCode}`));
+        console.log('');
+    }
+    // Prompt for shared secret if not provided
+    const sharedSecret = options.secret || await askQuestion(chalk.white('Enter shared secret (for E2EE encryption): '));
+    if (!sharedSecret) {
+        console.log(chalk.red('Shared secret is required for end-to-end encryption.'));
+        process.exit(1);
+    }
+    // Connect via backend API
+    console.log('');
+    console.log(chalk.blue('Connecting to Cloud Relay...'));
+    try {
+        const response = await axios.post(`${BACKEND_URL}${RELAY_CONNECT_ENDPOINT}`, {
+            pairingCode,
+            role,
+            sharedSecret,
+        }, { timeout: API_TIMEOUT_MS });
+        if (response.data?.success) {
+            console.log(chalk.green('  ✓ Connected to Cloud Relay'));
+            console.log(chalk.green(`  ✓ Role: ${role}`));
+            console.log(chalk.green(`  ✓ Pairing code: ${pairingCode}`));
+            if (response.data.sessionId) {
+                console.log(chalk.green(`  ✓ Session ID: ${response.data.sessionId}`));
+            }
+            console.log('');
+            if (role === 'orchestrator') {
+                console.log(chalk.cyan('Waiting for agent to pair with your code...'));
+                console.log(chalk.gray('The connection will be established when the other machine joins.'));
+            }
+            else {
+                console.log(chalk.cyan('Pairing with orchestrator...'));
+                console.log(chalk.gray('The connection will be established momentarily.'));
+            }
+            console.log('');
+            console.log(chalk.gray('To disconnect: crewly pair --disconnect'));
+            console.log(chalk.gray('To see paired devices: crewly pair --devices'));
+        }
+        else {
+            const msg = response.data?.error || 'Unknown error';
+            console.log(chalk.red(`  ✗ Failed to connect: ${msg}`));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        handleApiError(error, 'connect to Cloud Relay');
+    }
+}
+/**
+ * Disconnect from an active Cloud Relay session.
+ */
+async function disconnectRelay() {
+    console.log(chalk.blue('Disconnecting from Cloud Relay...'));
+    try {
+        const response = await axios.post(`${BACKEND_URL}${RELAY_DISCONNECT_ENDPOINT}`, {}, { timeout: API_TIMEOUT_MS });
+        if (response.data?.success) {
+            console.log(chalk.green('  ✓ Disconnected from Cloud Relay'));
+        }
+        else {
+            console.log(chalk.yellow('  No active relay session to disconnect.'));
+        }
+    }
+    catch (error) {
+        handleApiError(error, 'disconnect from Cloud Relay');
+    }
+}
+/**
+ * List devices connected via Cloud Relay.
+ */
+async function listDevices() {
+    console.log(chalk.blue('Fetching paired devices...'));
+    try {
+        const response = await axios.get(`${BACKEND_URL}${RELAY_DEVICES_ENDPOINT}`, { timeout: API_TIMEOUT_MS });
+        if (response.data?.success) {
+            const devices = response.data.devices || [];
+            if (devices.length === 0) {
+                console.log(chalk.yellow('  No devices currently paired.'));
+                console.log(chalk.gray('  Use "crewly pair --cloud" to start pairing.'));
+            }
+            else {
+                console.log(chalk.green(`  Found ${devices.length} paired device(s):\n`));
+                for (const device of devices) {
+                    const statusColor = device.state === 'paired' ? chalk.green : chalk.yellow;
+                    console.log(`  ${statusColor('●')} ${chalk.white(device.role || 'unknown')} — ${device.sessionId || 'N/A'}`);
+                    console.log(chalk.gray(`    State: ${device.state || 'unknown'}`));
+                    if (device.registeredAt) {
+                        console.log(chalk.gray(`    Connected: ${device.registeredAt}`));
+                    }
+                }
+            }
+        }
+        else {
+            console.log(chalk.yellow('  Could not fetch device list.'));
+        }
+    }
+    catch (error) {
+        handleApiError(error, 'fetch paired devices');
+    }
+}
+/**
+ * Handle API errors with user-friendly output.
+ *
+ * Differentiates between network errors (backend not running) and
+ * server errors (backend returned an error status).
+ *
+ * @param error - The caught error
+ * @param action - Description of the failed action for the error message
+ */
+function handleApiError(error, action) {
+    if (axios.isAxiosError(error)) {
+        if (error.code === 'ECONNREFUSED') {
+            console.log(chalk.red(`  ✗ Cannot ${action}: Crewly backend is not running.`));
+            console.log(chalk.gray('  Start with: crewly start'));
+        }
+        else if (error.response) {
+            const msg = error.response.data?.error || error.response.statusText || 'Server error';
+            console.log(chalk.red(`  ✗ Failed to ${action}: ${msg}`));
+        }
+        else {
+            console.log(chalk.red(`  ✗ Failed to ${action}: ${error.message}`));
+        }
+    }
+    else {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.log(chalk.red(`  ✗ Failed to ${action}: ${msg}`));
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=pair.js.map

package/dist/cli/cli/src/commands/pair.js.map

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

package/dist/cli/cli/src/commands/service.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Crewly service management command.
+ *
+ * Installs, uninstalls, and checks the status of Crewly as a platform-native
+ * background service:
+ *
+ * **macOS** — Login Item `.command` file (runs inside Terminal.app)
+ *   Why not a LaunchAgent plist? macOS TCC grants permissions based on the
+ *   "responsible process." LaunchAgent children do NOT inherit Full Disk
+ *   Access, so they cannot access ~/Desktop/ or other protected directories.
+ *   A `.command` file runs inside Terminal.app whose TCC permissions propagate
+ *   to child processes. It also sources the user's shell profile, picking up
+ *   NVM/Homebrew paths that LaunchAgents miss.
+ *
+ * **Linux** — systemd user service (`systemctl --user`)
+ *   No TCC equivalent on Linux, so a standard systemd unit file works.
+ *   The service sources the user's shell profile for NVM/PATH consistency.
+ */
+interface ServiceOptions {
+    force?: boolean;
+}
+/**
+ * Entry point for the `crewly service` subcommand.
+ *
+ * Dispatches to install / uninstall / status based on the positional argument.
+ * Platform detection routes to macOS or Linux implementations.
+ *
+ * @param action - One of "install", "uninstall", or "status"
+ * @param options - Command options (e.g. --force)
+ */
+export declare function serviceCommand(action: string, options: ServiceOptions): Promise<void>;
+/**
+ * Generates the systemd unit file content.
+ *
+ * Uses a wrapper script as ExecStart so the user's shell profile is sourced,
+ * ensuring NVM and other PATH additions are available.
+ *
+ * @param projectRoot - Absolute path to the Crewly project directory
+ * @returns The systemd unit file content
+ */
+export declare function generateSystemdUnit(projectRoot: string): string;
+/**
+ * Generates the Linux wrapper script that sources the shell profile
+ * before starting node, ensuring NVM/PATH are available.
+ *
+ * @param projectRoot - Absolute path to the Crewly project directory
+ * @returns The shell script content
+ */
+export declare function generateLinuxWrapper(projectRoot: string): string;
+/**
+ * Queries systemd for the current state of the crewly service.
+ *
+ * @returns "active", "enabled", "inactive", or null if not registered
+ */
+export declare function getSystemdState(): Promise<string | null>;
+/**
+ * Generates the content of the .command wrapper script (macOS).
+ *
+ * The script sources the user's shell profile (for NVM/PATH), prevents
+ * duplicate instances via a PID file, and auto-restarts on crash.
+ *
+ * @param projectRoot - Absolute path to the Crewly project directory
+ * @returns The shell script content
+ */
+export declare function generateCommandFile(projectRoot: string): string;
+/**
+ * Checks whether the Crewly Login Item is currently registered.
+ *
+ * @returns true if registered
+ */
+export declare function isLoginItemRegistered(): Promise<boolean>;
+/**
+ * Finds the Crewly project root by walking up from cwd looking for
+ * a package.json with `"name": "crewly"`.
+ *
+ * @returns Absolute path to the project root, or null if not found
+ */
+export declare function findProjectRoot(): string | null;
+/**
+ * Reads the PID file and verifies the process is still alive.
+ *
+ * @returns The PID if the process is running, or null
+ */
+export declare function getRunningPid(): number | null;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/cli/cli/src/commands/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../cli/src/commands/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA8FH,UAAU,cAAc;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAkBf;AA4VD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAmB/D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA4BhE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsB9D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAmD/D;AAsCD;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9D;AAgED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAsB/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAgB7C"}