langmart-gateway-type3 3.0.0 → 3.0.2

package/README.md

@@ -1,5 +1,7 @@
 # Gateway Type 3 - Seller-Managed Gateway
 
+[![npm version](https://badge.fury.io/js/langmart-gateway-type3.svg)](https://www.npmjs.com/package/langmart-gateway-type3)
+
 ## Overview
 Type 3 Gateway is a seller-managed gateway client that runs on the seller's infrastructure. It connects to the marketplace via WebSocket and uses the seller's own API keys to fulfill requests.
 
@@ -18,42 +20,200 @@ Type 3 Gateway is a seller-managed gateway client that runs on the seller's infr
 - **Interactive CLI UI** with chat interface and model management
 - **Intelligent Image Generation** with keyword-based auto-detection
 - **Terminal Image Preview** for generated images
+- **DevOps Mode**: Full session management with bash, SSH, and system tools
+
+---
+
+## 🚀 Quick Install (Recommended)
+
+Install the gateway on any server with a single command:
+
+```bash
+# Using unpkg CDN (recommended)
+curl -fsSL https://unpkg.com/langmart-gateway-type3/scripts/install.sh | bash -s -- \
+  --marketplace-url ws://your-marketplace:8081 \
+  --api-key YOUR_API_KEY \
+  --full \
+  --service
+```
+
+### Install Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--marketplace-url URL` | Marketplace WebSocket URL | `ws://localhost:8081` |
+| `--api-key KEY` | Gateway API key for authentication | (none) |
+| `--port PORT` | Gateway port | `8083` |
+| `--install-dir DIR` | Installation directory | `/opt/langmart-gateway` |
+| `--capabilities CAPS` | Capabilities: `session,llm` or `llm` | `llm` |
+| `--full` | Enable full capabilities (DevOps + LLM) | (disabled) |
+| `--service` | Install as systemd service | (disabled) |
+
+### Examples
+
+```bash
+# LLM routing only (default)
+curl -fsSL https://unpkg.com/langmart-gateway-type3/scripts/install.sh | bash -s -- \
+  --marketplace-url ws://10.0.1.117:8081 \
+  --api-key sk-test-inference-key
+
+# Full DevOps mode with systemd service
+curl -fsSL https://unpkg.com/langmart-gateway-type3/scripts/install.sh | bash -s -- \
+  --marketplace-url ws://10.0.1.117:8081 \
+  --api-key sk-test-inference-key \
+  --full \
+  --service
+
+# Custom port and directory
+curl -fsSL https://unpkg.com/langmart-gateway-type3/scripts/install.sh | bash -s -- \
+  --marketplace-url ws://10.0.1.117:8081 \
+  --api-key sk-test-inference-key \
+  --port 9000 \
+  --install-dir /home/user/gateway
+```
+
+### Alternative CDN
 
-## Installation
+```bash
+# Using jsdelivr
+curl -fsSL https://cdn.jsdelivr.net/npm/langmart-gateway-type3/scripts/install.sh | bash -s -- [OPTIONS]
+```
+
+---
+
+## 📦 Manual Installation
+
+### Option 1: npm install
 
 ```bash
+# Create installation directory
+mkdir -p /opt/langmart-gateway && cd /opt/langmart-gateway
+
+# Initialize and install
+npm init -y
+npm install langmart-gateway-type3
+
+# Create .env file
+cat > .env << EOF
+INSTANCE_ID=gw3-$(hostname)-$(date +%s | tail -c 5)
+GATEWAY_PORT=8083
+MARKETPLACE_URL=ws://your-marketplace:8081
+GATEWAY_API_KEY=your-api-key
+GATEWAY_CAPABILITIES=llm
+NODE_ENV=production
+EOF
+
+# Start the gateway
+node node_modules/langmart-gateway-type3/dist/index-server.js
+```
+
+### Option 2: Clone and Build
+
+```bash
+# Clone the repository
+git clone https://github.com/YiHuangDB/LangMartDesign.git
+cd LangMartDesign/gateway-type3
+
 # Install dependencies
 npm install
 
 # Build TypeScript
 npm run build
+
+# Configure
+cp .env.example .env
+# Edit .env with your settings
+
+# Start
+npm start
 ```
 
-## Configuration
+---
+
+## ⚙️ Configuration
+
+### Environment Variables
 
-Environment variables:
 ```bash
-GATEWAY3_ID=gw3-seller-001           # Gateway identifier
-GATEWAY3_API_KEY=sk-test-001         # Marketplace API key
-MARKETPLACE_URL=ws://localhost:8090   # Marketplace WebSocket URL
+# Gateway identification
+INSTANCE_ID=gw3-server-001           # Gateway identifier (auto-generated if not set)
+GATEWAY_PORT=8083                     # Gateway HTTP/WebSocket port
+
+# Marketplace connection
+MARKETPLACE_URL=ws://localhost:8081   # Marketplace WebSocket URL
+GATEWAY_API_KEY=sk-your-key          # Marketplace API key
+
+# Capabilities
+GATEWAY_CAPABILITIES=llm              # "llm" or "session,llm" for full DevOps
 
-# Provider API Keys (seller's own keys)
+# Local vault (for storing provider API keys)
+VAULT_PATH=.vault/credentials.enc     # Encrypted vault path
+VAULT_PASSWORD=random-secure-password # Vault encryption password
+
+# Provider API Keys (seller's own keys - stored in vault)
 OPENAI_API_KEY=sk-...                # OpenAI API key
 ANTHROPIC_API_KEY=sk-ant-...         # Anthropic API key
-GOOGLE_API_KEY=...                   # Google API key
-DEEPSEEK_API_KEY=sk-...             # DeepSeek API key
+GROQ_API_KEY=gsk_...                 # Groq API key
 ```
 
-## Running
+### Capability Modes
+
+| Mode | GATEWAY_CAPABILITIES | Description |
+|------|---------------------|-------------|
+| **LLM Only** | `llm` | Routes LLM requests to providers (default) |
+| **Full DevOps** | `session,llm` | LLM routing + bash, SSH, file ops, system tools |
+
+---
+
+## 🏃 Running
+
+### Manual Start
 
 ```bash
-# Development mode (with TypeScript)
-npm run dev
+cd /opt/langmart-gateway
 
-# Production mode (compiled JavaScript)
-npm start
+# If installed via npm
+./start.sh
+
+# Or directly
+node node_modules/langmart-gateway-type3/dist/index-server.js
 ```
 
+### Systemd Service
+
+If installed with `--service`:
+
+```bash
+# Start
+sudo systemctl start langmart-gateway
+
+# Stop
+sudo systemctl stop langmart-gateway
+
+# Status
+sudo systemctl status langmart-gateway
+
+# Logs
+sudo journalctl -u langmart-gateway -f
+```
+
+### Verify Installation
+
+```bash
+# Health check
+curl http://localhost:8083/health
+
+# Expected response:
+{
+  "status": "healthy",
+  "gatewayId": "gw3-server-12345",
+  "capabilities": ["session", "llm"],
+  "tools": 18
+}
+```
+
+---
+
 ## How It Works
 
 1. **Connection**: Gateway connects to marketplace via WebSocket

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langmart-gateway-type3",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "LangMart Type 3 Gateway - Seller-Managed Gateway with Local Vault",
   "main": "dist/index-server.js",
   "types": "dist/index-server.d.ts",
@@ -101,7 +101,7 @@
     "scripts/start.sh",
     "scripts/stop.sh",
     "scripts/status.sh",
-    "scripts/install-remote.sh",
+    "scripts/install.sh",
     ".env.example",
     "README.md"
   ],

package/scripts/{install-remote.sh → install.sh}

@@ -1,13 +1,23 @@
 #!/bin/bash
-# Remote Installation Script for LangMart Gateway Type 3
-# Usage: curl -fsSL https://raw.githubusercontent.com/YiHuangDB/LangMartDesign/main/gateway-type3/scripts/install-remote.sh | bash
-# Or: bash install-remote.sh [OPTIONS]
+# Installation Script for LangMart Gateway Type 3
+# Run this script ON the target server to install the gateway
+#
+# Usage (from npm/unpkg - recommended):
+#   curl -fsSL https://unpkg.com/langmart-gateway-type3/scripts/install.sh | bash -s -- [OPTIONS]
+#
+# Usage (from npm/jsdelivr):
+#   curl -fsSL https://cdn.jsdelivr.net/npm/langmart-gateway-type3/scripts/install.sh | bash -s -- [OPTIONS]
+#
+# Or download and run:
+#   bash install.sh [OPTIONS]
 #
 # Options:
 #   --marketplace-url URL    Marketplace WebSocket URL (default: ws://localhost:8081)
 #   --api-key KEY           Gateway API key for authentication
 #   --port PORT             Gateway port (default: 8083)
 #   --install-dir DIR       Installation directory (default: /opt/langmart-gateway)
+#   --capabilities CAPS     Gateway capabilities: session,llm or llm (default: llm)
+#   --full                  Enable full capabilities (DevOps + LLM routing)
 #   --service               Install as systemd service
 #   --help                  Show this help message
 
@@ -26,6 +36,7 @@ INSTALL_DIR="/opt/langmart-gateway"
 GATEWAY_PORT="8083"
 MARKETPLACE_URL="ws://localhost:8081"
 GATEWAY_API_KEY=""
+GATEWAY_CAPABILITIES=""
 INSTALL_SERVICE=false
 GITHUB_TOKEN=""
 
@@ -52,6 +63,14 @@ while [[ $# -gt 0 ]]; do
             INSTALL_SERVICE=true
             shift
             ;;
+        --capabilities)
+            GATEWAY_CAPABILITIES="$2"
+            shift 2
+            ;;
+        --full)
+            GATEWAY_CAPABILITIES="session,llm"
+            shift
+            ;;
         --github-token)
             GITHUB_TOKEN="$2"
             shift 2
