4runr-os 2.1.21 → 2.1.23

package/README.md

@@ -1,150 +1,65 @@
-# 4Runr OS - AI Agent Operating System
+# 4Runr OS
 
-Interactive terminal for managing AI agents on the 4Runr platform.
+Modern Terminal Interface for the 4Runr AI Agent OS.
 
-## Installation
+## Quick Start
 
-Install globally from npm:
+### One-Time Setup
 
 ```bash
 npm install -g 4runr-os
 ```
 
-## Quick Start
-
-After installation, simply run:
+### Daily Use
 
 ```bash
 4r
 ```
 
-That's it! The OS connects to the official 4Runr server automatically.
+**That's it!** No other setup needed.
 
-## Available Commands
+---
 
-You can use any of these commands:
-- `4r` - Short and simple (recommended)
-- `4runr` - Full command
-- `4runr-os` - Full package name
+## Features
 
-All commands do the same thing - launch the 4Runr OS terminal.
+- 🚀 **Modern TUI** - Beautiful Rust-based terminal interface
+- 🔄 **Auto-Updates** - Automatically updates when new versions are available
+- 🎯 **Zero Config** - Works out of the box
+- 🪶 **Lightweight** - Fast and efficient
 
-### Connect to Local Server (Development)
+## Commands
 
-If you're running a local gateway, set the `GATEWAY_URL` environment variable:
+- `4r` - Launch the 4Runr OS terminal interface
+- `4runr` - Alias for `4r`
+- `4runr-os` - Alias for `4r`
 
-**Windows (PowerShell):**
-```powershell
-$env:GATEWAY_URL="http://localhost:3001"
-4runr
-```
+## Auto-Update
 
-**Windows (CMD):**
-```cmd
-set GATEWAY_URL=http://localhost:3001
-4runr
-```
+The `4r` command automatically checks for updates and installs them if available. You can control this behavior:
 
-**Linux/Mac:**
 ```bash
-export GATEWAY_URL=http://localhost:3001
-4runr
-```
+# Disable auto-update (still checks)
+NO_AUTO_UPDATE=1 4r
 
-### Connect to Custom Server
+# Disable update check entirely
+NO_UPDATE_CHECK=1 4r
 
-To use a different server, set `GATEWAY_URL`:
-```bash
-export GATEWAY_URL=http://your-server.com:3001
-4runr
+# Or use the config command inside the OS
+4r
+# Then: config auto-update disable
 ```
 
-### Quick Start
-
-1. **Configure AI Provider:**
-   ```
-   4runr> config
-   ```
-   Follow the prompts to add your OpenAI or Anthropic API key.
-
-2. **Start Chatting:**
-   ```
-   4runr> run-agent assistant
-   ```
-   Then just type your messages!
-
-3. **Build Custom Agent:**
-   ```
-   4runr> build
-   ```
-   Create your own AI agent with custom system prompts.
-
-## Available Commands
-
-### AI Configuration
-- `config` - Configure AI provider (OpenAI/Anthropic)
-- `models` - List available AI models
-- `ai-status` - Show stored API keys and configuration
-
-### Agent Management
-- `run-agent [name]` - Start chatting with an AI agent
-- `build` - Build a custom AI agent (interactive)
-- `agents` - List available agents
-
-### Run Management
-- `create <name>` - Create a new run
-- `start <run-id>` - Start a run
-- `get <run-id>` - Get run details
-- `list` - List all runs
-
-### System
-- `status` - Show system status
-- `sentinel` - Show Sentinel monitoring
-- `metrics` - Show system metrics
-- `clear` - Clear the screen
-- `help` - Show all commands
-- `exit` - Exit the OS
-
-## Examples
-
-### Connect to Server and Configure
-
-```bash
-# Set server URL
-export GATEWAY_URL=http://44.222.212.152:3001
-
-# Run OS
-4runr
-
-# Configure OpenAI
-4runr> config
-# Follow prompts...
+## Requirements
 
-# Start chatting
-4runr> run-agent assistant
-Assistant> Hello! How can I help you?
-```
+- **Node.js** 18.0.0 or higher
+- **npm** (comes with Node.js)
 
-### Build Custom Agent
+**No Rust or build tools needed!** Pre-built binaries are included for Windows, Linux, and macOS.
 
