@leverageaiapps/leverageai-agent 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 LeverageAI Apps
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# LeverageAI Agent
+
+[![npm version](https://img.shields.io/npm/v/@leverageaiapps/leverageai-agent.svg)](https://www.npmjs.com/package/@leverageaiapps/leverageai-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+CLI tool to forward terminal sessions to your mobile device via Cloudflare Tunnel. **Code anywhere from your pocket.**
+
+<p align="center">
+  <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="Node.js">
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue" alt="Platform">
+</p>
+
+## Features
+
+- 🚀 **Instant Setup** - One command to start forwarding your terminal
+- 📱 **Mobile Access** - Access your terminal from any device with a browser
+- 🎙️ **Voice Input** - Built-in voice recognition for hands-free coding
+- 🔒 **Secure** - PIN-protected sessions with automatic IP blocking
+- 🌐 **No Port Forwarding** - Uses Cloudflare Quick Tunnel (no account needed)
+- ⚡ **Real-time** - WebSocket-based communication for instant feedback
+- 🎯 **PTY Support** - Full terminal emulation with node-pty
+
+## Prerequisites
+
+### Install cloudflared
+
+LeverageAI Agent requires `cloudflared` to create secure tunnels:
+
+**macOS:**
+```bash
+brew install cloudflared
+```
+
+**Ubuntu/Debian:**
+```bash
+sudo mkdir -p --mode=0755 /usr/share/keyrings
+curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
+echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main' | sudo tee /etc/apt/sources.list.d/cloudflared.list
+sudo apt-get update && sudo apt-get install cloudflared
+```
+
+**Arch Linux:**
+```bash
+sudo pacman -S cloudflared
+```
+
+For other systems, see the [official installation guide](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/).
+
+## Installation
+
+```bash
+npm install -g @leverageaiapps/leverageai-agent
+```
+
+**Verify Installation:**
+```bash
+leverageaiagent --version
+```
+
+## Quick Start
+
+```bash
+# Start a terminal session
+leverageaiagent start
+
+# Start with a specific command
+leverageaiagent start claude
+leverageaiagent start python
+leverageaiagent start vim
+```
+
+A QR code will appear - scan it with your phone and enter the 6-digit PIN to access your terminal!
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Start a terminal session
+leverageaiagent start
+
+# Start with a custom PIN
+leverageaiagent start --pin 123456
+
+# Start with a machine name
+leverageaiagent start --name "My Laptop"
+
+# Start a specific command
+leverageaiagent start claude --pin 123456
+```
+
+### Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--name <name>` | `-n` | Set a custom machine name |
+| `--pin <pin>` | `-p` | Set a custom 6-digit PIN |
+| `--debug-asr` | | Enable verbose ASR logging |
+
+### Configuration
+
+```bash
+# Show current configuration
+leverageaiagent config --show
+```
+
+## How It Works
+
+1. Run `leverageaiagent start [command]` in your terminal
+2. LeverageAI Agent starts a local web server and creates a Cloudflare tunnel
+3. A QR code appears with your unique URL
+4. Scan the QR code with your phone
+5. Enter the 6-digit PIN to access your terminal
+6. Your terminal is now accessible from your mobile device!
+
+### Exiting
+
+To exit LeverageAI Agent, you can:
+- Type `exit` in the terminal (or the command to exit your current program)
+- Press `Ctrl+C` in the terminal where you ran `leverageaiagent start`
+- Close the terminal window
+
+When you see **"Terminal session ended."**, the session has been successfully closed.
+
+## Security
+
+- **PIN Protection**: Each session requires a 6-digit PIN
+- **Rate Limiting**: Max 10 failed login attempts per IP
+- **Auto-blocking**: IPs are temporarily blocked after too many failures
+- **Session Cookies**: Authentication persists for 24 hours
+
+## Troubleshooting
+
+### Error: posix_spawnp failed
+
+Fix permissions on the node-pty spawn-helper:
+
+```bash
+# macOS ARM (M1/M2/M3)
+chmod +x node_modules/node-pty/prebuilds/darwin-arm64/spawn-helper
+
+# macOS Intel
+chmod +x node_modules/node-pty/prebuilds/darwin-x64/spawn-helper
+
+# Linux x64
+chmod +x node_modules/node-pty/prebuilds/linux-x64/spawn-helper
+```
+
+### cloudflared not found
+
+Install cloudflared following the [Prerequisites](#prerequisites) section, then verify:
+
+```bash
+cloudflared --version
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/) for secure tunneling
+- [node-pty](https://github.com/microsoft/node-pty) for PTY support
+- [xterm.js](https://xtermjs.org/) for terminal emulation in the browser

package/dist/capture.d.ts

@@ -0,0 +1,3 @@
+export declare function startCapture(sessionId: string, serverUrl: string): void;
+export declare function stopCapture(): void;
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AASA,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAuCvE;AAED,wBAAgB,WAAW,IAAI,IAAI,CASlC"}

package/dist/capture.js

@@ -0,0 +1,134 @@
+"use strict";
+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.startCapture = startCapture;
+exports.stopCapture = stopCapture;
+const axios_1 = __importDefault(require("axios"));
+const readline = __importStar(require("readline"));
+// Buffer for accumulating partial lines
+let lineBuffer = '';
+let debounceTimer = null;
+const DEBOUNCE_MS = 100;
+let rl = null;
+function startCapture(sessionId, serverUrl) {
+    // Only set up stdin capture if we're receiving piped input
+    if (process.stdin.isTTY) {
+        // Running interactively (not piped), don't capture stdin
+        console.log('  [Capture] Running in interactive mode');
+        return;
+    }
+    // Create readline interface for stdin (for piped input)
+    rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: false,
+    });
+    // Listen for lines from Claude Code (piped input)
+    rl.on('line', (line) => {
+        // Accumulate lines and debounce sending
+        lineBuffer += line + '\n';
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            sendMessage(sessionId, serverUrl, lineBuffer.trim());
+            lineBuffer = '';
+        }, DEBOUNCE_MS);
+    });
+    rl.on('close', () => {
+        // Send any remaining buffer
+        if (lineBuffer.trim()) {
+            sendMessage(sessionId, serverUrl, lineBuffer.trim());
+        }
+        console.log('  Input stream closed.');
+    });
+    console.log('  [Capture] Listening for piped input...');
+}
+function stopCapture() {
+    if (rl) {
+        rl.close();
+        rl = null;
+    }
+    if (debounceTimer) {
+        clearTimeout(debounceTimer);
+        debounceTimer = null;
+    }
+}
+async function sendMessage(sessionId, serverUrl, text) {
+    if (!text)
+        return;
+    try {
+        // Try to parse as Claude Code message format
+        const content = parseClaudeCodeMessage(text);
+        await axios_1.default.post(`${serverUrl}/api/sessions/${sessionId}/messages`, {
+            role: 'agent',
+            content,
+        });
+    }
+    catch (error) {
+        // Silently fail - we don't want to interrupt the user
+        if (process.env.DEBUG) {
+            console.error('Failed to send message:', error);
+        }
+    }
+}
+// Parse Claude Code output into structured format
+function parseClaudeCodeMessage(text) {
+    // Check for tool use patterns
+    const toolUseMatch = text.match(/^(?:Using|Running|Executing|Calling)\s+(\w+)/i);
+    if (toolUseMatch) {
+        return {
+            type: 'tool-call',
+            name: toolUseMatch[1],
+            input: { description: text },
+        };
+    }
+    // Check for code blocks
+    if (text.includes('```')) {
+        return {
+            type: 'text',
+            text,
+        };
+    }
+    // Default to text
+    return {
+        type: 'text',
+        text,
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

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

package/dist/cloudflare-tunnel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Start Cloudflare Quick Tunnel
+ * Returns the generated tunnel URL
+ */
+export declare function startTunnel(localPort?: number): Promise<string>;
+export declare function stopTunnel(): void;
+export declare function getTunnelUrl(): string | null;
+export declare function isTunnelRunning(): boolean;
+//# sourceMappingURL=cloudflare-tunnel.d.ts.map

package/dist/cloudflare-tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-tunnel.d.ts","sourceRoot":"","sources":["../src/cloudflare-tunnel.ts"],"names":[],"mappings":"AAmFA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAcrE;AAqFD,wBAAgB,UAAU,IAAI,IAAI,CAMjC;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/cloudflare-tunnel.js

@@ -0,0 +1,218 @@
+"use strict";
+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 });
+exports.startTunnel = startTunnel;
+exports.stopTunnel = stopTunnel;
+exports.getTunnelUrl = getTunnelUrl;
+exports.isTunnelRunning = isTunnelRunning;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+let tunnelProcess = null;
+let tunnelUrl = null;
+/**
+ * Get platform-specific installation instructions for cloudflared
+ */
+function getInstallationInstructions() {
+    const platform = os.platform();
+    switch (platform) {
+        case 'darwin': // macOS
+            return `cloudflared is required for LeverageAI Agent to work. Please install it using Homebrew:
+
+    brew install cloudflared
+
+Alternatively, you can download it from: https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/`;
+        case 'linux':
+            // Detect Linux distribution
+            const fs = require('fs');
+            let distroInstructions = '';
+            try {
+                // Check for common package managers
+                if (fs.existsSync('/usr/bin/apt') || fs.existsSync('/usr/bin/apt-get')) {
+                    // Debian/Ubuntu
+                    distroInstructions = `    # Add Cloudflare GPG key
+    sudo mkdir -p --mode=0755 /usr/share/keyrings
+    curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
+
+    # Add Cloudflare repository
+    echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main' | sudo tee /etc/apt/sources.list.d/cloudflared.list
+
+    # Install cloudflared
+    sudo apt-get update && sudo apt-get install cloudflared`;
+                }
+                else if (fs.existsSync('/usr/bin/yum')) {
+                    // CentOS/RHEL
+                    distroInstructions = `    # Add Cloudflare repository
+    curl -fsSl https://pkg.cloudflare.com/cloudflared.repo | sudo tee /etc/yum.repos.d/cloudflared.repo
+
+    # Install cloudflared
+    sudo yum update && sudo yum install cloudflared`;
+                }
+                else if (fs.existsSync('/usr/bin/dnf')) {
+                    // Fedora
+                    distroInstructions = `    # Add Cloudflare repository
+    sudo dnf config-manager --add-repo https://pkg.cloudflare.com/cloudflared.repo
+
+    # Install cloudflared
+    sudo dnf install cloudflared`;
+                }
+                else if (fs.existsSync('/usr/bin/pacman')) {
+                    // Arch Linux
+                    distroInstructions = `    # Install from community repository
+    sudo pacman -S cloudflared`;
+                }
+                else {
+                    // Generic Linux
+                    distroInstructions = `    # Download and install manually
+    curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared
+    chmod +x cloudflared
+    sudo mv cloudflared /usr/local/bin/`;
+                }
+            }
+            catch (error) {
+                // Fallback to generic instructions
+                distroInstructions = `    # Download and install manually
+    curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared
+    chmod +x cloudflared
+    sudo mv cloudflared /usr/local/bin/`;
+            }
+            return `cloudflared is required for LeverageAI Agent to work. Please install it:
+
+${distroInstructions}
+
+For other distributions, see: https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/`;
+        default:
+            return `cloudflared is required for LeverageAI Agent to work. Please install it from:
+https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/`;
+    }
+}
+/**
+ * Start Cloudflare Quick Tunnel
+ * Returns the generated tunnel URL
+ */
+function startTunnel(localPort = 4020) {
+    return new Promise((resolve, reject) => {
+        // Check if cloudflared is installed
+        const which = (0, child_process_1.spawn)('which', ['cloudflared']);
+        which.on('close', (code) => {
+            if (code !== 0) {
+                reject(new Error(getInstallationInstructions()));
+                return;
+            }
+            startTunnelProcess(localPort, resolve, reject);
+        });
+    });
+}
+function startTunnelProcess(localPort, resolve, reject) {
+    // Create environment without proxy settings for cloudflared
+    const env = { ...process.env };
+    delete env.HTTP_PROXY;
+    delete env.HTTPS_PROXY;
+    delete env.http_proxy;
+    delete env.https_proxy;
+    delete env.ALL_PROXY;
+    delete env.all_proxy;
+    // Ensure localhost bypasses proxy
+    env.NO_PROXY = 'localhost,127.0.0.1,*.local';
+    env.no_proxy = env.NO_PROXY;
+    // Use --url for quick tunnel (no account needed)
+    // Bypass proxy to avoid TLS handshake issues
+    tunnelProcess = (0, child_process_1.spawn)('cloudflared', ['tunnel', '--url', `http://localhost:${localPort}`], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: env,
+    });
+    let urlFound = false;
+    const timeout = setTimeout(() => {
+        if (!urlFound) {
+            reject(new Error('Timeout waiting for tunnel URL'));
+            stopTunnel();
+        }
+    }, 30000); // 30 second timeout
+    // cloudflared outputs the URL to stderr
+    tunnelProcess.stderr?.on('data', (data) => {
+        const output = data.toString();
+        // Debug output
+        if (process.env.DEBUG) {
+        }
+        // Look for the tunnel URL in the output
+        // Format: "https://xxx-yyy-zzz.trycloudflare.com"
+        const urlMatch = output.match(/https:\/\/[a-z0-9-]+\.trycloudflare\.com/);
+        if (urlMatch && !urlFound) {
+            urlFound = true;
+            clearTimeout(timeout);
+            tunnelUrl = urlMatch[0];
+            resolve(tunnelUrl);
+        }
+    });
+    tunnelProcess.stdout?.on('data', (data) => {
+        const output = data.toString();
+        if (process.env.DEBUG) {
+        }
+        // Also check stdout for URL
+        const urlMatch = output.match(/https:\/\/[a-z0-9-]+\.trycloudflare\.com/);
+        if (urlMatch && !urlFound) {
+            urlFound = true;
+            clearTimeout(timeout);
+            tunnelUrl = urlMatch[0];
+            resolve(tunnelUrl);
+        }
+    });
+    tunnelProcess.on('error', (err) => {
+        clearTimeout(timeout);
+        console.error('  [Tunnel] Failed to start:', err);
+        reject(err);
+    });
+    tunnelProcess.on('close', (code) => {
+        if (!urlFound) {
+            clearTimeout(timeout);
+            reject(new Error(`cloudflared exited with code ${code}`));
+        }
+        tunnelProcess = null;
+        tunnelUrl = null;
+    });
+}
+function stopTunnel() {
+    if (tunnelProcess) {
+        tunnelProcess.kill('SIGTERM');
+        tunnelProcess = null;
+        tunnelUrl = null;
+    }
+}
+function getTunnelUrl() {
+    return tunnelUrl;
+}
+function isTunnelRunning() {
+    return tunnelProcess !== null && !tunnelProcess.killed;
+}
+//# sourceMappingURL=cloudflare-tunnel.js.map

package/dist/cloudflare-tunnel.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface Config {
+    serverUrl: string;
+    machineId: string;
+}
+export declare function getConfig(): Config;
+export declare function setConfig(updates: Partial<Config>): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,MAAM;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAgBD,wBAAgB,SAAS,IAAI,MAAM,CAalC;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAexD"}