4runr-os 2.1.52 → 2.1.54

package/README.md

@@ -6,7 +6,7 @@
 ![License](https://img.shields.io/npm/l/4runr-os?style=for-the-badge)
 ![Node](https://img.shields.io/node/v/4runr-os?style=for-the-badge)
 
-**Production-ready terminal interface for managing AI agents with real-time monitoring, safety controls, and enterprise features.**
+**Complete operating system for AI agents - includes terminal interface (TUI), gateway component for AI agent credentials, underlying orchestration structure, and connections to external tools.**
 
 [Installation](#-installation) • [Features](#-features) • [Documentation](#-documentation) • [Support](#-support)
 
@@ -18,13 +18,13 @@
 
 ### Boot Screen
 
-![4Runr OS Boot Screen](./images/screenshot-boot.png)
+![4Runr OS Boot Screen](https://raw.githubusercontent.com/KyanBergeron4Runr/4Runr-AI-Agent-OS/master/packages/os-cli/images/screenshot-boot.png)
 
 *Initialization screen showing system startup and readiness status.*
 
 ### Main Interface
 
-![4Runr OS Terminal Interface](./images/screenshot.png)
+![4Runr OS Terminal Interface](https://raw.githubusercontent.com/KyanBergeron4Runr/4Runr-AI-Agent-OS/master/packages/os-cli/images/screenshot.png)
 
 *Full terminal interface showing system status, operations log, resources, and capabilities.*
 
@@ -50,8 +50,10 @@ npm install -g 4runr-os
 
 ## ✨ Features
 
-### 🎨 Modern Terminal Interface
-- **Rust + Ratatui** - High-performance, native terminal UI
+### 🎨 Complete Operating System
+- **Terminal Interface (TUI)** - Rust + Ratatui high-performance native terminal UI
+- **Gateway Component** - Built-in component for AI agent credentials and authentication
+- **Orchestration Layer** - Node.js backend managing system operations and structure
 - **Real-time Updates** - Live monitoring of agent runs, system resources, and network status
 - **Beautiful Design** - Clean, professional interface with 4Runr brand colors
 - **Cross-platform** - Works on Windows, macOS, and Linux
@@ -65,7 +67,8 @@ npm install -g 4runr-os
 ### 📊 Real-time Monitoring
 - **System Status** - CPU, memory, network monitoring
 - **Agent Operations** - Live log streaming and status updates
-- **Gateway Health** - Connection status and metrics
+- **Gateway Component Health** - Internal gateway component status and metrics
+- **External Gateway Connections** - Status of connections to external tools and services
 - **Resource Tracking** - Active runs, connections, and capabilities
 
 ### 🔄 Auto-Update System
@@ -152,26 +155,43 @@ Settings are saved in `~/.4runr/config.json` and persist across sessions.
 
 ## 🏗️ Architecture
 
-4Runr OS is built with:
+4Runr OS is a complete operating system that includes:
 
-- **Frontend**: Rust + Ratatui for the terminal interface
-- **Backend**: Node.js for orchestration and gateway communication
-- **Communication**: HTTP/SSE for real-time updates
-- **Safety**: Built-in Shield and Sentinel systems
+- **Terminal Interface (TUI)**: Rust + Ratatui frontend - the user interface
+- **Gateway Component**: Handles AI agent credentials and authentication (part of the OS)
+- **Orchestration Layer**: Node.js backend managing system operations
+- **External Gateway Connections**: Links to external tools and services (not local)
+- **Underlying Structure**: Core OS components for monitoring, safety, and resource management
+- **Communication**: HTTP/SSE for real-time updates between components
+- **Safety Systems**: Built-in Shield and Sentinel systems
 
 ```
-┌─────────────────┐
-│   4Runr OS      │  ← Terminal Interface (Rust + Ratatui)
-│   (TUI)         │
-└────────┬────────┘
-         │ HTTP/SSE
-         ▼
-┌─────────────────┐
-│   4Runr Gateway │  ← API Gateway (Node.js)
-│   (Backend)     │
-└─────────────────┘
+┌─────────────────────────────────────┐
+│         4Runr OS                    │
+│  ┌───────────────────────────────┐  │
+│  │  Terminal Interface (TUI)     │  │  ← User Interface (Rust + Ratatui)
+│  │  (Rust + Ratatui)             │  │
+│  └───────────┬───────────────────┘  │
+│              │                       │
+│  ┌───────────▼───────────────────┐  │
+│  │  Orchestration Layer          │  │  ← System Management (Node.js)
+│  │  (Node.js)                    │  │
+│  └───────────┬───────────────────┘  │
+│              │                       │
+│  ┌───────────▼───────────────────┐  │
+│  │  Gateway Component            │  │  ← AI Agent Credentials (OS Component)
+│  │  (AI Agent Auth)              │  │
+│  └───────────┬───────────────────┘  │
+│              │                       │
+│  ┌───────────▼───────────────────┐  │
+│  │  External Gateway Connections │  │  ← External Tools & Services
+│  │  (Non-local)                  │  │
+│  └───────────────────────────────┘  │
+└─────────────────────────────────────┘
 ```
 
+**Key Point**: The gateway is a **component** of the OS (for AI agent credentials), separate from the gateway **connections** to external tools. The OS includes the TUI, gateway component, orchestration, and underlying structure - not just the interface.
+
 ---
 
 ## 📚 Documentation

package/dist/index.js

@@ -2156,18 +2156,18 @@ const commands = {
                         // Use as string if not valid JSON
                     }
                     // Wrap tool code in async function
-                    const wrappedCode = `
-            (async () => {
-              ${tool.code}
-              // Tool should export a function or be a function
-              if (typeof tool === 'function') {
-                return await tool(${JSON.stringify(parsedInput)});
-              } else if (typeof execute === 'function') {
-                return await execute(${JSON.stringify(parsedInput)});
-              } else {
-                throw new Error('Tool must export a function named "tool" or "execute"');
-              }
-            })()
+                    const wrappedCode = `
+            (async () => {
+              ${tool.code}
+              // Tool should export a function or be a function
+              if (typeof tool === 'function') {
+                return await tool(${JSON.stringify(parsedInput)});
+              } else if (typeof execute === 'function') {
+                return await execute(${JSON.stringify(parsedInput)});
+              } else {
+                throw new Error('Tool must export a function named "tool" or "execute"');
+              }
+            })()
           `;
                     const result = await vm.default.runInNewContext(wrappedCode, context, { timeout: 5000 });
                     console.log(`\n${green}✓${reset} Tool executed successfully:`);