-```
-4runr> build
-Agent name: code-reviewer
-Agent description: Reviews code for bugs and improvements
-System prompt: You are an expert code reviewer...
-END
-Temperature: 0.3
-Max tokens: 2000
-
-4runr> run-agent code-reviewer
-```
+## Troubleshooting
 
-## Requirements
-
-- Node.js 18+ 
-- Access to a 4Runr Gateway (local or remote)
+See [SETUP.md](./SETUP.md) for detailed setup instructions and troubleshooting.
 
 ## License
 
 MIT
-

package/SETUP.md

@@ -0,0 +1,86 @@
+# 4Runr OS - Quick Setup Guide
+
+## One-Time Setup (Choose Your Platform)
+
+### Windows
+
+```powershell
+# Install 4runr-os
+npm install -g 4runr-os
+
+# Done! Now just use:
+4r
+```
+
+**That's it!** The package includes pre-built Windows binaries, so no Rust or build tools needed.
+
+---
+
+### Linux / macOS
+
+```bash
+# Install 4runr-os
+npm install -g 4runr-os
+
+# Done! Now just use:
+4r
+```
+
+**That's it!** The package includes pre-built binaries for Linux and macOS.
+
+---
+
+## After Setup
+
+Once installed, just run:
+
+```bash
+4r
+```
+
+That's all you need! The `4r` command will:
+- ✅ Launch the 4Runr OS terminal interface
+- ✅ Auto-update when new versions are available
+- ✅ Work immediately (no additional setup needed)
+
+---
+
+## Troubleshooting
+
+### "4r: command not found"
+
+Make sure npm global bin is in your PATH:
+
+**Windows:**
+```powershell
+# Add to PATH (add to your PowerShell profile)
+$env:Path += ";$env:APPDATA\npm"
+```
+
+**Linux/macOS:**
+```bash
+# Add to PATH (add to ~/.bashrc or ~/.zshrc)
+export PATH=$PATH:$(npm config get prefix)/bin
+```
+
+### "mk3-tui binary not found"
+
+If you see this error, the package will automatically try to build from source:
+
+**Windows:**
+- Install Visual Studio Build Tools: https://visualstudio.microsoft.com/downloads/
+- Or use GNU toolchain: `rustup toolchain install stable-x86_64-pc-windows-gnu && rustup default stable-x86_64-pc-windows-gnu`
+
+**Linux/macOS:**
+- Install Rust: `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`
+- Then run `4r` again - it will build automatically
+
+---
+
+## That's It!
+
+- **One-time setup**: `npm install -g 4runr-os`
+- **Daily use**: `4r`
+
+No other commands needed! 🚀
+

package/dist/index.js