@@ -67,11 +86,13 @@ while [[ $# -gt 0 ]]; do
             echo "  --port PORT             Gateway port (default: 8083)"
             echo "  --install-dir DIR       Installation directory (default: /opt/langmart-gateway)"
             echo "  --service               Install as systemd service"
+            echo "  --capabilities CAPS     Gateway capabilities: session,llm or llm (default: llm only)"
+            echo "  --full                  Enable full capabilities (session + llm) - DevOps mode"
             echo "  --github-token TOKEN    GitHub token for npm package access"
             echo "  --help                  Show this help message"
             echo ""
             echo "Example:"
-            echo "  $0 --marketplace-url ws://10.0.1.117:8081 --api-key sk-test-key --service"
+            echo "  $0 --marketplace-url ws://10.0.1.117:8081 --api-key sk-test-key --full --service"
             exit 0
             ;;
         *)
@@ -155,22 +176,17 @@ if [ ! -f package.json ]; then
 fi
 
 # Install the gateway package
-echo -e "${CYAN}[4/6] Installing @langmart/gateway-type3...${NC}"
-if [ -n "$GITHUB_TOKEN" ]; then
-    npm install @langmart/gateway-type3@latest
-else
-    # Direct clone fallback for development
-    echo -e "${YELLOW}Cloning from GitHub repository...${NC}"
-    git clone --depth 1 https://github.com/YiHuangDB/LangMartDesign.git /tmp/langmart-clone
-    cp -r /tmp/langmart-clone/gateway-type3/* .
-    rm -rf /tmp/langmart-clone
-    npm install --production
-    npm run build
-fi
+echo -e "${CYAN}[4/6] Installing langmart-gateway-type3...${NC}"
+# Install from npm (no token needed for public packages)
+npm install langmart-gateway-type3@latest
 echo -e "${GREEN}✓ Gateway package installed${NC}"
 
 # Create environment file
 echo -e "${CYAN}[5/6] Creating environment configuration...${NC}"
+
+# Generate vault password
+VAULT_PWD=$(openssl rand -base64 32)
+
 cat > .env << EOF
 # LangMart Gateway Type 3 Configuration
 # Generated by install-remote.sh on $(date)
@@ -185,9 +201,12 @@ MARKETPLACE_URL=${MARKETPLACE_URL}
 # Gateway authentication
 GATEWAY_API_KEY=${GATEWAY_API_KEY}
 
+# Gateway capabilities (session,llm = full DevOps mode, llm = LLM routing only)
+GATEWAY_CAPABILITIES=${GATEWAY_CAPABILITIES:-llm}
+
 # Local vault configuration
 VAULT_PATH=.vault/credentials.enc
-VAULT_PASSWORD=$(openssl rand -base64 32)
+VAULT_PASSWORD=${VAULT_PWD}
 
 # Environment
 NODE_ENV=production
@@ -199,11 +218,17 @@ echo -e "${GREEN}✓ Environment file created${NC}"
 cat > start.sh << 'STARTEOF'
 #!/bin/bash
 cd "$(dirname "$0")"
-source .env 2>/dev/null || true
 
-if [ -d node_modules/@langmart/gateway-type3 ]; then
+# Export all variables from .env file
+if [ -f .env ]; then
+    set -a
+    source .env
+    set +a
+fi
+
+if [ -d node_modules/langmart-gateway-type3 ]; then
     # Installed via npm
-    node node_modules/@langmart/gateway-type3/dist/index-server.js
+    node node_modules/langmart-gateway-type3/dist/index-server.js
 else
     # Direct installation
     node dist/index-server.js
@@ -265,6 +290,11 @@ echo ""
 echo -e "${CYAN}Installation Directory: ${INSTALL_DIR}${NC}"
 echo -e "${CYAN}Gateway Port: ${GATEWAY_PORT}${NC}"
 echo -e "${CYAN}Marketplace URL: ${MARKETPLACE_URL}${NC}"
+if [ -n "$GATEWAY_CAPABILITIES" ] && [ "$GATEWAY_CAPABILITIES" = "session,llm" ]; then
+    echo -e "${CYAN}Mode: Full (DevOps + LLM Routing)${NC}"
+else
+    echo -e "${CYAN}Mode: LLM Routing Only${NC}"
+fi
 echo ""
 echo -e "${YELLOW}Before starting, configure your API key:${NC}"
 echo -e "  ${CYAN}1. Edit ${INSTALL_DIR}/.env${NC}"