@@ -2519,19 +2519,24 @@ else {
         const __dirname = dirname(__filename);
         // Try to find mk3-tui binary in multiple locations
         const binaryName = process.platform === 'win32' ? 'mk3-tui.exe' : 'mk3-tui';
+        const platform = process.platform;
+        const arch = process.arch;
+        const platformKey = `${platform}-${arch}`;
         const possiblePaths = [
-            // From npm package 4runr-os-mk3 (global install) - binary is in PATH as 'mk3-tui'
-            binaryName,
-            // From npm package 4runr-os-mk3 (local node_modules via dependency)
-            path.join(__dirname, '..', 'node_modules', '4runr-os-mk3', 'target', 'release', binaryName),
+            // Pre-built binaries included in npm package (EASIEST - no build needed!)
+            path.join(__dirname, '..', 'mk3-tui', 'binaries', platformKey, binaryName),
+            path.join(__dirname, '..', 'mk3-tui', 'binaries', platform, binaryName), // Fallback to platform only
+            // Built from source in package (postinstall)
+            path.join(__dirname, '..', 'mk3-tui', 'target', 'release', binaryName),
             // From local build in monorepo (development)
             path.join(__dirname, '..', '..', '..', 'apps', 'mk3-tui', 'target', 'release', binaryName),
-            // From npm package 4runr-os-mk3 (local node_modules at root)
-            path.join(__dirname, '..', '..', '..', 'node_modules', '4runr-os-mk3', 'target', 'release', binaryName),
+            // Fallback: try PATH (for backwards compatibility)
+            binaryName,
         ];
         let binaryPath = null;
         for (const testPath of possiblePaths) {
-            if (testPath.includes('node_modules') || testPath.includes('apps')) {
+            // Check if it's an absolute path (contains path separators)
+            if (testPath.includes(path.sep) || testPath.includes('/') || testPath.includes('\\')) {
                 // Absolute path - check if exists
                 if (fs.existsSync(testPath)) {
                     binaryPath = testPath;
@@ -2542,7 +2547,8 @@ else {
                 // Try to find in PATH
                 try {
                     const { execSync } = await import('child_process');
-                    execSync(`which ${testPath}`, { stdio: 'ignore' });
+                    const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+                    execSync(`${whichCmd} ${testPath}`, { stdio: 'ignore' });
                     binaryPath = testPath;
                     break;
                 }
@@ -2555,135 +2561,108 @@ else {
             const platform = process.platform;
             const isWindows = platform === 'win32';
             process.stderr.write('\n[ERROR] mk3-tui binary not found.\n');
-            if (isWindows) {
-                process.stderr.write('\n⚠️  Windows binary not yet available in npm package.\n');
-                process.stderr.write('   The current package only includes Linux binaries.\n\n');
-                // Check if Rust is installed
-                const { checkAndInstallRust } = await import('./rust-check.js');
-                const autoInstallRust = process.env.AUTO_INSTALL_RUST === '1';
-                const rustInstalled = await checkAndInstallRust(autoInstallRust);
-                if (rustInstalled) {
-                    process.stderr.write('\n✅ Rust is installed! Building mk3-tui from npm package...\n\n');
-                    // Try to build from npm package
-                    try {
-                        const { execSync } = await import('child_process');
-                        const npmPackagePath = path.join(__dirname, '..', 'node_modules', '4runr-os-mk3');
-                        if (fs.existsSync(npmPackagePath)) {
-                            process.stderr.write('🔨 Building from npm package...\n');
-                            execSync('cargo build --release', {
-                                cwd: npmPackagePath,
-                                stdio: 'inherit',
+            // Check if Rust is installed and try to build
+            const { checkAndInstallRust, getRustInstallCommand } = await import('./rust-check.js');
+            const autoInstallRust = process.env.AUTO_INSTALL_RUST === '1';
+            const rustInstalled = await checkAndInstallRust(autoInstallRust);
+            if (rustInstalled) {
+                process.stderr.write('\n✅ Rust is installed! Building mk3-tui from 4runr-os package...\n\n');
+                // Try to build from 4runr-os package (mk3-tui is included)
+                try {
+                    const { execSync } = await import('child_process');
+                    const mk3Path = path.join(__dirname, '..', 'mk3-tui');
+                    if (fs.existsSync(mk3Path)) {
+                        process.stderr.write('🔨 Building from 4runr-os package...\n');
+                        try {
+                            // Use spawn to show output AND capture errors
+                            const { spawn } = await import('child_process');
+                            const cargoProcess = spawn('cargo', ['build', '--release'], {
+                                cwd: mk3Path,
+                                stdio: ['ignore', 'inherit', 'pipe'], // stdin: ignore, stdout: inherit (show), stderr: pipe (capture)
+                            });
+                            let stderrOutput = '';
+                            cargoProcess.stderr.on('data', (data) => {
+                                const text = data.toString();
+                                stderrOutput += text;
+                                // Also show errors to user
+                                process.stderr.write(text);
+                            });
+                            await new Promise((resolve, reject) => {
+                                cargoProcess.on('close', (code) => {
+                                    if (code !== 0) {
+                                        reject({ code, stderrOutput, message: `cargo build failed with code ${code}` });
+                                    }
+                                    else {
+                                        resolve();
+                                    }
+                                });
+                                cargoProcess.on('error', (err) => {
+                                    reject({ ...err, stderrOutput });
+                                });
                             });
-                            // Retry finding binary
-                            const builtBinary = path.join(npmPackagePath, 'target', 'release', binaryName);
-                            if (fs.existsSync(builtBinary)) {
-                                binaryPath = builtBinary;
-                                process.stderr.write('\n✅ Build successful! Launching...\n\n');
-                            }
-                            else {
-                                process.stderr.write('\n⚠️  Build completed but binary not found at expected location.\n');
-                                process.stderr.write('   Please try running "4r" again.\n\n');
-                                process.exit(1);
-                            }
                         }
-                        else {
-                            process.stderr.write('\n⚠️  4runr-os-mk3 package not found in node_modules.\n');
-                            process.stderr.write('   Installing...\n\n');
-                            execSync('npm install -g 4runr-os-mk3', { stdio: 'inherit' });
-                            // The postinstall script should have built it, try to find it
-                            const globalPath = process.platform === 'win32'
-                                ? path.join(process.env.APPDATA || '', 'npm', 'node_modules', '4runr-os-mk3', 'target', 'release', binaryName)
-                                : path.join('/usr/local/lib/node_modules', '4runr-os-mk3', 'target', 'release', binaryName);
-                            if (fs.existsSync(globalPath)) {
-                                binaryPath = globalPath;
-                            }
-                            else {
-                                // Try PATH
-                                try {
-                                    const whichCmd = platform === 'win32' ? 'where' : 'which';
-                                    execSync(`${whichCmd} ${binaryName}`, { stdio: 'ignore' });
-                                    binaryPath = binaryName;
-                                }
-                                catch {
-                                    process.stderr.write('\n⚠️  Please restart your terminal and run "4r" again.\n\n');
-                                    process.exit(1);
-                                }
-                            }
+                        catch (buildExecError) {
+                            // Attach captured stderr to error
+                            throw { ...buildExecError, buildOutput: buildExecError.stderrOutput || '' };
                         }
-                    }
-                    catch (buildError) {
-                        process.stderr.write('\n⚠️  Build failed. You can build manually:\n');
-                        process.stderr.write('   cd %APPDATA%\\npm\\node_modules\\4runr-os-mk3\n');
-                        process.stderr.write('   cargo build --release\n');
-                        process.stderr.write('   Then run: 4r\n\n');
-                        process.exit(1);
-                    }
-                }
-                else {
-                    process.stderr.write('   To use 4runr-os on Windows, you have two options:\n\n');
-                    process.stderr.write('   Option 1: Install Rust and build locally\n');
-                    process.stderr.write('   1. Install Rust (see instructions above)\n');
-                    process.stderr.write('   2. Build: cd %USERPROFILE% && git clone https://github.com/KyanBergeron4Runr/4Runr-AI-Agent-OS.git\n');
-                    process.stderr.write('   3. Build: cd 4Runr-AI-Agent-OS\\apps\\mk3-tui && cargo build --release\n');
-                    process.stderr.write('   4. Add to PATH or run: .\\target\\release\\mk3-tui.exe\n\n');
-                    process.stderr.write('   Option 2: Use WSL (Windows Subsystem for Linux)\n');
-                    process.stderr.write('   1. Install WSL: wsl --install\n');
-                    process.stderr.write('   2. In WSL: npm install -g 4runr-os\n');
-                    process.stderr.write('   3. Run: 4r\n\n');
-                    process.stderr.write('   Windows binary support coming soon!\n\n');
-                }
-            }
-            else {
-                process.stderr.write('The 4runr-os package requires 4runr-os-mk3.\n');
-                process.stderr.write('Installing automatically...\n\n');
-                try {
-                    // Try to install 4runr-os-mk3 automatically
-                    const { execSync } = await import('child_process');
-                    execSync('npm install -g 4runr-os-mk3', { stdio: 'inherit' });
-                    // Retry finding binary after install
-                    const retryPaths = [
-                        binaryName,
-                        path.join(__dirname, '..', 'node_modules', '4runr-os-mk3', 'target', 'release', binaryName),
-                    ];
-                    for (const testPath of retryPaths) {
-                        if (testPath === binaryName) {
-                            try {
-                                const whichCmd = platform === 'win32' ? 'where' : 'which';
-                                execSync(`${whichCmd} ${testPath}`, { stdio: 'ignore' });
-                                binaryPath = testPath;
-                                break;
-                            }
-                            catch {
-                                continue;
-                            }
+                        // Retry finding binary
+                        const builtBinary = path.join(mk3Path, 'target', 'release', binaryName);
+                        if (fs.existsSync(builtBinary)) {
+                            binaryPath = builtBinary;
+                            process.stderr.write('\n✅ Build successful! Launching...\n\n');
                         }
-                        else if (fs.existsSync(testPath)) {
-                            binaryPath = testPath;
-                            break;
+                        else {
+                            process.stderr.write('\n⚠️  Build completed but binary not found at expected location.\n');
+                            process.stderr.write('   Please try running "4r" again.\n\n');
+                            process.exit(1);
                         }
                     }
-                    if (!binaryPath) {
-                        process.stderr.write('\n[ERROR] Installation completed but binary still not found.\n');
-                        process.stderr.write('Please run: npm install -g 4runr-os-mk3\n');
-                        process.stderr.write('Then try again: 4r\n\n');
+                    else {
+                        process.stderr.write('\n⚠️  mk3-tui source not found in 4runr-os package.\n');
+                        process.stderr.write('   Please reinstall: npm install -g 4runr-os@latest\n\n');
                         process.exit(1);
                     }
                 }
-                catch (installError) {
-                    process.stderr.write('\n[ERROR] Auto-install failed. Please install manually:\n');
-                    process.stderr.write('  npm install -g 4runr-os-mk3\n');
-                    process.stderr.write('Then run: 4r\n\n');
-                    // Check if Rust might help (for building from source)
-                    const { isRustInstalled, getRustInstallCommand } = await import('./rust-check.js');
-                    if (!isRustInstalled()) {
-                        process.stderr.write('\n💡 Alternative: Build from source (requires Rust):\n');
+                catch (buildError) {
+                    const errorMsg = buildError?.message || String(buildError) || '';
+                    const errorOutput = buildError?.buildOutput || buildError?.stdout?.toString() || buildError?.stderr?.toString() || '';
+                    const fullError = (errorMsg + ' ' + errorOutput).toLowerCase();
+                    if (isWindows && (fullError.includes('link.exe') || fullError.includes('linker') || fullError.includes('msvc'))) {
+                        // Windows MSVC linker missing
+                        process.stderr.write('\n⚠️  Build failed: MSVC linker not found.\n');
+                        process.stderr.write('   Rust is installed, but Windows needs Visual Studio Build Tools.\n\n');
+                        process.stderr.write('   Option 1: Install Visual Studio Build Tools (Recommended)\n');
+                        process.stderr.write('   1. Download: https://visualstudio.microsoft.com/downloads/\n');
+                        process.stderr.write('   2. Install "Build Tools for Visual Studio"\n');
+                        process.stderr.write('   3. Select "Desktop development with C++" workload\n');
+                        process.stderr.write('   4. Restart terminal and run "4r" again\n\n');
+                        process.stderr.write('   Option 2: Use GNU toolchain (Alternative)\n');
+                        process.stderr.write('   1. Run: rustup toolchain install stable-x86_64-pc-windows-gnu\n');
+                        process.stderr.write('   2. Run: rustup default stable-x86_64-pc-windows-gnu\n');
+                        process.stderr.write('   3. Run "4r" again\n\n');
+                        process.stderr.write('   Option 3: Use WSL (Windows Subsystem for Linux)\n');
+                        process.stderr.write('   1. Install WSL: wsl --install\n');
+                        process.stderr.write('   2. In WSL: npm install -g 4runr-os\n');
+                        process.stderr.write('   3. In WSL: 4r\n\n');
+                    }
+                    else {
+                        // Generic build error
+                        process.stderr.write('\n⚠️  Build failed. Please ensure Rust is properly installed.\n');
                         process.stderr.write(`   Install Rust: ${getRustInstallCommand()}\n`);
-                        process.stderr.write('   Then build: git clone https://github.com/KyanBergeron4Runr/4Runr-AI-Agent-OS.git\n');
-                        process.stderr.write('   cd 4Runr-AI-Agent-OS/apps/mk3-tui && cargo build --release\n\n');
+                        process.stderr.write('   Then run "4r" again.\n\n');
+                        if (fullError) {
+                            process.stderr.write('   Error details:\n');
+                            process.stderr.write(`   ${fullError.substring(0, 500)}\n\n`);
+                        }
                     }
                     process.exit(1);
                 }
             }
+            else {
+                process.stderr.write('\n💡 To build mk3-tui, you need Rust installed.\n');
+                process.stderr.write(`   Install Rust: ${getRustInstallCommand()}\n`);
+                process.stderr.write('   Then run "4r" again - it will build automatically.\n\n');
+            }
             if (!binaryPath) {
                 process.exit(1);
             }