v0.5.0: NomadArch - Binary-Free Mode Release
Some checks failed
Release Binaries / release (push) Has been cancelled
Some checks failed
Release Binaries / release (push) Has been cancelled
Features: - Binary-Free Mode: No OpenCode binary required - NomadArch Native mode with free Zen models - Native session management - Provider routing (Zen, Qwen, Z.AI) - Fixed MCP connection with explicit connectAll() - Updated installers and launchers for all platforms - UI binary selector with Native option Free Models Available: - GPT-5 Nano (400K context) - Grok Code Fast 1 (256K context) - GLM-4.7 (205K context) - Doubao Seed Code (256K context) - Big Pickle (200K context)
This commit is contained in:
Gemini AI
312
.backup/Install-Linux.sh.backup
Normal file
312
.backup/Install-Linux.sh.backup
Normal file
@@ -0,0 +1,312 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo " ███╗ ██╗ ██████╗ ███╗ ███╗ █████╗ ██████╗ █████╗ ██████╗ ██████╗██╗ ██╗"
|
||||||
|
echo " ████╗ ██║██╔═══██╗████╗ ████║██╔══██╗██╔══██╗██╔══██╗██╔════╝██║ ██║"
|
||||||
|
echo " ██╔██╗ ██║██║ ██║██╔████╔██║███████║██║ ██║███████║██████╔╝██║ ███████║"
|
||||||
|
echo " ██║╚██╗██║██║ ██║██║╚██╔╝██║██╔══██║██║ ██║██╔══██║██╔══██╗██║ ██╔══██║"
|
||||||
|
echo " ██║ ╚████║╚██████╔╝██║ ╚═╝ ██║██║ ██║██████╔╝██║ ██║██║ ██║╚██████╗██║ ██║"
|
||||||
|
echo " ╚═╝ ╚═══╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝"
|
||||||
|
echo ""
|
||||||
|
echo " INSTALLER - Enhanced with Auto-Dependency Resolution"
|
||||||
|
echo " ═════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
ERRORS=0
|
||||||
|
WARNINGS=0
|
||||||
|
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
|
||||||
|
echo "[STEP 1/6] Detecting Linux Distribution..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Detect Linux distribution
|
||||||
|
if [ -f /etc/os-release ]; then
|
||||||
|
. /etc/os-release
|
||||||
|
DISTRO=$ID
|
||||||
|
DISTRO_VERSION=$VERSION_ID
|
||||||
|
echo "[OK] Detected: $PRETTY_NAME"
|
||||||
|
else
|
||||||
|
echo "[WARN] Could not detect specific distribution"
|
||||||
|
DISTRO="unknown"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 2/6] Checking System Requirements..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Check for Node.js
|
||||||
|
echo "[INFO] Checking Node.js..."
|
||||||
|
if ! command -v node &> /dev/null; then
|
||||||
|
echo "[ERROR] Node.js not found!"
|
||||||
|
echo ""
|
||||||
|
echo "NomadArch requires Node.js to run."
|
||||||
|
echo ""
|
||||||
|
echo "Install using your package manager:"
|
||||||
|
if [ "$DISTRO" = "ubuntu" ] || [ "$DISTRO" = "debian" ]; then
|
||||||
|
echo " sudo apt update && sudo apt install -y nodejs npm"
|
||||||
|
elif [ "$DISTRO" = "fedora" ]; then
|
||||||
|
echo " sudo dnf install -y nodejs npm"
|
||||||
|
elif [ "$DISTRO" = "arch" ] || [ "$DISTRO" = "manjaro" ]; then
|
||||||
|
echo " sudo pacman -S nodejs npm"
|
||||||
|
elif [ "$DISTRO" = "opensuse-leap" ] || [ "$DISTRO" = "opensuse-tumbleweed" ]; then
|
||||||
|
echo " sudo zypper install -y nodejs npm"
|
||||||
|
else
|
||||||
|
echo " Visit https://nodejs.org/ for installation instructions"
|
||||||
|
fi
|
||||||
|
echo ""
|
||||||
|
echo "Or install Node.js using NVM (Node Version Manager):"
|
||||||
|
echo " curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash"
|
||||||
|
echo " source ~/.bashrc"
|
||||||
|
echo " nvm install 20"
|
||||||
|
echo ""
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
NODE_VERSION=$(node --version)
|
||||||
|
echo "[OK] Node.js detected: $NODE_VERSION"
|
||||||
|
|
||||||
|
# Check Node.js version (require 18+)
|
||||||
|
NODE_MAJOR=$(echo $NODE_VERSION | cut -d. -f1 | sed 's/v//')
|
||||||
|
if [ "$NODE_MAJOR" -lt 18 ]; then
|
||||||
|
echo "[WARN] Node.js version is too old (found v$NODE_VERSION, required 18+)"
|
||||||
|
echo "[INFO] Please update Node.js"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for npm
|
||||||
|
echo "[INFO] Checking npm..."
|
||||||
|
if ! command -v npm &> /dev/null; then
|
||||||
|
echo "[ERROR] npm not found! This should come with Node.js."
|
||||||
|
echo "Please reinstall Node.js"
|
||||||
|
ERRORS=$((ERRORS + 1))
|
||||||
|
fi
|
||||||
|
NPM_VERSION=$(npm --version)
|
||||||
|
echo "[OK] npm detected: $NPM_VERSION"
|
||||||
|
|
||||||
|
# Check for build-essential (required for native modules)
|
||||||
|
echo "[INFO] Checking build tools..."
|
||||||
|
if ! command -v make &> /dev/null || ! command -v gcc &> /dev/null || ! command -v g++ &> /dev/null; then
|
||||||
|
echo "[WARN] Build tools not found (gcc, g++, make)"
|
||||||
|
echo "[INFO] Installing build-essential..."
|
||||||
|
if [ "$DISTRO" = "ubuntu" ] || [ "$DISTRO" = "debian" ]; then
|
||||||
|
sudo apt update && sudo apt install -y build-essential
|
||||||
|
elif [ "$DISTRO" = "fedora" ]; then
|
||||||
|
sudo dnf install -y gcc g++ make
|
||||||
|
elif [ "$DISTRO" = "arch" ] || [ "$DISTRO" = "manjaro" ]; then
|
||||||
|
sudo pacman -S --noconfirm base-devel
|
||||||
|
elif [ "$DISTRO" = "opensuse-leap" ] || [ "$DISTRO" = "opensuse-tumbleweed" ]; then
|
||||||
|
sudo zypper install -y gcc-c++ make
|
||||||
|
else
|
||||||
|
echo "[WARN] Could not auto-install build tools. Please install manually."
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "[OK] Build tools detected"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for Git (optional but recommended)
|
||||||
|
echo "[INFO] Checking Git..."
|
||||||
|
if ! command -v git &> /dev/null; then
|
||||||
|
echo "[WARN] Git not found (optional but recommended)"
|
||||||
|
echo "[INFO] Install: sudo apt install git (or equivalent for your distro)"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
GIT_VERSION=$(git --version)
|
||||||
|
echo "[OK] Git detected: $GIT_VERSION"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for Python (optional, for some tools)
|
||||||
|
echo "[INFO] Checking Python..."
|
||||||
|
if command -v python3 &> /dev/null; then
|
||||||
|
PY_VERSION=$(python3 --version 2>&1 | awk '{print $2}')
|
||||||
|
echo "[OK] Python3 detected: $PY_VERSION"
|
||||||
|
elif command -v python &> /dev/null; then
|
||||||
|
PY_VERSION=$(python --version 2>&1 | awk '{print $2}')
|
||||||
|
echo "[OK] Python detected: $PY_VERSION"
|
||||||
|
else
|
||||||
|
echo "[WARN] Python not found (optional, required for some build tools)"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check disk space (at least 2GB free)
|
||||||
|
FREE_SPACE=$(df -BG "$PWD" | tail -1 | awk '{print int($4/1024/1024)}')
|
||||||
|
if [ "$FREE_SPACE" -lt 2048 ]; then
|
||||||
|
echo "[WARN] Low disk space ($FREE_SPACE MB free, recommended 2GB+)"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
echo "[OK] Disk space: $FREE_SPACE MB free"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 3/7] Downloading OpenCode Binary..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ ! -d "bin" ]; then
|
||||||
|
mkdir bin
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ ! -f "bin/opencode" ]; then
|
||||||
|
echo "[SETUP] Downloading opencode binary from GitHub releases..."
|
||||||
|
echo "[INFO] This is required for workspace functionality."
|
||||||
|
|
||||||
|
# Detect architecture
|
||||||
|
ARCH=$(uname -m)
|
||||||
|
if [ "$ARCH" = "x86_64" ]; then
|
||||||
|
FILENAME="opencode-linux"
|
||||||
|
elif [ "$ARCH" = "aarch64" ] || [ "$ARCH" = "arm64" ]; then
|
||||||
|
FILENAME="opencode-linux-arm64"
|
||||||
|
else
|
||||||
|
echo "[WARN] Unsupported architecture: $ARCH"
|
||||||
|
echo "[INFO] Please download opencode manually from: https://opencode.ai/"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
FILENAME=""
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ -n "$FILENAME" ]; then
|
||||||
|
curl -L -o "bin/opencode" "https://github.com/NeuralNomadsAI/NomadArch/releases/latest/download/$FILENAME"
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo "[WARN] Failed to download opencode automatically."
|
||||||
|
echo "[INFO] You can install OpenCode CLI manually from: https://opencode.ai/"
|
||||||
|
echo "[INFO] Or download opencode and place it in bin/ folder"
|
||||||
|
echo "[INFO] Without opencode, workspace creation will fail."
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
chmod +x bin/opencode
|
||||||
|
echo "[OK] opencode downloaded successfully"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "[OK] opencode already exists"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 5/7] Setting Permissions..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Make scripts executable
|
||||||
|
chmod +x Launch-Unix.sh 2>/dev/null
|
||||||
|
chmod +x Install-Linux.sh 2>/dev/null
|
||||||
|
chmod +x Install-Mac.sh 2>/dev/null
|
||||||
|
|
||||||
|
echo "[OK] Scripts permissions set"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 6/7] Cleaning Previous Installation..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ -d "node_modules" ]; then
|
||||||
|
echo "[INFO] Found existing node_modules, cleaning..."
|
||||||
|
rm -rf node_modules
|
||||||
|
echo "[OK] Cleaned previous installation artifacts"
|
||||||
|
else
|
||||||
|
echo "[OK] No previous installation found"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 7/7] Installing Dependencies..."
|
||||||
|
echo ""
|
||||||
|
echo "This may take 3-10 minutes depending on your internet speed."
|
||||||
|
echo "Please be patient and do not close this terminal."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
npm install
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo ""
|
||||||
|
echo "[ERROR] npm install failed!"
|
||||||
|
echo ""
|
||||||
|
echo "Common solutions:"
|
||||||
|
echo " 1. Check your internet connection"
|
||||||
|
echo " 2. Try running with sudo if permission errors occur"
|
||||||
|
echo " 3. Clear npm cache: npm cache clean --force"
|
||||||
|
echo " 4. Delete node_modules and try again"
|
||||||
|
echo ""
|
||||||
|
echo "Attempting to clear npm cache and retry..."
|
||||||
|
npm cache clean --force
|
||||||
|
echo "Retrying installation..."
|
||||||
|
npm install
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo "[ERROR] Installation failed after retry."
|
||||||
|
ERRORS=$((ERRORS + 1))
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "[OK] Dependencies installed successfully"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 6/6] Building NomadArch..."
|
||||||
|
echo ""
|
||||||
|
echo "This may take 2-5 minutes depending on your system."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
npm run build
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo ""
|
||||||
|
echo "[ERROR] Build failed!"
|
||||||
|
echo ""
|
||||||
|
echo "Common solutions:"
|
||||||
|
echo " 1. Check that Node.js version is 18+ (node --version)"
|
||||||
|
echo " 2. Clear npm cache: npm cache clean --force"
|
||||||
|
echo " 3. Delete node_modules and reinstall: rm -rf node_modules && npm install"
|
||||||
|
echo " 4. Check for missing system dependencies (build-essential)"
|
||||||
|
echo " 5. Check error messages above for specific issues"
|
||||||
|
echo ""
|
||||||
|
ERRORS=$((ERRORS + 1))
|
||||||
|
else
|
||||||
|
echo "[OK] Build completed successfully"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "Verifying Installation"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Check if opencode binary exists
|
||||||
|
if [ ! -f "bin/opencode" ]; then
|
||||||
|
echo "[WARN] opencode binary not found. Workspace creation will fail."
|
||||||
|
echo "[INFO] Download from: https://github.com/NeuralNomadsAI/NomadArch/releases/latest/download/opencode-linux"
|
||||||
|
echo "[INFO] Or install OpenCode CLI from: https://opencode.ai/"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
echo "[OK] opencode binary verified"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "Installation Summary"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ $ERRORS -gt 0 ]; then
|
||||||
|
echo ""
|
||||||
|
echo "════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo "[FAILED] Installation encountered $ERRORS error(s)!"
|
||||||
|
echo ""
|
||||||
|
echo "Please review error messages above and try again."
|
||||||
|
echo "For help, see: https://github.com/NeuralNomadsAI/NomadArch/issues"
|
||||||
|
echo "════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo "[SUCCESS] Installation Complete!"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ $WARNINGS -gt 0 ]; then
|
||||||
|
echo "[WARN] There were $WARNINGS warning(s) during installation."
|
||||||
|
echo "Review warnings above. Most warnings are non-critical."
|
||||||
|
echo ""
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "You can now run NomadArch using:"
|
||||||
|
echo " ./Launch-Unix.sh"
|
||||||
|
echo ""
|
||||||
|
echo "For help and documentation, see: README.md"
|
||||||
|
echo "For troubleshooting, see: TROUBLESHOOTING.md"
|
||||||
|
echo "════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
echo "Press Enter to start NomadArch now, or Ctrl+C to start later..."
|
||||||
|
read
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[INFO] Starting NomadArch..."
|
||||||
|
./Launch-Unix.sh
|
||||||
349
.backup/Install-Mac.sh.backup
Normal file
349
.backup/Install-Mac.sh.backup
Normal file
@@ -0,0 +1,349 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo " ███╗ ██╗ ██████╗ ███╗ ███╗ █████╗ ██████╗ █████╗ ██████╗ ██████╗██╗ ██╗"
|
||||||
|
echo " ████╗ ██║██╔═══██╗████╗ ████║██╔══██╗██╔══██╗██╔══██╗██╔════╝██║ ██║"
|
||||||
|
echo " ██╔██╗ ██║██║ ██║██╔████╔██║███████║██║ ██║███████║██████╔╝██║ ███████║"
|
||||||
|
echo " ██║╚██╗██║██║ ██║██║╚██╔╝██║██╔══██║██║ ██║██╔══██║██╔══██╗██║ ██╔══██║"
|
||||||
|
echo " ██║ ╚████║╚██████╔╝██║ ╚═╝ ██║██║ ██║██████╔╝██║ ██║██║ ██║╚██████╗██║ ██║"
|
||||||
|
echo " ╚═╝ ╚═══╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝"
|
||||||
|
echo ""
|
||||||
|
echo " INSTALLER - macOS Enhanced with Auto-Dependency Resolution"
|
||||||
|
echo " ═══════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
ERRORS=0
|
||||||
|
WARNINGS=0
|
||||||
|
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
|
||||||
|
echo "[STEP 1/7] Checking macOS Version..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Detect macOS version
|
||||||
|
if [ -f /System/Library/CoreServices/SystemVersion.plist ]; then
|
||||||
|
MAC_VERSION=$(defaults read /System/Library/CoreServices/SystemVersion.plist ProductVersion)
|
||||||
|
MAC_MAJOR=$(echo $MAC_VERSION | cut -d. -f1)
|
||||||
|
echo "[OK] macOS detected: $MAC_VERSION"
|
||||||
|
|
||||||
|
# Check minimum version (macOS 11+ / Big Sur+)
|
||||||
|
if [ "$MAC_MAJOR" -lt 11 ]; then
|
||||||
|
echo "[WARN] NomadArch requires macOS 11+ (Big Sur or later)"
|
||||||
|
echo "[INFO] Your version is $MAC_VERSION"
|
||||||
|
echo "[INFO] Please upgrade macOS to continue"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "[WARN] Could not detect macOS version"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for Apple Silicon
|
||||||
|
ARCH=$(uname -m)
|
||||||
|
if [ "$ARCH" = "arm64" ]; then
|
||||||
|
echo "[OK] Apple Silicon detected (M1/M2/M3 chip)"
|
||||||
|
elif [ "$ARCH" = "x86_64" ]; then
|
||||||
|
echo "[OK] Intel Mac detected"
|
||||||
|
else
|
||||||
|
echo "[WARN] Unknown architecture: $ARCH"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 2/7] Checking System Requirements..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Check for Node.js
|
||||||
|
echo "[INFO] Checking Node.js..."
|
||||||
|
if ! command -v node &> /dev/null; then
|
||||||
|
echo "[ERROR] Node.js not found!"
|
||||||
|
echo ""
|
||||||
|
echo "NomadArch requires Node.js to run."
|
||||||
|
echo ""
|
||||||
|
echo "Install Node.js using one of these methods:"
|
||||||
|
echo ""
|
||||||
|
echo " 1. Homebrew (recommended):"
|
||||||
|
echo " brew install node"
|
||||||
|
echo ""
|
||||||
|
echo " 2. Download from official site:"
|
||||||
|
echo " Visit https://nodejs.org/"
|
||||||
|
echo " Download and install the macOS installer"
|
||||||
|
echo ""
|
||||||
|
echo " 3. Using NVM (Node Version Manager):"
|
||||||
|
echo " curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash"
|
||||||
|
echo " source ~/.zshrc (or ~/.bash_profile)"
|
||||||
|
echo " nvm install 20"
|
||||||
|
echo ""
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
NODE_VERSION=$(node --version)
|
||||||
|
echo "[OK] Node.js detected: $NODE_VERSION"
|
||||||
|
|
||||||
|
# Check Node.js version (require 18+)
|
||||||
|
NODE_MAJOR=$(echo $NODE_VERSION | cut -d. -f1 | sed 's/v//')
|
||||||
|
if [ "$NODE_MAJOR" -lt 18 ]; then
|
||||||
|
echo "[WARN] Node.js version is too old (found v$NODE_VERSION, required 18+)"
|
||||||
|
echo "[INFO] Please update Node.js: brew upgrade node"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for npm
|
||||||
|
echo "[INFO] Checking npm..."
|
||||||
|
if ! command -v npm &> /dev/null; then
|
||||||
|
echo "[ERROR] npm not found! This should come with Node.js."
|
||||||
|
echo "Please reinstall Node.js"
|
||||||
|
ERRORS=$((ERRORS + 1))
|
||||||
|
fi
|
||||||
|
NPM_VERSION=$(npm --version)
|
||||||
|
echo "[OK] npm detected: $NPM_VERSION"
|
||||||
|
|
||||||
|
# Check for Xcode Command Line Tools (required for native modules)
|
||||||
|
echo "[INFO] Checking Xcode Command Line Tools..."
|
||||||
|
if ! command -v xcode-select &> /dev/null; then
|
||||||
|
echo "[WARN] Xcode Command Line Tools not installed"
|
||||||
|
echo "[INFO] Required for building native Node.js modules"
|
||||||
|
echo ""
|
||||||
|
echo "Install by running:"
|
||||||
|
echo " xcode-select --install"
|
||||||
|
echo ""
|
||||||
|
echo "This will open a dialog to install the tools."
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
XCODE_PATH=$(xcode-select -p)
|
||||||
|
echo "[OK] Xcode Command Line Tools detected: $XCODE_PATH"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for Homebrew (optional but recommended)
|
||||||
|
echo "[INFO] Checking Homebrew..."
|
||||||
|
if ! command -v brew &> /dev/null; then
|
||||||
|
echo "[WARN] Homebrew not found (optional but recommended)"
|
||||||
|
echo "[INFO] Install Homebrew from: https://brew.sh/"
|
||||||
|
echo "[INFO] Then you can install dependencies with: brew install node git"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
BREW_VERSION=$(brew --version | head -1)
|
||||||
|
echo "[OK] Homebrew detected: $BREW_VERSION"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check for Git (optional but recommended)
|
||||||
|
echo "[INFO] Checking Git..."
|
||||||
|
if ! command -v git &> /dev/null; then
|
||||||
|
echo "[WARN] Git not found (optional but recommended)"
|
||||||
|
echo "[INFO] Install: brew install git"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
GIT_VERSION=$(git --version)
|
||||||
|
echo "[OK] Git detected: $GIT_VERSION"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check disk space (at least 2GB free)
|
||||||
|
FREE_SPACE=$(df -BG "$PWD" | tail -1 | awk '{print int($4/1024/1024)}')
|
||||||
|
if [ "$FREE_SPACE" -lt 2048 ]; then
|
||||||
|
echo "[WARN] Low disk space ($FREE_SPACE MB free, recommended 2GB+)"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
echo "[OK] Disk space: $FREE_SPACE MB free"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 3/7] Checking Rosetta 2 (Apple Silicon)..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Check if Rosetta 2 is installed on Apple Silicon
|
||||||
|
if [ "$ARCH" = "arm64" ]; then
|
||||||
|
if ! /usr/bin/pgrep -q oahd; then
|
||||||
|
echo "[INFO] Rosetta 2 is not running"
|
||||||
|
echo "[INFO] Some x86_64 dependencies may need Rosetta"
|
||||||
|
echo ""
|
||||||
|
echo "Install Rosetta 2 if needed:"
|
||||||
|
echo " softwareupdate --install-rosetta"
|
||||||
|
echo ""
|
||||||
|
else
|
||||||
|
echo "[OK] Rosetta 2 is installed and running"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 4/7] Checking Gatekeeper Status..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Check if Gatekeeper will block unsigned apps
|
||||||
|
echo "[INFO] Gatekeeper may block unsigned applications"
|
||||||
|
echo "[INFO] If NomadArch doesn't open, try:"
|
||||||
|
echo " Right-click -> Open"
|
||||||
|
echo " Or disable Gatekeeper (not recommended):"
|
||||||
|
echo " sudo spctl --master-disable"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 5/8] Downloading OpenCode Binary..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ ! -d "bin" ]; then
|
||||||
|
mkdir bin
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ ! -f "bin/opencode" ]; then
|
||||||
|
echo "[SETUP] Downloading opencode binary from GitHub releases..."
|
||||||
|
echo "[INFO] This is required for workspace functionality."
|
||||||
|
|
||||||
|
# Detect architecture
|
||||||
|
if [ "$ARCH" = "arm64" ]; then
|
||||||
|
FILENAME="opencode-macos-arm64"
|
||||||
|
elif [ "$ARCH" = "x86_64" ]; then
|
||||||
|
FILENAME="opencode-macos"
|
||||||
|
else
|
||||||
|
echo "[WARN] Unsupported architecture: $ARCH"
|
||||||
|
echo "[INFO] Please download opencode manually from: https://opencode.ai/"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
FILENAME=""
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ -n "$FILENAME" ]; then
|
||||||
|
curl -L -o "bin/opencode" "https://github.com/NeuralNomadsAI/NomadArch/releases/latest/download/$FILENAME"
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo "[WARN] Failed to download opencode automatically."
|
||||||
|
echo "[INFO] You can install OpenCode CLI manually from: https://opencode.ai/"
|
||||||
|
echo "[INFO] Or download opencode and place it in bin/ folder"
|
||||||
|
echo "[INFO] Without opencode, workspace creation will fail."
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
chmod +x bin/opencode
|
||||||
|
echo "[OK] opencode downloaded successfully"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "[OK] opencode already exists"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 6/8] Setting Permissions..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Make scripts executable
|
||||||
|
chmod +x Launch-Unix.sh 2>/dev/null
|
||||||
|
chmod +x Install-Linux.sh 2>/dev/null
|
||||||
|
chmod +x Install-Mac.sh 2>/dev/null
|
||||||
|
|
||||||
|
echo "[OK] Scripts permissions set"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 7/8] Cleaning Previous Installation..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ -d "node_modules" ]; then
|
||||||
|
echo "[INFO] Found existing node_modules, cleaning..."
|
||||||
|
rm -rf node_modules
|
||||||
|
echo "[OK] Cleaned previous installation artifacts"
|
||||||
|
else
|
||||||
|
echo "[OK] No previous installation found"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 8/8] Installing Dependencies..."
|
||||||
|
echo ""
|
||||||
|
echo "This may take 3-10 minutes depending on your internet speed."
|
||||||
|
echo "Please be patient and do not close this terminal."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
npm install
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo ""
|
||||||
|
echo "[ERROR] npm install failed!"
|
||||||
|
echo ""
|
||||||
|
echo "Common solutions:"
|
||||||
|
echo " 1. Check your internet connection"
|
||||||
|
echo " 2. Try clearing npm cache: npm cache clean --force"
|
||||||
|
echo " 3. Delete node_modules and try again: rm -rf node_modules && npm install"
|
||||||
|
echo " 4. Ensure Xcode Command Line Tools are installed"
|
||||||
|
echo " 5. Check if Node.js version is 18+"
|
||||||
|
echo ""
|
||||||
|
echo "Attempting to clear npm cache and retry..."
|
||||||
|
npm cache clean --force
|
||||||
|
echo "Retrying installation..."
|
||||||
|
npm install
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo "[ERROR] Installation failed after retry."
|
||||||
|
ERRORS=$((ERRORS + 1))
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo "[OK] Dependencies installed successfully"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "Building NomadArch..."
|
||||||
|
echo ""
|
||||||
|
echo "This may take 2-5 minutes depending on your system."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
npm run build
|
||||||
|
if [ $? -ne 0 ]; then
|
||||||
|
echo ""
|
||||||
|
echo "[ERROR] Build failed!"
|
||||||
|
echo ""
|
||||||
|
echo "Common solutions:"
|
||||||
|
echo " 1. Check that Node.js version is 18+ (node --version)"
|
||||||
|
echo " 2. Ensure Xcode Command Line Tools are installed: xcode-select --install"
|
||||||
|
echo " 3. Clear npm cache: npm cache clean --force"
|
||||||
|
echo " 4. Delete node_modules and reinstall: rm -rf node_modules && npm install"
|
||||||
|
echo " 5. Check error messages above for specific issues"
|
||||||
|
echo ""
|
||||||
|
ERRORS=$((ERRORS + 1))
|
||||||
|
else
|
||||||
|
echo "[OK] Build completed successfully"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "Verifying Installation"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Check if opencode binary exists
|
||||||
|
if [ ! -f "bin/opencode" ]; then
|
||||||
|
echo "[WARN] opencode binary not found. Workspace creation will fail."
|
||||||
|
echo "[INFO] Download from: https://github.com/NeuralNomadsAI/NomadArch/releases/latest/download/opencode-macos"
|
||||||
|
echo "[INFO] Or install OpenCode CLI from: https://opencode.ai/"
|
||||||
|
WARNINGS=$((WARNINGS + 1))
|
||||||
|
else
|
||||||
|
echo "[OK] opencode binary verified"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "Installation Summary"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ $ERRORS -gt 0 ]; then
|
||||||
|
echo ""
|
||||||
|
echo "════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo "[FAILED] Installation encountered $ERRORS error(s)!"
|
||||||
|
echo ""
|
||||||
|
echo "Please review error messages above and try again."
|
||||||
|
echo "For help, see: https://github.com/NeuralNomadsAI/NomadArch/issues"
|
||||||
|
echo "════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "══════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo "[SUCCESS] Installation Complete!"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [ $WARNINGS -gt 0 ]; then
|
||||||
|
echo "[WARN] There were $WARNINGS warning(s) during installation."
|
||||||
|
echo "Review warnings above. Most warnings are non-critical."
|
||||||
|
echo ""
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "You can now run NomadArch using:"
|
||||||
|
echo " ./Launch-Unix.sh"
|
||||||
|
echo ""
|
||||||
|
echo "For help and documentation, see: README.md"
|
||||||
|
echo "For troubleshooting, see: TROUBLESHOOTING.md"
|
||||||
|
echo "════════════════════════════════════════════════════════════════════════════"
|
||||||
|
echo ""
|
||||||
|
echo "Press Enter to start NomadArch now, or Ctrl+C to start later..."
|
||||||
|
read
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[INFO] Starting NomadArch..."
|
||||||
|
./Launch-Unix.sh
|
||||||
295
.backup/Install-Windows.bat.backup
Normal file
295
.backup/Install-Windows.bat.backup
Normal file
@@ -0,0 +1,295 @@
|
|||||||
|
@echo off
|
||||||
|
title NomadArch Installer
|
||||||
|
color 0A
|
||||||
|
setlocal enabledelayedexpansion
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo ███╗ ██╗ ██████╗ ███╗ ███╗ █████╗ ██████╗ █████╗ ██████╗ ██████╗██╗ ██╗
|
||||||
|
echo ████╗ ██║██╔═══██╗████╗ ████║██╔══██╗██╔══██╗██╔══██╗██╔════╝██║ ██║
|
||||||
|
echo ██╔██╗ ██║██║ ██║██╔████╔██║███████║██║ ██║███████║██████╔╝██║ ███████║
|
||||||
|
echo ██║╚██╗██║██║ ██║██║╚██╔╝██║██╔══██║██║ ██║██╔══██║██╔══██╗██║ ██╔══██║
|
||||||
|
echo ██║ ╚████║╚██████╔╝██║ ╚═╝ ██║██║ ██║██████╔╝██║ ██║██║ ██║╚██████╗██║ ██║
|
||||||
|
echo ╚═╝ ╚═══╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝
|
||||||
|
echo.
|
||||||
|
echo INSTALLER - Enhanced with Auto-Dependency Resolution
|
||||||
|
echo ═══════════════════════════════════════════════════════════════════════════════
|
||||||
|
echo.
|
||||||
|
|
||||||
|
set ERRORS=0
|
||||||
|
set WARNINGS=0
|
||||||
|
|
||||||
|
cd /d "%~dp0"
|
||||||
|
|
||||||
|
echo [STEP 1/6] Checking System Requirements...
|
||||||
|
echo.
|
||||||
|
|
||||||
|
:: Check for Administrator privileges
|
||||||
|
net session >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Not running as Administrator. Some operations may fail.
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
echo.
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Check for Node.js
|
||||||
|
echo [INFO] Checking Node.js...
|
||||||
|
where node >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [ERROR] Node.js not found!
|
||||||
|
echo.
|
||||||
|
echo NomadArch requires Node.js to run.
|
||||||
|
echo.
|
||||||
|
echo Download from: https://nodejs.org/
|
||||||
|
echo Recommended: Node.js 18.x LTS or 20.x LTS
|
||||||
|
echo.
|
||||||
|
echo Opening download page...
|
||||||
|
start "" "https://nodejs.org/"
|
||||||
|
echo.
|
||||||
|
echo Please install Node.js and run this installer again.
|
||||||
|
echo.
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
for /f "tokens=*" %%i in ('node --version') do set NODE_VERSION=%%i
|
||||||
|
echo [OK] Node.js detected: %NODE_VERSION%
|
||||||
|
|
||||||
|
:: Check Node.js version (require 18+)
|
||||||
|
for /f "tokens=1,2 delims=." %%a in ("%NODE_VERSION:v=%") do (
|
||||||
|
set MAJOR=%%a
|
||||||
|
set MINOR=%%b
|
||||||
|
)
|
||||||
|
if %MAJOR% lss 18 (
|
||||||
|
echo [WARN] Node.js version is too old (found v%MAJOR%.%MINOR%, required 18+)
|
||||||
|
echo [INFO] Please update Node.js from: https://nodejs.org/
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Check for npm
|
||||||
|
echo [INFO] Checking npm...
|
||||||
|
where npm >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [ERROR] npm not found! This should come with Node.js.
|
||||||
|
echo Please reinstall Node.js from: https://nodejs.org/
|
||||||
|
set /a ERRORS+=1
|
||||||
|
)
|
||||||
|
for /f "tokens=*" %%i in ('npm --version') do set NPM_VERSION=%%i
|
||||||
|
echo [OK] npm detected: %NPM_VERSION%
|
||||||
|
|
||||||
|
:: Check for Git (optional but recommended)
|
||||||
|
echo [INFO] Checking Git...
|
||||||
|
where git >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Git not found (optional but recommended)
|
||||||
|
echo [INFO] Install from: https://git-scm.com/
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
for /f "tokens=*" %%i in ('git --version') do set GIT_VERSION=%%i
|
||||||
|
echo [OK] Git detected: %GIT_VERSION%
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Check for Python (optional, for some tools)
|
||||||
|
echo [INFO] Checking Python...
|
||||||
|
where python >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
where python3 >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Python not found (optional, required for some build tools)
|
||||||
|
echo [INFO] Install from: https://www.python.org/downloads/
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] Python3 detected
|
||||||
|
)
|
||||||
|
) else (
|
||||||
|
for /f "tokens=2" %%i in ('python --version') do set PY_VERSION=%%i
|
||||||
|
echo [OK] Python detected: %PY_VERSION%
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Check disk space (at least 2GB free)
|
||||||
|
for /f "tokens=3" %%a in ('dir /-c "%~dp0" ^| find "bytes free"') do set FREE_SPACE=%%a
|
||||||
|
set /a FREE_SPACE_GB=!FREE_SPACE!/1024/1024/1024
|
||||||
|
if !FREE_SPACE_GB! lss 2 (
|
||||||
|
echo [WARN] Low disk space (!FREE_SPACE_GB! GB free, recommended 2GB+)
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] Disk space: !FREE_SPACE_GB! GB free
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 2/6] Cleaning Previous Installation...
|
||||||
|
echo.
|
||||||
|
|
||||||
|
if exist "node_modules" (
|
||||||
|
echo [INFO] Found existing node_modules, cleaning...
|
||||||
|
if exist "node_modules\.package-lock.json" (
|
||||||
|
del /f /q "node_modules\.package-lock.json" 2>nul
|
||||||
|
)
|
||||||
|
echo [OK] Cleaned previous installation artifacts
|
||||||
|
) else (
|
||||||
|
echo [OK] No previous installation found
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 3/6] Downloading OpenCode Binary...
|
||||||
|
echo.
|
||||||
|
|
||||||
|
if not exist "bin" mkdir bin
|
||||||
|
if not exist "bin\opencode.exe" (
|
||||||
|
echo [SETUP] Downloading opencode.exe from GitHub releases...
|
||||||
|
echo [INFO] This is required for workspace functionality.
|
||||||
|
curl -L -o "bin\opencode.exe" "https://github.com/NeuralNomadsAI/NomadArch/releases/latest/download/opencode.exe"
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Failed to download opencode.exe automatically.
|
||||||
|
echo [INFO] You can install OpenCode CLI manually from: https://opencode.ai/
|
||||||
|
echo [INFO] Or download opencode.exe and place it in bin/ folder
|
||||||
|
echo [INFO] Without opencode.exe, workspace creation will fail.
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] opencode.exe downloaded successfully
|
||||||
|
)
|
||||||
|
) else (
|
||||||
|
echo [OK] opencode.exe already exists
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 4/6] Installing Dependencies...
|
||||||
|
echo.
|
||||||
|
echo This may take 3-10 minutes depending on your internet speed.
|
||||||
|
echo Please be patient and do not close this window.
|
||||||
|
echo.
|
||||||
|
|
||||||
|
call npm install
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo.
|
||||||
|
echo [ERROR] npm install failed!
|
||||||
|
echo.
|
||||||
|
echo Common solutions:
|
||||||
|
echo 1. Check your internet connection
|
||||||
|
echo 2. Try running as Administrator
|
||||||
|
echo 3. Clear npm cache: npm cache clean --force
|
||||||
|
echo 4. Delete node_modules and try again
|
||||||
|
echo.
|
||||||
|
echo Attempting to clear npm cache and retry...
|
||||||
|
call npm cache clean --force
|
||||||
|
echo Retrying installation...
|
||||||
|
call npm install
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [ERROR] Installation failed after retry.
|
||||||
|
set /a ERRORS+=1
|
||||||
|
)
|
||||||
|
) else (
|
||||||
|
echo [OK] Dependencies installed successfully
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 5/6] Building NomadArch...
|
||||||
|
echo.
|
||||||
|
echo This may take 2-5 minutes depending on your system.
|
||||||
|
echo.
|
||||||
|
|
||||||
|
call npm run build
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo.
|
||||||
|
echo [ERROR] Build failed!
|
||||||
|
echo.
|
||||||
|
echo Common solutions:
|
||||||
|
echo 1. Check that Node.js version is 18+ (node --version)
|
||||||
|
echo 2. Clear npm cache: npm cache clean --force
|
||||||
|
echo 3. Delete node_modules and reinstall: rm -rf node_modules ^&^& npm install
|
||||||
|
echo 4. Check the error messages above for specific issues
|
||||||
|
echo.
|
||||||
|
set /a ERRORS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] Build completed successfully
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 6/6] Verifying Installation...
|
||||||
|
echo.
|
||||||
|
|
||||||
|
:: Check UI build
|
||||||
|
if not exist "packages\ui\dist" (
|
||||||
|
echo [WARN] UI build not found
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] UI build verified
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Check Server build
|
||||||
|
if not exist "packages\server\dist\bin.js" (
|
||||||
|
echo [WARN] Server build not found
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] Server build verified
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Check Electron build
|
||||||
|
if not exist "packages\electron-app\dist\main\main.js" (
|
||||||
|
echo [WARN] Electron build not found
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] Electron build verified
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Check opencode.exe
|
||||||
|
if not exist "bin\opencode.exe" (
|
||||||
|
echo [WARN] opencode.exe not found. Workspace creation will fail.
|
||||||
|
echo [INFO] Download from: https://github.com/NeuralNomadsAI/NomadArch/releases/latest/download/opencode.exe
|
||||||
|
echo [INFO] Or install OpenCode CLI from: https://opencode.ai/
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] opencode.exe verified
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 7/7] Installation Summary
|
||||||
|
echo.
|
||||||
|
|
||||||
|
if %ERRORS% gtr 0 (
|
||||||
|
echo.
|
||||||
|
echo ═══════════════════════════════════════════════════════════════════════════════
|
||||||
|
echo [FAILED] Installation encountered %ERRORS% error^(s^)!
|
||||||
|
echo.
|
||||||
|
echo Please review the error messages above and try again.
|
||||||
|
echo For help, see: https://github.com/NeuralNomadsAI/NomadArch/issues
|
||||||
|
echo ═══════════════════════════════════════════════════════════════════════════════
|
||||||
|
echo.
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo ═══════════════════════════════════════════════════════════════════════════════
|
||||||
|
echo [SUCCESS] Installation Complete!
|
||||||
|
echo.
|
||||||
|
if %WARNINGS% gtr 0 (
|
||||||
|
echo [WARN] There were %WARNINGS% warning^(s^) during installation.
|
||||||
|
echo Review the warnings above. Most warnings are non-critical.
|
||||||
|
echo.
|
||||||
|
)
|
||||||
|
echo You can now run NomadArch using:
|
||||||
|
echo - Launch-Windows.bat ^(Production mode^)
|
||||||
|
echo - Launch-Dev-Windows.bat ^(Developer mode with hot reload^)
|
||||||
|
echo - NomadArch.vbs ^(Silent mode, no console window^)
|
||||||
|
echo.
|
||||||
|
echo For help and documentation, see: README.md
|
||||||
|
echo For troubleshooting, see: TROUBLESHOOTING.md
|
||||||
|
echo ═══════════════════════════════════════════════════════════════════════════════
|
||||||
|
echo.
|
||||||
|
echo Press any key to start NomadArch now, or close this window to start later...
|
||||||
|
pause >nul
|
||||||
|
|
||||||
|
:: Offer to start the app
|
||||||
|
echo.
|
||||||
|
echo [OPTION] Would you like to start NomadArch now? ^(Y/N^)
|
||||||
|
set /p START_APP="> "
|
||||||
|
if /i "%START_APP%"=="Y" (
|
||||||
|
echo.
|
||||||
|
echo [INFO] Starting NomadArch...
|
||||||
|
call Launch-Windows.bat
|
||||||
|
) else (
|
||||||
|
echo.
|
||||||
|
echo [INFO] You can start NomadArch later by running Launch-Windows.bat
|
||||||
|
echo.
|
||||||
|
)
|
||||||
|
|
||||||
|
exit /b 0
|
||||||
71
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
Normal file
71
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
Normal file
@@ -0,0 +1,71 @@
|
|||||||
|
name: Bug Report
|
||||||
|
description: Report a bug or regression in CodeNomad
|
||||||
|
labels:
|
||||||
|
- bug
|
||||||
|
title: "[Bug]: "
|
||||||
|
body:
|
||||||
|
- type: markdown
|
||||||
|
attributes:
|
||||||
|
value: |
|
||||||
|
Thanks for filing a bug report! Please review open issues before submitting a new one and provide as much detail as possible so we can reproduce the problem.
|
||||||
|
- type: dropdown
|
||||||
|
id: variant
|
||||||
|
attributes:
|
||||||
|
label: App Variant
|
||||||
|
description: Which build are you running when this issue appears?
|
||||||
|
multiple: false
|
||||||
|
options:
|
||||||
|
- Electron
|
||||||
|
- Tauri
|
||||||
|
- Server CLI
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: input
|
||||||
|
id: os-version
|
||||||
|
attributes:
|
||||||
|
label: Operating System & Version
|
||||||
|
description: Include the OS family and version (e.g., macOS 15.0, Ubuntu 24.04, Windows 11 23H2).
|
||||||
|
placeholder: macOS 15.0
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: input
|
||||||
|
id: summary
|
||||||
|
attributes:
|
||||||
|
label: Issue Summary
|
||||||
|
description: Briefly describe what is happening.
|
||||||
|
placeholder: A quick one sentence problem statement
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: repro
|
||||||
|
attributes:
|
||||||
|
label: Steps to Reproduce
|
||||||
|
description: List the steps needed to reproduce the problem.
|
||||||
|
placeholder: |
|
||||||
|
1. Go to ...
|
||||||
|
2. Click ...
|
||||||
|
3. Observe ...
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: expected
|
||||||
|
attributes:
|
||||||
|
label: Expected Behavior
|
||||||
|
description: Describe what you expected to happen instead.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: logs
|
||||||
|
attributes:
|
||||||
|
label: Logs & Screenshots
|
||||||
|
description: Attach relevant logs, stack traces, or screenshots if available.
|
||||||
|
placeholder: Paste logs here or drag-and-drop files onto the issue.
|
||||||
|
validations:
|
||||||
|
required: false
|
||||||
|
- type: textarea
|
||||||
|
id: extra
|
||||||
|
attributes:
|
||||||
|
label: Additional Context
|
||||||
|
description: Add any other context about the problem here.
|
||||||
|
validations:
|
||||||
|
required: false
|
||||||
519
.github/workflows/build-and-upload.yml
vendored
Normal file
519
.github/workflows/build-and-upload.yml
vendored
Normal file
@@ -0,0 +1,519 @@
|
|||||||
|
name: Build and Upload Binaries
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_call:
|
||||||
|
inputs:
|
||||||
|
version:
|
||||||
|
description: "Version to apply to workspace packages"
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
tag:
|
||||||
|
description: "Git tag to upload assets to"
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
release_name:
|
||||||
|
description: "Release name (unused here, for context)"
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
id-token: write
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
env:
|
||||||
|
NODE_VERSION: 20
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build-macos:
|
||||||
|
runs-on: macos-15-intel
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-darwin-x64 --no-save
|
||||||
|
|
||||||
|
- name: Build macOS binaries (Electron)
|
||||||
|
run: npm run build:mac --workspace @neuralnomads/codenomad-electron-app
|
||||||
|
|
||||||
|
- name: Upload release assets
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s nullglob
|
||||||
|
for file in packages/electron-app/release/*.zip; do
|
||||||
|
[ -f "$file" ] || continue
|
||||||
|
echo "Uploading $file"
|
||||||
|
gh release upload "$TAG" "$file" --clobber
|
||||||
|
done
|
||||||
|
|
||||||
|
build-windows:
|
||||||
|
runs-on: windows-2025
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${{ env.VERSION }} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
shell: bash
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-win32-x64-msvc --no-save
|
||||||
|
|
||||||
|
- name: Build Windows binaries (Electron)
|
||||||
|
run: npm run build:win --workspace @neuralnomads/codenomad-electron-app
|
||||||
|
|
||||||
|
- name: Upload release assets
|
||||||
|
shell: pwsh
|
||||||
|
run: |
|
||||||
|
Get-ChildItem -Path "packages/electron-app/release" -Filter *.zip -File | ForEach-Object {
|
||||||
|
Write-Host "Uploading $($_.FullName)"
|
||||||
|
gh release upload $env:TAG $_.FullName --clobber
|
||||||
|
}
|
||||||
|
|
||||||
|
build-linux:
|
||||||
|
runs-on: ubuntu-24.04
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-linux-x64-gnu --no-save
|
||||||
|
|
||||||
|
- name: Build Linux binaries (Electron)
|
||||||
|
run: npm run build:linux --workspace @neuralnomads/codenomad-electron-app
|
||||||
|
|
||||||
|
- name: Upload release assets
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s nullglob
|
||||||
|
for file in packages/electron-app/release/*.zip; do
|
||||||
|
[ -f "$file" ] || continue
|
||||||
|
echo "Uploading $file"
|
||||||
|
gh release upload "$TAG" "$file" --clobber
|
||||||
|
done
|
||||||
|
|
||||||
|
build-tauri-macos:
|
||||||
|
runs-on: macos-15-intel
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Setup Rust (Tauri)
|
||||||
|
uses: dtolnay/rust-toolchain@stable
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-darwin-x64 --no-save
|
||||||
|
|
||||||
|
- name: Build macOS bundle (Tauri)
|
||||||
|
run: npm run build --workspace @codenomad/tauri-app
|
||||||
|
|
||||||
|
- name: Package Tauri artifacts (macOS)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
BUNDLE_ROOT="packages/tauri-app/target/release/bundle"
|
||||||
|
ARTIFACT_DIR="packages/tauri-app/release-tauri"
|
||||||
|
rm -rf "$ARTIFACT_DIR"
|
||||||
|
mkdir -p "$ARTIFACT_DIR"
|
||||||
|
if [ -d "$BUNDLE_ROOT/macos/CodeNomad.app" ]; then
|
||||||
|
ditto -ck --sequesterRsrc --keepParent "$BUNDLE_ROOT/macos/CodeNomad.app" "$ARTIFACT_DIR/CodeNomad-Tauri-${VERSION}-macos-x64.zip"
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Upload Tauri release assets (macOS)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s nullglob
|
||||||
|
for file in packages/tauri-app/release-tauri/*.zip; do
|
||||||
|
[ -f "$file" ] || continue
|
||||||
|
echo "Uploading $file"
|
||||||
|
gh release upload "$TAG" "$file" --clobber
|
||||||
|
done
|
||||||
|
|
||||||
|
build-tauri-macos-arm64:
|
||||||
|
runs-on: macos-26
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Setup Rust (Tauri)
|
||||||
|
uses: dtolnay/rust-toolchain@stable
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-darwin-arm64 --no-save
|
||||||
|
|
||||||
|
- name: Build macOS bundle (Tauri, arm64)
|
||||||
|
run: npm run build --workspace @codenomad/tauri-app
|
||||||
|
|
||||||
|
- name: Package Tauri artifacts (macOS arm64)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
BUNDLE_ROOT="packages/tauri-app/target/release/bundle"
|
||||||
|
ARTIFACT_DIR="packages/tauri-app/release-tauri"
|
||||||
|
rm -rf "$ARTIFACT_DIR"
|
||||||
|
mkdir -p "$ARTIFACT_DIR"
|
||||||
|
if [ -d "$BUNDLE_ROOT/macos/CodeNomad.app" ]; then
|
||||||
|
ditto -ck --sequesterRsrc --keepParent "$BUNDLE_ROOT/macos/CodeNomad.app" "$ARTIFACT_DIR/CodeNomad-Tauri-${VERSION}-macos-arm64.zip"
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Upload Tauri release assets (macOS arm64)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s nullglob
|
||||||
|
for file in packages/tauri-app/release-tauri/*.zip; do
|
||||||
|
[ -f "$file" ] || continue
|
||||||
|
echo "Uploading $file"
|
||||||
|
gh release upload "$TAG" "$file" --clobber
|
||||||
|
done
|
||||||
|
|
||||||
|
build-tauri-windows:
|
||||||
|
runs-on: windows-2025
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Setup Rust (Tauri)
|
||||||
|
uses: dtolnay/rust-toolchain@stable
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${{ env.VERSION }} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
shell: bash
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-win32-x64-msvc --no-save
|
||||||
|
|
||||||
|
- name: Build Windows bundle (Tauri)
|
||||||
|
run: npm run build --workspace @codenomad/tauri-app
|
||||||
|
|
||||||
|
- name: Package Tauri artifacts (Windows)
|
||||||
|
shell: pwsh
|
||||||
|
run: |
|
||||||
|
$bundleRoot = "packages/tauri-app/target/release/bundle"
|
||||||
|
$artifactDir = "packages/tauri-app/release-tauri"
|
||||||
|
if (Test-Path $artifactDir) { Remove-Item $artifactDir -Recurse -Force }
|
||||||
|
New-Item -ItemType Directory -Path $artifactDir | Out-Null
|
||||||
|
$exe = Get-ChildItem -Path $bundleRoot -Recurse -File -Filter *.exe | Select-Object -First 1
|
||||||
|
if ($null -ne $exe) {
|
||||||
|
$dest = Join-Path $artifactDir ("CodeNomad-Tauri-$env:VERSION-windows-x64.zip")
|
||||||
|
Compress-Archive -Path $exe.Directory.FullName -DestinationPath $dest -Force
|
||||||
|
}
|
||||||
|
|
||||||
|
- name: Upload Tauri release assets (Windows)
|
||||||
|
shell: pwsh
|
||||||
|
run: |
|
||||||
|
if (Test-Path "packages/tauri-app/release-tauri") {
|
||||||
|
Get-ChildItem -Path "packages/tauri-app/release-tauri" -Filter *.zip -File | ForEach-Object {
|
||||||
|
Write-Host "Uploading $($_.FullName)"
|
||||||
|
gh release upload $env:TAG $_.FullName --clobber
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
build-tauri-linux:
|
||||||
|
runs-on: ubuntu-24.04
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Setup Rust (Tauri)
|
||||||
|
uses: dtolnay/rust-toolchain@stable
|
||||||
|
|
||||||
|
- name: Install Linux build dependencies (Tauri)
|
||||||
|
run: |
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y \
|
||||||
|
build-essential \
|
||||||
|
pkg-config \
|
||||||
|
libgtk-3-dev \
|
||||||
|
libglib2.0-dev \
|
||||||
|
libwebkit2gtk-4.1-dev \
|
||||||
|
libsoup-3.0-dev \
|
||||||
|
libayatana-appindicator3-dev \
|
||||||
|
librsvg2-dev
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-linux-x64-gnu --no-save
|
||||||
|
|
||||||
|
- name: Build Linux bundle (Tauri)
|
||||||
|
run: npm run build --workspace @codenomad/tauri-app
|
||||||
|
|
||||||
|
- name: Package Tauri artifacts (Linux)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
SEARCH_ROOT="packages/tauri-app/target"
|
||||||
|
ARTIFACT_DIR="packages/tauri-app/release-tauri"
|
||||||
|
rm -rf "$ARTIFACT_DIR"
|
||||||
|
mkdir -p "$ARTIFACT_DIR"
|
||||||
|
shopt -s nullglob globstar
|
||||||
|
|
||||||
|
find_one() {
|
||||||
|
find "$SEARCH_ROOT" -type f -iname "$1" | head -n1
|
||||||
|
}
|
||||||
|
|
||||||
|
appimage=$(find_one "*.AppImage")
|
||||||
|
deb=$(find_one "*.deb")
|
||||||
|
rpm=$(find_one "*.rpm")
|
||||||
|
|
||||||
|
if [ -z "$appimage" ] || [ -z "$deb" ] || [ -z "$rpm" ]; then
|
||||||
|
echo "Missing bundle(s): appimage=${appimage:-none} deb=${deb:-none} rpm=${rpm:-none}" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
cp "$appimage" "$ARTIFACT_DIR/CodeNomad-Tauri-${VERSION}-linux-x64.AppImage"
|
||||||
|
cp "$deb" "$ARTIFACT_DIR/CodeNomad-Tauri-${VERSION}-linux-x64.deb"
|
||||||
|
cp "$rpm" "$ARTIFACT_DIR/CodeNomad-Tauri-${VERSION}-linux-x64.rpm"
|
||||||
|
|
||||||
|
- name: Upload Tauri release assets (Linux)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s nullglob
|
||||||
|
for file in packages/tauri-app/release-tauri/*; do
|
||||||
|
[ -f "$file" ] || continue
|
||||||
|
echo "Uploading $file"
|
||||||
|
gh release upload "$TAG" "$file" --clobber
|
||||||
|
done
|
||||||
|
|
||||||
|
build-tauri-linux-arm64:
|
||||||
|
if: ${{ false }}
|
||||||
|
runs-on: ubuntu-24.04
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup QEMU
|
||||||
|
uses: docker/setup-qemu-action@v3
|
||||||
|
with:
|
||||||
|
platforms: linux/arm64
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Setup Rust (Tauri)
|
||||||
|
uses: dtolnay/rust-toolchain@stable
|
||||||
|
with:
|
||||||
|
targets: aarch64-unknown-linux-gnu
|
||||||
|
|
||||||
|
- name: Install Linux build dependencies (Tauri)
|
||||||
|
run: |
|
||||||
|
sudo dpkg --add-architecture arm64
|
||||||
|
sudo tee /etc/apt/sources.list.d/arm64.list >/dev/null <<'EOF'
|
||||||
|
deb [arch=arm64] http://ports.ubuntu.com/ubuntu-ports noble main restricted universe multiverse
|
||||||
|
deb [arch=arm64] http://ports.ubuntu.com/ubuntu-ports noble-updates main restricted universe multiverse
|
||||||
|
deb [arch=arm64] http://ports.ubuntu.com/ubuntu-ports noble-security main restricted universe multiverse
|
||||||
|
deb [arch=arm64] http://ports.ubuntu.com/ubuntu-ports noble-backports main restricted universe multiverse
|
||||||
|
EOF
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y \
|
||||||
|
build-essential \
|
||||||
|
pkg-config \
|
||||||
|
gcc-aarch64-linux-gnu \
|
||||||
|
g++-aarch64-linux-gnu \
|
||||||
|
libgtk-3-dev:arm64 \
|
||||||
|
libglib2.0-dev:arm64 \
|
||||||
|
libwebkit2gtk-4.1-dev:arm64 \
|
||||||
|
libsoup-3.0-dev:arm64 \
|
||||||
|
libayatana-appindicator3-dev:arm64 \
|
||||||
|
librsvg2-dev:arm64
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-linux-arm64-gnu --no-save
|
||||||
|
|
||||||
|
- name: Build Linux bundle (Tauri arm64)
|
||||||
|
env:
|
||||||
|
TAURI_BUILD_TARGET: aarch64-unknown-linux-gnu
|
||||||
|
PKG_CONFIG_PATH: /usr/lib/aarch64-linux-gnu/pkgconfig
|
||||||
|
CC_aarch64_unknown_linux_gnu: aarch64-linux-gnu-gcc
|
||||||
|
CXX_aarch64_unknown_linux_gnu: aarch64-linux-gnu-g++
|
||||||
|
AR_aarch64_unknown_linux_gnu: aarch64-linux-gnu-ar
|
||||||
|
run: npm run build --workspace @codenomad/tauri-app
|
||||||
|
|
||||||
|
- name: Package Tauri artifacts (Linux arm64)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
SEARCH_ROOT="packages/tauri-app/target"
|
||||||
|
ARTIFACT_DIR="packages/tauri-app/release-tauri"
|
||||||
|
rm -rf "$ARTIFACT_DIR"
|
||||||
|
mkdir -p "$ARTIFACT_DIR"
|
||||||
|
shopt -s nullglob globstar
|
||||||
|
first_artifact=$(find "$SEARCH_ROOT" -type f \( -name "*.AppImage" -o -name "*.deb" -o -name "*.rpm" -o -name "*.tar.gz" \) | head -n1)
|
||||||
|
fallback_bin="$SEARCH_ROOT/release/codenomad-tauri"
|
||||||
|
if [ -n "$first_artifact" ]; then
|
||||||
|
zip -j "$ARTIFACT_DIR/CodeNomad-Tauri-${VERSION}-linux-x64.zip" "$first_artifact"
|
||||||
|
elif [ -f "$fallback_bin" ]; then
|
||||||
|
zip -j "$ARTIFACT_DIR/CodeNomad-Tauri-${VERSION}-linux-x64.zip" "$fallback_bin"
|
||||||
|
else
|
||||||
|
echo "No bundled artifact found under $SEARCH_ROOT and no binary at $fallback_bin" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
|
||||||
|
- name: Upload Tauri release assets (Linux arm64)
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s nullglob
|
||||||
|
for file in packages/tauri-app/release-tauri/*.zip; do
|
||||||
|
[ -f "$file" ] || continue
|
||||||
|
echo "Uploading $file"
|
||||||
|
gh release upload "$TAG" "$file" --clobber
|
||||||
|
done
|
||||||
|
|
||||||
|
|
||||||
|
build-linux-rpm:
|
||||||
|
runs-on: ubuntu-24.04
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
VERSION: ${{ inputs.version }}
|
||||||
|
TAG: ${{ inputs.tag }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
cache: npm
|
||||||
|
|
||||||
|
- name: Install rpm packaging dependencies
|
||||||
|
run: |
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y rpm ruby ruby-dev build-essential
|
||||||
|
sudo gem install --no-document fpm
|
||||||
|
|
||||||
|
- name: Set workspace versions
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Install project dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-linux-x64-gnu --no-save
|
||||||
|
|
||||||
|
- name: Build Linux RPM binaries
|
||||||
|
run: npm run build:linux-rpm --workspace @neuralnomads/codenomad-electron-app
|
||||||
|
|
||||||
|
- name: Upload RPM release assets
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
shopt -s nullglob
|
||||||
|
for file in packages/electron-app/release/*.rpm; do
|
||||||
|
[ -f "$file" ] || continue
|
||||||
|
echo "Uploading $file"
|
||||||
|
gh release upload "$TAG" "$file" --clobber
|
||||||
|
done
|
||||||
16
.github/workflows/dev-release.yml
vendored
Normal file
16
.github/workflows/dev-release.yml
vendored
Normal file
@@ -0,0 +1,16 @@
|
|||||||
|
name: Dev Release
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
id-token: write
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
dev-release:
|
||||||
|
uses: ./.github/workflows/reusable-release.yml
|
||||||
|
with:
|
||||||
|
version_suffix: -dev
|
||||||
|
dist_tag: dev
|
||||||
|
secrets: inherit
|
||||||
74
.github/workflows/manual-npm-publish.yml
vendored
Normal file
74
.github/workflows/manual-npm-publish.yml
vendored
Normal file
@@ -0,0 +1,74 @@
|
|||||||
|
name: Manual NPM Publish
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_dispatch:
|
||||||
|
inputs:
|
||||||
|
version:
|
||||||
|
description: "Version to publish (e.g. 0.2.0-dev)"
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
dist_tag:
|
||||||
|
description: "npm dist-tag"
|
||||||
|
required: false
|
||||||
|
default: dev
|
||||||
|
type: string
|
||||||
|
workflow_call:
|
||||||
|
inputs:
|
||||||
|
version:
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
dist_tag:
|
||||||
|
required: false
|
||||||
|
type: string
|
||||||
|
default: dev
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
contents: read
|
||||||
|
id-token: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
publish:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
env:
|
||||||
|
NODE_VERSION: 20
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
registry-url: https://registry.npmjs.org
|
||||||
|
|
||||||
|
- name: Ensure npm >=11.5.1
|
||||||
|
run: npm install -g npm@latest
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm ci --workspaces
|
||||||
|
|
||||||
|
- name: Ensure rollup native binary
|
||||||
|
run: npm install @rollup/rollup-linux-x64-gnu --no-save
|
||||||
|
|
||||||
|
- name: Build server package (includes UI bundling)
|
||||||
|
run: npm run build --workspace @neuralnomads/codenomad
|
||||||
|
|
||||||
|
- name: Set publish metadata
|
||||||
|
shell: bash
|
||||||
|
run: |
|
||||||
|
VERSION_INPUT="${{ inputs.version }}"
|
||||||
|
if [ -z "$VERSION_INPUT" ]; then
|
||||||
|
VERSION_INPUT=$(node -p "require('./package.json').version")
|
||||||
|
fi
|
||||||
|
echo "VERSION=$VERSION_INPUT" >> "$GITHUB_ENV"
|
||||||
|
echo "DIST_TAG=${{ inputs.dist_tag || 'dev' }}" >> "$GITHUB_ENV"
|
||||||
|
|
||||||
|
- name: Bump package version for publish
|
||||||
|
run: npm version ${VERSION} --workspaces --include-workspace-root --no-git-tag-version --allow-same-version
|
||||||
|
|
||||||
|
- name: Publish server package with provenance
|
||||||
|
env:
|
||||||
|
NPM_CONFIG_PROVENANCE: true
|
||||||
|
NPM_CONFIG_REGISTRY: https://registry.npmjs.org
|
||||||
|
run: |
|
||||||
|
npm publish --workspace @neuralnomads/codenomad --access public --tag ${DIST_TAG} --provenance
|
||||||
17
.github/workflows/release.yml
vendored
Normal file
17
.github/workflows/release.yml
vendored
Normal file
@@ -0,0 +1,17 @@
|
|||||||
|
name: Release Binaries
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches:
|
||||||
|
- main
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
id-token: write
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
release:
|
||||||
|
uses: ./.github/workflows/reusable-release.yml
|
||||||
|
with:
|
||||||
|
dist_tag: latest
|
||||||
|
secrets: inherit
|
||||||
80
.github/workflows/reusable-release.yml
vendored
Normal file
80
.github/workflows/reusable-release.yml
vendored
Normal file
@@ -0,0 +1,80 @@
|
|||||||
|
name: Reusable Release
|
||||||
|
|
||||||
|
on:
|
||||||
|
workflow_call:
|
||||||
|
inputs:
|
||||||
|
version_suffix:
|
||||||
|
description: "Suffix appended to package.json version"
|
||||||
|
required: false
|
||||||
|
default: ""
|
||||||
|
type: string
|
||||||
|
dist_tag:
|
||||||
|
description: "npm dist-tag to publish under"
|
||||||
|
required: false
|
||||||
|
default: dev
|
||||||
|
type: string
|
||||||
|
|
||||||
|
permissions:
|
||||||
|
id-token: write
|
||||||
|
contents: write
|
||||||
|
|
||||||
|
env:
|
||||||
|
NODE_VERSION: 20
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
prepare-release:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
outputs:
|
||||||
|
version: ${{ steps.versions.outputs.version }}
|
||||||
|
tag: ${{ steps.versions.outputs.tag }}
|
||||||
|
release_name: ${{ steps.versions.outputs.release_name }}
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Setup Node
|
||||||
|
uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: ${{ env.NODE_VERSION }}
|
||||||
|
|
||||||
|
- name: Compute release versions
|
||||||
|
id: versions
|
||||||
|
env:
|
||||||
|
VERSION_SUFFIX: ${{ inputs.version_suffix }}
|
||||||
|
run: |
|
||||||
|
BASE_VERSION=$(node -p "require('./package.json').version")
|
||||||
|
VERSION="${BASE_VERSION}${VERSION_SUFFIX}"
|
||||||
|
TAG="v${VERSION}"
|
||||||
|
echo "version=$VERSION" >> "$GITHUB_OUTPUT"
|
||||||
|
echo "tag=$TAG" >> "$GITHUB_OUTPUT"
|
||||||
|
echo "release_name=$TAG" >> "$GITHUB_OUTPUT"
|
||||||
|
|
||||||
|
- name: Create GitHub release
|
||||||
|
env:
|
||||||
|
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
TAG: ${{ steps.versions.outputs.tag }}
|
||||||
|
run: |
|
||||||
|
if gh release view "$TAG" >/dev/null 2>&1; then
|
||||||
|
echo "Release $TAG already exists"
|
||||||
|
else
|
||||||
|
gh release create "$TAG" --title "$TAG" --generate-notes
|
||||||
|
fi
|
||||||
|
|
||||||
|
build-and-upload:
|
||||||
|
needs: prepare-release
|
||||||
|
uses: ./.github/workflows/build-and-upload.yml
|
||||||
|
with:
|
||||||
|
version: ${{ needs.prepare-release.outputs.version }}
|
||||||
|
tag: ${{ needs.prepare-release.outputs.tag }}
|
||||||
|
release_name: ${{ needs.prepare-release.outputs.release_name }}
|
||||||
|
secrets: inherit
|
||||||
|
|
||||||
|
publish-server:
|
||||||
|
needs:
|
||||||
|
- prepare-release
|
||||||
|
- build-and-upload
|
||||||
|
uses: ./.github/workflows/manual-npm-publish.yml
|
||||||
|
with:
|
||||||
|
version: ${{ needs.prepare-release.outputs.version }}
|
||||||
|
dist_tag: ${{ inputs.dist_tag }}
|
||||||
|
secrets: inherit
|
||||||
103
.gitignore
vendored
Normal file
103
.gitignore
vendored
Normal file
@@ -0,0 +1,103 @@
|
|||||||
|
# =====================================================
|
||||||
|
# NomadArch - Git Ignore Configuration
|
||||||
|
# Clean public repository version
|
||||||
|
# =====================================================
|
||||||
|
|
||||||
|
# ===================== Dependencies =====================
|
||||||
|
node_modules/
|
||||||
|
.pnpm-store/
|
||||||
|
.yarn/
|
||||||
|
|
||||||
|
# ===================== Build Outputs ====================
|
||||||
|
dist/
|
||||||
|
release/
|
||||||
|
out/
|
||||||
|
*.bundle.js
|
||||||
|
*.bundle.js.map
|
||||||
|
|
||||||
|
# ===================== IDE & Editor =====================
|
||||||
|
.DS_Store
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
.vscode/
|
||||||
|
*.code-workspace
|
||||||
|
.dir-locals.el
|
||||||
|
|
||||||
|
# ===================== Vite / Build Tools ===============
|
||||||
|
.vite/
|
||||||
|
.electron-vite/
|
||||||
|
*.local
|
||||||
|
|
||||||
|
# ===================== Logs & Debug =====================
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
pnpm-debug.log*
|
||||||
|
install.log
|
||||||
|
.tmp-*.log
|
||||||
|
|
||||||
|
# ===================== OS Generated Files ===============
|
||||||
|
Thumbs.db
|
||||||
|
ehthumbs.db
|
||||||
|
Desktop.ini
|
||||||
|
|
||||||
|
# ===================== Temporary Files ==================
|
||||||
|
*.tmp
|
||||||
|
*.temp
|
||||||
|
.tmp-*/
|
||||||
|
.cache/
|
||||||
|
*.bak
|
||||||
|
|
||||||
|
# ===================== Environment & Secrets ============
|
||||||
|
.env
|
||||||
|
.env.local
|
||||||
|
.env.development.local
|
||||||
|
.env.test.local
|
||||||
|
.env.production.local
|
||||||
|
.env*.local
|
||||||
|
*.pem
|
||||||
|
*.key
|
||||||
|
secrets/
|
||||||
|
credentials/
|
||||||
|
|
||||||
|
# ===================== OpenCode Data ====================
|
||||||
|
.opencode/
|
||||||
|
!.opencode/.gitignore
|
||||||
|
|
||||||
|
# ===================== Session & User Data ==============
|
||||||
|
.trae/
|
||||||
|
.agent/artifacts/
|
||||||
|
.backup/
|
||||||
|
.tmp-qwen-code/
|
||||||
|
|
||||||
|
# ===================== MCP Config (may contain keys) ===
|
||||||
|
# Keep the template but user should configure their own
|
||||||
|
# .mcp.json
|
||||||
|
|
||||||
|
# ===================== Test Coverage ====================
|
||||||
|
coverage/
|
||||||
|
.nyc_output/
|
||||||
|
|
||||||
|
# ===================== Electron Build ===================
|
||||||
|
packages/electron-app/dist/
|
||||||
|
packages/electron-app/out/
|
||||||
|
packages/electron-app/release/
|
||||||
|
|
||||||
|
# ===================== UI Build =========================
|
||||||
|
packages/ui/dist/
|
||||||
|
packages/ui/renderer/dist/
|
||||||
|
|
||||||
|
# ===================== Server Build =====================
|
||||||
|
packages/server/dist/
|
||||||
|
|
||||||
|
# ===================== Lock files (optional) ============
|
||||||
|
# package-lock.json
|
||||||
|
# pnpm-lock.yaml
|
||||||
|
# yarn.lock
|
||||||
|
|
||||||
|
# ===================== Backup Files =====================
|
||||||
|
*.backup
|
||||||
|
*_backup*
|
||||||
|
_backup_original/
|
||||||
32
.mcp.json
Normal file
32
.mcp.json
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"sequential-thinking": {
|
||||||
|
"command": "npx",
|
||||||
|
"args": [
|
||||||
|
"-y",
|
||||||
|
"@modelcontextprotocol/server-sequential-thinking"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"desktop-commander": {
|
||||||
|
"command": "npx",
|
||||||
|
"args": [
|
||||||
|
"-y",
|
||||||
|
"@modelcontextprotocol/server-desktop-commander"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"web-reader": {
|
||||||
|
"command": "npx",
|
||||||
|
"args": [
|
||||||
|
"-y",
|
||||||
|
"@modelcontextprotocol/server-web-reader"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"github": {
|
||||||
|
"command": "npx",
|
||||||
|
"args": [
|
||||||
|
"-y",
|
||||||
|
"@modelcontextprotocol/server-github"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
5
.opencode/agent/web_developer.md
Normal file
5
.opencode/agent/web_developer.md
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
---
|
||||||
|
description: Develops Web UI components.
|
||||||
|
mode: all
|
||||||
|
---
|
||||||
|
You are a Web Frontend Developer Agent. Your primary focus is on developing SolidJS UI components, ensuring adherence to modern web best practices, excellent UI/UX, and efficient data integration.
|
||||||
1
.tmp-qwen-code
Submodule
1
.tmp-qwen-code
Submodule
Submodule .tmp-qwen-code added at a92be72e88
@@ -0,0 +1,140 @@
|
|||||||
|
## Implementation Plan: Enhanced Session Compaction System (9 High-Priority Fixes)
|
||||||
|
|
||||||
|
### Phase 1: Core Foundation (Types & Configuration)
|
||||||
|
|
||||||
|
**NEW: `packages/ui/src/stores/session-compaction.ts`**
|
||||||
|
|
||||||
|
1. **Compaction Types & Interfaces**
|
||||||
|
- `CompactionMessageFlags`: summary, mode, provenance flags
|
||||||
|
- `StructuredSummary`: Tier A/B schema with what_was_done, files, current_state, key_decisions, next_steps, blockers, artifacts, tags, provenance
|
||||||
|
- `CompactionEvent`: Audit trail with event_id, timestamp, actor, trigger_reason, token_before/after, model_used, cost_estimate
|
||||||
|
- `CompactionConfig`: autoCompactEnabled, autoCompactThreshold, compactPreserveWindow, pruneReclaimThreshold, userPreference, undoRetentionWindow
|
||||||
|
- `SessionCompactingHook`: Plugin contract for domain-specific rules
|
||||||
|
|
||||||
|
2. **Configuration Store**
|
||||||
|
- Default config: auto=80%, preserve=40k tokens, prune_threshold=20k, preference="ask"
|
||||||
|
- Export functions: `getCompactionConfig()`, `updateCompactionConfig()`
|
||||||
|
|
||||||
|
### Phase 2: Overflow Detection Engine
|
||||||
|
|
||||||
|
**MODIFY: `packages/ui/src/stores/session-compaction.ts`**
|
||||||
|
|
||||||
|
3. **Token Monitoring Functions**
|
||||||
|
- `isOverflowDetected(usage, modelLimit)`: Check if usage >= threshold%
|
||||||
|
- `shouldPruneToolOutputs(usage)`: Check if tool outputs > reclaim threshold
|
||||||
|
- `estimateTokenReduction(before, after)`: Calculate % reduction
|
||||||
|
|
||||||
|
4. **Audit Trail System**
|
||||||
|
- `recordCompactionEvent(sessionId, event)`: Append-only to audit log
|
||||||
|
- `getCompactionHistory(sessionId)`: Retrieve audit trail
|
||||||
|
- `exportAuditLog()`: For compliance/debugging
|
||||||
|
|
||||||
|
### Phase 3: Secrets Detection & Sanitization
|
||||||
|
|
||||||
|
**NEW: `packages/ui/src/lib/secrets-detector.ts`**
|
||||||
|
|
||||||
|
5. **Secrets Detector**
|
||||||
|
- Pattern matching for: api keys, passwords, tokens, secrets, credentials
|
||||||
|
- `redactSecrets(content)`: Returns { clean: string, redactions: { path, reason }[] }
|
||||||
|
- Placeholder format: `[REDACTED: {reason}]`
|
||||||
|
|
||||||
|
### Phase 4: AI-Powered Compaction Agent
|
||||||
|
|
||||||
|
**MODIFY: `packages/ui/src/stores/session-compaction.ts`**
|
||||||
|
|
||||||
|
6. **Compaction Agent Integration**
|
||||||
|
- `COMPACTION_AGENT_PROMPT`: Structured prompt with instructions
|
||||||
|
- `generateCompactionSummary(instanceId, sessionId, window)`: Call sendMessage() to get AI summary
|
||||||
|
- Parse response into Tier A (human) and Tier B (structured JSON)
|
||||||
|
|
||||||
|
7. **Execute Compaction**
|
||||||
|
- `executeCompaction(instanceId, sessionId, mode)`: Main compaction orchestration
|
||||||
|
- Steps: enumerate → plugin hooks → AI summary → sanitize → store → prune → audit
|
||||||
|
- Returns: preview, token estimate, compaction event
|
||||||
|
|
||||||
|
### Phase 5: Pruning Engine
|
||||||
|
|
||||||
|
**MODIFY: `packages/ui/src/stores/session-compaction.ts`**
|
||||||
|
|
||||||
|
8. **Sliding Window Pruning**
|
||||||
|
- `pruneToolOutputs(instanceId, sessionId)`: Maintain queue, prune oldest > threshold
|
||||||
|
- `isToolOutput(part)`: Classify build logs, test logs, large JSON
|
||||||
|
|
||||||
|
### Phase 6: Undo & Rehydration
|
||||||
|
|
||||||
|
**MODIFY: `packages/ui/src/stores/session-compaction.ts`**
|
||||||
|
|
||||||
|
9. **Undo System**
|
||||||
|
- `undoCompaction(sessionId, compactionEventId)`: Rehydrate within retention window
|
||||||
|
- `getCompactedSessionSummary(sessionId)`: Retrieve stored summary
|
||||||
|
- `expandCompactedView(sessionId)`: Return archived messages
|
||||||
|
|
||||||
|
### Phase 7: Integration
|
||||||
|
|
||||||
|
**MODIFY: `packages/ui/src/stores/session-events.ts`**
|
||||||
|
|
||||||
|
10. **Auto-Compact Trigger**
|
||||||
|
- Monitor `EventSessionUpdated` for token usage
|
||||||
|
- Trigger based on user preference (auto/ask/never)
|
||||||
|
- Call existing `showConfirmDialog()` with compaction preview
|
||||||
|
|
||||||
|
**MODIFY: `packages/ui/src/stores/session-actions.ts`**
|
||||||
|
|
||||||
|
11. **Replace compactSession**
|
||||||
|
- Use new `executeCompaction()` function
|
||||||
|
- Support both "prune" and "compact" modes
|
||||||
|
|
||||||
|
### Phase 8: Schema Validation
|
||||||
|
|
||||||
|
**NEW: `packages/ui/src/lib/compaction-validation.ts`**
|
||||||
|
|
||||||
|
12. **Schema Validation**
|
||||||
|
- `validateStructuredSummary(summary)`: Zod schema for Tier B
|
||||||
|
- `validateCompactionEvent(event)`: Zod schema for audit trail
|
||||||
|
- `ValidationErrors` type with path, message, code
|
||||||
|
|
||||||
|
### Phase 9: CI Tests
|
||||||
|
|
||||||
|
**NEW: `packages/ui/src/stores/session-compaction.test.ts`**
|
||||||
|
|
||||||
|
13. **Test Coverage**
|
||||||
|
- `test_overflow_detection`: Verify threshold calculation
|
||||||
|
- `test_secrets_redaction`: Verify patterns are caught
|
||||||
|
- `test_compaction_execution`: Full compaction flow
|
||||||
|
- `test_undo_rehydration`: Verify restore works
|
||||||
|
- `test_plugin_hooks`: Verify custom rules apply
|
||||||
|
|
||||||
|
### Phase 10: Canary Rollout
|
||||||
|
|
||||||
|
**MODIFY: `packages/ui/src/stores/session-compaction.ts`**
|
||||||
|
|
||||||
|
14. **Feature Flag**
|
||||||
|
- `ENABLE_SMART_COMPACTION`: Environment variable or config flag
|
||||||
|
- Default: `false` for canary, set to `true` for full rollout
|
||||||
|
- Graceful degradation: fall back to simple compaction if disabled
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Implementation Order (Priority)
|
||||||
|
|
||||||
|
1. **P0 - Foundation**: Types, config, schema validation (1-2, 12)
|
||||||
|
2. **P0 - Core Engine**: Overflow detection, secrets detector (3-5)
|
||||||
|
3. **P0 - AI Integration**: Compaction agent, execute function (6-7)
|
||||||
|
4. **P1 - Pruning**: Tool output classification, sliding window (8)
|
||||||
|
5. **P1 - Undo**: Rehydration system (9)
|
||||||
|
6. **P1 - Integration**: Session events, actions integration (10-11)
|
||||||
|
7. **P2 - Tests**: CI test coverage (13)
|
||||||
|
8. **P2 - Rollout**: Feature flag, canary enablement (14)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Success Criteria
|
||||||
|
|
||||||
|
- ✅ AI generates meaningful summaries (not just "0 AI responses")
|
||||||
|
- ✅ Overflow detected before context limit exceeded
|
||||||
|
- ✅ Secrets are redacted before storage
|
||||||
|
- ✅ Audit trail tracks every compaction
|
||||||
|
- ✅ Undo works within retention window
|
||||||
|
- ✅ Schema validation prevents corrupt data
|
||||||
|
- ✅ CI tests ensure reliability
|
||||||
|
- ✅ Canary flag allows safe rollout
|
||||||
@@ -0,0 +1,391 @@
|
|||||||
|
# FINAL EXECUTION PLAN - 8 Fixes with Proof Deliverables
|
||||||
|
|
||||||
|
## Fix Summary
|
||||||
|
|
||||||
|
| Fix | Files | Deliverables |
|
||||||
|
|------|--------|-------------|
|
||||||
|
| C1 | Install-Windows.bat, Install-Mac.sh, Install-Linux.sh, Launch-Windows.bat, Launch-Dev-Windows.bat, Launch-Unix.sh | 9 path diffs + `dir packages\ui\dist` verification |
|
||||||
|
| C2 | packages/ui/vite.config.ts, Launch-Dev-Windows.bat, Launch-Dev-Unix.sh (NEW) | vite.config.ts diff + 2 launcher diffs + Vite log showing port |
|
||||||
|
| C3 | Launch-Windows.bat, Launch-Dev-Windows.bat, Launch-Unix.sh | 3 CLI_PORT env var diffs + server log showing port |
|
||||||
|
| C4 | Install-Windows.bat, Install-Mac.sh, Install-Linux.sh | 3 download/checksum diffs + log verification |
|
||||||
|
| C5 | Install-Windows.bat | Certutil parsing diff + hash output |
|
||||||
|
| C6 | Install-Windows.bat, Install-Mac.sh, Install-Linux.sh | 3 TARGET_DIR/BIN_DIR diffs + fallback test output |
|
||||||
|
| C7 | Install-Windows.bat, Install-Mac.sh, Install-Linux.sh | 3 health check path diffs + health check output |
|
||||||
|
| C8 | Launch-Dev-Windows.bat | 1 path diff + grep verification |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C1: UI Build Path Correction
|
||||||
|
|
||||||
|
**Files:** Install-Windows.bat (lines 194, 245), Install-Mac.sh (204, 256), Install-Linux.sh (220, 272), Launch-Windows.bat (185), Launch-Dev-Windows.bat (144), Launch-Unix.sh (178)
|
||||||
|
|
||||||
|
**Diff:**
|
||||||
|
```batch
|
||||||
|
# All Windows scripts - replace:
|
||||||
|
packages\ui\src\renderer\dist
|
||||||
|
# With:
|
||||||
|
packages\ui\dist
|
||||||
|
|
||||||
|
# All Unix scripts - replace:
|
||||||
|
packages/ui/src/renderer/dist
|
||||||
|
# With:
|
||||||
|
packages/ui/dist
|
||||||
|
```
|
||||||
|
|
||||||
|
**Verification:** `dir packages\ui\dist` + `dir packages\ui\dist\index.html`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C2: Vite Dev Server Port Wiring
|
||||||
|
|
||||||
|
**File 1: packages/ui/vite.config.ts (line 23)**
|
||||||
|
|
||||||
|
```diff
|
||||||
|
- server: {
|
||||||
|
- port: 3000,
|
||||||
|
- },
|
||||||
|
+ server: {
|
||||||
|
+ port: Number(process.env.VITE_PORT ?? 3000),
|
||||||
|
+ },
|
||||||
|
```
|
||||||
|
|
||||||
|
**File 2: Launch-Dev-Windows.bat (after port detection)**
|
||||||
|
|
||||||
|
```diff
|
||||||
|
- start "NomadArch UI" cmd /k "cd /d \"%~dp0packages\ui\" && set VITE_PORT=!UI_PORT! && npm run dev"
|
||||||
|
+ start "NomadArch UI" cmd /k "cd /d \"%~dp0packages\ui\" && set VITE_PORT=!UI_PORT! && npm run dev -- --port !UI_PORT!"
|
||||||
|
```
|
||||||
|
|
||||||
|
**File 3: Launch-Dev-Unix.sh (NEW FILE)**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
set -e
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
cd "$SCRIPT_DIR"
|
||||||
|
|
||||||
|
# Port detection
|
||||||
|
DEFAULT_SERVER_PORT=3001
|
||||||
|
DEFAULT_UI_PORT=5173
|
||||||
|
SERVER_PORT=$DEFAULT_SERVER_PORT
|
||||||
|
UI_PORT=$DEFAULT_UI_PORT
|
||||||
|
|
||||||
|
echo "[INFO] Detecting available ports..."
|
||||||
|
|
||||||
|
# Server port (3001-3050)
|
||||||
|
for port in {3001..3050}; do
|
||||||
|
if ! lsof -i :$port -sTCP:LISTEN -t > /dev/null 2>&1; then
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
# UI port (5173-5200)
|
||||||
|
for port in {5173..5200}; do
|
||||||
|
if ! lsof -i :$port -sTCP:LISTEN -t > /dev/null 2>&1; then
|
||||||
|
UI_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
echo "[INFO] Using server port: $SERVER_PORT"
|
||||||
|
echo "[INFO] Using UI port: $UI_PORT"
|
||||||
|
|
||||||
|
# Start server with CLI_PORT
|
||||||
|
echo "[INFO] Starting Backend Server..."
|
||||||
|
cd packages/server
|
||||||
|
export CLI_PORT=$SERVER_PORT
|
||||||
|
npm run dev &
|
||||||
|
SERVER_PID=$!
|
||||||
|
|
||||||
|
sleep 3
|
||||||
|
|
||||||
|
# Start UI with VITE_PORT + --port flag
|
||||||
|
echo "[INFO] Starting Frontend UI..."
|
||||||
|
cd "$SCRIPT_DIR/packages/ui"
|
||||||
|
export VITE_PORT=$UI_PORT
|
||||||
|
npm run dev -- --port $UI_PORT &
|
||||||
|
UI_PID=$!
|
||||||
|
|
||||||
|
sleep 3
|
||||||
|
|
||||||
|
# Start Electron
|
||||||
|
echo "[INFO] Starting Electron..."
|
||||||
|
cd "$SCRIPT_DIR/packages/electron-app"
|
||||||
|
npm run dev
|
||||||
|
|
||||||
|
# Cleanup on exit
|
||||||
|
trap "kill $SERVER_PID $UI_PID 2>/dev/null; exit" INT TERM
|
||||||
|
```
|
||||||
|
|
||||||
|
**Verification:** Vite log output showing `Local: http://localhost:<detected_port>`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C3: Server Port Environment Variable
|
||||||
|
|
||||||
|
**Launch-Windows.bat (before npm run dev:electron):**
|
||||||
|
|
||||||
|
```diff
|
||||||
|
echo [INFO] Starting NomadArch...
|
||||||
|
set SERVER_URL=http://localhost:!SERVER_PORT!
|
||||||
|
echo [INFO] Server will run on http://localhost:!SERVER_PORT!
|
||||||
|
+
|
||||||
|
+ set CLI_PORT=!SERVER_PORT!
|
||||||
|
call npm run dev:electron
|
||||||
|
```
|
||||||
|
|
||||||
|
**Launch-Dev-Windows.bat (server start command):**
|
||||||
|
|
||||||
|
```diff
|
||||||
|
echo [INFO] Starting Backend Server...
|
||||||
|
- start "NomadArch Server" cmd /k "cd /d \"%~dp0packages\server\" && npm run dev"
|
||||||
|
+ start "NomadArch Server" cmd /k "cd /d \"%~dp0packages\server\" && set CLI_PORT=!SERVER_PORT! && npm run dev"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Launch-Unix.sh (before npm run dev:electron):**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Starting NomadArch..."
|
||||||
|
SERVER_URL="http://localhost:$SERVER_PORT"
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Server will run on http://localhost:$SERVER_PORT"
|
||||||
|
|
||||||
|
export CLI_PORT=$SERVER_PORT
|
||||||
|
npm run dev:electron
|
||||||
|
```
|
||||||
|
|
||||||
|
**Verification:** Server log showing `CodeNomad Server is ready at http://127.0.0.1:<detected_port>`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C4: OpenCode Download with Dynamic Version + Checksum
|
||||||
|
|
||||||
|
**Install-Windows.bat (lines 165-195):**
|
||||||
|
|
||||||
|
```batch
|
||||||
|
set TARGET_DIR=%SCRIPT_DIR%
|
||||||
|
set BIN_DIR=%TARGET_DIR%\bin
|
||||||
|
if not exist "%BIN_DIR%" mkdir "%BIN_DIR%"
|
||||||
|
|
||||||
|
:: Resolve latest version from GitHub API
|
||||||
|
echo [INFO] Resolving latest OpenCode version...
|
||||||
|
for /f "delims=" %%v in ('curl -s https://api.github.com/repos/sst/opencode/releases/latest ^| findstr "\"tag_name\""') do (
|
||||||
|
set OPENCODE_VERSION=%%v
|
||||||
|
set OPENCODE_VERSION=!OPENCODE_VERSION:~18,-2!
|
||||||
|
)
|
||||||
|
|
||||||
|
set OPENCODE_BASE=https://github.com/sst/opencode/releases/download/v%OPENCODE_VERSION%
|
||||||
|
set OPENCODE_URL=%OPENCODE_BASE%/opencode-windows-%ARCH%.exe
|
||||||
|
set CHECKSUM_URL=%OPENCODE_BASE%/checksums.txt
|
||||||
|
|
||||||
|
if exist "%BIN_DIR%\opencode.exe" (
|
||||||
|
echo [OK] OpenCode binary already exists
|
||||||
|
) else (
|
||||||
|
echo [INFO] Downloading OpenCode v%OPENCODE_VERSION%...
|
||||||
|
echo Downloading from: %OPENCODE_URL%
|
||||||
|
|
||||||
|
:: Download binary to BIN_DIR
|
||||||
|
curl -L -o "%BIN_DIR%\opencode.exe.tmp" "%OPENCODE_URL%"
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [ERROR] Download failed!
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :skip_opencode
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Download checksums
|
||||||
|
curl -L -o "%BIN_DIR%\checksums.txt" "%CHECKSUM_URL%"
|
||||||
|
|
||||||
|
:: Extract expected checksum
|
||||||
|
set EXPECTED_HASH=
|
||||||
|
for /f "tokens=1,2" %%h in ('type "%BIN_DIR%\checksums.txt" ^| findstr /i "opencode-windows-%ARCH%"') do (
|
||||||
|
set EXPECTED_HASH=%%h
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Calculate actual hash (line 2 from certutil)
|
||||||
|
set ACTUAL_HASH=
|
||||||
|
for /f "skip=1 tokens=*" %%h in ('certutil -hashfile "%BIN_DIR%\opencode.exe.tmp" SHA256 ^| findstr /v "CertUtil" ^| findstr /v "hash of"') do (
|
||||||
|
set ACTUAL_HASH=%%h
|
||||||
|
goto :hash_found
|
||||||
|
)
|
||||||
|
:hash_found
|
||||||
|
|
||||||
|
:: Verify and output hashes
|
||||||
|
echo Expected hash: !EXPECTED_HASH!
|
||||||
|
echo Actual hash: !ACTUAL_HASH!
|
||||||
|
|
||||||
|
if "!ACTUAL_HASH!"=="!EXPECTED_HASH!" (
|
||||||
|
move /Y "%BIN_DIR%\opencode.exe.tmp" "%BIN_DIR%\opencode.exe"
|
||||||
|
echo [OK] OpenCode downloaded and verified
|
||||||
|
echo [%date% %time%] OpenCode v%OPENCODE_VERSION% downloaded, checksum verified >> "%TARGET_DIR%\install.log"
|
||||||
|
) else (
|
||||||
|
echo [ERROR] Checksum mismatch!
|
||||||
|
del "%BIN_DIR%\opencode.exe.tmp"
|
||||||
|
set /a ERRORS+=1
|
||||||
|
)
|
||||||
|
)
|
||||||
|
:skip_opencode
|
||||||
|
```
|
||||||
|
|
||||||
|
**Install-Mac.sh / Install-Linux.sh:** Similar pattern with `opencode-darwin-${ARCH}` and `opencode-linux-${ARCH}`, using `TARGET_DIR/bin`
|
||||||
|
|
||||||
|
**Verification:** Log shows `OpenCode v<x.y.z> downloaded, checksum verified` + `ls TARGET_DIR/bin/opencode` exists
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C5: Windows Checksum Parsing
|
||||||
|
|
||||||
|
**Included in C4 above.** Key change:
|
||||||
|
|
||||||
|
```batch
|
||||||
|
:: Parse certutil output - hash is on line 2
|
||||||
|
for /f "skip=1 tokens=*" %%h in ('certutil -hashfile "%BIN_DIR%\opencode.exe.tmp" SHA256 ^| findstr /v "CertUtil" ^| findstr /v "hash of"') do (
|
||||||
|
set ACTUAL_HASH=%%h
|
||||||
|
goto :hash_found
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Verification:** Output shows matching hashes:
|
||||||
|
```
|
||||||
|
Expected hash: abc123def456...
|
||||||
|
Actual hash: abc123def456...
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C6: Permission Fallback with TARGET_DIR/BIN_DIR
|
||||||
|
|
||||||
|
**Install-Windows.bat (lines 125-160):**
|
||||||
|
|
||||||
|
```batch
|
||||||
|
set TARGET_DIR=%SCRIPT_DIR%
|
||||||
|
set BIN_DIR=%TARGET_DIR%\bin
|
||||||
|
set NEEDS_FALLBACK=0
|
||||||
|
|
||||||
|
echo [STEP 2/10] Checking Write Permissions...
|
||||||
|
echo.
|
||||||
|
|
||||||
|
echo. > "%SCRIPT_DIR%\test-write.tmp" 2>nul
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Cannot write to current directory: %SCRIPT_DIR%
|
||||||
|
echo [INFO] Setting fallback for install outputs...
|
||||||
|
|
||||||
|
set TARGET_DIR=%USERPROFILE%\NomadArch-Install
|
||||||
|
set BIN_DIR=%TARGET_DIR%\bin
|
||||||
|
if not exist "%TARGET_DIR%" mkdir "%TARGET_DIR%"
|
||||||
|
if not exist "%BIN_DIR%" mkdir "%BIN_DIR%"
|
||||||
|
|
||||||
|
echo. > "%TARGET_DIR%\test-write.tmp" 2>nul
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [ERROR] Cannot write to fallback directory either!
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :final_check
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [OK] Using fallback for outputs: %TARGET_DIR%
|
||||||
|
echo [%date% %time%] Using fallback: %TARGET_DIR% >> "%TARGET_DIR%\install.log"
|
||||||
|
set NEEDS_FALLBACK=1
|
||||||
|
del "%TARGET_DIR%\test-write.tmp"
|
||||||
|
) else (
|
||||||
|
if not exist "%BIN_DIR%" mkdir "%BIN_DIR%"
|
||||||
|
del "%SCRIPT_DIR%\test-write.tmp"
|
||||||
|
echo [OK] Write permissions verified
|
||||||
|
)
|
||||||
|
|
||||||
|
:: All log writes use TARGET_DIR
|
||||||
|
set LOG_FILE=%TARGET_DIR%\install.log
|
||||||
|
```
|
||||||
|
|
||||||
|
**Install-Mac.sh / Install-Linux.sh:** Similar pattern with `TARGET_DIR=$HOME/.nomadarch-install`, `BIN_DIR=$TARGET_DIR/bin`
|
||||||
|
|
||||||
|
**Verification:** Run from read-only directory, output shows `Using fallback for outputs: C:\Users\xxx\NomadArch-Install`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C7: Health Check Path Corrections
|
||||||
|
|
||||||
|
**Install-Windows.bat (health check section):**
|
||||||
|
|
||||||
|
```diff
|
||||||
|
:: UI health check
|
||||||
|
- if exist "%SCRIPT_DIR%\packages\ui\src\renderer\dist" (
|
||||||
|
+ if exist "%SCRIPT_DIR%\packages\ui\dist\index.html" (
|
||||||
|
echo [OK] UI build directory exists
|
||||||
|
) else (
|
||||||
|
- echo [ERROR] UI build directory not found
|
||||||
|
+ echo [ERROR] UI build directory not found at packages\ui\dist
|
||||||
|
set /a HEALTH_ERRORS+=1
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Electron health check
|
||||||
|
- if exist "%SCRIPT_DIR%\packages\electron-app\dist\main.js" (
|
||||||
|
+ if exist "%SCRIPT_DIR%\packages\electron-app\dist\main\main.js" (
|
||||||
|
echo [OK] Electron main.js exists
|
||||||
|
) else (
|
||||||
|
echo [WARN] Electron build not found (will build on launch)
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Install-Mac.sh / Install-Linux.sh:** Same logic with shell syntax
|
||||||
|
|
||||||
|
**Verification:** Health check output:
|
||||||
|
```
|
||||||
|
[OK] UI build directory exists
|
||||||
|
[OK] Electron main.js exists
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## C8: Launch-Dev-Windows Electron Path Fix
|
||||||
|
|
||||||
|
**Launch-Dev-Windows.bat line 162:**
|
||||||
|
|
||||||
|
```diff
|
||||||
|
- if not exist "electron-app\dist\main.js" (
|
||||||
|
+ if not exist "packages\electron-app\dist\main\main.js" (
|
||||||
|
```
|
||||||
|
|
||||||
|
**Verification:** `grep -n "electron-app" Launch-Dev-Windows.bat` shows no `electron-app\` references remaining
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Execution Order
|
||||||
|
|
||||||
|
1. C6 (TARGET_DIR/BIN_DIR) - Foundation for C4
|
||||||
|
2. C7 (Health checks) - Independent path fixes
|
||||||
|
3. C1 (UI paths) - Quick path replacements
|
||||||
|
4. C8 (Launch-Dev-Windows) - Quick path fix
|
||||||
|
5. C2 (Vite port) - Includes new file creation
|
||||||
|
6. C3 (Server port) - Quick env var changes
|
||||||
|
7. C4 (OpenCode download) - Depends on C6, includes C5
|
||||||
|
8. **Run build** for C1/C7 verification
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Verification Commands to Run
|
||||||
|
|
||||||
|
| Fix | Command | Expected Output |
|
||||||
|
|------|----------|----------------|
|
||||||
|
| C1 | `dir packages\ui\dist` | Shows `index.html`, `assets/` |
|
||||||
|
| C2 | Run Launch-Dev, check Vite log | `Local: http://localhost:3001` |
|
||||||
|
| C3 | Run launcher, check server log | `CodeNomad Server is ready at http://127.0.0.1:3001` |
|
||||||
|
| C4 | Run install, grep log | `OpenCode v<x.y.z> downloaded, checksum verified` |
|
||||||
|
| C5 | Run install, check log | Hashes match in output |
|
||||||
|
| C6 | Run from read-only dir | `Using fallback: C:\Users\xxx\NomadArch-Install` |
|
||||||
|
| C7 | Run install, check output | `UI build directory exists` + `Electron main.js exists` |
|
||||||
|
| C8 | `grep -n "electron-app" Launch-Dev-Windows.bat` | Only `packages\electron-app` or commented lines |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Files Modified/Created
|
||||||
|
|
||||||
|
| File | Action |
|
||||||
|
|------|--------|
|
||||||
|
| Install-Windows.bat | Edit (C1, C4, C5, C6, C7) |
|
||||||
|
| Install-Mac.sh | Edit (C1, C4, C6, C7) |
|
||||||
|
| Install-Linux.sh | Edit (C1, C4, C6, C7) |
|
||||||
|
| Launch-Windows.bat | Edit (C1, C3) |
|
||||||
|
| Launch-Dev-Windows.bat | Edit (C1, C2, C3, C8) |
|
||||||
|
| Launch-Unix.sh | Edit (C1, C3) |
|
||||||
|
| Launch-Dev-Unix.sh | CREATE (C2) |
|
||||||
|
| packages/ui/vite.config.ts | Edit (C2) |
|
||||||
20
AGENTS.md
Normal file
20
AGENTS.md
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
# AGENT NOTES
|
||||||
|
|
||||||
|
## Styling Guidelines
|
||||||
|
- Reuse the existing token & utility layers before introducing new CSS variables or custom properties. Extend `src/styles/tokens.css` / `src/styles/utilities.css` if a shared pattern is needed.
|
||||||
|
- Keep aggregate entry files (e.g., `src/styles/controls.css`, `messaging.css`, `panels.css`) lean—they should only `@import` feature-specific subfiles located inside `src/styles/{components|messaging|panels}`.
|
||||||
|
- When adding new component styles, place them beside their peers in the scoped subdirectory (e.g., `src/styles/messaging/new-part.css`) and import them from the corresponding aggregator file.
|
||||||
|
- Prefer smaller, focused style files (≈150 lines or less) over large monoliths. Split by component or feature area if a file grows beyond that size.
|
||||||
|
- Co-locate reusable UI patterns (buttons, selectors, dropdowns, etc.) under `src/styles/components/` and avoid redefining the same utility classes elsewhere.
|
||||||
|
- Document any new styling conventions or directory additions in this file so future changes remain consistent.
|
||||||
|
|
||||||
|
## Coding Principles
|
||||||
|
- Favor KISS by keeping modules narrowly scoped and limiting public APIs to what callers actually need.
|
||||||
|
- Uphold DRY: share helpers via dedicated modules before copy/pasting logic across stores, components, or scripts.
|
||||||
|
- Enforce single responsibility; split large files when concerns diverge (state, actions, API, events, etc.).
|
||||||
|
- Prefer composable primitives (signals, hooks, utilities) over deep inheritance or implicit global state.
|
||||||
|
- When adding platform integrations (SSE, IPC, SDK), isolate them in thin adapters that surface typed events/actions.
|
||||||
|
|
||||||
|
## Tooling Preferences
|
||||||
|
- Use the `edit` tool for modifying existing files; prefer it over other editing methods.
|
||||||
|
- Use the `write` tool only when creating new files from scratch.
|
||||||
263
BUILD.md
Normal file
263
BUILD.md
Normal file
@@ -0,0 +1,263 @@
|
|||||||
|
# Building CodeNomad Binaries
|
||||||
|
|
||||||
|
This guide explains how to build distributable binaries for CodeNomad.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- **Bun** - Package manager and runtime
|
||||||
|
- **Node.js** - For electron-builder
|
||||||
|
- **Electron Builder** - Installed via devDependencies
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
All commands now run inside the workspace packages. From the repo root you can target the Electron app package directly:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run build --workspace @neuralnomads/codenomad-electron-app
|
||||||
|
```
|
||||||
|
|
||||||
|
### Build for Current Platform (macOS default)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bun run build:binaries
|
||||||
|
```
|
||||||
|
|
||||||
|
This builds for macOS (Universal - Intel + Apple Silicon) by default.
|
||||||
|
|
||||||
|
## Platform-Specific Builds
|
||||||
|
|
||||||
|
### macOS
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Universal (Intel + Apple Silicon) - Recommended
|
||||||
|
bun run build:mac
|
||||||
|
|
||||||
|
# Intel only (x64)
|
||||||
|
bun run build:mac-x64
|
||||||
|
|
||||||
|
# Apple Silicon only (ARM64)
|
||||||
|
bun run build:mac-arm64
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output formats:** `.dmg`, `.zip`
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# x64 (64-bit Intel/AMD)
|
||||||
|
bun run build:win
|
||||||
|
|
||||||
|
# ARM64 (Windows on ARM)
|
||||||
|
bun run build:win-arm64
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output formats:** `.exe` (NSIS installer), `.zip`
|
||||||
|
|
||||||
|
### Linux
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# x64 (64-bit)
|
||||||
|
bun run build:linux
|
||||||
|
|
||||||
|
# ARM64
|
||||||
|
bun run build:linux-arm64
|
||||||
|
```
|
||||||
|
|
||||||
|
**Output formats:** `.AppImage`, `.deb`, `.tar.gz`
|
||||||
|
|
||||||
|
### Build All Platforms
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bun run build:all
|
||||||
|
```
|
||||||
|
|
||||||
|
⚠️ **Note:** Cross-platform builds may have limitations. Build on the target platform for best results.
|
||||||
|
|
||||||
|
## Build Process
|
||||||
|
|
||||||
|
The build script performs these steps:
|
||||||
|
|
||||||
|
1. **Build @neuralnomads/codenomad** → Produces the CLI `dist/` bundle (also rebuilds the UI assets it serves)
|
||||||
|
2. **Compile TypeScript + bundle with Vite** → Electron main, preload, and renderer output in `dist/`
|
||||||
|
3. **Package with electron-builder** → Platform-specific binaries
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
Binaries are generated in the `release/` directory:
|
||||||
|
|
||||||
|
```
|
||||||
|
release/
|
||||||
|
├── CodeNomad-0.1.0-mac-universal.dmg
|
||||||
|
├── CodeNomad-0.1.0-mac-universal.zip
|
||||||
|
├── CodeNomad-0.1.0-win-x64.exe
|
||||||
|
├── CodeNomad-0.1.0-linux-x64.AppImage
|
||||||
|
└── ...
|
||||||
|
```
|
||||||
|
|
||||||
|
## File Naming Convention
|
||||||
|
|
||||||
|
```
|
||||||
|
CodeNomad-{version}-{os}-{arch}.{ext}
|
||||||
|
```
|
||||||
|
|
||||||
|
- **version**: From package.json (e.g., `0.1.0`)
|
||||||
|
- **os**: `mac`, `win`, `linux`
|
||||||
|
- **arch**: `x64`, `arm64`, `universal`
|
||||||
|
- **ext**: `dmg`, `zip`, `exe`, `AppImage`, `deb`, `tar.gz`
|
||||||
|
|
||||||
|
## Platform Requirements
|
||||||
|
|
||||||
|
### macOS
|
||||||
|
|
||||||
|
- **Build on:** macOS 10.13+
|
||||||
|
- **Run on:** macOS 10.13+
|
||||||
|
- **Code signing:** Optional (recommended for distribution)
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
- **Build on:** Windows 10+, macOS, or Linux
|
||||||
|
- **Run on:** Windows 10+
|
||||||
|
- **Code signing:** Optional (recommended for distribution)
|
||||||
|
|
||||||
|
### Linux
|
||||||
|
|
||||||
|
- **Build on:** Any platform
|
||||||
|
- **Run on:** Ubuntu 18.04+, Debian 10+, Fedora 32+, Arch
|
||||||
|
- **Dependencies:** Varies by distro
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Build fails on macOS
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install Xcode Command Line Tools
|
||||||
|
xcode-select --install
|
||||||
|
```
|
||||||
|
|
||||||
|
### Build fails on Linux
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install dependencies (Debian/Ubuntu)
|
||||||
|
sudo apt-get install -y rpm
|
||||||
|
|
||||||
|
# Install dependencies (Fedora)
|
||||||
|
sudo dnf install -y rpm-build
|
||||||
|
```
|
||||||
|
|
||||||
|
### "electron-builder not found"
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install dependencies
|
||||||
|
bun install
|
||||||
|
```
|
||||||
|
|
||||||
|
### Build is slow
|
||||||
|
|
||||||
|
- Use platform-specific builds instead of `build:all`
|
||||||
|
- Close other applications to free up resources
|
||||||
|
- Use SSD for faster I/O
|
||||||
|
|
||||||
|
## Development vs Production
|
||||||
|
|
||||||
|
**Development:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bun run dev # Hot reload, no packaging
|
||||||
|
```
|
||||||
|
|
||||||
|
**Production:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
bun run build:binaries # Full build + packaging
|
||||||
|
```
|
||||||
|
|
||||||
|
## CI/CD Integration
|
||||||
|
|
||||||
|
Example GitHub Actions workflow:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
name: Build Binaries
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
tags:
|
||||||
|
- "v*"
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build-mac:
|
||||||
|
runs-on: macos-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v3
|
||||||
|
- uses: oven-sh/setup-bun@v1
|
||||||
|
- run: bun install
|
||||||
|
- run: bun run build:mac
|
||||||
|
|
||||||
|
build-win:
|
||||||
|
runs-on: windows-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v3
|
||||||
|
- uses: oven-sh/setup-bun@v1
|
||||||
|
- run: bun install
|
||||||
|
- run: bun run build:win
|
||||||
|
|
||||||
|
build-linux:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v3
|
||||||
|
- uses: oven-sh/setup-bun@v1
|
||||||
|
- run: bun install
|
||||||
|
- run: bun run build:linux
|
||||||
|
```
|
||||||
|
|
||||||
|
## Advanced Configuration
|
||||||
|
|
||||||
|
Edit `package.json` → `build` section to customize:
|
||||||
|
|
||||||
|
- App icon
|
||||||
|
- Code signing
|
||||||
|
- Installer options
|
||||||
|
- File associations
|
||||||
|
- Auto-update settings
|
||||||
|
|
||||||
|
See [electron-builder docs](https://www.electron.build/) for details.
|
||||||
|
|
||||||
|
## Brand Assets
|
||||||
|
|
||||||
|
- `images/CodeNomad-Icon.png` — primary asset for in-app logo placements and the 1024×1024 master icon used to generate packaged app icons
|
||||||
|
|
||||||
|
To update the binaries:
|
||||||
|
|
||||||
|
1. Run `node scripts/generate-icons.js images/CodeNomad-Icon.png electron/resources` to round the corners and emit fresh `icon.icns`, `icon.ico`, and `icon.png` files.
|
||||||
|
2. (Optional) Pass `--radius` to tweak the corner curvature or `--name` to change the filename prefix.
|
||||||
|
3. If you prefer manual control, export `images/CodeNomad-Icon.png` with your tool of choice and place the generated files in `electron/resources/`.
|
||||||
|
|
||||||
|
## Clean Build
|
||||||
|
|
||||||
|
Remove previous builds:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
rm -rf release/ dist/
|
||||||
|
bun run build:binaries
|
||||||
|
```
|
||||||
|
|
||||||
|
## FAQ
|
||||||
|
|
||||||
|
**Q: Can I build for Windows on macOS?**
|
||||||
|
A: Yes, but native binaries (e.g., DMG) require the target OS.
|
||||||
|
|
||||||
|
**Q: How large are the binaries?**
|
||||||
|
A: Approximately 100-150 MB (includes Electron runtime).
|
||||||
|
|
||||||
|
**Q: Do I need code signing?**
|
||||||
|
A: Not required, but recommended for public distribution to avoid security warnings.
|
||||||
|
|
||||||
|
**Q: How do I update the version?**
|
||||||
|
A: Update `version` in `package.json`, then rebuild.
|
||||||
|
|
||||||
|
## Support
|
||||||
|
|
||||||
|
For issues or questions:
|
||||||
|
|
||||||
|
- Check [electron-builder documentation](https://www.electron.build/)
|
||||||
|
- Open an issue in the repository
|
||||||
|
- Review existing build logs in `release/`
|
||||||
819
Dev Chat with IDEs/GLM 4.7 Progress Log.txt
Normal file
819
Dev Chat with IDEs/GLM 4.7 Progress Log.txt
Normal file
@@ -0,0 +1,819 @@
|
|||||||
|
SOLO Coder
|
||||||
|
|
||||||
|
Thought process
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Fix multix chat auto-scroll for new messages and streaming
|
||||||
|
|
||||||
|
Fixed multix chat auto-scroll for new messages and streaming. Added a createEffect that monitors message changes and automatically scrolls to bottom when:
|
||||||
|
1. New messages arrive
|
||||||
|
2. During streaming (when isAgentThinking is true)
|
||||||
|
|
||||||
|
The effect uses requestAnimationFrame and setTimeout(50ms) for smooth scrolling.
|
||||||
|
|
||||||
|
0/1 done
|
||||||
|
|
||||||
|
Fix multix chat auto-scroll for new messages and streaming
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\stores\session-events.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'scrollToBottom|scrollIntoView|setShouldScroll'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'addMessage|updateMessage|createMessage'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'EventContentDelta|EventMessageDone'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'case.*session\.message|handleMessageUpdate'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Let me look at the sendMessage function and add auto-scroll when new content arrives:
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Now I can see the issue. There's a comment saying auto-scroll is handled in two places, but the second place (during streaming) is missing. Let me add the auto-scroll effect:
|
||||||
|
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
multi-task-chat.tsx
|
||||||
|
packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
+ 11 - 1
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Let me check if scrollToBottom function exists:
|
||||||
|
|
||||||
|
Search codebase for 'function scrollToBottom|const scrollToBottom'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
NomadArch
|
||||||
|
Auto Run
|
||||||
|
Terminal
|
||||||
|
|
||||||
|
cd "e:\TRAE Playground\NeuralNomadsAi\NomadArch" && npm run typecheck 2>&1 | Select-Object -First 20
|
||||||
|
|
||||||
|
(TraeAI-8) E:\TRAE Playground\NeuralNomadsAi\NomadArch [0:0] $ cd "e:\TRAE Playground\NeuralNomadsAi\NomadArch" && npm run typecheck 2>&1 | Select-Object -First 20
|
||||||
|
|
||||||
|
> nomadarch-workspace@0.4.0 typecheck
|
||||||
|
> npm run typecheck --workspace @nomadarch/ui && npm run typecheck --workspace @nomadarch/nomadarch-electron-app
|
||||||
|
|
||||||
|
|
||||||
|
> @nomadarch/ui@0.4.0 typecheck
|
||||||
|
> tsc --noEmit -p tsconfig.json
|
||||||
|
|
||||||
|
|
||||||
|
> @nomadarch/nomadarch-electron-app@0.4.0 typecheck
|
||||||
|
> tsc --noEmit -p tsconfig.json
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
1/1 done
|
||||||
|
|
||||||
|
Fix multix chat auto-scroll for new messages and streaming
|
||||||
|
|
||||||
|
## Auto-Scroll Fixed for Multix Chat!
|
||||||
|
File : packages/ui/src/components/chat/multi-task-chat.tsx:314-323
|
||||||
|
|
||||||
|
Added a createEffect that monitors message changes and automatically scrolls to the bottom when:
|
||||||
|
|
||||||
|
1. New messages arrive
|
||||||
|
2. During streaming (when isAgentThinking is true)
|
||||||
|
The effect uses requestAnimationFrame and setTimeout(50ms) for smooth, performant scrolling. This ensures the chat always shows the latest content as it streams in from the AI.
|
||||||
|
|
||||||
|
### All Issues Fixed:
|
||||||
|
1. ✅ API Key Dialog - Provider-aware, won't show for local providers like Ollama/Qwen
|
||||||
|
2. ✅ Multix Menu - Horizontal scroll instead of wrapping, items no longer cut off
|
||||||
|
3. ✅ Auto-Scroll - Chat automatically scrolls when new messages arrive or streaming
|
||||||
|
|
||||||
|
Artifacts
|
||||||
|
|
||||||
|
1 file changed + 11 - 1
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
multi-task-chat.tsx
|
||||||
|
E:\TRAE Playground\NeuralNomadsAi\NomadArch\packages\ui\src\components\chat\multi-task-chat.tsx
|
||||||
|
|
||||||
|
+ 11 - 1
|
||||||
|
|
||||||
|
Rom283
|
||||||
|
|
||||||
|
de_modules/@suid/base/BackdropUnstyled/index.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/Cancel.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/CheckBox.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/CheckBoxOutlineBlank.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/IndeterminateCheckBox.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/TextareaAutosize/index.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/ArrowDropDown.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/NativeSelect/NativeSelectInput.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/OutlinedInput/NotchedOutline.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/FirstPage.jsx status=304 durationMs=3
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/NavigateBefore.jsx status=304 durationMs=3
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/NavigateNext.jsx status=304 durationMs=3
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/LastPage.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/Radio/RadioButtonIcon.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/Select/SelectInput.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/Star.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/StarBorder.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/Portal/index.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/PopperUnstyled/index.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/ButtonBase/Ripple.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/Transition/Transition.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/ModalUnstyled/ModalUnstyled.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/BadgeUnstyled/BadgeUnstyled.jsx status=304 durationMs=2
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/MoreHoriz.jsx status=304 durationMs=3
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/BackdropUnstyled/BackdropUnstyled.jsx status=304 durationMs=3
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/TextareaAutosize/TextareaAutosize.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/TextareaAutosize/TextareaAutosizeProps.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/Portal/Portal.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/RadioButtonChecked.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/material/internal/svg-icons/RadioButtonUnchecked.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/node_modules/@suid/base/PopperUnstyled/PopperUnstyled.jsx status=304 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/api/config/app status=200 durationMs=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/api/workspaces status=200 durationMs=1
|
||||||
|
|
||||||
|
[cli] failed to load CLI view: Error: (-3) loading 'http://localhost:3000/'
|
||||||
|
|
||||||
|
at rejectAndCleanup (node:electron/js2c/browser_init:2:79837)
|
||||||
|
|
||||||
|
at WebContents.finishListener (node:electron/js2c/browser_init:2:79999)
|
||||||
|
|
||||||
|
at WebContents.emit (node:events:519:28) {
|
||||||
|
|
||||||
|
errno: -3,
|
||||||
|
|
||||||
|
code: '',
|
||||||
|
|
||||||
|
url: 'http://localhost:3000/'
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [sse] SSE client connected clientId=1
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/api/workspaces/mjhl6zmm/files?path=. status=200 durationMs=46
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/api/meta status=200 durationMs=114
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=GET url=/@fs/E:/TRAE%20Playground/NeuralNomadsAi/NomadArch/packages/ui/src/images/CodeNomad-Icon.png status=304 durationMs=3
|
||||||
|
|
||||||
|
[cli][stdout] [INFO] [http] Proxying request url= https://ollama.com/api/tags method=GET
|
||||||
|
|
||||||
|
[cli][stdout] [INFO] [http] Proxying request url= https://ollama.com/api/tags method=GET
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=POST url=/api/proxy status=200 durationMs=458
|
||||||
|
|
||||||
|
[cli][stdout] [INFO] [http] Proxying request url= https://api.z.ai/api/paas/v4/models method=GET
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=POST url=/api/proxy status=200 durationMs=366
|
||||||
|
|
||||||
|
[cli][stdout] [INFO] [http] Proxying request url= https://api.z.ai/api/paas/v4/models method=GET
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=POST url=/api/proxy status=200 durationMs=1755
|
||||||
|
|
||||||
|
[cli][stdout] [DEBUG] [http] HTTP request completed method=POST url=/api/proxy status=200 durationMs=2094
|
||||||
|
|
||||||
|
Something stuck again, electron opens into black screen and stuck there
|
||||||
|
|
||||||
|
SOLO Coder
|
||||||
|
|
||||||
|
Thought process
|
||||||
|
|
||||||
|
Fix Electron black screen/stuck on load issue
|
||||||
|
|
||||||
|
Fixed Electron black screen/stuck on load issue:
|
||||||
|
|
||||||
|
1. Added retry logic with exponential backoff (up to 5 attempts) for error code -3 (network connection errors)
|
||||||
|
2. Added 30-second timeout for both preload view and main window load
|
||||||
|
3. Added user-friendly error screen when max retries are reached
|
||||||
|
4. Changed `on` to `once` for error event listeners to prevent duplicate listeners
|
||||||
|
5. Reset retry counter on successful load
|
||||||
|
|
||||||
|
Now when Electron fails to load localhost:3000, it will:
|
||||||
|
- Automatically retry with increasing delays (1s, 2s, 4s, 8s, 16s)
|
||||||
|
- Show loading screen during retries
|
||||||
|
- Display friendly error screen with retry button after max attempts
|
||||||
|
|
||||||
|
0/1 done
|
||||||
|
|
||||||
|
Fix Electron black screen/stuck on load issue
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'failed to load CLI view|loading.*localhost:3000'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'class.*CliManager|CliManager.*='
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'import.*cliManager|const cliManager|new.*CliManager'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for '**/cli-process*.{ts,tsx,js,jsx}'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'CliProcessManager|class.*Manager'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\process-manager.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\process-manager.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Looking at the error failed to load CLI view: Error: (-3) loading 'http://localhost:3000/' , this is a network/connection error in Electron. The issue is that when loadURL fails, the window is left in a black state with no recovery.
|
||||||
|
|
||||||
|
Let me add proper error handling with retry logic and a fallback error screen:
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
main.ts
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
+ 2 - 0
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
main.ts
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
+ 10 - 0
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
main.ts
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
+ 108 - 1
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Search codebase for 'did-finish-load'
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Let me also add a timeout handler for the preload view to prevent it from hanging indefinitely:
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
main.ts
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
+ 9 - 0
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Let me add a timeout handler for the main window load as well:
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
main.ts
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
+ 11 - 0
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
NomadArch
|
||||||
|
Auto Run
|
||||||
|
Terminal
|
||||||
|
|
||||||
|
cd "e:\TRAE Playground\NeuralNomadsAi\NomadArch" && npm run typecheck 2>&1 | Select-Object -First 30
|
||||||
|
|
||||||
|
(TraeAI-8) E:\TRAE Playground\NeuralNomadsAi\NomadArch [0:0] $ cd "e:\TRAE Playground\NeuralNomadsAi\NomadArch" && npm run typecheck 2>&1 | Select-Object -First 30
|
||||||
|
|
||||||
|
> nomadarch-workspace@0.4.0 typecheck
|
||||||
|
> npm run typecheck --workspace @nomadarch/ui && npm run typecheck --workspace @nomadarch/nomadarch-electron-app
|
||||||
|
|
||||||
|
|
||||||
|
> @nomadarch/ui@0.4.0 typecheck
|
||||||
|
> tsc --noEmit -p tsconfig.json
|
||||||
|
|
||||||
|
|
||||||
|
> @nomadarch/nomadarch-electron-app@0.4.0 typecheck
|
||||||
|
> tsc --noEmit -p tsconfig.json
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
Let me also fix a potential issue with multiple error listeners being attached to webContents:
|
||||||
|
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
main.ts
|
||||||
|
packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
+ 1 - 1
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
NomadArch
|
||||||
|
Auto Run
|
||||||
|
Terminal
|
||||||
|
|
||||||
|
cd "e:\TRAE Playground\NeuralNomadsAi\NomadArch" && npm run typecheck 2>&1 | Select-Object -First 30
|
||||||
|
|
||||||
|
(TraeAI-8) E:\TRAE Playground\NeuralNomadsAi\NomadArch [0:0] $ cd "e:\TRAE Playground\NeuralNomadsAi\NomadArch" && npm run typecheck 2>&1 | Select-Object -First 30
|
||||||
|
|
||||||
|
> nomadarch-workspace@0.4.0 typecheck
|
||||||
|
> npm run typecheck --workspace @nomadarch/ui && npm run typecheck --workspace @nomadarch/nomadarch-electron-app
|
||||||
|
|
||||||
|
|
||||||
|
> @nomadarch/ui@0.4.0 typecheck
|
||||||
|
> tsc --noEmit -p tsconfig.json
|
||||||
|
|
||||||
|
|
||||||
|
> @nomadarch/nomadarch-electron-app@0.4.0 typecheck
|
||||||
|
> tsc --noEmit -p tsconfig.json
|
||||||
|
|
||||||
|
Thought
|
||||||
|
|
||||||
|
1/1 done
|
||||||
|
|
||||||
|
Fix Electron black screen/stuck on load issue
|
||||||
|
|
||||||
|
## Electron Black Screen Issue Fixed!
|
||||||
|
File : packages/electron-app/electron/main/main.ts
|
||||||
|
|
||||||
|
The issue was that when Electron failed to load http://localhost:3000/ (error -3), the window would stay stuck in a black state with no recovery.
|
||||||
|
|
||||||
|
### Changes Made:
|
||||||
|
1. Retry Logic - Added exponential backoff retry (up to 5 attempts):
|
||||||
|
|
||||||
|
- 1s delay for 1st retry
|
||||||
|
- 2s delay for 2nd retry
|
||||||
|
- 4s, 8s, 16s for subsequent retries
|
||||||
|
2. Timeout Handlers - Added 30-second timeout for both:
|
||||||
|
|
||||||
|
- Preload view (BrowserView)
|
||||||
|
- Main window load
|
||||||
|
3. Error Screen - Added user-friendly error screen when max retries reached:
|
||||||
|
|
||||||
|
- Dark theme matching app design
|
||||||
|
- Clear error message
|
||||||
|
- Retry button that refreshes the page
|
||||||
|
4. Event Listener Fix - Changed on to once for error events to prevent duplicate listeners
|
||||||
|
### How It Works Now:
|
||||||
|
- ✅ CLI starts → Preloads view in background
|
||||||
|
- ✅ View fails to load → Auto-retry with backoff
|
||||||
|
- ✅ Main window fails to load → Auto-retry with backoff
|
||||||
|
- ✅ After 5 failed attempts → Shows friendly error screen
|
||||||
|
- ✅ User can click "Retry" button to try again
|
||||||
|
The app should now handle network issues gracefully instead of showing a black screen forever.
|
||||||
|
|
||||||
|
Artifacts
|
||||||
|
|
||||||
|
1 file changed + 140 - 1
|
||||||
|
|
||||||
|
Open Diff
|
||||||
|
|
||||||
|
main.ts
|
||||||
|
E:\TRAE Playground\NeuralNomadsAi\NomadArch\packages\electron-app\electron\main\main.ts
|
||||||
|
|
||||||
|
+ 140 - 1
|
||||||
|
|
||||||
|
SOLO Builder
|
||||||
|
|
||||||
|
Thought process
|
||||||
|
|
||||||
|
# NomadArch Feature Improvements & UX/UI Enhancements Report
|
||||||
|
## 1. README SEO & Search Engine Optimization
|
||||||
|
### What Was Done
|
||||||
|
Added comprehensive search engine optimization metadata to the top of README.md :
|
||||||
|
1.1 HTML Meta Tags
|
||||||
|
HTML
|
||||||
|
1.2 Open Graph Metadata (Facebook/LinkedIn)
|
||||||
|
HTML
|
||||||
|
1.3 Twitter Card Metadata
|
||||||
|
HTML
|
||||||
|
1.4 Schema.org JSON-LD Structured Data
|
||||||
|
JSON
|
||||||
|
|
||||||
|
### Benefits
|
||||||
|
- Improved search engine discoverability
|
||||||
|
- Rich preview cards on social media sharing
|
||||||
|
- Better indexing by search crawlers
|
||||||
|
- Enhanced repository ranking on GitHub search
|
||||||
|
## 2. Repository Branding & Engagement Elements
|
||||||
|
### What Was Done 2.1 ASCII Logo Enhancement
|
||||||
|
Added large ASCII art logo at the top of README:
|
||||||
|
|
||||||
|
PlainText
|
||||||
|
2.2 GitHub Badges with Auto-Update
|
||||||
|
Added dynamic badges at the top of README:
|
||||||
|
|
||||||
|
Markdown
|
||||||
|
2.3 Call-to-Action Banner
|
||||||
|
Added engagement banner:
|
||||||
|
|
||||||
|
Markdown
|
||||||
|
2.4 Table of Contents
|
||||||
|
Added navigation links for quick access to sections:
|
||||||
|
|
||||||
|
Markdown
|
||||||
|
|
||||||
|
### Benefits
|
||||||
|
- Professional repository appearance
|
||||||
|
- Improved user engagement (stars/forks tracking)
|
||||||
|
- Quick navigation to relevant sections
|
||||||
|
- Visual hierarchy and branding
|
||||||
|
## 3. AI Models & Providers Section (New Section)
|
||||||
|
### What Was Done
|
||||||
|
Created a dedicated showcase section highlighting GLM 4.7 and all supported AI providers.
|
||||||
|
3.1 GLM 4.7 Spotlight
|
||||||
|
Markdown
|
||||||
|
3.2 Discount Code Integration
|
||||||
|
Markdown
|
||||||
|
3.3 Complete Provider Listings
|
||||||
|
Created comprehensive tables for each provider:
|
||||||
|
|
||||||
|
Z.AI Models:
|
||||||
|
|
||||||
|
Model Context Window Pricing Best For GLM 4.7 128K $0.50/1M tokens Web development, coding GLM 4.6 128K $0.40/1M tokens General coding GLM 4 128K $0.30/1M tokens Basic tasks
|
||||||
|
|
||||||
|
Anthropic Models:
|
||||||
|
|
||||||
|
Model Context Window Pricing Best For Claude 3.7 Sonnet 200K $3.00/1M tokens Complex reasoning Claude 3.5 Sonnet 200K $3.00/1M tokens Balanced performance Claude 3 Opus 200K $15.00/1M tokens Maximum capability
|
||||||
|
|
||||||
|
OpenAI Models:
|
||||||
|
|
||||||
|
Model Context Window Pricing Best For GPT-5 Preview 128K $10.00/1M tokens Latest capabilities GPT-4.1 128K $5.00/1M tokens Advanced reasoning GPT-4 Turbo 128K $3.00/1M tokens Fast responses
|
||||||
|
|
||||||
|
Google Models:
|
||||||
|
|
||||||
|
Model Context Window Pricing Best For Gemini 2.0 Pro 1M $1.00/1M tokens Large context Gemini 2.0 Flash 1M $0.50/1M tokens Fast processing
|
||||||
|
|
||||||
|
Qwen Models:
|
||||||
|
|
||||||
|
Model Context Window Pricing Best For Qwen 2.5 Coder 32K $0.30/1M tokens Python/JavaScript Qwen 2.5 32K $0.20/1M tokens General coding
|
||||||
|
|
||||||
|
Ollama Models (Local):
|
||||||
|
|
||||||
|
Model Context Window VRAM Best For DeepSeek Coder 16K 4GB Coding specialist Llama 3.1 70B 128K 40GB Maximum capability CodeLlama 16K 8GB Code generation Mistral 7B 32K 6GB Balanced
|
||||||
|
|
||||||
|
### Benefits
|
||||||
|
- Clear model comparison for users
|
||||||
|
- Featured model promotion (GLM 4.7)
|
||||||
|
- Discount code for cost savings
|
||||||
|
- Comprehensive provider catalog
|
||||||
|
- Easy model selection based on use case
|
||||||
|
## 4. Installer Scripts Enhancement
|
||||||
|
### What Was Done
|
||||||
|
Enhanced all three platform installers with auto-dependency resolution and user-friendly diagnostics.
|
||||||
|
4.1 Install-Windows.bat
|
||||||
|
Key Features:
|
||||||
|
|
||||||
|
1. ASCII Art Banner
|
||||||
|
batch
|
||||||
|
|
||||||
|
2. Administrator Privilege Check
|
||||||
|
batch
|
||||||
|
|
||||||
|
3. Node.js Detection
|
||||||
|
batch
|
||||||
|
|
||||||
|
4. OpenCode CLI Installation (Primary: npm)
|
||||||
|
batch
|
||||||
|
|
||||||
|
5. OpenCode CLI Installation (Fallback: GitHub Releases)
|
||||||
|
batch
|
||||||
|
|
||||||
|
6. Dependency Installation
|
||||||
|
batch
|
||||||
|
|
||||||
|
7. UI Auto-Build
|
||||||
|
batch
|
||||||
|
|
||||||
|
8. Step-by-Step Progress
|
||||||
|
PlainText
|
||||||
|
4.2 Install-Linux.sh
|
||||||
|
Key Features:
|
||||||
|
|
||||||
|
1. Distribution Detection
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
2. Package-Specific Installation Commands
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
3. NVM Installation Instructions
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
4. Architecture Detection
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
5. Permission Management
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
4.3 Install-Mac.sh
|
||||||
|
Key Features:
|
||||||
|
|
||||||
|
1. macOS Version Detection
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
2. Architecture Detection (Apple Silicon/Intel)
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
3. Xcode Command Line Tools Check
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
4. Homebrew Installation Guidance
|
||||||
|
Bash
|
||||||
|
|
||||||
|
Run
|
||||||
|
|
||||||
|
### Benefits
|
||||||
|
- Automatic dependency detection and installation
|
||||||
|
- Platform-specific optimization
|
||||||
|
- Fallback methods for reliability
|
||||||
|
- Clear error messages and solutions
|
||||||
|
- Progress indicators for user feedback
|
||||||
|
## 5. Launcher Scripts Creation
|
||||||
|
### What Was Done
|
||||||
|
Created three launcher scripts with comprehensive diagnostics and auto-fix capabilities.
|
||||||
|
5.1 Launch-Windows.bat
|
||||||
|
Features:
|
||||||
|
|
||||||
|
1. Dependency Checking
|
||||||
|
batch
|
||||||
|
|
||||||
|
2. OpenCode CLI Detection
|
||||||
|
batch
|
||||||
|
|
||||||
|
3. UI Auto-Build
|
||||||
|
batch
|
||||||
|
|
||||||
|
4. Port Availability Check
|
||||||
|
batch
|
||||||
|
|
||||||
|
5. Electron Launch
|
||||||
|
```
|
||||||
|
call npm run dev:electron
|
||||||
|
```
|
||||||
|
6. Error Recovery
|
||||||
|
```
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo.
|
||||||
|
echo [ERROR] NomadArch exited with an error!
|
||||||
|
echo.
|
||||||
|
echo Common solutions:
|
||||||
|
echo 1. Check that all dependencies are installed: npm
|
||||||
|
install
|
||||||
|
echo 2. Check that the UI is built: cd packages\ui &&
|
||||||
|
npm run build
|
||||||
|
echo 3. Check for port conflicts
|
||||||
|
)
|
||||||
|
``` 5.2 Launch-Unix.sh (Linux/macOS)
|
||||||
|
Features:
|
||||||
|
|
||||||
|
1. Cross-Platform Compatibility
|
||||||
|
```
|
||||||
|
#!/bin/bash
|
||||||
|
cd "$(dirname "$0")"
|
||||||
|
```
|
||||||
|
2. Dependency Checking
|
||||||
|
```
|
||||||
|
if ! command -v node &> /dev/null; then
|
||||||
|
echo "[ERROR] Node.js not found!"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
```
|
||||||
|
3. Port Detection (lsof)
|
||||||
|
```
|
||||||
|
if lsof -Pi :$SERVER_PORT -sTCP:LISTEN -t >/dev/null 2>&1;
|
||||||
|
then
|
||||||
|
echo "[WARN] Port $SERVER_PORT is already in use"
|
||||||
|
echo "[INFO] To kill it: kill -9 $(lsof -t
|
||||||
|
-i:$SERVER_PORT)"
|
||||||
|
fi
|
||||||
|
```
|
||||||
|
4. Electron Launch
|
||||||
|
```
|
||||||
|
npm run dev:electron
|
||||||
|
``` 5.3 Launch-Dev-Windows.bat
|
||||||
|
Features:
|
||||||
|
|
||||||
|
1. Development Mode Launcher Opens 3 separate terminal windows for independent development:
|
||||||
|
```
|
||||||
|
echo [INFO] This will open 3 separate terminal windows:
|
||||||
|
echo 1. Backend Server (port 3001)
|
||||||
|
echo 2. Frontend UI (port 3000)
|
||||||
|
echo 3. Electron App
|
||||||
|
```
|
||||||
|
2. Independent Service Management
|
||||||
|
```
|
||||||
|
echo [INFO] Starting Backend Server...
|
||||||
|
start "NomadArch Server" cmd /k "cd /d
|
||||||
|
\"%~dp0packages\server\" && npm run dev"
|
||||||
|
|
||||||
|
echo [INFO] Starting Frontend UI...
|
||||||
|
start "NomadArch UI" cmd /k "cd /d \"%~dp0packages\ui\" &&
|
||||||
|
npm run dev"
|
||||||
|
|
||||||
|
echo [INFO] Starting Electron App...
|
||||||
|
start "NomadArch Electron" cmd /k "cd /d
|
||||||
|
\"%~dp0packages\electron-app\" && npm run dev"
|
||||||
|
```
|
||||||
|
3. Clean Shutdown
|
||||||
|
```
|
||||||
|
echo [INFO] Stopping all services...
|
||||||
|
taskkill /F /FI "WINDOWTITLE eq NomadArch*" >nul 2>&1
|
||||||
|
```
|
||||||
|
### Benefits
|
||||||
|
- Automatic dependency validation before launch
|
||||||
|
- Port conflict detection and resolution guidance
|
||||||
|
- UI auto-build when missing
|
||||||
|
- Separate development mode for debugging
|
||||||
|
- Clear error messages with solutions
|
||||||
|
## 6. Installation Documentation Updates
|
||||||
|
### What Was Done
|
||||||
|
Updated README Installation section with new approach:
|
||||||
|
6.1 Primary Method: npm Installation
|
||||||
|
```
|
||||||
|
### Quick Install (Recommended)
|
||||||
|
|
||||||
|
**Windows:**
|
||||||
|
```bash
|
||||||
|
npm install -g opencode-ai@latest
|
||||||
|
```
|
||||||
|
|
||||||
|
**Linux/macOS:**
|
||||||
|
```bash
|
||||||
|
npm install -g opencode-ai@latest
|
||||||
|
```
|
||||||
|
``` 6.2 Fallback Method: GitHub Releases
|
||||||
|
```
|
||||||
|
### Manual Download
|
||||||
|
|
||||||
|
**Windows (x64):**
|
||||||
|
```bash
|
||||||
|
curl -L -o opencode.exe https://github.com/sst/opencode/
|
||||||
|
releases/latest/download/opencode-windows-x64.zip
|
||||||
|
unzip opencode-windows-x64.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
**Linux (x64):**
|
||||||
|
```bash
|
||||||
|
curl -L -o opencode.zip https://github.com/sst/opencode/
|
||||||
|
releases/latest/download/opencode-linux-x64.zip
|
||||||
|
unzip opencode.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
**macOS (Apple Silicon):**
|
||||||
|
```bash
|
||||||
|
curl -L -o opencode.zip https://github.com/sst/opencode/
|
||||||
|
releases/latest/download/opencode-darwin-arm64.zip
|
||||||
|
unzip opencode.zip
|
||||||
|
```
|
||||||
|
``` 6.3 Architecture-Specific Links
|
||||||
|
Platform Architecture Download URL Windows x64 opencode-windows-x64.zip Linux x64 opencode-linux-x64.zip Linux ARM64 opencode-linux-arm64.zip macOS x64 opencode-darwin-x64.zip macOS ARM64 opencode-darwin-arm64.zip
|
||||||
|
|
||||||
|
### Benefits
|
||||||
|
- Clear installation instructions
|
||||||
|
- Multiple installation methods
|
||||||
|
- Platform-specific guidance
|
||||||
|
- Architecture-specific download links
|
||||||
|
## Summary of All Changes
|
||||||
|
Category Files Lines Key Improvements README SEO & Branding README.md ~140 Meta tags, badges, ASCII logo, CTA banner AI Models Section README.md ~75 GLM 4.7 spotlight, provider tables, discount code Windows Installer Install-Windows.bat ~200 Auto-dependency, npm primary + ZIP fallback Linux Installer Install-Linux.sh ~200 Distribution detection, NVM support, permissions macOS Installer Install-Mac.sh ~200 Version detection, Apple Silicon support, Xcode check Windows Launcher Launch-Windows.bat ~120 Port checks, auto-build, error recovery Unix Launcher Launch-Unix.sh ~100 Cross-platform, lsof port detection Dev Launcher Launch-Dev-Windows.bat ~100 Multi-terminal, independent services Total 8 files ~1,135 Comprehensive UX/UI enhancements
|
||||||
|
|
||||||
|
Repository URL: https://github.com/roman-ryzenadvanced/NomadArch-v1.0
|
||||||
|
|
||||||
|
Completed
|
||||||
|
|
||||||
|
47%
|
||||||
|
|
||||||
|
@ SOLO Builder
|
||||||
|
|
||||||
|
You are chatting with SOLO Builder now
|
||||||
359
Install-Linux.sh
Normal file
359
Install-Linux.sh
Normal file
@@ -0,0 +1,359 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# NomadArch Installer for Linux
|
||||||
|
# Version: 0.5.0 - Binary-Free Mode
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
BLUE='\033[0;34m'
|
||||||
|
NC='\033[0m'
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
TARGET_DIR="$SCRIPT_DIR"
|
||||||
|
BIN_DIR="$TARGET_DIR/bin"
|
||||||
|
LOG_FILE="$TARGET_DIR/install.log"
|
||||||
|
ERRORS=0
|
||||||
|
WARNINGS=0
|
||||||
|
NEEDS_FALLBACK=0
|
||||||
|
BINARY_FREE_MODE=0
|
||||||
|
|
||||||
|
log() {
|
||||||
|
echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" >> "$LOG_FILE"
|
||||||
|
}
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "NomadArch Installer (Linux)"
|
||||||
|
echo "Version: 0.5.0 - Binary-Free Mode"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
log "Installer started"
|
||||||
|
|
||||||
|
echo "[STEP 1/8] OS and Architecture Detection"
|
||||||
|
OS_TYPE=$(uname -s)
|
||||||
|
ARCH_TYPE=$(uname -m)
|
||||||
|
log "OS: $OS_TYPE"
|
||||||
|
log "Architecture: $ARCH_TYPE"
|
||||||
|
|
||||||
|
if [[ "$OS_TYPE" != "Linux" ]]; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} This installer is for Linux. Current OS: $OS_TYPE"
|
||||||
|
log "ERROR: Not Linux ($OS_TYPE)"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
case "$ARCH_TYPE" in
|
||||||
|
x86_64) ARCH="x64" ;;
|
||||||
|
aarch64) ARCH="arm64" ;;
|
||||||
|
armv7l) ARCH="arm" ;;
|
||||||
|
*)
|
||||||
|
echo -e "${RED}[ERROR]${NC} Unsupported architecture: $ARCH_TYPE"
|
||||||
|
log "ERROR: Unsupported arch $ARCH_TYPE"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
echo -e "${GREEN}[OK]${NC} OS: Linux"
|
||||||
|
echo -e "${GREEN}[OK]${NC} Architecture: $ARCH_TYPE"
|
||||||
|
|
||||||
|
if [[ -f /etc/os-release ]]; then
|
||||||
|
# shellcheck disable=SC1091
|
||||||
|
. /etc/os-release
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Distribution: ${PRETTY_NAME:-unknown}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 2/8] Checking write permissions"
|
||||||
|
mkdir -p "$BIN_DIR"
|
||||||
|
if ! touch "$SCRIPT_DIR/.install-write-test" 2>/dev/null; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} No write access to $SCRIPT_DIR"
|
||||||
|
TARGET_DIR="$HOME/.nomadarch-install"
|
||||||
|
BIN_DIR="$TARGET_DIR/bin"
|
||||||
|
LOG_FILE="$TARGET_DIR/install.log"
|
||||||
|
mkdir -p "$BIN_DIR"
|
||||||
|
if ! touch "$TARGET_DIR/.install-write-test" 2>/dev/null; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} Cannot write to $TARGET_DIR"
|
||||||
|
log "ERROR: Write permission denied to fallback"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
rm -f "$TARGET_DIR/.install-write-test"
|
||||||
|
NEEDS_FALLBACK=1
|
||||||
|
echo -e "${GREEN}[OK]${NC} Using fallback: $TARGET_DIR"
|
||||||
|
else
|
||||||
|
rm -f "$SCRIPT_DIR/.install-write-test"
|
||||||
|
echo -e "${GREEN}[OK]${NC} Write access OK"
|
||||||
|
fi
|
||||||
|
|
||||||
|
log "Install target: $TARGET_DIR"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 3/8] Ensuring system dependencies"
|
||||||
|
|
||||||
|
SUDO=""
|
||||||
|
if [[ $EUID -ne 0 ]]; then
|
||||||
|
if command -v sudo >/dev/null 2>&1; then
|
||||||
|
SUDO="sudo"
|
||||||
|
else
|
||||||
|
echo -e "${RED}[ERROR]${NC} sudo is required to install dependencies"
|
||||||
|
log "ERROR: sudo not found"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
install_packages() {
|
||||||
|
local manager="$1"
|
||||||
|
shift
|
||||||
|
local packages=("$@")
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Installing via $manager: ${packages[*]}"
|
||||||
|
case "$manager" in
|
||||||
|
apt)
|
||||||
|
$SUDO apt-get update -y
|
||||||
|
$SUDO apt-get install -y "${packages[@]}"
|
||||||
|
;;
|
||||||
|
dnf)
|
||||||
|
$SUDO dnf install -y "${packages[@]}"
|
||||||
|
;;
|
||||||
|
yum)
|
||||||
|
$SUDO yum install -y "${packages[@]}"
|
||||||
|
;;
|
||||||
|
pacman)
|
||||||
|
$SUDO pacman -Sy --noconfirm "${packages[@]}"
|
||||||
|
;;
|
||||||
|
zypper)
|
||||||
|
$SUDO zypper -n install "${packages[@]}"
|
||||||
|
;;
|
||||||
|
apk)
|
||||||
|
$SUDO apk add --no-cache "${packages[@]}"
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
return 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
PACKAGE_MANAGER=""
|
||||||
|
if command -v apt-get >/dev/null 2>&1; then
|
||||||
|
PACKAGE_MANAGER="apt"
|
||||||
|
elif command -v dnf >/dev/null 2>&1; then
|
||||||
|
PACKAGE_MANAGER="dnf"
|
||||||
|
elif command -v yum >/dev/null 2>&1; then
|
||||||
|
PACKAGE_MANAGER="yum"
|
||||||
|
elif command -v pacman >/dev/null 2>&1; then
|
||||||
|
PACKAGE_MANAGER="pacman"
|
||||||
|
elif command -v zypper >/dev/null 2>&1; then
|
||||||
|
PACKAGE_MANAGER="zypper"
|
||||||
|
elif command -v apk >/dev/null 2>&1; then
|
||||||
|
PACKAGE_MANAGER="apk"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ -z "$PACKAGE_MANAGER" ]]; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} No supported package manager found."
|
||||||
|
echo "Install Node.js, npm, git, and curl manually."
|
||||||
|
log "ERROR: No package manager found"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
MISSING_PKGS=()
|
||||||
|
command -v curl >/dev/null 2>&1 || MISSING_PKGS+=("curl")
|
||||||
|
command -v git >/dev/null 2>&1 || MISSING_PKGS+=("git")
|
||||||
|
|
||||||
|
if ! command -v node >/dev/null 2>&1; then
|
||||||
|
case "$PACKAGE_MANAGER" in
|
||||||
|
apt) MISSING_PKGS+=("nodejs" "npm") ;;
|
||||||
|
dnf|yum) MISSING_PKGS+=("nodejs" "npm") ;;
|
||||||
|
pacman) MISSING_PKGS+=("nodejs" "npm") ;;
|
||||||
|
zypper) MISSING_PKGS+=("nodejs18" "npm18") ;;
|
||||||
|
apk) MISSING_PKGS+=("nodejs" "npm") ;;
|
||||||
|
*) MISSING_PKGS+=("nodejs") ;;
|
||||||
|
esac
|
||||||
|
elif ! command -v npm >/dev/null 2>&1; then
|
||||||
|
MISSING_PKGS+=("npm")
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ ${#MISSING_PKGS[@]} -gt 0 ]]; then
|
||||||
|
install_packages "$PACKAGE_MANAGER" "${MISSING_PKGS[@]}" || {
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Some packages failed to install. Trying alternative method..."
|
||||||
|
if ! command -v node >/dev/null 2>&1; then
|
||||||
|
install_packages "$PACKAGE_MANAGER" "nodejs" || true
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! command -v node >/dev/null 2>&1; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} Node.js install failed."
|
||||||
|
log "ERROR: Node.js still missing"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
NODE_VERSION=$(node --version)
|
||||||
|
NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d'v' -f2 | cut -d'.' -f1)
|
||||||
|
echo -e "${GREEN}[OK]${NC} Node.js: $NODE_VERSION"
|
||||||
|
if [[ $NODE_MAJOR -lt 18 ]]; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Node.js 18+ is recommended"
|
||||||
|
((WARNINGS++))
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! command -v npm >/dev/null 2>&1; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} npm is not available"
|
||||||
|
log "ERROR: npm missing after install"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
NPM_VERSION=$(npm --version)
|
||||||
|
echo -e "${GREEN}[OK]${NC} npm: $NPM_VERSION"
|
||||||
|
|
||||||
|
if command -v git >/dev/null 2>&1; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} Git: $(git --version)"
|
||||||
|
else
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Git not found (optional)"
|
||||||
|
((WARNINGS++))
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 4/8] Installing npm dependencies"
|
||||||
|
cd "$SCRIPT_DIR"
|
||||||
|
log "Running npm install"
|
||||||
|
if ! npm install; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} npm install failed"
|
||||||
|
log "ERROR: npm install failed"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo -e "${GREEN}[OK]${NC} Dependencies installed"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 5/8] OpenCode Binary (OPTIONAL - Binary-Free Mode Available)"
|
||||||
|
echo -e "${BLUE}[INFO]${NC} NomadArch now supports Binary-Free Mode!"
|
||||||
|
echo -e "${BLUE}[INFO]${NC} You can use the application without OpenCode binary."
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Free models from OpenCode Zen are available without the binary."
|
||||||
|
mkdir -p "$BIN_DIR"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
read -p "Skip OpenCode binary download? (Y for Binary-Free Mode / N to download) [Y]: " SKIP_CHOICE
|
||||||
|
SKIP_CHOICE="${SKIP_CHOICE:-Y}"
|
||||||
|
|
||||||
|
if [[ "${SKIP_CHOICE^^}" == "Y" ]]; then
|
||||||
|
BINARY_FREE_MODE=1
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Skipping OpenCode binary - using Binary-Free Mode"
|
||||||
|
log "Using Binary-Free Mode"
|
||||||
|
else
|
||||||
|
OPENCODE_PINNED_VERSION="0.1.44"
|
||||||
|
OPENCODE_VERSION="$OPENCODE_PINNED_VERSION"
|
||||||
|
|
||||||
|
LATEST_VERSION=$(curl -s --max-time 10 https://api.github.com/repos/sst/opencode/releases/latest 2>/dev/null | grep '"tag_name"' | cut -d'"' -f4 | sed 's/^v//')
|
||||||
|
if [[ -n "$LATEST_VERSION" ]]; then
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Latest available: v${LATEST_VERSION}, using pinned: v${OPENCODE_VERSION}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
OPENCODE_BASE="https://github.com/sst/opencode/releases/download/v${OPENCODE_VERSION}"
|
||||||
|
OPENCODE_URL="${OPENCODE_BASE}/opencode-linux-${ARCH}"
|
||||||
|
CHECKSUM_URL="${OPENCODE_BASE}/checksums.txt"
|
||||||
|
|
||||||
|
NEEDS_DOWNLOAD=0
|
||||||
|
if [[ -f "$BIN_DIR/opencode" ]]; then
|
||||||
|
EXISTING_VERSION=$("$BIN_DIR/opencode" --version 2>/dev/null | head -1 || echo "unknown")
|
||||||
|
if [[ "$EXISTING_VERSION" == *"$OPENCODE_VERSION"* ]] || [[ "$EXISTING_VERSION" != "unknown" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} OpenCode binary exists (version: $EXISTING_VERSION)"
|
||||||
|
else
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Existing binary version mismatch, re-downloading..."
|
||||||
|
NEEDS_DOWNLOAD=1
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
NEEDS_DOWNLOAD=1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ $NEEDS_DOWNLOAD -eq 1 ]]; then
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Downloading OpenCode v${OPENCODE_VERSION} for ${ARCH}..."
|
||||||
|
|
||||||
|
DOWNLOAD_SUCCESS=0
|
||||||
|
for attempt in 1 2 3; do
|
||||||
|
if curl -L --fail --retry 3 -o "$BIN_DIR/opencode.tmp" "$OPENCODE_URL" 2>/dev/null; then
|
||||||
|
DOWNLOAD_SUCCESS=1
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Download attempt $attempt failed, retrying..."
|
||||||
|
sleep 2
|
||||||
|
done
|
||||||
|
|
||||||
|
if [[ $DOWNLOAD_SUCCESS -eq 0 ]]; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Failed to download OpenCode binary - using Binary-Free Mode"
|
||||||
|
BINARY_FREE_MODE=1
|
||||||
|
else
|
||||||
|
if curl -L --fail -o "$BIN_DIR/checksums.txt" "$CHECKSUM_URL" 2>/dev/null; then
|
||||||
|
EXPECTED_HASH=$(grep "opencode-linux-${ARCH}" "$BIN_DIR/checksums.txt" | awk '{print $1}')
|
||||||
|
ACTUAL_HASH=$(sha256sum "$BIN_DIR/opencode.tmp" | awk '{print $1}')
|
||||||
|
|
||||||
|
if [[ "$ACTUAL_HASH" == "$EXPECTED_HASH" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} Checksum verified"
|
||||||
|
else
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Checksum mismatch (may be OK for some versions)"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
mv "$BIN_DIR/opencode.tmp" "$BIN_DIR/opencode"
|
||||||
|
chmod +x "$BIN_DIR/opencode"
|
||||||
|
echo -e "${GREEN}[OK]${NC} OpenCode binary installed"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 6/8] Building UI assets"
|
||||||
|
if [[ -d "$SCRIPT_DIR/packages/ui/dist" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} UI build already exists"
|
||||||
|
else
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Building UI"
|
||||||
|
pushd "$SCRIPT_DIR/packages/ui" >/dev/null
|
||||||
|
npm run build
|
||||||
|
popd >/dev/null
|
||||||
|
echo -e "${GREEN}[OK]${NC} UI assets built"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 7/8] Post-install health check"
|
||||||
|
HEALTH_ERRORS=0
|
||||||
|
|
||||||
|
[[ -f "$SCRIPT_DIR/package.json" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
[[ -d "$SCRIPT_DIR/packages/ui" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
[[ -d "$SCRIPT_DIR/packages/server" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
[[ -f "$SCRIPT_DIR/packages/ui/dist/index.html" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
|
||||||
|
if [[ $HEALTH_ERRORS -eq 0 ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} Health checks passed"
|
||||||
|
else
|
||||||
|
echo -e "${RED}[ERROR]${NC} Health checks failed ($HEALTH_ERRORS)"
|
||||||
|
ERRORS=$((ERRORS+HEALTH_ERRORS))
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 8/8] Installation Summary"
|
||||||
|
echo ""
|
||||||
|
echo " Install Dir: $TARGET_DIR"
|
||||||
|
echo " Architecture: $ARCH"
|
||||||
|
echo " Node.js: $NODE_VERSION"
|
||||||
|
echo " npm: $NPM_VERSION"
|
||||||
|
if [[ $BINARY_FREE_MODE -eq 1 ]]; then
|
||||||
|
echo " Mode: Binary-Free Mode (OpenCode Zen free models available)"
|
||||||
|
else
|
||||||
|
echo " Mode: Full Mode (OpenCode binary installed)"
|
||||||
|
fi
|
||||||
|
echo " Errors: $ERRORS"
|
||||||
|
echo " Warnings: $WARNINGS"
|
||||||
|
echo " Log File: $LOG_FILE"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [[ $ERRORS -gt 0 ]]; then
|
||||||
|
echo -e "${RED}[RESULT]${NC} Installation completed with errors"
|
||||||
|
echo "Review $LOG_FILE for details."
|
||||||
|
else
|
||||||
|
echo -e "${GREEN}[RESULT]${NC} Installation completed successfully"
|
||||||
|
echo "Run: ./Launch-Unix.sh"
|
||||||
|
echo ""
|
||||||
|
if [[ $BINARY_FREE_MODE -eq 1 ]]; then
|
||||||
|
echo -e "${BLUE}NOTE:${NC} Running in Binary-Free Mode."
|
||||||
|
echo " Free models (GPT-5 Nano, Grok Code, GLM-4.7, etc.) are available."
|
||||||
|
echo " You can also authenticate with Qwen for additional models."
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
exit $ERRORS
|
||||||
280
Install-Mac.sh
Normal file
280
Install-Mac.sh
Normal file
@@ -0,0 +1,280 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# NomadArch Installer for macOS
|
||||||
|
# Version: 0.5.0 - Binary-Free Mode
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
BLUE='\033[0;34m'
|
||||||
|
NC='\033[0m'
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
TARGET_DIR="$SCRIPT_DIR"
|
||||||
|
BIN_DIR="$TARGET_DIR/bin"
|
||||||
|
LOG_FILE="$TARGET_DIR/install.log"
|
||||||
|
ERRORS=0
|
||||||
|
WARNINGS=0
|
||||||
|
NEEDS_FALLBACK=0
|
||||||
|
BINARY_FREE_MODE=0
|
||||||
|
|
||||||
|
log() {
|
||||||
|
echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" >> "$LOG_FILE"
|
||||||
|
}
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "NomadArch Installer (macOS)"
|
||||||
|
echo "Version: 0.5.0 - Binary-Free Mode"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
log "Installer started"
|
||||||
|
|
||||||
|
echo "[STEP 1/8] OS and Architecture Detection"
|
||||||
|
OS_TYPE=$(uname -s)
|
||||||
|
ARCH_TYPE=$(uname -m)
|
||||||
|
log "OS: $OS_TYPE"
|
||||||
|
log "Architecture: $ARCH_TYPE"
|
||||||
|
|
||||||
|
if [[ "$OS_TYPE" != "Darwin" ]]; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} This installer is for macOS. Current OS: $OS_TYPE"
|
||||||
|
log "ERROR: Not macOS ($OS_TYPE)"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
case "$ARCH_TYPE" in
|
||||||
|
arm64) ARCH="arm64" ;;
|
||||||
|
x86_64) ARCH="x64" ;;
|
||||||
|
*)
|
||||||
|
echo -e "${RED}[ERROR]${NC} Unsupported architecture: $ARCH_TYPE"
|
||||||
|
log "ERROR: Unsupported arch $ARCH_TYPE"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
echo -e "${GREEN}[OK]${NC} OS: macOS"
|
||||||
|
echo -e "${GREEN}[OK]${NC} Architecture: $ARCH_TYPE"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 2/8] Checking write permissions"
|
||||||
|
mkdir -p "$BIN_DIR"
|
||||||
|
if ! touch "$SCRIPT_DIR/.install-write-test" 2>/dev/null; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} No write access to $SCRIPT_DIR"
|
||||||
|
TARGET_DIR="$HOME/.nomadarch-install"
|
||||||
|
BIN_DIR="$TARGET_DIR/bin"
|
||||||
|
LOG_FILE="$TARGET_DIR/install.log"
|
||||||
|
mkdir -p "$BIN_DIR"
|
||||||
|
if ! touch "$TARGET_DIR/.install-write-test" 2>/dev/null; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} Cannot write to $TARGET_DIR"
|
||||||
|
log "ERROR: Write permission denied to fallback"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
rm -f "$TARGET_DIR/.install-write-test"
|
||||||
|
NEEDS_FALLBACK=1
|
||||||
|
echo -e "${GREEN}[OK]${NC} Using fallback: $TARGET_DIR"
|
||||||
|
else
|
||||||
|
rm -f "$SCRIPT_DIR/.install-write-test"
|
||||||
|
echo -e "${GREEN}[OK]${NC} Write access OK"
|
||||||
|
fi
|
||||||
|
|
||||||
|
log "Install target: $TARGET_DIR"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 3/8] Ensuring system dependencies"
|
||||||
|
|
||||||
|
if ! command -v curl >/dev/null 2>&1; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} curl is required but not available"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! command -v brew >/dev/null 2>&1; then
|
||||||
|
echo -e "${YELLOW}[INFO]${NC} Homebrew not found. Installing..."
|
||||||
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
||||||
|
fi
|
||||||
|
|
||||||
|
MISSING_PKGS=()
|
||||||
|
command -v git >/dev/null 2>&1 || MISSING_PKGS+=("git")
|
||||||
|
command -v node >/dev/null 2>&1 || MISSING_PKGS+=("node")
|
||||||
|
|
||||||
|
if [[ ${#MISSING_PKGS[@]} -gt 0 ]]; then
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Installing: ${MISSING_PKGS[*]}"
|
||||||
|
brew install "${MISSING_PKGS[@]}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! command -v node >/dev/null 2>&1; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} Node.js install failed"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
NODE_VERSION=$(node --version)
|
||||||
|
NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d'v' -f2 | cut -d'.' -f1)
|
||||||
|
echo -e "${GREEN}[OK]${NC} Node.js: $NODE_VERSION"
|
||||||
|
if [[ $NODE_MAJOR -lt 18 ]]; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Node.js 18+ is recommended"
|
||||||
|
((WARNINGS++))
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! command -v npm >/dev/null 2>&1; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} npm is not available"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
NPM_VERSION=$(npm --version)
|
||||||
|
echo -e "${GREEN}[OK]${NC} npm: $NPM_VERSION"
|
||||||
|
|
||||||
|
if command -v git >/dev/null 2>&1; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} Git: $(git --version)"
|
||||||
|
else
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Git not found (optional)"
|
||||||
|
((WARNINGS++))
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 4/8] Installing npm dependencies"
|
||||||
|
cd "$SCRIPT_DIR"
|
||||||
|
log "Running npm install"
|
||||||
|
if ! npm install; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} npm install failed"
|
||||||
|
log "ERROR: npm install failed"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo -e "${GREEN}[OK]${NC} Dependencies installed"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 5/8] OpenCode Binary (OPTIONAL - Binary-Free Mode Available)"
|
||||||
|
echo -e "${BLUE}[INFO]${NC} NomadArch now supports Binary-Free Mode!"
|
||||||
|
echo -e "${BLUE}[INFO]${NC} You can use the application without OpenCode binary."
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Free models from OpenCode Zen are available without the binary."
|
||||||
|
mkdir -p "$BIN_DIR"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
read -p "Skip OpenCode binary download? (Y for Binary-Free Mode / N to download) [Y]: " SKIP_CHOICE
|
||||||
|
SKIP_CHOICE="${SKIP_CHOICE:-Y}"
|
||||||
|
|
||||||
|
if [[ "${SKIP_CHOICE^^}" == "Y" ]]; then
|
||||||
|
BINARY_FREE_MODE=1
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Skipping OpenCode binary - using Binary-Free Mode"
|
||||||
|
log "Using Binary-Free Mode"
|
||||||
|
else
|
||||||
|
# Pin to a specific known-working version
|
||||||
|
OPENCODE_PINNED_VERSION="0.1.44"
|
||||||
|
OPENCODE_VERSION="$OPENCODE_PINNED_VERSION"
|
||||||
|
|
||||||
|
LATEST_VERSION=$(curl -s --max-time 10 https://api.github.com/repos/sst/opencode/releases/latest 2>/dev/null | grep '"tag_name"' | cut -d'"' -f4 | sed 's/^v//')
|
||||||
|
if [[ -n "$LATEST_VERSION" ]]; then
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Latest available: v${LATEST_VERSION}, using pinned: v${OPENCODE_VERSION}"
|
||||||
|
fi
|
||||||
|
|
||||||
|
OPENCODE_BASE="https://github.com/sst/opencode/releases/download/v${OPENCODE_VERSION}"
|
||||||
|
OPENCODE_URL="${OPENCODE_BASE}/opencode-darwin-${ARCH}"
|
||||||
|
CHECKSUM_URL="${OPENCODE_BASE}/checksums.txt"
|
||||||
|
|
||||||
|
NEEDS_DOWNLOAD=0
|
||||||
|
if [[ -f "$BIN_DIR/opencode" ]]; then
|
||||||
|
EXISTING_VERSION=$("$BIN_DIR/opencode" --version 2>/dev/null | head -1 || echo "unknown")
|
||||||
|
if [[ "$EXISTING_VERSION" == *"$OPENCODE_VERSION"* ]] || [[ "$EXISTING_VERSION" != "unknown" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} OpenCode binary exists (version: $EXISTING_VERSION)"
|
||||||
|
else
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Existing binary version mismatch, re-downloading..."
|
||||||
|
NEEDS_DOWNLOAD=1
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
NEEDS_DOWNLOAD=1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ $NEEDS_DOWNLOAD -eq 1 ]]; then
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Downloading OpenCode v${OPENCODE_VERSION} for ${ARCH}..."
|
||||||
|
|
||||||
|
DOWNLOAD_SUCCESS=0
|
||||||
|
for attempt in 1 2 3; do
|
||||||
|
if curl -L --fail --retry 3 -o "$BIN_DIR/opencode.tmp" "$OPENCODE_URL" 2>/dev/null; then
|
||||||
|
DOWNLOAD_SUCCESS=1
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Download attempt $attempt failed, retrying..."
|
||||||
|
sleep 2
|
||||||
|
done
|
||||||
|
|
||||||
|
if [[ $DOWNLOAD_SUCCESS -eq 0 ]]; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Failed to download OpenCode binary - using Binary-Free Mode"
|
||||||
|
BINARY_FREE_MODE=1
|
||||||
|
else
|
||||||
|
if curl -L --fail -o "$BIN_DIR/checksums.txt" "$CHECKSUM_URL" 2>/dev/null; then
|
||||||
|
EXPECTED_HASH=$(grep "opencode-darwin-${ARCH}" "$BIN_DIR/checksums.txt" | awk '{print $1}')
|
||||||
|
ACTUAL_HASH=$(shasum -a 256 "$BIN_DIR/opencode.tmp" | awk '{print $1}')
|
||||||
|
|
||||||
|
if [[ "$ACTUAL_HASH" == "$EXPECTED_HASH" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} Checksum verified"
|
||||||
|
else
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Checksum mismatch (may be OK for some versions)"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
mv "$BIN_DIR/opencode.tmp" "$BIN_DIR/opencode"
|
||||||
|
chmod +x "$BIN_DIR/opencode"
|
||||||
|
echo -e "${GREEN}[OK]${NC} OpenCode binary installed"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 6/8] Building UI assets"
|
||||||
|
if [[ -d "$SCRIPT_DIR/packages/ui/dist" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} UI build already exists"
|
||||||
|
else
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Building UI"
|
||||||
|
pushd "$SCRIPT_DIR/packages/ui" >/dev/null
|
||||||
|
npm run build
|
||||||
|
popd >/dev/null
|
||||||
|
echo -e "${GREEN}[OK]${NC} UI assets built"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 7/8] Post-install health check"
|
||||||
|
HEALTH_ERRORS=0
|
||||||
|
|
||||||
|
[[ -f "$SCRIPT_DIR/package.json" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
[[ -d "$SCRIPT_DIR/packages/ui" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
[[ -d "$SCRIPT_DIR/packages/server" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
[[ -f "$SCRIPT_DIR/packages/ui/dist/index.html" ]] || HEALTH_ERRORS=$((HEALTH_ERRORS+1))
|
||||||
|
|
||||||
|
if [[ $HEALTH_ERRORS -eq 0 ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} Health checks passed"
|
||||||
|
else
|
||||||
|
echo -e "${RED}[ERROR]${NC} Health checks failed ($HEALTH_ERRORS)"
|
||||||
|
ERRORS=$((ERRORS+HEALTH_ERRORS))
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 8/8] Installation Summary"
|
||||||
|
echo ""
|
||||||
|
echo " Install Dir: $TARGET_DIR"
|
||||||
|
echo " Architecture: $ARCH"
|
||||||
|
echo " Node.js: $NODE_VERSION"
|
||||||
|
echo " npm: $NPM_VERSION"
|
||||||
|
if [[ $BINARY_FREE_MODE -eq 1 ]]; then
|
||||||
|
echo " Mode: Binary-Free Mode (OpenCode Zen free models available)"
|
||||||
|
else
|
||||||
|
echo " Mode: Full Mode (OpenCode binary installed)"
|
||||||
|
fi
|
||||||
|
echo " Errors: $ERRORS"
|
||||||
|
echo " Warnings: $WARNINGS"
|
||||||
|
echo " Log File: $LOG_FILE"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [[ $ERRORS -gt 0 ]]; then
|
||||||
|
echo -e "${RED}[RESULT]${NC} Installation completed with errors"
|
||||||
|
echo "Review $LOG_FILE for details."
|
||||||
|
else
|
||||||
|
echo -e "${GREEN}[RESULT]${NC} Installation completed successfully"
|
||||||
|
echo "Run: ./Launch-Unix.sh"
|
||||||
|
echo ""
|
||||||
|
if [[ $BINARY_FREE_MODE -eq 1 ]]; then
|
||||||
|
echo -e "${BLUE}NOTE:${NC} Running in Binary-Free Mode."
|
||||||
|
echo " Free models (GPT-5 Nano, Grok Code, GLM-4.7, etc.) are available."
|
||||||
|
echo " You can also authenticate with Qwen for additional models."
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
exit $ERRORS
|
||||||
267
Install-Windows.bat
Normal file
267
Install-Windows.bat
Normal file
@@ -0,0 +1,267 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal enabledelayedexpansion
|
||||||
|
|
||||||
|
title NomadArch Installer
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo NomadArch Installer (Windows)
|
||||||
|
echo Version: 0.5.0 - Binary-Free Mode
|
||||||
|
echo.
|
||||||
|
|
||||||
|
set SCRIPT_DIR=%~dp0
|
||||||
|
set SCRIPT_DIR=%SCRIPT_DIR:~0,-1%
|
||||||
|
set TARGET_DIR=%SCRIPT_DIR%
|
||||||
|
set BIN_DIR=%TARGET_DIR%\bin
|
||||||
|
set LOG_FILE=%TARGET_DIR%\install.log
|
||||||
|
set TEMP_DIR=%TARGET_DIR%\.install-temp
|
||||||
|
|
||||||
|
set ERRORS=0
|
||||||
|
set WARNINGS=0
|
||||||
|
set NEEDS_FALLBACK=0
|
||||||
|
set SKIP_OPENCODE=0
|
||||||
|
|
||||||
|
echo [%date% %time%] Installer started >> "%LOG_FILE%"
|
||||||
|
|
||||||
|
echo [STEP 1/8] OS and Architecture Detection
|
||||||
|
|
||||||
|
REM Use PowerShell for architecture detection (works on all Windows versions)
|
||||||
|
for /f "tokens=*" %%i in ('powershell -NoProfile -Command "[System.Environment]::Is64BitOperatingSystem"') do set IS64BIT=%%i
|
||||||
|
if /i "%IS64BIT%"=="True" (
|
||||||
|
set ARCH=x64
|
||||||
|
) else (
|
||||||
|
set ARCH=x86
|
||||||
|
)
|
||||||
|
echo [OK] Architecture: %ARCH%
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 2/8] Checking write permissions
|
||||||
|
if not exist "%BIN_DIR%" mkdir "%BIN_DIR%" 2>nul
|
||||||
|
if not exist "%TEMP_DIR%" mkdir "%TEMP_DIR%" 2>nul
|
||||||
|
|
||||||
|
echo. > "%SCRIPT_DIR%\test-write.tmp" 2>nul
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [WARN] Cannot write to current directory: %SCRIPT_DIR%
|
||||||
|
set TARGET_DIR=%USERPROFILE%\NomadArch-Install
|
||||||
|
set BIN_DIR=!TARGET_DIR!\bin
|
||||||
|
set LOG_FILE=!TARGET_DIR!\install.log
|
||||||
|
set TEMP_DIR=!TARGET_DIR!\.install-temp
|
||||||
|
if not exist "!TARGET_DIR!" mkdir "!TARGET_DIR!"
|
||||||
|
if not exist "!BIN_DIR!" mkdir "!BIN_DIR!"
|
||||||
|
if not exist "!TEMP_DIR!" mkdir "!TEMP_DIR!"
|
||||||
|
echo. > "!TARGET_DIR!\test-write.tmp" 2>nul
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] Cannot write to fallback directory: !TARGET_DIR!
|
||||||
|
echo [%date% %time%] ERROR: Write permission denied >> "%LOG_FILE%"
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :SUMMARY
|
||||||
|
)
|
||||||
|
del "!TARGET_DIR!\test-write.tmp"
|
||||||
|
set NEEDS_FALLBACK=1
|
||||||
|
echo [OK] Using fallback: !TARGET_DIR!
|
||||||
|
) else (
|
||||||
|
del "%SCRIPT_DIR%\test-write.tmp"
|
||||||
|
echo [OK] Write permissions verified
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 3/8] Ensuring system dependencies
|
||||||
|
|
||||||
|
set WINGET_AVAILABLE=0
|
||||||
|
where winget >nul 2>&1
|
||||||
|
if !ERRORLEVEL! equ 0 set WINGET_AVAILABLE=1
|
||||||
|
|
||||||
|
set CHOCO_AVAILABLE=0
|
||||||
|
where choco >nul 2>&1
|
||||||
|
if !ERRORLEVEL! equ 0 set CHOCO_AVAILABLE=1
|
||||||
|
|
||||||
|
set DOWNLOAD_CMD=powershell
|
||||||
|
where curl >nul 2>&1
|
||||||
|
if !ERRORLEVEL! equ 0 set DOWNLOAD_CMD=curl
|
||||||
|
|
||||||
|
where node >nul 2>&1
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [INFO] Node.js not found. Attempting to install...
|
||||||
|
if !WINGET_AVAILABLE! equ 1 (
|
||||||
|
winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
|
||||||
|
) else if !CHOCO_AVAILABLE! equ 1 (
|
||||||
|
choco install nodejs-lts -y
|
||||||
|
) else (
|
||||||
|
echo [ERROR] No supported package manager found.
|
||||||
|
echo Please install Node.js LTS from https://nodejs.org/
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :SUMMARY
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
where node >nul 2>&1
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] Node.js install failed or requires a new terminal session.
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :SUMMARY
|
||||||
|
)
|
||||||
|
|
||||||
|
for /f "tokens=*" %%i in ('node --version') do set NODE_VERSION=%%i
|
||||||
|
echo [OK] Node.js: %NODE_VERSION%
|
||||||
|
|
||||||
|
where npm >nul 2>&1
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] npm not found after Node.js install.
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :SUMMARY
|
||||||
|
)
|
||||||
|
|
||||||
|
for /f "tokens=*" %%i in ('npm --version') do set NPM_VERSION=%%i
|
||||||
|
echo [OK] npm: %NPM_VERSION%
|
||||||
|
|
||||||
|
where git >nul 2>&1
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [INFO] Git not found. Attempting to install...
|
||||||
|
if !WINGET_AVAILABLE! equ 1 (
|
||||||
|
winget install -e --id Git.Git --accept-source-agreements --accept-package-agreements
|
||||||
|
) else if !CHOCO_AVAILABLE! equ 1 (
|
||||||
|
choco install git -y
|
||||||
|
) else (
|
||||||
|
echo [WARN] Git not installed - optional
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
)
|
||||||
|
) else (
|
||||||
|
for /f "tokens=*" %%i in ('git --version') do set GIT_VERSION=%%i
|
||||||
|
echo [OK] Git: !GIT_VERSION!
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 4/8] Installing npm dependencies
|
||||||
|
cd /d "%SCRIPT_DIR%"
|
||||||
|
echo [%date% %time%] Running npm install >> "%LOG_FILE%"
|
||||||
|
call npm install
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] npm install failed!
|
||||||
|
echo [%date% %time%] ERROR: npm install failed >> "%LOG_FILE%"
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :SUMMARY
|
||||||
|
)
|
||||||
|
echo [OK] Dependencies installed
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 5/8] OpenCode Binary - OPTIONAL
|
||||||
|
echo.
|
||||||
|
echo [INFO] NomadArch now supports Binary-Free Mode!
|
||||||
|
echo [INFO] You can use the application without OpenCode binary.
|
||||||
|
echo [INFO] Free models from OpenCode Zen are available without the binary.
|
||||||
|
echo.
|
||||||
|
if not exist "%BIN_DIR%" mkdir "%BIN_DIR%" 2>nul
|
||||||
|
|
||||||
|
set /p SKIP_CHOICE="Skip OpenCode binary download? (Y for Binary-Free / N to download) [Y]: "
|
||||||
|
if /i "!SKIP_CHOICE!"=="" set SKIP_CHOICE=Y
|
||||||
|
if /i "!SKIP_CHOICE!"=="Y" goto :skip_opencode_download
|
||||||
|
|
||||||
|
REM Download OpenCode binary
|
||||||
|
echo [INFO] Fetching OpenCode version info...
|
||||||
|
for /f "delims=" %%v in ('powershell -NoProfile -Command "try { (Invoke-WebRequest -UseBasicParsing https://api.github.com/repos/sst/opencode/releases/latest).Content | ConvertFrom-Json | Select-Object -ExpandProperty tag_name } catch { 'v0.1.44' }"') do set OPENCODE_VERSION=%%v
|
||||||
|
set OPENCODE_VERSION=!OPENCODE_VERSION:v=!
|
||||||
|
|
||||||
|
set OPENCODE_BASE=https://github.com/sst/opencode/releases/download/v!OPENCODE_VERSION!
|
||||||
|
set OPENCODE_URL=!OPENCODE_BASE!/opencode-windows-%ARCH%.exe
|
||||||
|
set CHECKSUM_URL=!OPENCODE_BASE!/checksums.txt
|
||||||
|
|
||||||
|
if exist "%BIN_DIR%\opencode.exe" (
|
||||||
|
echo [OK] OpenCode binary already exists
|
||||||
|
echo [%date% %time%] OpenCode binary exists, skipping download >> "%LOG_FILE%"
|
||||||
|
goto :opencode_done
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [INFO] Downloading OpenCode v!OPENCODE_VERSION!...
|
||||||
|
if "!DOWNLOAD_CMD!"=="curl" (
|
||||||
|
curl -L -o "%BIN_DIR%\opencode.exe.tmp" "!OPENCODE_URL!"
|
||||||
|
) else (
|
||||||
|
powershell -NoProfile -Command "Invoke-WebRequest -Uri '!OPENCODE_URL!' -OutFile '%BIN_DIR%\opencode.exe.tmp'"
|
||||||
|
)
|
||||||
|
|
||||||
|
if exist "%BIN_DIR%\opencode.exe.tmp" (
|
||||||
|
move /Y "%BIN_DIR%\opencode.exe.tmp" "%BIN_DIR%\opencode.exe" >nul
|
||||||
|
echo [OK] OpenCode downloaded
|
||||||
|
) else (
|
||||||
|
echo [WARN] OpenCode download failed - using Binary-Free Mode instead
|
||||||
|
set SKIP_OPENCODE=1
|
||||||
|
)
|
||||||
|
goto :opencode_done
|
||||||
|
|
||||||
|
:skip_opencode_download
|
||||||
|
set SKIP_OPENCODE=1
|
||||||
|
echo [INFO] Skipping OpenCode binary - using Binary-Free Mode
|
||||||
|
echo [%date% %time%] Using Binary-Free Mode >> "%LOG_FILE%"
|
||||||
|
|
||||||
|
:opencode_done
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 6/8] Building UI assets
|
||||||
|
if exist "%SCRIPT_DIR%\packages\ui\dist\index.html" (
|
||||||
|
echo [OK] UI build already exists
|
||||||
|
) else (
|
||||||
|
echo [INFO] Building UI assets...
|
||||||
|
pushd packages\ui
|
||||||
|
call npm run build
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] UI build failed!
|
||||||
|
popd
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :SUMMARY
|
||||||
|
)
|
||||||
|
popd
|
||||||
|
echo [OK] UI assets built successfully
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 7/8] Post-install health check
|
||||||
|
set HEALTH_ERRORS=0
|
||||||
|
|
||||||
|
if not exist "%SCRIPT_DIR%\package.json" set /a HEALTH_ERRORS+=1
|
||||||
|
if not exist "%SCRIPT_DIR%\packages\ui" set /a HEALTH_ERRORS+=1
|
||||||
|
if not exist "%SCRIPT_DIR%\packages\server" set /a HEALTH_ERRORS+=1
|
||||||
|
if not exist "%SCRIPT_DIR%\packages\ui\dist\index.html" set /a HEALTH_ERRORS+=1
|
||||||
|
|
||||||
|
if !HEALTH_ERRORS! equ 0 (
|
||||||
|
echo [OK] Health checks passed
|
||||||
|
) else (
|
||||||
|
echo [ERROR] Health checks failed: !HEALTH_ERRORS! issues
|
||||||
|
set /a ERRORS+=!HEALTH_ERRORS!
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 8/8] Installation Summary
|
||||||
|
echo.
|
||||||
|
echo Install Dir: %TARGET_DIR%
|
||||||
|
echo Architecture: %ARCH%
|
||||||
|
echo Node.js: %NODE_VERSION%
|
||||||
|
echo npm: %NPM_VERSION%
|
||||||
|
if !SKIP_OPENCODE! equ 1 (
|
||||||
|
echo Mode: Binary-Free Mode
|
||||||
|
) else (
|
||||||
|
echo Mode: Full Mode with OpenCode binary
|
||||||
|
)
|
||||||
|
echo Errors: !ERRORS!
|
||||||
|
echo Warnings: !WARNINGS!
|
||||||
|
echo Log File: %LOG_FILE%
|
||||||
|
echo.
|
||||||
|
|
||||||
|
:SUMMARY
|
||||||
|
if !ERRORS! gtr 0 (
|
||||||
|
echo [RESULT] Installation completed with errors.
|
||||||
|
echo Review the log: %LOG_FILE%
|
||||||
|
echo.
|
||||||
|
echo If Node.js was just installed, open a new terminal and run this installer again.
|
||||||
|
) else (
|
||||||
|
echo [RESULT] Installation completed successfully.
|
||||||
|
echo Run Launch-Windows.bat to start the application.
|
||||||
|
echo.
|
||||||
|
if !SKIP_OPENCODE! equ 1 (
|
||||||
|
echo NOTE: Running in Binary-Free Mode.
|
||||||
|
echo Free models: GPT-5 Nano, Grok Code, GLM-4.7, etc.
|
||||||
|
echo You can also authenticate with Qwen for additional models.
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo Press any key to exit...
|
||||||
|
pause >nul
|
||||||
|
exit /b !ERRORS!
|
||||||
152
Launch-Dev-Unix.sh
Normal file
152
Launch-Dev-Unix.sh
Normal file
@@ -0,0 +1,152 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# NomadArch Development Launcher for macOS and Linux
|
||||||
|
# Version: 0.4.0
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
BLUE='\033[0;34m'
|
||||||
|
NC='\033[0m'
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
cd "$SCRIPT_DIR"
|
||||||
|
|
||||||
|
ERRORS=0
|
||||||
|
WARNINGS=0
|
||||||
|
AUTO_FIXED=0
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "NomadArch Development Launcher (macOS/Linux)"
|
||||||
|
echo "Version: 0.4.0"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
echo "[PREFLIGHT 1/6] Checking Dependencies..."
|
||||||
|
|
||||||
|
if ! command -v node &> /dev/null; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Node.js not found. Running installer..."
|
||||||
|
if [[ "$OSTYPE" == "darwin"* ]]; then
|
||||||
|
bash "$SCRIPT_DIR/Install-Mac.sh"
|
||||||
|
else
|
||||||
|
bash "$SCRIPT_DIR/Install-Linux.sh"
|
||||||
|
fi
|
||||||
|
echo -e "${BLUE}[INFO]${NC} If Node.js was installed, open a new terminal and run Launch-Dev-Unix.sh again."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
NODE_VERSION=$(node --version)
|
||||||
|
echo -e "${GREEN}[OK]${NC} Node.js: $NODE_VERSION"
|
||||||
|
|
||||||
|
if ! command -v npm &> /dev/null; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} npm not found!"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
NPM_VERSION=$(npm --version)
|
||||||
|
echo -e "${GREEN}[OK]${NC} npm: $NPM_VERSION"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 2/6] Installing dependencies if needed..."
|
||||||
|
|
||||||
|
if [[ ! -d "node_modules" ]]; then
|
||||||
|
echo -e "${YELLOW}[INFO]${NC} Dependencies not installed. Installing now..."
|
||||||
|
npm install
|
||||||
|
echo -e "${GREEN}[OK]${NC} Dependencies installed (auto-fix)"
|
||||||
|
((AUTO_FIXED++))
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 3/6] Finding Available Ports..."
|
||||||
|
|
||||||
|
DEFAULT_SERVER_PORT=3001
|
||||||
|
DEFAULT_UI_PORT=3000
|
||||||
|
SERVER_PORT=$DEFAULT_SERVER_PORT
|
||||||
|
UI_PORT=$DEFAULT_UI_PORT
|
||||||
|
|
||||||
|
for port in {3001..3050}; do
|
||||||
|
# Try lsof first, then ss, then netstat
|
||||||
|
if command -v lsof &> /dev/null; then
|
||||||
|
if ! lsof -i :$port -sTCP:LISTEN -t > /dev/null 2>&1; then
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
elif command -v ss &> /dev/null; then
|
||||||
|
if ! ss -tuln | grep -q ":$port "; then
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
elif command -v netstat &> /dev/null; then
|
||||||
|
if ! netstat -tuln | grep -q ":$port "; then
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
for port in {3000..3050}; do
|
||||||
|
# Try lsof first, then ss, then netstat
|
||||||
|
if command -v lsof &> /dev/null; then
|
||||||
|
if ! lsof -i :$port -sTCP:LISTEN -t > /dev/null 2>&1; then
|
||||||
|
UI_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
elif command -v ss &> /dev/null; then
|
||||||
|
if ! ss -tuln | grep -q ":$port "; then
|
||||||
|
UI_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
elif command -v netstat &> /dev/null; then
|
||||||
|
if ! netstat -tuln | grep -q ":$port "; then
|
||||||
|
UI_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
UI_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
echo -e "${GREEN}[OK]${NC} Server port: $SERVER_PORT"
|
||||||
|
echo -e "${GREEN}[OK]${NC} UI port: $UI_PORT"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 4/6] Launch Summary"
|
||||||
|
|
||||||
|
echo -e "${BLUE}[STATUS]${NC}"
|
||||||
|
echo ""
|
||||||
|
echo " Node.js: $NODE_VERSION"
|
||||||
|
echo " npm: $NPM_VERSION"
|
||||||
|
echo " Auto-fixes applied: $AUTO_FIXED"
|
||||||
|
echo " Warnings: $WARNINGS"
|
||||||
|
echo " Errors: $ERRORS"
|
||||||
|
echo " Server Port: $SERVER_PORT"
|
||||||
|
echo " UI Port: $UI_PORT"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 5/6] Starting services..."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
export CLI_PORT=$SERVER_PORT
|
||||||
|
export VITE_PORT=$UI_PORT
|
||||||
|
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Starting backend server..."
|
||||||
|
nohup bash -c "cd '$SCRIPT_DIR/packages/server' && npm run dev" >/dev/null 2>&1 &
|
||||||
|
|
||||||
|
sleep 2
|
||||||
|
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Starting UI server..."
|
||||||
|
nohup bash -c "cd '$SCRIPT_DIR/packages/ui' && npm run dev -- --port $UI_PORT" >/dev/null 2>&1 &
|
||||||
|
|
||||||
|
sleep 2
|
||||||
|
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Starting Electron app..."
|
||||||
|
npm run dev:electron
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 6/6] Done."
|
||||||
192
Launch-Dev-Windows.bat
Normal file
192
Launch-Dev-Windows.bat
Normal file
@@ -0,0 +1,192 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal enabledelayedexpansion
|
||||||
|
|
||||||
|
title NomadArch Development Launcher
|
||||||
|
color 0B
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo NomadArch Development Launcher (Windows)
|
||||||
|
echo Version: 0.5.0 - Binary-Free Mode
|
||||||
|
echo.
|
||||||
|
|
||||||
|
set SCRIPT_DIR=%~dp0
|
||||||
|
set SCRIPT_DIR=%SCRIPT_DIR:~0,-1%
|
||||||
|
cd /d "%SCRIPT_DIR%"
|
||||||
|
|
||||||
|
set ERRORS=0
|
||||||
|
set WARNINGS=0
|
||||||
|
set AUTO_FIXED=0
|
||||||
|
set BINARY_FREE_MODE=0
|
||||||
|
|
||||||
|
echo [PREFLIGHT 1/7] Checking Dependencies...
|
||||||
|
|
||||||
|
where node >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Node.js not found. Running installer...
|
||||||
|
call "%SCRIPT_DIR%\Install-Windows.bat"
|
||||||
|
echo [INFO] If Node.js was installed, open a new terminal and run Launch-Dev-Windows.bat again.
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
for /f "tokens=*" %%i in ('node --version') do set NODE_VERSION=%%i
|
||||||
|
echo [OK] Node.js: %NODE_VERSION%
|
||||||
|
|
||||||
|
where npm >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [ERROR] npm not found!
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
for /f "tokens=*" %%i in ('npm --version') do set NPM_VERSION=%%i
|
||||||
|
echo [OK] npm: %NPM_VERSION%
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 2/7] Checking for OpenCode CLI...
|
||||||
|
|
||||||
|
where opencode >nul 2>&1
|
||||||
|
if %ERRORLEVEL% equ 0 (
|
||||||
|
echo [OK] OpenCode CLI in PATH - Full Mode
|
||||||
|
goto :opencode_check_done
|
||||||
|
)
|
||||||
|
|
||||||
|
if exist "bin\opencode.exe" (
|
||||||
|
echo [OK] OpenCode binary in bin/ - Full Mode
|
||||||
|
goto :opencode_check_done
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [INFO] OpenCode CLI not found - Using Binary-Free Mode
|
||||||
|
echo [INFO] Free models: GPT-5 Nano, Grok Code, GLM-4.7 via OpenCode Zen
|
||||||
|
set BINARY_FREE_MODE=1
|
||||||
|
|
||||||
|
:opencode_check_done
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 3/7] Checking Dependencies...
|
||||||
|
|
||||||
|
if not exist "node_modules" (
|
||||||
|
echo [INFO] Dependencies not installed. Installing now...
|
||||||
|
call npm install
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] Dependency installation failed!
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
echo [OK] Dependencies installed
|
||||||
|
set /a AUTO_FIXED+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] Dependencies found
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 4/7] Finding Available Ports...
|
||||||
|
|
||||||
|
set DEFAULT_SERVER_PORT=3001
|
||||||
|
set DEFAULT_UI_PORT=3000
|
||||||
|
set SERVER_PORT=%DEFAULT_SERVER_PORT%
|
||||||
|
set UI_PORT=%DEFAULT_UI_PORT%
|
||||||
|
|
||||||
|
for /l %%p in (%DEFAULT_SERVER_PORT%,1,3050) do (
|
||||||
|
netstat -ano | findstr ":%%p " | findstr "LISTENING" >nul
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
set SERVER_PORT=%%p
|
||||||
|
goto :server_port_found
|
||||||
|
)
|
||||||
|
)
|
||||||
|
:server_port_found
|
||||||
|
|
||||||
|
for /l %%p in (%DEFAULT_UI_PORT%,1,3050) do (
|
||||||
|
netstat -ano | findstr ":%%p " | findstr "LISTENING" >nul
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
set UI_PORT=%%p
|
||||||
|
goto :ui_port_found
|
||||||
|
)
|
||||||
|
)
|
||||||
|
:ui_port_found
|
||||||
|
|
||||||
|
echo [OK] Server port: !SERVER_PORT!
|
||||||
|
echo [OK] UI port: !UI_PORT!
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 5/7] Final Checks...
|
||||||
|
|
||||||
|
if not exist "packages\ui\dist\index.html" (
|
||||||
|
echo [WARN] UI build directory not found
|
||||||
|
echo [INFO] Running UI build...
|
||||||
|
pushd packages\ui
|
||||||
|
call npm run build
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] UI build failed!
|
||||||
|
popd
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :launch_check
|
||||||
|
)
|
||||||
|
popd
|
||||||
|
echo [OK] UI build completed
|
||||||
|
set /a AUTO_FIXED+=1
|
||||||
|
)
|
||||||
|
|
||||||
|
if not exist "packages\electron-app\dist\main\main.js" (
|
||||||
|
echo [WARN] Electron build incomplete
|
||||||
|
echo [INFO] Running full build...
|
||||||
|
call npm run build
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] Full build failed!
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :launch_check
|
||||||
|
)
|
||||||
|
echo [OK] Full build completed
|
||||||
|
set /a AUTO_FIXED+=1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 6/7] Launch Summary
|
||||||
|
|
||||||
|
echo [STATUS]
|
||||||
|
echo.
|
||||||
|
echo Node.js: %NODE_VERSION%
|
||||||
|
echo npm: %NPM_VERSION%
|
||||||
|
if !BINARY_FREE_MODE! equ 1 (
|
||||||
|
echo Mode: Binary-Free Mode
|
||||||
|
) else (
|
||||||
|
echo Mode: Full Mode with OpenCode
|
||||||
|
)
|
||||||
|
echo Auto-fixes applied: !AUTO_FIXED!
|
||||||
|
echo Warnings: !WARNINGS!
|
||||||
|
echo Errors: !ERRORS!
|
||||||
|
echo Server Port: !SERVER_PORT!
|
||||||
|
echo UI Port: !UI_PORT!
|
||||||
|
echo.
|
||||||
|
|
||||||
|
if !ERRORS! gtr 0 (
|
||||||
|
echo [RESULT] Cannot start due to errors!
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 7/7] Starting NomadArch in Development Mode...
|
||||||
|
echo [INFO] Server: http://localhost:!SERVER_PORT!
|
||||||
|
echo [INFO] UI: http://localhost:!UI_PORT!
|
||||||
|
echo.
|
||||||
|
|
||||||
|
start "NomadArch Server" cmd /k "cd /d \"%~dp0packages\server\" && set CLI_PORT=!SERVER_PORT! && npm run dev"
|
||||||
|
timeout /t 3 /nobreak >nul
|
||||||
|
start "NomadArch UI" cmd /k "cd /d \"%~dp0packages\ui\" && set VITE_PORT=!UI_PORT! && npm run dev -- --port !UI_PORT!"
|
||||||
|
timeout /t 3 /nobreak >nul
|
||||||
|
start "NomadArch Electron" cmd /k "cd /d \"%~dp0packages\electron-app\" && npm run dev"
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [OK] All services started.
|
||||||
|
echo Press any key to stop all services...
|
||||||
|
pause >nul
|
||||||
|
|
||||||
|
taskkill /F /FI "WINDOWTITLE eq NomadArch*" >nul 2>&1
|
||||||
|
taskkill /F /FI "WINDOWTITLE eq NomadArch Server*" >nul 2>&1
|
||||||
|
taskkill /F /FI "WINDOWTITLE eq NomadArch UI*" >nul 2>&1
|
||||||
|
taskkill /F /FI "WINDOWTITLE eq NomadArch Electron*" >nul 2>&1
|
||||||
|
|
||||||
|
:launch_check
|
||||||
|
pause
|
||||||
|
exit /b !ERRORS!
|
||||||
62
Launch-Unix-Prod.sh
Normal file
62
Launch-Unix-Prod.sh
Normal file
@@ -0,0 +1,62 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# NomadArch Production Launcher for macOS and Linux
|
||||||
|
# Version: 0.4.0
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
BLUE='\033[0;34m'
|
||||||
|
NC='\033[0m'
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
cd "$SCRIPT_DIR"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "NomadArch Launcher (macOS/Linux, Production Mode)"
|
||||||
|
echo "Version: 0.4.0"
|
||||||
|
echo "Features: SMART FIX / APEX / SHIELD / MULTIX MODE"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
echo "[STEP 1/3] Checking Dependencies..."
|
||||||
|
|
||||||
|
if ! command -v node &> /dev/null; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} Node.js not found!"
|
||||||
|
echo "Please run the installer first:"
|
||||||
|
if [[ "$OSTYPE" == "darwin"* ]]; then
|
||||||
|
echo " ./Install-Mac.sh"
|
||||||
|
else
|
||||||
|
echo " ./Install-Linux.sh"
|
||||||
|
fi
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
NODE_VERSION=$(node --version)
|
||||||
|
echo -e "${GREEN}[OK]${NC} Node.js: $NODE_VERSION"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 2/3] Checking Pre-Built UI..."
|
||||||
|
|
||||||
|
if [[ -d "packages/electron-app/dist/renderer/assets" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} Pre-built UI assets found"
|
||||||
|
else
|
||||||
|
echo -e "${RED}[ERROR]${NC} Pre-built UI assets not found."
|
||||||
|
echo "Run: npm run build"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[STEP 3/3] Starting NomadArch (Production Mode)..."
|
||||||
|
|
||||||
|
cd packages/electron-app
|
||||||
|
npx electron .
|
||||||
|
EXIT_CODE=$?
|
||||||
|
|
||||||
|
if [[ $EXIT_CODE -ne 0 ]]; then
|
||||||
|
echo ""
|
||||||
|
echo -e "${RED}[ERROR]${NC} NomadArch exited with an error!"
|
||||||
|
fi
|
||||||
|
|
||||||
|
exit $EXIT_CODE
|
||||||
195
Launch-Unix.sh
Normal file
195
Launch-Unix.sh
Normal file
@@ -0,0 +1,195 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# NomadArch Launcher for macOS and Linux
|
||||||
|
# Version: 0.5.0 - Binary-Free Mode
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
BLUE='\033[0;34m'
|
||||||
|
NC='\033[0m'
|
||||||
|
|
||||||
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
cd "$SCRIPT_DIR"
|
||||||
|
|
||||||
|
ERRORS=0
|
||||||
|
WARNINGS=0
|
||||||
|
AUTO_FIXED=0
|
||||||
|
BINARY_FREE_MODE=0
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "NomadArch Launcher (macOS/Linux)"
|
||||||
|
echo "Version: 0.5.0 - Binary-Free Mode"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
echo "[PREFLIGHT 1/7] Checking Dependencies..."
|
||||||
|
|
||||||
|
if ! command -v node &> /dev/null; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Node.js not found. Running installer..."
|
||||||
|
if [[ "$OSTYPE" == "darwin"* ]]; then
|
||||||
|
bash "$SCRIPT_DIR/Install-Mac.sh"
|
||||||
|
else
|
||||||
|
bash "$SCRIPT_DIR/Install-Linux.sh"
|
||||||
|
fi
|
||||||
|
echo -e "${BLUE}[INFO]${NC} If Node.js was installed, open a new terminal and run Launch-Unix.sh again."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
NODE_VERSION=$(node --version)
|
||||||
|
echo -e "${GREEN}[OK]${NC} Node.js: $NODE_VERSION"
|
||||||
|
|
||||||
|
if ! command -v npm &> /dev/null; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} npm not found!"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
NPM_VERSION=$(npm --version)
|
||||||
|
echo -e "${GREEN}[OK]${NC} npm: $NPM_VERSION"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 2/7] Checking for OpenCode CLI (Optional)..."
|
||||||
|
|
||||||
|
if command -v opencode &> /dev/null; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} OpenCode CLI available in PATH - Full Mode"
|
||||||
|
elif [[ -f "$SCRIPT_DIR/bin/opencode" ]]; then
|
||||||
|
echo -e "${GREEN}[OK]${NC} OpenCode binary found in bin/ - Full Mode"
|
||||||
|
else
|
||||||
|
echo -e "${BLUE}[INFO]${NC} OpenCode CLI not found - Using Binary-Free Mode"
|
||||||
|
echo -e "${BLUE}[INFO]${NC} Free models (GPT-5 Nano, Grok Code, GLM-4.7) available via OpenCode Zen"
|
||||||
|
BINARY_FREE_MODE=1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 3/7] Checking Dependencies..."
|
||||||
|
|
||||||
|
if [[ ! -d "node_modules" ]]; then
|
||||||
|
echo -e "${YELLOW}[INFO]${NC} Dependencies not installed. Installing now..."
|
||||||
|
if ! npm install; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} Dependency installation failed!"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo -e "${GREEN}[OK]${NC} Dependencies installed (auto-fix)"
|
||||||
|
((AUTO_FIXED++))
|
||||||
|
else
|
||||||
|
echo -e "${GREEN}[OK]${NC} Dependencies found"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 4/7] Finding Available Port..."
|
||||||
|
|
||||||
|
DEFAULT_SERVER_PORT=3001
|
||||||
|
DEFAULT_UI_PORT=3000
|
||||||
|
SERVER_PORT=$DEFAULT_SERVER_PORT
|
||||||
|
UI_PORT=$DEFAULT_UI_PORT
|
||||||
|
|
||||||
|
for port in {3001..3050}; do
|
||||||
|
# Try lsof first, then ss, then netstat
|
||||||
|
if command -v lsof &> /dev/null; then
|
||||||
|
if ! lsof -i :$port -sTCP:LISTEN -t > /dev/null 2>&1; then
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
elif command -v ss &> /dev/null; then
|
||||||
|
if ! ss -tuln | grep -q ":$port "; then
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
elif command -v netstat &> /dev/null; then
|
||||||
|
if ! netstat -tuln | grep -q ":$port "; then
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
# No port checking tools, just use default
|
||||||
|
SERVER_PORT=$port
|
||||||
|
break
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
|
echo -e "${GREEN}[OK]${NC} Server port: $SERVER_PORT"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 5/7] Final Checks..."
|
||||||
|
|
||||||
|
if [[ ! -d "packages/ui/dist" ]]; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} UI build directory not found"
|
||||||
|
echo -e "${YELLOW}[INFO]${NC} Running UI build..."
|
||||||
|
pushd packages/ui >/dev/null
|
||||||
|
if ! npm run build; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} UI build failed!"
|
||||||
|
popd >/dev/null
|
||||||
|
((ERRORS++))
|
||||||
|
else
|
||||||
|
popd >/dev/null
|
||||||
|
echo -e "${GREEN}[OK]${NC} UI build completed (auto-fix)"
|
||||||
|
((AUTO_FIXED++))
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo -e "${GREEN}[OK]${NC} UI build directory exists"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ ! -f "packages/electron-app/dist/main/main.js" ]]; then
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} Electron build incomplete"
|
||||||
|
echo -e "${YELLOW}[INFO]${NC} Running full build..."
|
||||||
|
if ! npm run build; then
|
||||||
|
echo -e "${RED}[ERROR]${NC} Full build failed!"
|
||||||
|
((ERRORS++))
|
||||||
|
else
|
||||||
|
echo -e "${GREEN}[OK]${NC} Full build completed (auto-fix)"
|
||||||
|
((AUTO_FIXED++))
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
echo -e "${GREEN}[OK]${NC} Electron build exists"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "[PREFLIGHT 6/7] Launch Summary"
|
||||||
|
|
||||||
|
echo -e "${BLUE}[STATUS]${NC}"
|
||||||
|
echo ""
|
||||||
|
echo " Node.js: $NODE_VERSION"
|
||||||
|
echo " npm: $NPM_VERSION"
|
||||||
|
if [[ $BINARY_FREE_MODE -eq 1 ]]; then
|
||||||
|
echo " Mode: Binary-Free Mode (No OpenCode binary required)"
|
||||||
|
echo " Free Models: GPT-5 Nano, Grok Code, GLM-4.7, Doubao, Big Pickle"
|
||||||
|
else
|
||||||
|
echo " Mode: Full Mode (OpenCode binary available)"
|
||||||
|
fi
|
||||||
|
echo " Auto-fixes applied: $AUTO_FIXED"
|
||||||
|
echo " Warnings: $WARNINGS"
|
||||||
|
echo " Errors: $ERRORS"
|
||||||
|
echo " Server Port: $SERVER_PORT"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
if [[ $ERRORS -gt 0 ]]; then
|
||||||
|
echo -e "${RED}[RESULT]${NC} Cannot start due to errors!"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Starting NomadArch..."
|
||||||
|
echo -e "${GREEN}[INFO]${NC} Server will run on http://localhost:$SERVER_PORT"
|
||||||
|
echo -e "${YELLOW}[INFO]${NC} Press Ctrl+C to stop"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
SERVER_URL="http://localhost:$SERVER_PORT"
|
||||||
|
|
||||||
|
if [[ "$OSTYPE" == "darwin"* ]]; then
|
||||||
|
open "$SERVER_URL" 2>/dev/null || true
|
||||||
|
elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
|
||||||
|
xdg-open "$SERVER_URL" 2>/dev/null || true
|
||||||
|
fi
|
||||||
|
|
||||||
|
export CLI_PORT=$SERVER_PORT
|
||||||
|
export NOMADARCH_BINARY_FREE_MODE=$BINARY_FREE_MODE
|
||||||
|
npm run dev:electron
|
||||||
|
|
||||||
|
EXIT_CODE=$?
|
||||||
|
|
||||||
|
if [[ $EXIT_CODE -ne 0 ]]; then
|
||||||
|
echo ""
|
||||||
|
echo -e "${RED}[ERROR]${NC} NomadArch exited with an error!"
|
||||||
|
fi
|
||||||
|
|
||||||
|
exit $EXIT_CODE
|
||||||
57
Launch-Windows-Prod.bat
Normal file
57
Launch-Windows-Prod.bat
Normal file
@@ -0,0 +1,57 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal enabledelayedexpansion
|
||||||
|
|
||||||
|
title NomadArch Launcher (Production Mode)
|
||||||
|
color 0A
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo NomadArch Launcher (Windows, Production Mode)
|
||||||
|
echo Version: 0.4.0
|
||||||
|
echo Features: SMART FIX / APEX / SHIELD / MULTIX MODE
|
||||||
|
echo.
|
||||||
|
|
||||||
|
set SCRIPT_DIR=%~dp0
|
||||||
|
set SCRIPT_DIR=%SCRIPT_DIR:~0,-1%
|
||||||
|
cd /d "%SCRIPT_DIR%"
|
||||||
|
|
||||||
|
echo [STEP 1/3] Checking Dependencies...
|
||||||
|
|
||||||
|
where node >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Node.js not found. Running installer...
|
||||||
|
call "%SCRIPT_DIR%\Install-Windows.bat"
|
||||||
|
echo [INFO] If Node.js was installed, open a new terminal and run Launch-Windows-Prod.bat again.
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
for /f "tokens=*" %%i in ('node --version') do set NODE_VERSION=%%i
|
||||||
|
echo [OK] Node.js: %NODE_VERSION%
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 2/3] Checking Pre-Built UI...
|
||||||
|
|
||||||
|
if exist "packages\electron-app\dist\renderer\assets" (
|
||||||
|
echo [OK] Pre-built UI assets found
|
||||||
|
) else (
|
||||||
|
echo [ERROR] Pre-built UI assets not found.
|
||||||
|
echo Run: npm run build
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [STEP 3/3] Starting NomadArch (Production Mode)...
|
||||||
|
|
||||||
|
pushd packages\electron-app
|
||||||
|
npx electron .
|
||||||
|
popd
|
||||||
|
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo.
|
||||||
|
echo [ERROR] NomadArch exited with an error!
|
||||||
|
echo.
|
||||||
|
)
|
||||||
|
|
||||||
|
pause
|
||||||
|
exit /b %ERRORLEVEL%
|
||||||
215
Launch-Windows.bat
Normal file
215
Launch-Windows.bat
Normal file
@@ -0,0 +1,215 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal enabledelayedexpansion
|
||||||
|
|
||||||
|
title NomadArch Launcher
|
||||||
|
color 0A
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo NomadArch Launcher (Windows)
|
||||||
|
echo Version: 0.5.0 - Binary-Free Mode
|
||||||
|
echo.
|
||||||
|
|
||||||
|
set SCRIPT_DIR=%~dp0
|
||||||
|
set SCRIPT_DIR=%SCRIPT_DIR:~0,-1%
|
||||||
|
cd /d "%SCRIPT_DIR%"
|
||||||
|
|
||||||
|
set ERRORS=0
|
||||||
|
set WARNINGS=0
|
||||||
|
set AUTO_FIXED=0
|
||||||
|
set BINARY_FREE_MODE=0
|
||||||
|
|
||||||
|
echo [PREFLIGHT 1/7] Checking Dependencies...
|
||||||
|
|
||||||
|
where node >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [WARN] Node.js not found. Running installer...
|
||||||
|
call "%SCRIPT_DIR%\Install-Windows.bat"
|
||||||
|
echo [INFO] If Node.js was installed, open a new terminal and run Launch-Windows.bat again.
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
for /f "tokens=*" %%i in ('node --version') do set NODE_VERSION=%%i
|
||||||
|
echo [OK] Node.js: %NODE_VERSION%
|
||||||
|
|
||||||
|
where npm >nul 2>&1
|
||||||
|
if %ERRORLEVEL% neq 0 (
|
||||||
|
echo [ERROR] npm not found!
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
for /f "tokens=*" %%i in ('npm --version') do set NPM_VERSION=%%i
|
||||||
|
echo [OK] npm: %NPM_VERSION%
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 2/7] Checking OpenCode CLI...
|
||||||
|
|
||||||
|
where opencode >nul 2>&1
|
||||||
|
if %ERRORLEVEL% equ 0 (
|
||||||
|
echo [OK] OpenCode CLI in PATH - Full Mode
|
||||||
|
goto :opencode_check_done
|
||||||
|
)
|
||||||
|
|
||||||
|
if exist "bin\opencode.exe" (
|
||||||
|
echo [OK] OpenCode binary in bin/ - Full Mode
|
||||||
|
goto :opencode_check_done
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [INFO] OpenCode CLI not found - Using Binary-Free Mode
|
||||||
|
echo [INFO] Free models: GPT-5 Nano, Grok Code, GLM-4.7 via OpenCode Zen
|
||||||
|
set BINARY_FREE_MODE=1
|
||||||
|
|
||||||
|
:opencode_check_done
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 3/7] Checking Dependencies...
|
||||||
|
|
||||||
|
if not exist "node_modules" (
|
||||||
|
echo [INFO] Dependencies not installed. Installing now...
|
||||||
|
call npm install
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] Dependency installation failed!
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
echo [OK] Dependencies installed
|
||||||
|
set /a AUTO_FIXED+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] Dependencies found
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 4/7] Finding Available Port...
|
||||||
|
|
||||||
|
set DEFAULT_SERVER_PORT=3001
|
||||||
|
set DEFAULT_UI_PORT=3000
|
||||||
|
set SERVER_PORT=%DEFAULT_SERVER_PORT%
|
||||||
|
set UI_PORT=%DEFAULT_UI_PORT%
|
||||||
|
|
||||||
|
for /l %%p in (%DEFAULT_SERVER_PORT%,1,3050) do (
|
||||||
|
netstat -ano | findstr ":%%p " | findstr "LISTENING" >nul
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
set SERVER_PORT=%%p
|
||||||
|
goto :server_port_found
|
||||||
|
)
|
||||||
|
)
|
||||||
|
:server_port_found
|
||||||
|
|
||||||
|
echo [OK] Server port: !SERVER_PORT!
|
||||||
|
|
||||||
|
if !SERVER_PORT! neq %DEFAULT_SERVER_PORT% (
|
||||||
|
echo [INFO] Port %DEFAULT_SERVER_PORT% was in use, using !SERVER_PORT! instead
|
||||||
|
set /a WARNINGS+=1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 5/7] Final Checks...
|
||||||
|
|
||||||
|
if not exist "packages\ui\dist\index.html" (
|
||||||
|
echo [WARN] UI build directory not found
|
||||||
|
echo [INFO] Running UI build...
|
||||||
|
pushd packages\ui
|
||||||
|
call npm run build
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] UI build failed!
|
||||||
|
popd
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :final_launch_check
|
||||||
|
)
|
||||||
|
popd
|
||||||
|
echo [OK] UI build completed
|
||||||
|
set /a AUTO_FIXED+=1
|
||||||
|
) else (
|
||||||
|
echo [OK] UI build directory exists
|
||||||
|
)
|
||||||
|
|
||||||
|
if not exist "packages\electron-app\dist\main\main.js" (
|
||||||
|
echo [WARN] Electron build incomplete
|
||||||
|
echo [INFO] Running full build...
|
||||||
|
call npm run build
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo [ERROR] Full build failed!
|
||||||
|
set /a ERRORS+=1
|
||||||
|
goto :final_launch_check
|
||||||
|
)
|
||||||
|
echo [OK] Full build completed
|
||||||
|
set /a AUTO_FIXED+=1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo [PREFLIGHT 6/7] Launch Summary
|
||||||
|
|
||||||
|
echo [STATUS]
|
||||||
|
echo.
|
||||||
|
echo Node.js: %NODE_VERSION%
|
||||||
|
echo npm: %NPM_VERSION%
|
||||||
|
if !BINARY_FREE_MODE! equ 1 (
|
||||||
|
echo Mode: Binary-Free Mode
|
||||||
|
echo Free Models: GPT-5 Nano, Grok Code, GLM-4.7, Doubao, Big Pickle
|
||||||
|
) else (
|
||||||
|
echo Mode: Full Mode with OpenCode
|
||||||
|
)
|
||||||
|
echo Auto-fixes applied: !AUTO_FIXED!
|
||||||
|
echo Warnings: !WARNINGS!
|
||||||
|
echo Errors: !ERRORS!
|
||||||
|
echo Server Port: !SERVER_PORT!
|
||||||
|
echo.
|
||||||
|
|
||||||
|
if !ERRORS! gtr 0 (
|
||||||
|
echo [RESULT] Cannot start due to errors!
|
||||||
|
echo.
|
||||||
|
echo Please fix the errors above and try again.
|
||||||
|
pause
|
||||||
|
exit /b 1
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [INFO] Starting NomadArch...
|
||||||
|
echo [INFO] Server will run on http://localhost:!SERVER_PORT!
|
||||||
|
echo [INFO] UI will run on http://localhost:!UI_PORT!
|
||||||
|
echo [INFO] Press Ctrl+C to stop
|
||||||
|
echo.
|
||||||
|
|
||||||
|
set SERVER_URL=http://localhost:!SERVER_PORT!
|
||||||
|
set VITE_PORT=!UI_PORT!
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo ========================================
|
||||||
|
echo Starting UI dev server on port !UI_PORT!...
|
||||||
|
echo ========================================
|
||||||
|
|
||||||
|
pushd packages\ui
|
||||||
|
start "NomadArch UI Server" cmd /c "set VITE_PORT=!UI_PORT! && npm run dev"
|
||||||
|
popd
|
||||||
|
|
||||||
|
echo [INFO] Waiting for UI dev server to start...
|
||||||
|
timeout /t 3 /nobreak >nul
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo ========================================
|
||||||
|
echo Starting Electron app...
|
||||||
|
echo ========================================
|
||||||
|
|
||||||
|
set "VITE_DEV_SERVER_URL=http://localhost:!UI_PORT!"
|
||||||
|
set "NOMADARCH_OPEN_DEVTOOLS=false"
|
||||||
|
set "NOMADARCH_BINARY_FREE_MODE=!BINARY_FREE_MODE!"
|
||||||
|
call npm run dev:electron
|
||||||
|
|
||||||
|
if !ERRORLEVEL! neq 0 (
|
||||||
|
echo.
|
||||||
|
echo [ERROR] NomadArch exited with an error!
|
||||||
|
echo.
|
||||||
|
echo Error Code: !ERRORLEVEL!
|
||||||
|
echo.
|
||||||
|
echo Troubleshooting:
|
||||||
|
echo 1. Ensure port !SERVER_PORT! is not in use
|
||||||
|
echo 2. Run Install-Windows.bat again
|
||||||
|
echo 3. Check log file: packages\electron-app\.log
|
||||||
|
echo.
|
||||||
|
)
|
||||||
|
|
||||||
|
:final_launch_check
|
||||||
|
echo.
|
||||||
|
echo Press any key to exit...
|
||||||
|
pause >nul
|
||||||
|
exit /b !ERRORS!
|
||||||
149
PROGRESS.md
Normal file
149
PROGRESS.md
Normal file
@@ -0,0 +1,149 @@
|
|||||||
|
# CodeNomad - Development Progress
|
||||||
|
|
||||||
|
## Completed Tasks
|
||||||
|
|
||||||
|
### Task 001: Project Setup ✅
|
||||||
|
- Set up Electron + SolidJS + Vite + TypeScript
|
||||||
|
- Configured TailwindCSS v3 (downgraded from v4 for electron-vite compatibility)
|
||||||
|
- Build pipeline with electron-vite
|
||||||
|
- Application window management
|
||||||
|
- Application menu with keyboard shortcuts
|
||||||
|
|
||||||
|
### Task 002: Empty State UI & Folder Selection ✅
|
||||||
|
- Empty state component with styled UI
|
||||||
|
- Native folder picker integration
|
||||||
|
- IPC handlers for folder selection
|
||||||
|
- UI state management with SolidJS signals
|
||||||
|
- Loading states with spinner
|
||||||
|
- Keyboard shortcuts (Cmd/Ctrl+N)
|
||||||
|
|
||||||
|
### Task 003: Process Manager ✅
|
||||||
|
- Process spawning: `opencode serve --port 0`
|
||||||
|
- Port detection from stdout (regex: `opencode server listening on http://...`)
|
||||||
|
- Process lifecycle management (spawn, kill, cleanup)
|
||||||
|
- IPC communication for instance management
|
||||||
|
- Instance state tracking (starting → ready → stopped/error)
|
||||||
|
- Auto-cleanup on app quit
|
||||||
|
- Error handling & timeout protection (10s)
|
||||||
|
- Graceful shutdown (SIGTERM → SIGKILL)
|
||||||
|
|
||||||
|
### Task 004: SDK Integration ✅
|
||||||
|
- Installed `@opencode-ai/sdk` package
|
||||||
|
- SDK manager for client lifecycle
|
||||||
|
- Session fetching from OpenCode server
|
||||||
|
- Agent fetching (`client.app.agents()`)
|
||||||
|
- Provider fetching (`client.config.providers()`)
|
||||||
|
- Session store with SolidJS signals
|
||||||
|
- Instance store updated with SDK client
|
||||||
|
- Loading states for async operations
|
||||||
|
- Error handling for network failures
|
||||||
|
|
||||||
|
### Task 005: Session Picker Modal ✅
|
||||||
|
- Modal dialog with Kobalte Dialog
|
||||||
|
- Lists ALL existing sessions (scrollable)
|
||||||
|
- Session metadata display (title, relative timestamp)
|
||||||
|
- Native HTML select dropdown for agents
|
||||||
|
- Auto-selects first agent by default
|
||||||
|
- Create new session with selected agent
|
||||||
|
- Cancel button stops instance and closes modal
|
||||||
|
- Resume session on click
|
||||||
|
- Empty state for no sessions
|
||||||
|
- Loading state for agents
|
||||||
|
- Keyboard navigation (Escape to cancel)
|
||||||
|
|
||||||
|
## Current State
|
||||||
|
|
||||||
|
**Working Features:**
|
||||||
|
- ✅ App launches with empty state
|
||||||
|
- ✅ Folder selection via native dialog
|
||||||
|
- ✅ OpenCode server spawning per folder
|
||||||
|
- ✅ Port extraction and process tracking
|
||||||
|
- ✅ SDK client connection to running servers
|
||||||
|
- ✅ Session list fetching and display
|
||||||
|
- ✅ Agent and provider data fetching
|
||||||
|
- ✅ Session picker modal on instance creation
|
||||||
|
- ✅ Resume existing sessions
|
||||||
|
- ✅ Create new sessions with agent selection
|
||||||
|
|
||||||
|
**File Structure:**
|
||||||
|
```
|
||||||
|
packages/opencode-client/
|
||||||
|
├── electron/
|
||||||
|
│ ├── main/
|
||||||
|
│ │ ├── main.ts (window + IPC setup)
|
||||||
|
│ │ ├── menu.ts (app menu)
|
||||||
|
│ │ ├── ipc.ts (instance IPC handlers)
|
||||||
|
│ │ └── process-manager.ts (server spawning)
|
||||||
|
│ └── preload/
|
||||||
|
│ └── index.ts (IPC bridge)
|
||||||
|
├── src/
|
||||||
|
│ ├── components/
|
||||||
|
│ │ ├── empty-state.tsx
|
||||||
|
│ │ └── session-picker.tsx
|
||||||
|
│ ├── lib/
|
||||||
|
│ │ └── sdk-manager.ts
|
||||||
|
│ ├── stores/
|
||||||
|
│ │ ├── ui.ts
|
||||||
|
│ │ ├── instances.ts
|
||||||
|
│ │ └── sessions.ts
|
||||||
|
│ ├── types/
|
||||||
|
│ │ ├── electron.d.ts
|
||||||
|
│ │ ├── instance.ts
|
||||||
|
│ │ └── session.ts
|
||||||
|
│ └── App.tsx
|
||||||
|
├── tasks/
|
||||||
|
│ ├── done/ (001-005)
|
||||||
|
│ └── todo/ (006+)
|
||||||
|
└── docs/
|
||||||
|
```
|
||||||
|
|
||||||
|
## Next Steps
|
||||||
|
|
||||||
|
### Task 006: Message Stream UI (NEXT)
|
||||||
|
- Message display component
|
||||||
|
- User/assistant message rendering
|
||||||
|
- Markdown support with syntax highlighting
|
||||||
|
- Tool use visualization
|
||||||
|
- Auto-scroll behavior
|
||||||
|
|
||||||
|
### Task 007: Prompt Input
|
||||||
|
- Text input with multi-line support
|
||||||
|
- Send button
|
||||||
|
- File attachment support
|
||||||
|
- Keyboard shortcuts (Enter for new line; Cmd+Enter/Ctrl+Enter to send)
|
||||||
|
|
||||||
|
### Task 008: Instance Tabs
|
||||||
|
- Tab bar for multiple instances
|
||||||
|
- Switch between instances
|
||||||
|
- Close instance tabs
|
||||||
|
- "+" button for new instance
|
||||||
|
|
||||||
|
## Build & Test
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd packages/opencode-client
|
||||||
|
bun run build
|
||||||
|
bunx electron .
|
||||||
|
```
|
||||||
|
|
||||||
|
**Known Issue:**
|
||||||
|
- Dev mode (`bun dev`) fails due to Bun workspace hoisting + electron-vite
|
||||||
|
- Workaround: Use production builds for testing
|
||||||
|
|
||||||
|
## Dependencies
|
||||||
|
|
||||||
|
- Electron 38
|
||||||
|
- SolidJS 1.8
|
||||||
|
- TailwindCSS 3.x
|
||||||
|
- @opencode-ai/sdk
|
||||||
|
- @kobalte/core (Dialog)
|
||||||
|
- Vite 5
|
||||||
|
- TypeScript 5
|
||||||
|
|
||||||
|
## Stats
|
||||||
|
|
||||||
|
- **Tasks completed:** 5/5 (Phase 1)
|
||||||
|
- **Files created:** 18+
|
||||||
|
- **Lines of code:** ~1500+
|
||||||
|
- **Build time:** ~7s
|
||||||
|
- **Bundle size:** 152KB (renderer)
|
||||||
152
Prepare-Public-Release.bat
Normal file
152
Prepare-Public-Release.bat
Normal file
@@ -0,0 +1,152 @@
|
|||||||
|
@echo off
|
||||||
|
setlocal enabledelayedexpansion
|
||||||
|
|
||||||
|
:: =====================================================
|
||||||
|
:: NomadArch - Clean Copy Script for Public Release
|
||||||
|
:: Creates a sanitized copy without sensitive data
|
||||||
|
:: =====================================================
|
||||||
|
|
||||||
|
title NomadArch Clean Copy for GitHub
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo =====================================================
|
||||||
|
echo NomadArch - Prepare Clean Public Release
|
||||||
|
echo =====================================================
|
||||||
|
echo.
|
||||||
|
|
||||||
|
set SCRIPT_DIR=%~dp0
|
||||||
|
set SCRIPT_DIR=%SCRIPT_DIR:~0,-1%
|
||||||
|
set DEST_DIR=%USERPROFILE%\Desktop\NomadArch-Public-Release
|
||||||
|
|
||||||
|
echo [INFO] Source: %SCRIPT_DIR%
|
||||||
|
echo [INFO] Destination: %DEST_DIR%
|
||||||
|
echo.
|
||||||
|
|
||||||
|
if exist "%DEST_DIR%" (
|
||||||
|
echo [WARN] Destination exists. Removing old copy...
|
||||||
|
rmdir /s /q "%DEST_DIR%"
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [STEP 1/6] Creating destination directory...
|
||||||
|
mkdir "%DEST_DIR%"
|
||||||
|
|
||||||
|
echo [STEP 2/6] Copying core project files...
|
||||||
|
|
||||||
|
:: Copy essential files
|
||||||
|
copy "%SCRIPT_DIR%\package.json" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\package-lock.json" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\.gitignore" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\README.md" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\BUILD.md" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\AGENTS.md" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\PROGRESS.md" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\manual_test_guide.md" "%DEST_DIR%\" >nul
|
||||||
|
|
||||||
|
:: Copy launchers and installers
|
||||||
|
copy "%SCRIPT_DIR%\Install-*.bat" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\Install-*.sh" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\Launch-*.bat" "%DEST_DIR%\" >nul
|
||||||
|
copy "%SCRIPT_DIR%\Launch-*.sh" "%DEST_DIR%\" >nul
|
||||||
|
|
||||||
|
echo [STEP 3/6] Copying packages directory (source only)...
|
||||||
|
|
||||||
|
:: Use robocopy to exclude unwanted items
|
||||||
|
robocopy "%SCRIPT_DIR%\packages" "%DEST_DIR%\packages" /E /NFL /NDL /NJH /NJS /NC /NS ^
|
||||||
|
/XD node_modules dist out release .vite .electron-vite _backup_original __pycache__ ^
|
||||||
|
/XF *.log *.bak *.tmp *.map
|
||||||
|
|
||||||
|
echo [STEP 4/6] Copying additional directories...
|
||||||
|
|
||||||
|
:: Copy docs if exists
|
||||||
|
if exist "%SCRIPT_DIR%\docs" (
|
||||||
|
robocopy "%SCRIPT_DIR%\docs" "%DEST_DIR%\docs" /E /NFL /NDL /NJH /NJS /NC /NS /XD node_modules
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Copy images if exists
|
||||||
|
if exist "%SCRIPT_DIR%\images" (
|
||||||
|
robocopy "%SCRIPT_DIR%\images" "%DEST_DIR%\images" /E /NFL /NDL /NJH /NJS /NC /NS
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Copy dev-docs if exists
|
||||||
|
if exist "%SCRIPT_DIR%\dev-docs" (
|
||||||
|
robocopy "%SCRIPT_DIR%\dev-docs" "%DEST_DIR%\dev-docs" /E /NFL /NDL /NJH /NJS /NC /NS
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Copy scripts directory if exists
|
||||||
|
if exist "%SCRIPT_DIR%\scripts" (
|
||||||
|
robocopy "%SCRIPT_DIR%\scripts" "%DEST_DIR%\scripts" /E /NFL /NDL /NJH /NJS /NC /NS
|
||||||
|
)
|
||||||
|
|
||||||
|
:: Copy .github directory (workflows, templates)
|
||||||
|
if exist "%SCRIPT_DIR%\.github" (
|
||||||
|
robocopy "%SCRIPT_DIR%\.github" "%DEST_DIR%\.github" /E /NFL /NDL /NJH /NJS /NC /NS
|
||||||
|
)
|
||||||
|
|
||||||
|
echo [STEP 5/6] Creating clean MCP config template...
|
||||||
|
|
||||||
|
:: Create a template .mcp.json with placeholders
|
||||||
|
(
|
||||||
|
echo {
|
||||||
|
echo "mcpServers": {
|
||||||
|
echo "sequential-thinking": {
|
||||||
|
echo "command": "npx",
|
||||||
|
echo "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
|
||||||
|
echo },
|
||||||
|
echo "desktop-commander": {
|
||||||
|
echo "command": "npx",
|
||||||
|
echo "args": ["-y", "@modelcontextprotocol/server-desktop-commander"]
|
||||||
|
echo },
|
||||||
|
echo "web-reader": {
|
||||||
|
echo "command": "npx",
|
||||||
|
echo "args": ["-y", "@modelcontextprotocol/server-web-reader"]
|
||||||
|
echo },
|
||||||
|
echo "github": {
|
||||||
|
echo "command": "npx",
|
||||||
|
echo "args": ["-y", "@modelcontextprotocol/server-github"],
|
||||||
|
echo "env": {
|
||||||
|
echo "GITHUB_TOKEN": "YOUR_GITHUB_TOKEN_HERE"
|
||||||
|
echo }
|
||||||
|
echo }
|
||||||
|
echo }
|
||||||
|
echo }
|
||||||
|
) > "%DEST_DIR%\.mcp.json.example"
|
||||||
|
|
||||||
|
echo [STEP 6/6] Final cleanup...
|
||||||
|
|
||||||
|
:: Remove any accidentally copied sensitive files
|
||||||
|
if exist "%DEST_DIR%\.opencode" rmdir /s /q "%DEST_DIR%\.opencode"
|
||||||
|
if exist "%DEST_DIR%\.trae" rmdir /s /q "%DEST_DIR%\.trae"
|
||||||
|
if exist "%DEST_DIR%\.backup" rmdir /s /q "%DEST_DIR%\.backup"
|
||||||
|
if exist "%DEST_DIR%\.tmp-qwen-code" rmdir /s /q "%DEST_DIR%\.tmp-qwen-code"
|
||||||
|
if exist "%DEST_DIR%\.agent" rmdir /s /q "%DEST_DIR%\.agent"
|
||||||
|
if exist "%DEST_DIR%\install.log" del "%DEST_DIR%\install.log"
|
||||||
|
|
||||||
|
:: Delete any .bak files that got through
|
||||||
|
for /r "%DEST_DIR%" %%f in (*.bak) do del "%%f" 2>nul
|
||||||
|
for /r "%DEST_DIR%" %%f in (*.log) do del "%%f" 2>nul
|
||||||
|
for /r "%DEST_DIR%" %%f in (*.tmp) do del "%%f" 2>nul
|
||||||
|
|
||||||
|
:: Remove _backup_original directories
|
||||||
|
for /d /r "%DEST_DIR%" %%d in (_backup_original) do (
|
||||||
|
if exist "%%d" rmdir /s /q "%%d"
|
||||||
|
)
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo =====================================================
|
||||||
|
echo Clean Copy Complete!
|
||||||
|
echo =====================================================
|
||||||
|
echo.
|
||||||
|
echo Location: %DEST_DIR%
|
||||||
|
echo.
|
||||||
|
echo Next Steps:
|
||||||
|
echo 1. Review the contents of %DEST_DIR%
|
||||||
|
echo 2. cd %DEST_DIR%
|
||||||
|
echo 3. git init
|
||||||
|
echo 4. git add .
|
||||||
|
echo 5. git commit -m "Initial public release"
|
||||||
|
echo 6. git remote add origin https://github.com/YOUR_USER/NomadArch.git
|
||||||
|
echo 7. git push -u origin main
|
||||||
|
echo.
|
||||||
|
echo =====================================================
|
||||||
|
|
||||||
|
pause
|
||||||
354
README.md
Normal file
354
README.md
Normal file
@@ -0,0 +1,354 @@
|
|||||||
|
<p align="center">
|
||||||
|
<img src="packages/ui/src/images/CodeNomad-Icon.png" alt="NomadArch Logo" width="180" height="180">
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<h1 align="center">🏛️ NomadArch</h1>
|
||||||
|
|
||||||
|
<h3 align="center">Advanced AI Coding Workspace</h3>
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<em>NomadArch is an enhanced fork of CodeNomad — now with GLM 4.7, multi-model support, and MULTIX Mode</em>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href="https://github.com/roman-ryzenadvanced/NomadArch-v1.0/stargazers">
|
||||||
|
<img src="https://img.shields.io/github/stars/roman-ryzenadvanced/NomadArch-v1.0?style=for-the-badge&logo=github&logoColor=white&color=gold" alt="GitHub Stars">
|
||||||
|
</a>
|
||||||
|
<a href="https://github.com/roman-ryzenadvanced/NomadArch-v1.0/network/members">
|
||||||
|
<img src="https://img.shields.io/github/forks/roman-ryzenadvanced/NomadArch-v1.0?style=for-the-badge&logo=git&logoColor=white&color=blue" alt="GitHub Forks">
|
||||||
|
</a>
|
||||||
|
<a href="https://github.com/roman-ryzenadvanced/NomadArch-v1.0/blob/main/LICENSE">
|
||||||
|
<img src="https://img.shields.io/github/license/roman-ryzenadvanced/NomadArch-v1.0?style=for-the-badge&color=green" alt="License">
|
||||||
|
</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href="#-features">Features</a> •
|
||||||
|
<a href="#-supported-ai-models">AI Models</a> •
|
||||||
|
<a href="#-installation">Installation</a> •
|
||||||
|
<a href="#-usage">Usage</a> •
|
||||||
|
<a href="#-whats-new">What's New</a> •
|
||||||
|
<a href="#-credits">Credits</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href="https://github.com/roman-ryzenadvanced/NomadArch-v1.0">
|
||||||
|
<img src="https://img.shields.io/badge/⭐_Star_this_repo-yellow?style=for-the-badge" alt="Star this repo">
|
||||||
|
</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 Overview
|
||||||
|
|
||||||
|
**NomadArch** is an enhanced fork of CodeNomad, featuring significant UI/UX improvements, additional AI integrations, and a more robust architecture. This is a full-featured AI coding assistant with support for multiple AI providers including **GLM 4.7**, Anthropic, OpenAI, Google, Qwen, and local models via Ollama.
|
||||||
|
|
||||||
|
### ✨ Key Improvements Over CodeNomad
|
||||||
|
- 🔧 Fixed Qwen OAuth authentication flow
|
||||||
|
- 🚀 Enhanced MULTIX Mode with live token streaming
|
||||||
|
- 🎨 Improved UI/UX with detailed tooltips
|
||||||
|
- ✅ Auto-build verification on launch
|
||||||
|
- 📦 Comprehensive installer scripts for all platforms
|
||||||
|
- 🔌 Port conflict detection and resolution hints
|
||||||
|
- 🆓 **NEW: Binary-Free Mode** - No external binaries required!
|
||||||
|
|
||||||
|
### 🆓 Binary-Free Mode (v0.5.0)
|
||||||
|
|
||||||
|
NomadArch now works **without requiring the OpenCode binary**! This means:
|
||||||
|
|
||||||
|
| Benefit | Description |
|
||||||
|
|---------|-------------|
|
||||||
|
| ⚡ **Faster Setup** | No binary downloads, just npm install |
|
||||||
|
| 🌍 **Universal** | Works on all platforms without platform-specific binaries |
|
||||||
|
| 🆓 **Free Models** | Access free AI models without any binary |
|
||||||
|
| 🔄 **Seamless** | Automatically uses native mode when binary unavailable |
|
||||||
|
|
||||||
|
**Free Models Available (No API Key Required):**
|
||||||
|
- 🧠 **GPT-5 Nano** - 400K context, reasoning + tools
|
||||||
|
- ⚡ **Grok Code Fast 1** - 256K context, optimized for code
|
||||||
|
- 🌟 **GLM-4.7** - 205K context, top-tier performance
|
||||||
|
- 🚀 **Doubao Seed Code** - 256K context, specialized for coding
|
||||||
|
- 🥒 **Big Pickle** - 200K context, efficient and fast
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🤖 Supported AI Models
|
||||||
|
|
||||||
|
NomadArch supports a wide range of AI models from multiple providers, giving you flexibility to choose the best model for your coding tasks.
|
||||||
|
|
||||||
|
### 🔥 Featured Model: GLM 4.7 (Z.AI)
|
||||||
|
|
||||||
|
**GLM 4.7** is the latest state-of-the-art open model from Z.AI, now fully integrated into NomadArch. Released in December 2025, GLM 4.7 ranks **#1 for Web Development** and **#6 overall** on the LM Arena leaderboard.
|
||||||
|
|
||||||
|
| Feature | Description |
|
||||||
|
|---------|-------------|
|
||||||
|
| 📊 **128K Context Window** | Process entire codebases in a single session |
|
||||||
|
| 🧠 **Interleaved Thinking** | Advanced reasoning with multi-step analysis |
|
||||||
|
| 💭 **Preserved Thinking** | Maintains reasoning chain across long conversations |
|
||||||
|
| 🔄 **Turn-level Thinking** | Optimized per-response reasoning for efficiency |
|
||||||
|
|
||||||
|
#### Benchmark Performance
|
||||||
|
|
||||||
|
| Benchmark | Score | Notes |
|
||||||
|
|-----------|-------|-------|
|
||||||
|
| SWE-bench | **+73.8%** | Over GLM-4.6 |
|
||||||
|
| SWE-bench Multilingual | **+66.7%** | Over GLM-4.6 |
|
||||||
|
| Terminal Bench 2.0 | **+41%** | Over GLM-4.6 |
|
||||||
|
| LM Arena WebDev | **#1** | Open Model Ranking |
|
||||||
|
| LM Arena Overall | **#6** | Open Model Ranking |
|
||||||
|
|
||||||
|
> 🎯 **Get 10% discount on Z.AI with code: [`R0K78RJKNW`](https://z.ai/subscribe?ic=R0K78RJKNW)**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 📋 All Supported Models
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🌟 Z.AI Models</b></summary>
|
||||||
|
|
||||||
|
| Model | Context | Specialty |
|
||||||
|
|-------|---------|-----------|
|
||||||
|
| **GLM 4.7** | 128K | Web Development, Coding |
|
||||||
|
| GLM 4.6 | 128K | General Coding |
|
||||||
|
| GLM-4 | 128K | Versatile |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🟣 Anthropic Models</b></summary>
|
||||||
|
|
||||||
|
| Model | Context | Specialty |
|
||||||
|
|-------|---------|-----------|
|
||||||
|
| Claude 3.7 Sonnet | 200K | Complex Reasoning |
|
||||||
|
| Claude 3.5 Sonnet | 200K | Balanced Performance |
|
||||||
|
| Claude 3 Opus | 200K | Maximum Quality |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🟢 OpenAI Models</b></summary>
|
||||||
|
|
||||||
|
| Model | Context | Specialty |
|
||||||
|
|-------|---------|-----------|
|
||||||
|
| GPT-5 Preview | 200K | Latest Capabilities |
|
||||||
|
| GPT-4.1 | 128K | Production Ready |
|
||||||
|
| GPT-4 Turbo | 128K | Fast & Efficient |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🔵 Google Models</b></summary>
|
||||||
|
|
||||||
|
| Model | Context | Specialty |
|
||||||
|
|-------|---------|-----------|
|
||||||
|
| Gemini 2.0 Pro | 1M+ | Massive Context |
|
||||||
|
| Gemini 2.0 Flash | 1M+ | Ultra Fast |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🟠 Qwen & Local Models</b></summary>
|
||||||
|
|
||||||
|
| Model | Context/Size | Specialty |
|
||||||
|
|-------|--------------|-----------|
|
||||||
|
| Qwen 2.5 Coder | 32K | Code Specialized |
|
||||||
|
| Qwen 2.5 | 32K | General Purpose |
|
||||||
|
| DeepSeek Coder (Ollama) | Varies | Code |
|
||||||
|
| Llama 3.1 (Ollama) | Varies | General |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📦 Installation
|
||||||
|
|
||||||
|
### Quick Start (Recommended)
|
||||||
|
|
||||||
|
#### Windows
|
||||||
|
```batch
|
||||||
|
Install-Windows.bat
|
||||||
|
Launch-Windows.bat
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Linux
|
||||||
|
```bash
|
||||||
|
chmod +x Install-Linux.sh && ./Install-Linux.sh
|
||||||
|
./Launch-Unix.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
#### macOS
|
||||||
|
```bash
|
||||||
|
chmod +x Install-Mac.sh && ./Install-Mac.sh
|
||||||
|
./Launch-Unix.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### Manual Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/roman-ryzenadvanced/NomadArch-v1.0.git
|
||||||
|
cd NomadArch
|
||||||
|
npm install
|
||||||
|
npm run dev:electron
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Features
|
||||||
|
|
||||||
|
### Core Features
|
||||||
|
| Feature | Description |
|
||||||
|
|---------|-------------|
|
||||||
|
| 🤖 **Multi-Provider AI** | GLM 4.7, Anthropic, OpenAI, Google, Qwen, Ollama |
|
||||||
|
| 🖥️ **Electron Desktop App** | Native feel with modern web technologies |
|
||||||
|
| 📁 **Workspace Management** | Organize your projects efficiently |
|
||||||
|
| 💬 **Real-time Streaming** | Live responses from AI models |
|
||||||
|
| 🔧 **Smart Fix** | AI-powered code error detection and fixes |
|
||||||
|
| 🔌 **Ollama Integration** | Run local AI models for privacy |
|
||||||
|
|
||||||
|
### UI/UX Highlights
|
||||||
|
| Mode | Description |
|
||||||
|
|------|-------------|
|
||||||
|
| ⚡ **MULTIX Mode** | Multi-task parallel AI conversations with live token counting |
|
||||||
|
| 🛡️ **SHIELD Mode** | Auto-approval for hands-free operation |
|
||||||
|
| 🚀 **APEX Mode** | Autonomous AI that chains tasks together |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🆕 What's New
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🎨 Branding & Identity</b></summary>
|
||||||
|
|
||||||
|
- ✅ **New Branding**: "NomadArch" with proper attribution to OpenCode
|
||||||
|
- ✅ **Updated Loading Screen**: New branding with fork attribution
|
||||||
|
- ✅ **Updated Empty States**: All screens show NomadArch branding
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🔐 Qwen OAuth Integration</b></summary>
|
||||||
|
|
||||||
|
- ✅ **Fixed OAuth Flow**: Resolved "Body cannot be empty" error
|
||||||
|
- ✅ **Proper API Bodies**: POST requests now include proper JSON bodies
|
||||||
|
- ✅ **Fixed Device Poll Schema**: Corrected Fastify schema validation
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🚀 MULTIX Mode Enhancements</b></summary>
|
||||||
|
|
||||||
|
- ✅ **Live Streaming Token Counter**: Visible in header during AI processing
|
||||||
|
- ✅ **Thinking Roller Indicator**: Animated indicator with bouncing dots
|
||||||
|
- ✅ **Token Stats Display**: Shows input/output tokens processed
|
||||||
|
- ✅ **Auto-Scroll**: Intelligent scrolling during streaming
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>🐛 Bug Fixes</b></summary>
|
||||||
|
|
||||||
|
- ✅ Fixed Qwen OAuth "empty body" errors
|
||||||
|
- ✅ Fixed MultiX panel being pushed off screen
|
||||||
|
- ✅ Fixed top menu/toolbar disappearing
|
||||||
|
- ✅ Fixed layout breaking when scrolling
|
||||||
|
- ✅ Fixed sessions not showing on workspace entry
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎮 Button Guide
|
||||||
|
|
||||||
|
| Button | Description |
|
||||||
|
|--------|-------------|
|
||||||
|
| **AUTHED** | Shows authentication status (Green = connected) |
|
||||||
|
| **AI MODEL** | Click to switch between AI models |
|
||||||
|
| **SMART FIX** | AI analyzes code for errors and applies fixes |
|
||||||
|
| **BUILD** | Compiles and builds your project |
|
||||||
|
| **APEX** | Autonomous mode - AI chains actions automatically |
|
||||||
|
| **SHIELD** | Auto-approval mode - AI makes changes without prompts |
|
||||||
|
| **MULTIX MODE** | Opens multi-task pipeline for parallel conversations |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📁 Project Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
NomadArch/
|
||||||
|
├── Install-*.bat/.sh # Platform installers
|
||||||
|
├── Launch-*.bat/.sh # Platform launchers
|
||||||
|
├── packages/
|
||||||
|
│ ├── electron-app/ # Electron main process
|
||||||
|
│ ├── server/ # Backend (Fastify)
|
||||||
|
│ ├── ui/ # Frontend (SolidJS + Vite)
|
||||||
|
│ └── opencode-config/ # OpenCode configuration
|
||||||
|
└── README.md
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 Requirements
|
||||||
|
|
||||||
|
| Requirement | Version |
|
||||||
|
|-------------|---------|
|
||||||
|
| Node.js | v18+ |
|
||||||
|
| npm | v9+ |
|
||||||
|
| OS | Windows 10+, macOS 11+, Linux |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🆘 Troubleshooting
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Common Issues & Solutions</b></summary>
|
||||||
|
|
||||||
|
**Dependencies not installed?**
|
||||||
|
```bash
|
||||||
|
# Run the installer for your platform
|
||||||
|
Install-Windows.bat # Windows
|
||||||
|
./Install-Linux.sh # Linux
|
||||||
|
./Install-Mac.sh # macOS
|
||||||
|
```
|
||||||
|
|
||||||
|
**Port conflict?**
|
||||||
|
```bash
|
||||||
|
# Kill process on port 3000/3001
|
||||||
|
taskkill /F /PID <PID> # Windows
|
||||||
|
kill -9 <PID> # Unix
|
||||||
|
```
|
||||||
|
|
||||||
|
**OAuth fails?**
|
||||||
|
1. Check internet connection
|
||||||
|
2. Complete OAuth in browser
|
||||||
|
3. Clear browser cookies and retry
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🙏 Credits
|
||||||
|
|
||||||
|
Built with amazing open source projects:
|
||||||
|
|
||||||
|
| Category | Projects |
|
||||||
|
|----------|----------|
|
||||||
|
| **Framework** | SolidJS, Vite, TypeScript, Electron |
|
||||||
|
| **UI** | TailwindCSS, Kobalte, SUID Material |
|
||||||
|
| **Backend** | Fastify, Ollama |
|
||||||
|
| **AI** | OpenCode CLI, Various AI SDKs |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📄 License
|
||||||
|
|
||||||
|
This project is a fork of [CodeNomad](https://github.com/opencode/codenom).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
Made with ❤️ by <a href="https://github.com/NeuralNomadsAI">NeuralNomadsAI</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<sub>NomadArch is an enhanced fork of CodeNomad</sub>
|
||||||
|
</p>
|
||||||
1
UX Upgrade/.env.local
Normal file
1
UX Upgrade/.env.local
Normal file
@@ -0,0 +1 @@
|
|||||||
|
GEMINI_API_KEY=PLACEHOLDER_API_KEY
|
||||||
BIN
bin/opencode.exe
Normal file
BIN
bin/opencode.exe
Normal file
Binary file not shown.
180
dev-docs/INDEX.md
Normal file
180
dev-docs/INDEX.md
Normal file
@@ -0,0 +1,180 @@
|
|||||||
|
# Documentation Index
|
||||||
|
|
||||||
|
Quick reference to all documentation files.
|
||||||
|
|
||||||
|
## Main Documents
|
||||||
|
|
||||||
|
### [README.md](../README.md)
|
||||||
|
|
||||||
|
Project overview, installation, and getting started guide.
|
||||||
|
|
||||||
|
### [SUMMARY.md](SUMMARY.md)
|
||||||
|
|
||||||
|
Executive summary of the entire project - **start here!**
|
||||||
|
|
||||||
|
### [MVP-PRINCIPLES.md](MVP-PRINCIPLES.md)
|
||||||
|
|
||||||
|
**MVP development philosophy** - Focus on functionality, NOT performance ⚡
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Specification Documents
|
||||||
|
|
||||||
|
### [architecture.md](architecture.md)
|
||||||
|
|
||||||
|
**Complete system architecture**
|
||||||
|
|
||||||
|
- Component layers and responsibilities
|
||||||
|
- State management structure
|
||||||
|
- Data flow diagrams
|
||||||
|
- Technology stack
|
||||||
|
- Security and performance considerations
|
||||||
|
|
||||||
|
**Read this to understand:** How the app is structured
|
||||||
|
|
||||||
|
### [user-interface.md](user-interface.md)
|
||||||
|
|
||||||
|
**Complete UI/UX specifications**
|
||||||
|
|
||||||
|
- Every screen and component layout
|
||||||
|
- Visual design specifications
|
||||||
|
- Interaction patterns
|
||||||
|
- Accessibility requirements
|
||||||
|
- Color schemes and typography
|
||||||
|
|
||||||
|
**Read this to understand:** What the app looks like and how users interact
|
||||||
|
|
||||||
|
### [technical-implementation.md](technical-implementation.md)
|
||||||
|
|
||||||
|
**Implementation details**
|
||||||
|
|
||||||
|
- File structure
|
||||||
|
- TypeScript interfaces
|
||||||
|
- Process management logic
|
||||||
|
- SDK integration patterns
|
||||||
|
- IPC communication
|
||||||
|
- Error handling strategies
|
||||||
|
|
||||||
|
**Read this to understand:** How to actually build it
|
||||||
|
|
||||||
|
### [build-roadmap.md](build-roadmap.md)
|
||||||
|
|
||||||
|
**Development plan**
|
||||||
|
|
||||||
|
- 8 phases of development
|
||||||
|
- Task dependencies
|
||||||
|
- Timeline estimates
|
||||||
|
- Success criteria
|
||||||
|
- Risk mitigation
|
||||||
|
|
||||||
|
**Read this to understand:** The development journey from start to finish
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Task Documents
|
||||||
|
|
||||||
|
### [tasks/README.md](../tasks/README.md)
|
||||||
|
|
||||||
|
**Task management guide**
|
||||||
|
|
||||||
|
- Task workflow
|
||||||
|
- Naming conventions
|
||||||
|
- How to work on tasks
|
||||||
|
- Progress tracking
|
||||||
|
|
||||||
|
### Task Files (in tasks/todo/)
|
||||||
|
|
||||||
|
- **001-project-setup.md** - Electron + SolidJS boilerplate
|
||||||
|
- **002-empty-state-ui.md** - Initial UI with folder selection
|
||||||
|
- **003-process-manager.md** - OpenCode server spawning
|
||||||
|
- **004-sdk-integration.md** - API client integration
|
||||||
|
- **005-session-picker-modal.md** - Session selection UI
|
||||||
|
|
||||||
|
More tasks will be added as we progress through phases.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Reading Order
|
||||||
|
|
||||||
|
### For First-Time Readers:
|
||||||
|
|
||||||
|
1. [SUMMARY.md](SUMMARY.md) - Get the big picture
|
||||||
|
2. [architecture.md](architecture.md) - Understand the structure
|
||||||
|
3. [user-interface.md](user-interface.md) - See what you're building
|
||||||
|
4. [build-roadmap.md](build-roadmap.md) - Understand the plan
|
||||||
|
5. [tasks/README.md](../tasks/README.md) - Learn the workflow
|
||||||
|
|
||||||
|
### For Implementers:
|
||||||
|
|
||||||
|
1. [tasks/README.md](../tasks/README.md) - Understand task workflow
|
||||||
|
2. [technical-implementation.md](technical-implementation.md) - Implementation patterns
|
||||||
|
3. [tasks/todo/001-\*.md](../tasks/todo/) - Start with first task
|
||||||
|
4. Refer to architecture.md and user-interface.md as needed
|
||||||
|
|
||||||
|
### For Designers:
|
||||||
|
|
||||||
|
1. [user-interface.md](user-interface.md) - Complete UI specs
|
||||||
|
2. [architecture.md](architecture.md) - Component structure
|
||||||
|
3. [SUMMARY.md](SUMMARY.md) - Feature overview
|
||||||
|
|
||||||
|
### For Project Managers:
|
||||||
|
|
||||||
|
1. [SUMMARY.md](SUMMARY.md) - Executive overview
|
||||||
|
2. [build-roadmap.md](build-roadmap.md) - Timeline and phases
|
||||||
|
3. [tasks/README.md](../tasks/README.md) - Task tracking
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick Reference
|
||||||
|
|
||||||
|
### Common Questions
|
||||||
|
|
||||||
|
**Q: Where do I start?**
|
||||||
|
A: Read [SUMMARY.md](SUMMARY.md), then start [Task 001](../tasks/todo/001-project-setup.md)
|
||||||
|
|
||||||
|
**Q: How long will this take?**
|
||||||
|
A: See [build-roadmap.md](build-roadmap.md) - MVP in 3-7 weeks depending on commitment
|
||||||
|
|
||||||
|
**Q: What does the UI look like?**
|
||||||
|
A: See [user-interface.md](user-interface.md) for complete specifications
|
||||||
|
|
||||||
|
**Q: How does it work internally?**
|
||||||
|
A: See [architecture.md](architecture.md) for system design
|
||||||
|
|
||||||
|
**Q: How do I build feature X?**
|
||||||
|
A: See [technical-implementation.md](technical-implementation.md) for patterns
|
||||||
|
|
||||||
|
**Q: What's the development plan?**
|
||||||
|
A: See [build-roadmap.md](build-roadmap.md) for phases
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Document Status
|
||||||
|
|
||||||
|
| Document | Status | Last Updated |
|
||||||
|
| --------------------------- | ----------- | ------------ |
|
||||||
|
| README.md | ✅ Complete | 2024-10-22 |
|
||||||
|
| SUMMARY.md | ✅ Complete | 2024-10-22 |
|
||||||
|
| architecture.md | ✅ Complete | 2024-10-22 |
|
||||||
|
| user-interface.md | ✅ Complete | 2024-10-22 |
|
||||||
|
| technical-implementation.md | ✅ Complete | 2024-10-22 |
|
||||||
|
| build-roadmap.md | ✅ Complete | 2024-10-22 |
|
||||||
|
| tasks/README.md | ✅ Complete | 2024-10-22 |
|
||||||
|
| Task 001-005 | ✅ Complete | 2024-10-22 |
|
||||||
|
|
||||||
|
**Project phase:** Post-MVP (Phases 1-3 complete; Phase 4 work underway).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Contributing to Documentation
|
||||||
|
|
||||||
|
When updating documentation:
|
||||||
|
|
||||||
|
1. Update the relevant file
|
||||||
|
2. Update "Last Updated" in this index
|
||||||
|
3. Update SUMMARY.md if adding major changes
|
||||||
|
4. Keep consistent formatting and style
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
_This index will be updated as more documentation is added._
|
||||||
326
dev-docs/MVP-PRINCIPLES.md
Normal file
326
dev-docs/MVP-PRINCIPLES.md
Normal file
@@ -0,0 +1,326 @@
|
|||||||
|
# MVP Development Principles
|
||||||
|
|
||||||
|
## Core Philosophy
|
||||||
|
|
||||||
|
**Focus on functionality, NOT performance.**
|
||||||
|
|
||||||
|
The MVP (Minimum Viable Product) is about proving the concept and getting feedback. Performance optimization comes later, after we validate the product with real users.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## What We Care About in MVP
|
||||||
|
|
||||||
|
### ✅ DO Focus On:
|
||||||
|
|
||||||
|
1. **Functionality**
|
||||||
|
- Does it work?
|
||||||
|
- Can users complete their tasks?
|
||||||
|
- Are all core features present?
|
||||||
|
|
||||||
|
2. **Correctness**
|
||||||
|
- Does it produce correct results?
|
||||||
|
- Does error handling work?
|
||||||
|
- Is data persisted properly?
|
||||||
|
|
||||||
|
3. **User Experience**
|
||||||
|
- Is the UI intuitive?
|
||||||
|
- Are loading states clear?
|
||||||
|
- Are error messages helpful?
|
||||||
|
|
||||||
|
4. **Stability**
|
||||||
|
- Does it crash?
|
||||||
|
- Can users recover from errors?
|
||||||
|
- Does it lose data?
|
||||||
|
|
||||||
|
5. **Code Quality**
|
||||||
|
- Is code readable?
|
||||||
|
- Are types correct?
|
||||||
|
- Is it maintainable?
|
||||||
|
|
||||||
|
### ❌ DON'T Focus On:
|
||||||
|
|
||||||
|
1. **Performance Optimization**
|
||||||
|
- Virtual scrolling
|
||||||
|
- Message batching
|
||||||
|
- Lazy loading
|
||||||
|
- Memory optimization
|
||||||
|
- Render optimization
|
||||||
|
|
||||||
|
2. **Scalability**
|
||||||
|
- Handling 1000+ messages
|
||||||
|
- Multiple instances with 100+ sessions
|
||||||
|
- Large file attachments
|
||||||
|
- Massive search indexes
|
||||||
|
|
||||||
|
3. **Advanced Features**
|
||||||
|
- Plugins
|
||||||
|
- Advanced search
|
||||||
|
- Custom themes
|
||||||
|
- Workspace management
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Specific MVP Guidelines
|
||||||
|
|
||||||
|
### Messages & Rendering
|
||||||
|
|
||||||
|
**Simple approach:**
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Just render everything - no virtual scrolling
|
||||||
|
<For each={messages()}>
|
||||||
|
{(message) => <MessageItem message={message} />}
|
||||||
|
</For>
|
||||||
|
```
|
||||||
|
|
||||||
|
**Don't worry about:**
|
||||||
|
|
||||||
|
- Sessions with 500+ messages
|
||||||
|
- Re-render performance
|
||||||
|
- Memory usage
|
||||||
|
- Scroll performance
|
||||||
|
|
||||||
|
**When to optimize:**
|
||||||
|
|
||||||
|
- Post-MVP (Phase 8)
|
||||||
|
- Only if users report issues
|
||||||
|
- Based on real-world usage data
|
||||||
|
|
||||||
|
### State Management
|
||||||
|
|
||||||
|
**Simple approach:**
|
||||||
|
|
||||||
|
- Use SolidJS signals directly
|
||||||
|
- No batching
|
||||||
|
- No debouncing
|
||||||
|
- No caching layers
|
||||||
|
|
||||||
|
**Don't worry about:**
|
||||||
|
|
||||||
|
- Update frequency
|
||||||
|
- Number of reactive dependencies
|
||||||
|
- State structure optimization
|
||||||
|
|
||||||
|
### Process Management
|
||||||
|
|
||||||
|
**Simple approach:**
|
||||||
|
|
||||||
|
- Spawn servers as needed
|
||||||
|
- Kill on close
|
||||||
|
- Basic error handling
|
||||||
|
|
||||||
|
**Don't worry about:**
|
||||||
|
|
||||||
|
- Resource limits (max processes)
|
||||||
|
- CPU/memory monitoring
|
||||||
|
- Restart optimization
|
||||||
|
- Process pooling
|
||||||
|
|
||||||
|
### API Communication
|
||||||
|
|
||||||
|
**Simple approach:**
|
||||||
|
|
||||||
|
- Direct SDK calls
|
||||||
|
- Basic error handling
|
||||||
|
- Simple retry (if at all)
|
||||||
|
|
||||||
|
**Don't worry about:**
|
||||||
|
|
||||||
|
- Request batching
|
||||||
|
- Response caching
|
||||||
|
- Optimistic updates
|
||||||
|
- Request deduplication
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Decision Framework
|
||||||
|
|
||||||
|
When implementing any feature, ask:
|
||||||
|
|
||||||
|
### Is this optimization needed for MVP?
|
||||||
|
|
||||||
|
**NO if:**
|
||||||
|
|
||||||
|
- It only helps with large datasets
|
||||||
|
- It only helps with many instances
|
||||||
|
- It's about speed, not correctness
|
||||||
|
- Users won't notice the difference
|
||||||
|
- It adds significant complexity
|
||||||
|
|
||||||
|
**YES if:**
|
||||||
|
|
||||||
|
- Users can't complete basic tasks without it
|
||||||
|
- App is completely unusable without it
|
||||||
|
- It prevents data loss
|
||||||
|
- It's a security requirement
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
**Virtual Scrolling:** ❌ NO for MVP
|
||||||
|
|
||||||
|
- MVP users won't have 1000+ message sessions
|
||||||
|
- Simple list rendering works fine for <100 messages
|
||||||
|
- Add in Phase 8 if needed
|
||||||
|
|
||||||
|
**Error Handling:** ✅ YES for MVP
|
||||||
|
|
||||||
|
- Users need clear feedback when things fail
|
||||||
|
- Prevents frustration and data loss
|
||||||
|
- Core to usability
|
||||||
|
|
||||||
|
**Message Batching:** ❌ NO for MVP
|
||||||
|
|
||||||
|
- SolidJS handles updates efficiently
|
||||||
|
- Only matters at very high frequency
|
||||||
|
- Add later if users report lag
|
||||||
|
|
||||||
|
**Session Persistence:** ✅ YES for MVP
|
||||||
|
|
||||||
|
- Users expect sessions to persist
|
||||||
|
- Losing work is unacceptable
|
||||||
|
- Core functionality
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Testing Approach
|
||||||
|
|
||||||
|
### MVP Testing Focus
|
||||||
|
|
||||||
|
**Test for:**
|
||||||
|
|
||||||
|
- ✅ Correctness (does it work?)
|
||||||
|
- ✅ Error handling (does it fail gracefully?)
|
||||||
|
- ✅ Data integrity (is data saved?)
|
||||||
|
- ✅ User flows (can users complete tasks?)
|
||||||
|
|
||||||
|
**Don't test for:**
|
||||||
|
|
||||||
|
- ❌ Performance benchmarks
|
||||||
|
- ❌ Load testing
|
||||||
|
- ❌ Stress testing
|
||||||
|
- ❌ Scalability limits
|
||||||
|
|
||||||
|
### Acceptable Performance
|
||||||
|
|
||||||
|
For MVP, these are **acceptable:**
|
||||||
|
|
||||||
|
- 100 messages render in 1 second
|
||||||
|
- UI slightly laggy during heavy streaming
|
||||||
|
- Memory usage grows with message count
|
||||||
|
- Multiple instances slow down app
|
||||||
|
|
||||||
|
These become **unacceptable** only if:
|
||||||
|
|
||||||
|
- Users complain
|
||||||
|
- App becomes unusable
|
||||||
|
- Basic tasks can't be completed
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## When to Optimize
|
||||||
|
|
||||||
|
### Post-MVP Triggers
|
||||||
|
|
||||||
|
Add optimization when:
|
||||||
|
|
||||||
|
1. **User Feedback**
|
||||||
|
- Multiple users report slowness
|
||||||
|
- Users abandon due to performance
|
||||||
|
- Performance prevents usage
|
||||||
|
|
||||||
|
2. **Measurable Issues**
|
||||||
|
- App freezes for >2 seconds
|
||||||
|
- Memory usage causes crashes
|
||||||
|
- UI becomes unresponsive
|
||||||
|
|
||||||
|
3. **Phase 8 Reached**
|
||||||
|
- MVP complete and validated
|
||||||
|
- User base established
|
||||||
|
- Performance becomes focus
|
||||||
|
|
||||||
|
### How to Optimize
|
||||||
|
|
||||||
|
When the time comes:
|
||||||
|
|
||||||
|
1. **Measure First**
|
||||||
|
- Profile actual bottlenecks
|
||||||
|
- Use real user data
|
||||||
|
- Identify specific problems
|
||||||
|
|
||||||
|
2. **Target Fixes**
|
||||||
|
- Fix the specific bottleneck
|
||||||
|
- Don't over-engineer
|
||||||
|
- Measure improvement
|
||||||
|
|
||||||
|
3. **Iterate**
|
||||||
|
- Optimize one thing at a time
|
||||||
|
- Verify with users
|
||||||
|
- Stop when "fast enough"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Communication with Users
|
||||||
|
|
||||||
|
### During Alpha/Beta
|
||||||
|
|
||||||
|
**Be honest about performance:**
|
||||||
|
|
||||||
|
- "This is an MVP - expect some slowness with large sessions"
|
||||||
|
- "We're focused on functionality first"
|
||||||
|
- "Performance optimization is planned for v1.x"
|
||||||
|
|
||||||
|
**Set expectations:**
|
||||||
|
|
||||||
|
- Works best with <200 messages per session
|
||||||
|
- Multiple instances may slow things down
|
||||||
|
- We'll optimize based on your feedback
|
||||||
|
|
||||||
|
### Collecting Feedback
|
||||||
|
|
||||||
|
**Ask about:**
|
||||||
|
|
||||||
|
- ✅ What features are missing?
|
||||||
|
- ✅ What's confusing?
|
||||||
|
- ✅ What doesn't work?
|
||||||
|
- ✅ Is it too slow to use?
|
||||||
|
|
||||||
|
**Don't ask about:**
|
||||||
|
|
||||||
|
- ❌ How many milliseconds for X?
|
||||||
|
- ❌ Memory usage specifics
|
||||||
|
- ❌ Benchmark comparisons
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Summary
|
||||||
|
|
||||||
|
### The MVP Mantra
|
||||||
|
|
||||||
|
> **Make it work, then make it better, then make it fast.**
|
||||||
|
|
||||||
|
For CodeNomad MVP:
|
||||||
|
|
||||||
|
- **Phase 1-7:** Make it work, make it better
|
||||||
|
- **Phase 8+:** Make it fast
|
||||||
|
|
||||||
|
### Remember
|
||||||
|
|
||||||
|
- Premature optimization is the root of all evil
|
||||||
|
- Real users provide better optimization guidance than assumptions
|
||||||
|
- Functionality > Performance for MVP
|
||||||
|
- You can't optimize what users don't use
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Quick Reference
|
||||||
|
|
||||||
|
**When in doubt, ask:**
|
||||||
|
|
||||||
|
1. Is this feature essential for users to do their job? → Build it
|
||||||
|
2. Is this optimization essential for the feature to work? → Build it
|
||||||
|
3. Is this just making it faster/more efficient? → Defer to Phase 8
|
||||||
|
|
||||||
|
**MVP = Minimum _Viable_ Product**
|
||||||
|
|
||||||
|
- Viable = works and is useful
|
||||||
|
- Viable ≠ optimized and fast
|
||||||
348
dev-docs/SUMMARY.md
Normal file
348
dev-docs/SUMMARY.md
Normal file
@@ -0,0 +1,348 @@
|
|||||||
|
# CodeNomad - Project Summary
|
||||||
|
|
||||||
|
## Current Status
|
||||||
|
|
||||||
|
We have completed the MVP milestones (Phases 1-3) and are now operating in post-MVP mode. Future work prioritizes multi-instance support, advanced input polish, and system integrations outlined in later phases.
|
||||||
|
|
||||||
|
## What We've Created
|
||||||
|
|
||||||
|
A comprehensive specification and task breakdown for building the CodeNomad desktop application.
|
||||||
|
|
||||||
|
## Directory Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
packages/opencode-client/
|
||||||
|
├── docs/ # Comprehensive documentation
|
||||||
|
│ ├── architecture.md # System architecture & design
|
||||||
|
│ ├── user-interface.md # UI/UX specifications
|
||||||
|
│ ├── technical-implementation.md # Technical details & patterns
|
||||||
|
│ ├── build-roadmap.md # Phased development plan
|
||||||
|
│ └── SUMMARY.md # This file
|
||||||
|
├── tasks/
|
||||||
|
│ ├── README.md # Task management guide
|
||||||
|
│ ├── todo/ # Tasks to implement
|
||||||
|
│ │ ├── 001-project-setup.md
|
||||||
|
│ │ ├── 002-empty-state-ui.md
|
||||||
|
│ │ ├── 003-process-manager.md
|
||||||
|
│ │ ├── 004-sdk-integration.md
|
||||||
|
│ │ └── 005-session-picker-modal.md
|
||||||
|
│ └── done/ # Completed tasks (empty)
|
||||||
|
└── README.md # Project overview
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
## Documentation Overview
|
||||||
|
|
||||||
|
### 1. Architecture (architecture.md)
|
||||||
|
|
||||||
|
**What it covers:**
|
||||||
|
|
||||||
|
- High-level system design
|
||||||
|
- Component layers (Main process, Renderer, Communication)
|
||||||
|
- State management approach
|
||||||
|
- Tab hierarchy (Instance tabs → Session tabs)
|
||||||
|
- Data flow for key operations
|
||||||
|
- Technology stack decisions
|
||||||
|
- Security considerations
|
||||||
|
|
||||||
|
**Key sections:**
|
||||||
|
|
||||||
|
- Component architecture diagram
|
||||||
|
- Instance/Session state structures
|
||||||
|
- Communication patterns (HTTP, SSE)
|
||||||
|
- Error handling strategies
|
||||||
|
- Performance considerations
|
||||||
|
|
||||||
|
### 2. User Interface (user-interface.md)
|
||||||
|
|
||||||
|
**What it covers:**
|
||||||
|
|
||||||
|
- Complete UI layout specifications
|
||||||
|
- Visual design for every component
|
||||||
|
- Interaction patterns
|
||||||
|
- Keyboard shortcuts
|
||||||
|
- Accessibility requirements
|
||||||
|
- Empty states and error states
|
||||||
|
- Modal designs
|
||||||
|
|
||||||
|
**Key sections:**
|
||||||
|
|
||||||
|
- Detailed layout wireframes (ASCII art)
|
||||||
|
- Component-by-component specifications
|
||||||
|
- Message rendering formats
|
||||||
|
- Control bar designs
|
||||||
|
- Modal/overlay specifications
|
||||||
|
- Color schemes and typography
|
||||||
|
|
||||||
|
### 3. Technical Implementation (technical-implementation.md)
|
||||||
|
|
||||||
|
**What it covers:**
|
||||||
|
|
||||||
|
- Technology stack details
|
||||||
|
- Project file structure
|
||||||
|
- State management patterns
|
||||||
|
- Process management implementation
|
||||||
|
- SDK integration approach
|
||||||
|
- SSE event handling
|
||||||
|
- IPC communication
|
||||||
|
- Error handling strategies
|
||||||
|
- Performance optimizations
|
||||||
|
|
||||||
|
**Key sections:**
|
||||||
|
|
||||||
|
- Complete project structure
|
||||||
|
- TypeScript interfaces
|
||||||
|
- Process spawning logic
|
||||||
|
- SDK client management
|
||||||
|
- Message rendering implementation
|
||||||
|
- Build and packaging config
|
||||||
|
|
||||||
|
### 4. Build Roadmap (build-roadmap.md)
|
||||||
|
|
||||||
|
**What it covers:**
|
||||||
|
|
||||||
|
- 8 development phases
|
||||||
|
- Task dependencies
|
||||||
|
- Timeline estimates
|
||||||
|
- Success criteria per phase
|
||||||
|
- Risk mitigation
|
||||||
|
- Release strategy
|
||||||
|
|
||||||
|
**Phases:**
|
||||||
|
|
||||||
|
1. **Foundation** (Week 1) - Project setup, process management
|
||||||
|
2. **Core Chat** (Week 2) - Message display, SSE streaming
|
||||||
|
3. **Essential Features** (Week 3) - Markdown, agents, errors
|
||||||
|
4. **Multi-Instance** (Week 4) - Multiple projects support
|
||||||
|
5. **Advanced Input** (Week 5) - Commands, file attachments
|
||||||
|
6. **Polish** (Week 6) - UX refinements, settings
|
||||||
|
7. **System Integration** (Week 7) - Native features
|
||||||
|
8. **Advanced** (Week 8+) - Performance, plugins
|
||||||
|
|
||||||
|
## Task Breakdown
|
||||||
|
|
||||||
|
### Current Tasks (Phase 1)
|
||||||
|
|
||||||
|
**001 - Project Setup** (2-3 hours)
|
||||||
|
|
||||||
|
- Set up Electron + SolidJS + Vite
|
||||||
|
- Configure TypeScript, TailwindCSS
|
||||||
|
- Create basic project structure
|
||||||
|
- Verify build pipeline works
|
||||||
|
|
||||||
|
**002 - Empty State UI** (2-3 hours)
|
||||||
|
|
||||||
|
- Create empty state component
|
||||||
|
- Implement folder selection dialog
|
||||||
|
- Add keyboard shortcuts
|
||||||
|
- Style and test responsiveness
|
||||||
|
|
||||||
|
**003 - Process Manager** (4-5 hours)
|
||||||
|
|
||||||
|
- Spawn OpenCode server processes
|
||||||
|
- Parse stdout for port extraction
|
||||||
|
- Kill processes on command
|
||||||
|
- Handle errors and timeouts
|
||||||
|
- Auto-cleanup on app quit
|
||||||
|
|
||||||
|
**004 - SDK Integration** (3-4 hours)
|
||||||
|
|
||||||
|
- Create SDK client per instance
|
||||||
|
- Fetch sessions, agents, models
|
||||||
|
- Implement session CRUD operations
|
||||||
|
- Add error handling and retries
|
||||||
|
|
||||||
|
**005 - Session Picker Modal** (3-4 hours)
|
||||||
|
|
||||||
|
- Build modal with session list
|
||||||
|
- Agent selector for new sessions
|
||||||
|
- Keyboard navigation
|
||||||
|
- Loading and error states
|
||||||
|
|
||||||
|
**Total Phase 1 time: ~15-20 hours (2-3 weeks part-time)**
|
||||||
|
|
||||||
|
## Key Design Decisions
|
||||||
|
|
||||||
|
### 1. Two-Level Tabs
|
||||||
|
|
||||||
|
- **Level 1**: Instance tabs (one per project folder)
|
||||||
|
- **Level 2**: Session tabs (multiple per instance)
|
||||||
|
- Allows working on multiple projects with multiple conversations each
|
||||||
|
|
||||||
|
### 2. Process Management in Main Process
|
||||||
|
|
||||||
|
- Electron main process spawns servers
|
||||||
|
- Parses stdout to get port
|
||||||
|
- IPC sends port to renderer
|
||||||
|
- Ensures clean shutdown on app quit
|
||||||
|
|
||||||
|
### 3. One SDK Client Per Instance
|
||||||
|
|
||||||
|
- Each instance has its own HTTP client
|
||||||
|
- Connects to different port (different server)
|
||||||
|
- Isolated state prevents cross-contamination
|
||||||
|
|
||||||
|
### 4. SolidJS for Reactivity
|
||||||
|
|
||||||
|
- Fine-grained reactivity for SSE updates
|
||||||
|
- No re-render cascades
|
||||||
|
- Better performance for real-time updates
|
||||||
|
- Smaller bundle size than React
|
||||||
|
|
||||||
|
### 5. No Virtual Scrolling or Performance Optimization in MVP
|
||||||
|
|
||||||
|
- Start with simple list rendering
|
||||||
|
- Don't optimize for large sessions initially
|
||||||
|
- Focus on functionality, not performance
|
||||||
|
- Add optimizations in post-MVP phases if needed
|
||||||
|
- Reduces initial complexity and speeds up development
|
||||||
|
|
||||||
|
### 6. Messages and Tool Calls Inline
|
||||||
|
|
||||||
|
- All activity shows in main message stream
|
||||||
|
- Tool calls expandable/collapsible
|
||||||
|
- File changes visible inline
|
||||||
|
- Single timeline view
|
||||||
|
|
||||||
|
## Implementation Guidelines
|
||||||
|
|
||||||
|
### For Each Task:
|
||||||
|
|
||||||
|
1. Read task file completely
|
||||||
|
2. Review related documentation
|
||||||
|
3. Follow steps in order
|
||||||
|
4. Check off acceptance criteria
|
||||||
|
5. Test thoroughly
|
||||||
|
6. Move to done/ when complete
|
||||||
|
|
||||||
|
### Code Standards:
|
||||||
|
|
||||||
|
- TypeScript for everything
|
||||||
|
- No `any` types
|
||||||
|
- Descriptive variable names
|
||||||
|
- Comments for complex logic
|
||||||
|
- Error handling on all async operations
|
||||||
|
- Loading states for all network calls
|
||||||
|
|
||||||
|
### Testing Approach:
|
||||||
|
|
||||||
|
- Manual testing at each step
|
||||||
|
- Test on minimum window size (800x600)
|
||||||
|
- Test error cases
|
||||||
|
- Test edge cases (long text, special chars)
|
||||||
|
- Keyboard navigation verification
|
||||||
|
|
||||||
|
## Next Steps
|
||||||
|
|
||||||
|
### To Start Building:
|
||||||
|
|
||||||
|
1. **Read all documentation**
|
||||||
|
- Understand architecture
|
||||||
|
- Review UI specifications
|
||||||
|
- Study technical approach
|
||||||
|
|
||||||
|
2. **Start with Task 001**
|
||||||
|
- Set up project structure
|
||||||
|
- Install dependencies
|
||||||
|
- Verify build works
|
||||||
|
|
||||||
|
3. **Follow sequential order**
|
||||||
|
- Each task builds on previous
|
||||||
|
- Don't skip ahead
|
||||||
|
- Dependencies matter
|
||||||
|
|
||||||
|
4. **Track progress**
|
||||||
|
- Update task checkboxes
|
||||||
|
- Move completed tasks to done/
|
||||||
|
- Update roadmap as you go
|
||||||
|
|
||||||
|
### When You Hit Issues:
|
||||||
|
|
||||||
|
1. Review task prerequisites
|
||||||
|
2. Check documentation for clarification
|
||||||
|
3. Look at related specs
|
||||||
|
4. Ask questions on unclear requirements
|
||||||
|
5. Document blockers and solutions
|
||||||
|
|
||||||
|
## Success Metrics
|
||||||
|
|
||||||
|
### MVP (After Task 015)
|
||||||
|
|
||||||
|
- Can select folder → spawn server → chat
|
||||||
|
- Messages stream in real-time
|
||||||
|
- Can switch agents and models
|
||||||
|
- Tool executions visible
|
||||||
|
- Basic error handling works
|
||||||
|
- **Performance is NOT a concern** - focus on functionality
|
||||||
|
|
||||||
|
### Beta (After Task 030)
|
||||||
|
|
||||||
|
- Multi-instance support
|
||||||
|
- Advanced input (files, commands)
|
||||||
|
- Polished UX
|
||||||
|
- Settings and preferences
|
||||||
|
- Native menus
|
||||||
|
|
||||||
|
### v1.0 (After Task 035)
|
||||||
|
|
||||||
|
- System tray integration
|
||||||
|
- Auto-updates
|
||||||
|
- Crash reporting
|
||||||
|
- Production-ready stability
|
||||||
|
|
||||||
|
## Useful References
|
||||||
|
|
||||||
|
### Within This Project:
|
||||||
|
|
||||||
|
- `README.md` - Project overview and getting started
|
||||||
|
- `docs/architecture.md` - System design
|
||||||
|
- `docs/user-interface.md` - UI specifications
|
||||||
|
- `docs/technical-implementation.md` - Implementation details
|
||||||
|
- `tasks/README.md` - Task workflow guide
|
||||||
|
|
||||||
|
### External:
|
||||||
|
|
||||||
|
- OpenCode server API: https://opencode.ai/docs/server/
|
||||||
|
- Electron docs: https://electronjs.org/docs
|
||||||
|
- SolidJS docs: https://solidjs.com
|
||||||
|
- Kobalte UI: https://kobalte.dev
|
||||||
|
|
||||||
|
## Questions to Resolve
|
||||||
|
|
||||||
|
Before starting implementation, clarify:
|
||||||
|
|
||||||
|
1. Exact OpenCode CLI syntax for spawning server
|
||||||
|
2. Expected stdout format for port extraction
|
||||||
|
3. SDK package location and version
|
||||||
|
4. Any platform-specific gotchas
|
||||||
|
5. Icon and branding assets location
|
||||||
|
|
||||||
|
## Estimated Timeline
|
||||||
|
|
||||||
|
**Conservative estimate (part-time, ~15 hours/week):**
|
||||||
|
|
||||||
|
- Phase 1 (MVP Foundation): 2-3 weeks
|
||||||
|
- Phase 2 (Core Chat): 2 weeks
|
||||||
|
- Phase 3 (Essential): 2 weeks
|
||||||
|
- **MVP Complete: 6-7 weeks**
|
||||||
|
|
||||||
|
**Aggressive estimate (full-time, ~40 hours/week):**
|
||||||
|
|
||||||
|
- Phase 1: 1 week
|
||||||
|
- Phase 2: 1 week
|
||||||
|
- Phase 3: 1 week
|
||||||
|
- **MVP Complete: 3 weeks**
|
||||||
|
|
||||||
|
Add 2-4 weeks for testing, bug fixes, and polish before alpha release.
|
||||||
|
|
||||||
|
## This is a Living Document
|
||||||
|
|
||||||
|
As you build:
|
||||||
|
|
||||||
|
- Update estimates based on actual time
|
||||||
|
- Add new tasks as needed
|
||||||
|
- Refine specifications
|
||||||
|
- Document learnings
|
||||||
|
- Track blockers and solutions
|
||||||
|
|
||||||
|
Good luck! 🚀
|
||||||
228
dev-docs/TOOL_CALL_IMPLEMENTATION.md
Normal file
228
dev-docs/TOOL_CALL_IMPLEMENTATION.md
Normal file
@@ -0,0 +1,228 @@
|
|||||||
|
# Tool Call Rendering Implementation
|
||||||
|
|
||||||
|
This document describes how tool calls are rendered in the CodeNomad, following the patterns established in the TUI.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
Each tool type has specialized rendering logic that displays the most relevant information for that tool. This matches the TUI's approach of providing context-specific displays rather than generic input/output dumps.
|
||||||
|
|
||||||
|
## Tool-Specific Rendering
|
||||||
|
|
||||||
|
### 1. **read** - File Reading
|
||||||
|
|
||||||
|
- **Title**: `Read {filename}`
|
||||||
|
- **Body**: Preview of file content (first 6 lines) from `metadata.preview`
|
||||||
|
- **Use case**: Shows what file content the assistant is reading
|
||||||
|
|
||||||
|
### 2. **edit** - File Editing
|
||||||
|
|
||||||
|
- **Title**: `Edit {filename}`
|
||||||
|
- **Body**: Diff/patch showing changes from `metadata.diff`
|
||||||
|
- **Special**: Shows diagnostics if available in metadata
|
||||||
|
- **Use case**: Shows what changes are being made to files
|
||||||
|
|
||||||
|
### 3. **write** - File Writing
|
||||||
|
|
||||||
|
- **Title**: `Write {filename}`
|
||||||
|
- **Body**: File content being written (first 10 lines)
|
||||||
|
- **Special**: Shows diagnostics if available in metadata
|
||||||
|
- **Use case**: Shows new file content being created
|
||||||
|
|
||||||
|
### 4. **bash** - Shell Commands
|
||||||
|
|
||||||
|
- **Title**: `Shell {description}` (or command if no description)
|
||||||
|
- **Body**: Console-style display with `$ command` and output
|
||||||
|
|
||||||
|
```
|
||||||
|
$ npm install vitest
|
||||||
|
added 50 packages...
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Output from**: `metadata.output`
|
||||||
|
- **Use case**: Shows command execution and results
|
||||||
|
|
||||||
|
### 5. **webfetch** - Web Fetching
|
||||||
|
|
||||||
|
- **Title**: `Fetch {url}`
|
||||||
|
- **Body**: Fetched content (first 10 lines)
|
||||||
|
- **Use case**: Shows web content being retrieved
|
||||||
|
|
||||||
|
### 6. **todowrite** - Task Planning
|
||||||
|
|
||||||
|
- **Title**: Dynamic based on todo phase:
|
||||||
|
- All pending: "Creating plan"
|
||||||
|
- All completed: "Completing plan"
|
||||||
|
- Mixed: "Updating plan"
|
||||||
|
- **Body**: Formatted todo list:
|
||||||
|
- `- [x] Completed task`
|
||||||
|
- `- [ ] Pending task`
|
||||||
|
- `- [ ] ~~Cancelled task~~`
|
||||||
|
- `- [ ] In progress task` (highlighted)
|
||||||
|
- **Use case**: Shows the AI's task planning
|
||||||
|
|
||||||
|
### 7. **task** - Delegated Tasks
|
||||||
|
|
||||||
|
- **Title**: `Task[subagent_type] {description}`
|
||||||
|
- **Body**: List of delegated tool calls with icons:
|
||||||
|
|
||||||
|
```
|
||||||
|
⚡ bash: npm install
|
||||||
|
📖 read package.json
|
||||||
|
✏️ edit src/app.ts
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Special**: In TUI, includes navigation hints for session tree
|
||||||
|
- **Use case**: Shows what the delegated agent is doing
|
||||||
|
|
||||||
|
### 8. **todoread** - Plan Reading
|
||||||
|
|
||||||
|
- **Special**: Hidden in TUI, returns empty string
|
||||||
|
- **Use case**: Internal tool, not displayed to user
|
||||||
|
|
||||||
|
### 9. **glob** - File Pattern Matching
|
||||||
|
|
||||||
|
- **Title**: `Glob {pattern}`
|
||||||
|
- **Use case**: Shows file search patterns
|
||||||
|
|
||||||
|
### 10. **grep** - Content Search
|
||||||
|
|
||||||
|
- **Title**: `Grep "{pattern}"`
|
||||||
|
- **Use case**: Shows what content is being searched
|
||||||
|
|
||||||
|
### 11. **list** - Directory Listing
|
||||||
|
|
||||||
|
- **Title**: `List`
|
||||||
|
- **Use case**: Shows directory operations
|
||||||
|
|
||||||
|
### 12. **patch** - Patching Files
|
||||||
|
|
||||||
|
- **Title**: `Patch`
|
||||||
|
- **Use case**: Shows patch operations
|
||||||
|
|
||||||
|
### 13. **invalid** - Invalid Tool Calls
|
||||||
|
|
||||||
|
- **Title**: Name of the actual tool attempted
|
||||||
|
- **Use case**: Shows validation errors
|
||||||
|
|
||||||
|
### 14. **Default** - Unknown Tools
|
||||||
|
|
||||||
|
- **Title**: Capitalized tool name
|
||||||
|
- **Body**: Output truncated to 10 lines
|
||||||
|
- **Use case**: Fallback for any new or custom tools
|
||||||
|
|
||||||
|
## Status States
|
||||||
|
|
||||||
|
### Pending
|
||||||
|
|
||||||
|
- **Icon**: ⏸ (pause symbol)
|
||||||
|
- **Title**: Action text (e.g., "Writing command...", "Preparing edit...")
|
||||||
|
- **Border**: Accent color
|
||||||
|
- **Animation**: Shimmer effect on title
|
||||||
|
- **Expandable**: Shows "Waiting for permission..." message
|
||||||
|
|
||||||
|
### Running
|
||||||
|
|
||||||
|
- **Icon**: ⏳ (hourglass)
|
||||||
|
- **Title**: Same as completed state
|
||||||
|
- **Border**: Warning color (yellow/orange)
|
||||||
|
- **Animation**: Pulse on status icon
|
||||||
|
|
||||||
|
### Completed
|
||||||
|
|
||||||
|
- **Icon**: ✓ (checkmark)
|
||||||
|
- **Title**: Tool-specific title with arguments
|
||||||
|
- **Border**: Success color (green)
|
||||||
|
- **Body**: Tool-specific rendered content
|
||||||
|
|
||||||
|
### Error
|
||||||
|
|
||||||
|
- **Icon**: ✗ (X mark)
|
||||||
|
- **Title**: Same format but in error color
|
||||||
|
- **Border**: Error color (red)
|
||||||
|
- **Body**: Error message in highlighted box
|
||||||
|
|
||||||
|
## Title Rendering Logic
|
||||||
|
|
||||||
|
The title follows this pattern:
|
||||||
|
|
||||||
|
1. **Pending state**: Show action text
|
||||||
|
|
||||||
|
```
|
||||||
|
"Writing command..."
|
||||||
|
"Preparing edit..."
|
||||||
|
"Delegating..."
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Completed/Running/Error**: Show specific info
|
||||||
|
|
||||||
|
```
|
||||||
|
"Shell npm install"
|
||||||
|
"Edit src/app.ts"
|
||||||
|
"Read package.json"
|
||||||
|
"Task[general] Search for files"
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Special cases**:
|
||||||
|
- `todowrite`: Shows plan phase
|
||||||
|
- `todoread`: Just "Plan"
|
||||||
|
- `bash`: Uses description if available, otherwise shows command
|
||||||
|
|
||||||
|
## Metadata Usage
|
||||||
|
|
||||||
|
Tool calls use `metadata` for rich content:
|
||||||
|
|
||||||
|
- **read**: `metadata.preview` - file preview content
|
||||||
|
- **edit**: `metadata.diff` - patch/diff text
|
||||||
|
- **bash**: `metadata.output` - command output
|
||||||
|
- **todowrite**: `metadata.todos[]` - todo items with status
|
||||||
|
- **task**: `metadata.summary[]` - delegated tool calls
|
||||||
|
- **edit/write**: `metadata.diagnostics` - LSP diagnostics
|
||||||
|
|
||||||
|
## Design Principles
|
||||||
|
|
||||||
|
1. **Context-specific**: Each tool shows the most relevant information
|
||||||
|
2. **Progressive disclosure**: Collapsed by default, expand for details
|
||||||
|
3. **Visual hierarchy**: Icons, colors, and borders indicate status
|
||||||
|
4. **Truncation**: Long content is truncated (6-10 lines) to prevent overwhelming
|
||||||
|
5. **Consistency**: All tools follow same header/body/error structure
|
||||||
|
|
||||||
|
## Component Structure
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
<div class="tool-call tool-call-status-{status}">
|
||||||
|
<button class="tool-call-header" onClick={toggle}>
|
||||||
|
<span class="tool-call-icon">▶/▼</span>
|
||||||
|
<span class="tool-call-emoji">{icon}</span>
|
||||||
|
<span class="tool-call-summary">{title}</span>
|
||||||
|
<span class="tool-call-status">{statusIcon}</span>
|
||||||
|
</button>
|
||||||
|
|
||||||
|
{expanded && (
|
||||||
|
<div class="tool-call-details">
|
||||||
|
{/* Tool-specific body content */}
|
||||||
|
{error && <div class="tool-call-error-content">{error}</div>}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
```
|
||||||
|
|
||||||
|
## CSS Classes
|
||||||
|
|
||||||
|
- `.tool-call` - Base container
|
||||||
|
- `.tool-call-status-{pending|running|completed|error}` - Status-specific styling
|
||||||
|
- `.tool-call-header` - Clickable header with expand/collapse
|
||||||
|
- `.tool-call-emoji` - Tool type icon
|
||||||
|
- `.tool-call-summary` - Tool title/description
|
||||||
|
- `.tool-call-details` - Expanded content area
|
||||||
|
- `.tool-call-content` - Code/output content (monospace)
|
||||||
|
- `.tool-call-todos` - Todo list container
|
||||||
|
- `.tool-call-task-summary` - Delegated task list
|
||||||
|
- `.tool-call-error-content` - Error message display
|
||||||
|
|
||||||
|
## Future Enhancements
|
||||||
|
|
||||||
|
1. **Syntax highlighting**: Use Shiki for code blocks in bash, read, write
|
||||||
|
2. **Diff rendering**: Better diff visualization for edit tool
|
||||||
|
3. **Copy buttons**: Quick copy for code/output
|
||||||
|
4. **File links**: Click filename to open in editor
|
||||||
|
5. **Diagnostics display**: Show LSP errors/warnings inline
|
||||||
312
dev-docs/architecture.md
Normal file
312
dev-docs/architecture.md
Normal file
@@ -0,0 +1,312 @@
|
|||||||
|
# CodeNomad Architecture
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
CodeNomad is a cross-platform desktop application built with Electron that provides a multi-instance, multi-session interface for interacting with OpenCode servers. Each instance manages its own OpenCode server process and can handle multiple concurrent sessions.
|
||||||
|
|
||||||
|
## High-Level Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────┐
|
||||||
|
│ Electron Main Process │
|
||||||
|
│ - Window management │
|
||||||
|
│ - Process spawning (opencode serve) │
|
||||||
|
│ - IPC bridge to renderer │
|
||||||
|
│ - File system operations │
|
||||||
|
└────────────────┬────────────────────────────────────────┘
|
||||||
|
│ IPC
|
||||||
|
┌────────────────┴────────────────────────────────────────┐
|
||||||
|
│ Electron Renderer Process │
|
||||||
|
│ ┌──────────────────────────────────────────────────┐ │
|
||||||
|
│ │ SolidJS Application │ │
|
||||||
|
│ │ ┌────────────────────────────────────────────┐ │ │
|
||||||
|
│ │ │ Instance Manager │ │ │
|
||||||
|
│ │ │ - Spawns/kills OpenCode servers │ │ │
|
||||||
|
│ │ │ - Manages SDK clients per instance │ │ │
|
||||||
|
│ │ │ - Handles port allocation │ │ │
|
||||||
|
│ │ └────────────────────────────────────────────┘ │ │
|
||||||
|
│ │ ┌────────────────────────────────────────────┐ │ │
|
||||||
|
│ │ │ State Management (SolidJS Stores) │ │ │
|
||||||
|
│ │ │ - instances[] │ │ │
|
||||||
|
│ │ │ - sessions[] per instance │ │ │
|
||||||
|
│ │ │ - normalized message store per session │ │ │
|
||||||
|
│ │ └────────────────────────────────────────────┘ │ │
|
||||||
|
│ │ ┌────────────────────────────────────────────┐ │ │
|
||||||
|
│ │ │ UI Components │ │ │
|
||||||
|
│ │ │ - InstanceTabs │ │ │
|
||||||
|
│ │ │ - SessionTabs │ │ │
|
||||||
|
│ │ │ - MessageSection │ │ │
|
||||||
|
│ │ │ - PromptInput │ │ │
|
||||||
|
│ │ └────────────────────────────────────────────┘ │ │
|
||||||
|
│ └──────────────────────────────────────────────────┘ │
|
||||||
|
└─────────────────────────────────────────────────────────┘
|
||||||
|
│ HTTP/SSE
|
||||||
|
┌────────────────┴────────────────────────────────────────┐
|
||||||
|
│ Multiple OpenCode Server Processes │
|
||||||
|
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||||
|
│ │ Instance 1 │ │ Instance 2 │ │ Instance 3 │ │
|
||||||
|
│ │ Port: 4096 │ │ Port: 4097 │ │ Port: 4098 │ │
|
||||||
|
│ │ ~/project-a │ │ ~/project-a │ │ ~/api │ │
|
||||||
|
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||||
|
└─────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## Component Layers
|
||||||
|
|
||||||
|
### 1. Main Process Layer (Electron)
|
||||||
|
|
||||||
|
**Responsibilities:**
|
||||||
|
|
||||||
|
- Create and manage application window
|
||||||
|
- Spawn OpenCode server processes as child processes
|
||||||
|
- Parse server stdout to extract port information
|
||||||
|
- Handle process lifecycle (start, stop, restart)
|
||||||
|
- Provide IPC handlers for renderer requests
|
||||||
|
- Manage native OS integrations (file dialogs, menus)
|
||||||
|
|
||||||
|
**Key Modules:**
|
||||||
|
|
||||||
|
- `main.ts` - Application entry point
|
||||||
|
- `process-manager.ts` - OpenCode server process spawning
|
||||||
|
- `ipc-handlers.ts` - IPC communication handlers
|
||||||
|
- `menu.ts` - Native application menu
|
||||||
|
|
||||||
|
### 2. Renderer Process Layer (SolidJS)
|
||||||
|
|
||||||
|
**Responsibilities:**
|
||||||
|
|
||||||
|
- Render UI components
|
||||||
|
- Manage application state
|
||||||
|
- Handle user interactions
|
||||||
|
- Communicate with OpenCode servers via HTTP/SSE
|
||||||
|
- Real-time message streaming
|
||||||
|
|
||||||
|
**Key Modules:**
|
||||||
|
|
||||||
|
- `App.tsx` - Root component
|
||||||
|
- `stores/` - State management
|
||||||
|
- `components/` - UI components
|
||||||
|
- `contexts/` - SolidJS context providers
|
||||||
|
- `lib/` - Utilities and helpers
|
||||||
|
|
||||||
|
### 3. Communication Layer
|
||||||
|
|
||||||
|
**HTTP API Communication:**
|
||||||
|
|
||||||
|
- SDK client per instance
|
||||||
|
- RESTful API calls for session/config/file operations
|
||||||
|
- Error handling and retries
|
||||||
|
|
||||||
|
**SSE (Server-Sent Events):**
|
||||||
|
|
||||||
|
- One EventSource per instance
|
||||||
|
- Real-time message updates
|
||||||
|
- Event type routing
|
||||||
|
- Reconnection logic
|
||||||
|
|
||||||
|
**CLI Proxy Paths:**
|
||||||
|
|
||||||
|
- The CLI server terminates all HTTP/SSE traffic and forwards it to the correct OpenCode instance.
|
||||||
|
- Each `WorkspaceDescriptor` exposes `proxyPath` (e.g., `/workspaces/<id>/instance`), which acts as the base URL for both REST and SSE calls.
|
||||||
|
- The renderer never touches the random per-instance port directly; it only talks to `window.location.origin + proxyPath` so a single CLI port can front every session.
|
||||||
|
|
||||||
|
## Data Flow
|
||||||
|
|
||||||
|
### Instance Creation Flow
|
||||||
|
|
||||||
|
1. User selects folder via Electron file dialog
|
||||||
|
2. Main process receives folder path via IPC
|
||||||
|
3. Main process spawns `opencode serve --port 0`
|
||||||
|
4. Main process parses stdout for port number
|
||||||
|
5. Main process sends port + PID back to renderer
|
||||||
|
6. Renderer creates SDK client for that port
|
||||||
|
7. Renderer fetches initial session list
|
||||||
|
8. Renderer displays session picker
|
||||||
|
|
||||||
|
### Message Streaming Flow
|
||||||
|
|
||||||
|
1. User submits prompt in active session
|
||||||
|
2. Renderer POSTs to `/session/:id/message`
|
||||||
|
3. SSE connection receives `MessageUpdated` events
|
||||||
|
4. Events are routed to correct instance → session
|
||||||
|
5. Message state updates trigger UI re-render
|
||||||
|
6. Messages display with auto-scroll
|
||||||
|
|
||||||
|
### Child Session Creation Flow
|
||||||
|
|
||||||
|
1. OpenCode server creates child session
|
||||||
|
2. SSE emits `SessionUpdated` event with `parentId`
|
||||||
|
3. Renderer adds session to instance's session list
|
||||||
|
4. New session tab appears automatically
|
||||||
|
5. Optional: Auto-switch to new tab
|
||||||
|
|
||||||
|
## State Management
|
||||||
|
|
||||||
|
### Instance State
|
||||||
|
|
||||||
|
```
|
||||||
|
instances: Map<instanceId, {
|
||||||
|
id: string
|
||||||
|
folder: string
|
||||||
|
port: number
|
||||||
|
pid: number
|
||||||
|
proxyPath: string // `/workspaces/:id/instance`
|
||||||
|
status: 'starting' | 'ready' | 'error' | 'stopped'
|
||||||
|
client: OpenCodeClient
|
||||||
|
eventSource: EventSource
|
||||||
|
sessions: Map<sessionId, Session>
|
||||||
|
activeSessionId: string | null
|
||||||
|
logs: string[]
|
||||||
|
}>
|
||||||
|
```
|
||||||
|
|
||||||
|
### Session State
|
||||||
|
|
||||||
|
```
|
||||||
|
Session: {
|
||||||
|
id: string
|
||||||
|
title: string
|
||||||
|
parentId: string | null
|
||||||
|
messages: Message[]
|
||||||
|
agent: string
|
||||||
|
model: { providerId: string, modelId: string }
|
||||||
|
status: 'idle' | 'streaming' | 'error'
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Message State
|
||||||
|
|
||||||
|
```
|
||||||
|
Message: {
|
||||||
|
id: string
|
||||||
|
sessionId: string
|
||||||
|
type: 'user' | 'assistant'
|
||||||
|
parts: Part[]
|
||||||
|
timestamp: number
|
||||||
|
status: 'sending' | 'sent' | 'streaming' | 'complete' | 'error'
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Tab Hierarchy
|
||||||
|
|
||||||
|
### Level 1: Instance Tabs
|
||||||
|
|
||||||
|
Each tab represents one OpenCode server instance:
|
||||||
|
|
||||||
|
- Label: Folder name (with counter if duplicate)
|
||||||
|
- Icon: Folder icon
|
||||||
|
- Close button: Stops server and closes tab
|
||||||
|
- "+" button: Opens folder picker for new instance
|
||||||
|
|
||||||
|
### Level 2: Session Tabs
|
||||||
|
|
||||||
|
Each instance has multiple session tabs:
|
||||||
|
|
||||||
|
- Main session tab (always present)
|
||||||
|
- Child session tabs (auto-created)
|
||||||
|
- Logs tab (shows server output)
|
||||||
|
- "+" button: Creates new session
|
||||||
|
|
||||||
|
### Tab Behavior
|
||||||
|
|
||||||
|
**Instance Tab Switching:**
|
||||||
|
|
||||||
|
- Preserves session tabs
|
||||||
|
- Switches active SDK client
|
||||||
|
- Updates SSE event routing
|
||||||
|
|
||||||
|
**Session Tab Switching:**
|
||||||
|
|
||||||
|
- Loads messages for that session
|
||||||
|
- Updates agent/model controls
|
||||||
|
- Preserves scroll position
|
||||||
|
|
||||||
|
## Technology Stack
|
||||||
|
|
||||||
|
### Core
|
||||||
|
|
||||||
|
- **Electron** - Desktop wrapper
|
||||||
|
- **SolidJS** - Reactive UI framework
|
||||||
|
- **TypeScript** - Type safety
|
||||||
|
- **Vite** - Build tool
|
||||||
|
|
||||||
|
### UI
|
||||||
|
|
||||||
|
- **TailwindCSS** - Styling
|
||||||
|
- **Kobalte** - Accessible UI primitives
|
||||||
|
- **Shiki** - Code syntax highlighting
|
||||||
|
- **Marked** - Markdown parsing
|
||||||
|
|
||||||
|
### Communication
|
||||||
|
|
||||||
|
- **OpenCode SDK** - API client
|
||||||
|
- **EventSource** - SSE streaming
|
||||||
|
- **Node Child Process** - Process spawning
|
||||||
|
|
||||||
|
## Error Handling
|
||||||
|
|
||||||
|
### Process Errors
|
||||||
|
|
||||||
|
- Server fails to start → Show error in instance tab
|
||||||
|
- Server crashes → Attempt auto-restart once
|
||||||
|
- Port already in use → Find next available port
|
||||||
|
|
||||||
|
### Network Errors
|
||||||
|
|
||||||
|
- API call fails → Show inline error, allow retry
|
||||||
|
- SSE disconnects → Auto-reconnect with backoff
|
||||||
|
- Timeout → Show timeout error, allow manual retry
|
||||||
|
|
||||||
|
### User Errors
|
||||||
|
|
||||||
|
- Invalid folder selection → Show error dialog
|
||||||
|
- Permission denied → Show actionable error message
|
||||||
|
- Out of memory → Graceful degradation message
|
||||||
|
|
||||||
|
## Performance Considerations
|
||||||
|
|
||||||
|
**Note: Performance optimization is NOT a focus for MVP. These are future considerations.**
|
||||||
|
|
||||||
|
### Message Rendering (Post-MVP)
|
||||||
|
|
||||||
|
- Start with simple list rendering - no virtual scrolling
|
||||||
|
- No message limits initially
|
||||||
|
- Only optimize if users report issues
|
||||||
|
- Virtual scrolling can be added in Phase 8 if needed
|
||||||
|
|
||||||
|
### State Updates
|
||||||
|
|
||||||
|
- SolidJS fine-grained reactivity handles most cases
|
||||||
|
- No special optimizations needed for MVP
|
||||||
|
- Batching/debouncing can be added later if needed
|
||||||
|
|
||||||
|
### Memory Management (Post-MVP)
|
||||||
|
|
||||||
|
- No memory management in MVP
|
||||||
|
- Let browser/OS handle it
|
||||||
|
- Add limits only if problems arise in testing
|
||||||
|
|
||||||
|
## Security Considerations
|
||||||
|
|
||||||
|
- No remote code execution
|
||||||
|
- Server spawned with user permissions
|
||||||
|
- No eval() or dangerous innerHTML
|
||||||
|
- Sanitize markdown rendering
|
||||||
|
- Validate all IPC messages
|
||||||
|
- HTTPS only for external requests
|
||||||
|
|
||||||
|
## Extensibility Points
|
||||||
|
|
||||||
|
### Plugin System (Future)
|
||||||
|
|
||||||
|
- Custom slash commands
|
||||||
|
- Custom message renderers
|
||||||
|
- Theme extensions
|
||||||
|
- Keybinding customization
|
||||||
|
|
||||||
|
### Configuration (Future)
|
||||||
|
|
||||||
|
- Per-instance settings
|
||||||
|
- Global preferences
|
||||||
|
- Workspace-specific configs
|
||||||
|
- Import/export settings
|
||||||
391
dev-docs/build-roadmap.md
Normal file
391
dev-docs/build-roadmap.md
Normal file
@@ -0,0 +1,391 @@
|
|||||||
|
# CodeNomad Build Roadmap
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
This document outlines the phased approach to building the CodeNomad desktop application. Each phase builds incrementally on the previous, with clear deliverables and milestones.
|
||||||
|
|
||||||
|
**Status:** MVP (Phases 1-3) is complete. Focus now shifts to post-MVP phases starting with multi-instance support and advanced input refinements.
|
||||||
|
|
||||||
|
## MVP Scope (Phases 1-3)
|
||||||
|
|
||||||
|
The minimum viable product includes:
|
||||||
|
|
||||||
|
- Single instance management
|
||||||
|
- Session selection and creation
|
||||||
|
- Message display (streaming)
|
||||||
|
- Basic prompt input (text only)
|
||||||
|
- Agent/model selection
|
||||||
|
- Process lifecycle management
|
||||||
|
|
||||||
|
**Target: 3-4 weeks for MVP**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 1: Foundation (Week 1)
|
||||||
|
|
||||||
|
**Goal:** Running Electron app that can spawn OpenCode servers
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
1. ✅ **001-project-setup** - Electron + SolidJS + Vite boilerplate
|
||||||
|
2. ✅ **002-empty-state-ui** - Empty state UI with folder selection
|
||||||
|
3. ✅ **003-process-manager** - Spawn and manage OpenCode server processes
|
||||||
|
4. ✅ **004-sdk-integration** - Connect to server via SDK
|
||||||
|
5. ✅ **005-session-picker-modal** - Select/create session modal
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- App launches successfully
|
||||||
|
- Can select folder
|
||||||
|
- Server spawns automatically
|
||||||
|
- Session picker appears
|
||||||
|
- Can create/select session
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- User can launch app → select folder → see session picker
|
||||||
|
- Server process runs in background
|
||||||
|
- Sessions fetch from API successfully
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 2: Core Chat Interface (Week 2)
|
||||||
|
|
||||||
|
**Goal:** Display messages and send basic prompts
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
6. **006-instance-session-tabs** - Two-level tab navigation
|
||||||
|
7. **007-message-display** - Render user and assistant messages
|
||||||
|
8. **008-sse-integration** - Real-time message streaming
|
||||||
|
9. **009-prompt-input-basic** - Text input with send functionality
|
||||||
|
10. **010-tool-call-rendering** - Display tool executions inline
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- Tab navigation works
|
||||||
|
- Messages display correctly
|
||||||
|
- Real-time updates via SSE
|
||||||
|
- Can send text messages
|
||||||
|
- Tool calls show status
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- User can type message → see response stream in real-time
|
||||||
|
- Tool executions visible and expandable
|
||||||
|
- Multiple sessions can be open simultaneously
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 3: Essential Features (Week 3)
|
||||||
|
|
||||||
|
**Goal:** Feature parity with basic TUI functionality
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
11. **011-agent-model-selectors** - Dropdown for agent/model switching
|
||||||
|
12. **012-markdown-rendering** - Proper markdown with code highlighting
|
||||||
|
13. **013-logs-tab** - View server logs
|
||||||
|
14. **014-error-handling** - Comprehensive error states and recovery
|
||||||
|
15. **015-keyboard-shortcuts** - Essential keyboard navigation
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- Can switch agents and models
|
||||||
|
- Markdown renders beautifully
|
||||||
|
- Code blocks have syntax highlighting
|
||||||
|
- Server logs accessible
|
||||||
|
- Errors handled gracefully
|
||||||
|
- Cmd/Ctrl+N, K, L shortcuts work
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- User experience matches TUI quality
|
||||||
|
- All error cases handled
|
||||||
|
- Keyboard-first navigation option available
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 4: Multi-Instance Support (Week 4)
|
||||||
|
|
||||||
|
**Goal:** Work on multiple projects simultaneously
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
16. **016-instance-tabs** - Instance-level tab management
|
||||||
|
17. **017-instance-state-persistence** - Remember instances across restarts
|
||||||
|
18. **018-child-session-handling** - Auto-create tabs for child sessions
|
||||||
|
19. **019-instance-lifecycle** - Stop, restart, reconnect instances
|
||||||
|
20. **020-multiple-sdk-clients** - One SDK client per instance
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- Multiple instance tabs
|
||||||
|
- Persists across app restarts
|
||||||
|
- Child sessions appear as new tabs
|
||||||
|
- Can stop individual instances
|
||||||
|
- All instances work independently
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- User can work on 3+ projects simultaneously
|
||||||
|
- App remembers state on restart
|
||||||
|
- No interference between instances
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 5: Advanced Input (Week 5)
|
||||||
|
|
||||||
|
**Goal:** Full input capabilities matching TUI
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
21. **021-slash-commands** - Command palette with autocomplete
|
||||||
|
22. **022-file-attachments** - @ mention file picker
|
||||||
|
23. **023-drag-drop-files** - Drag files onto input
|
||||||
|
24. **024-attachment-chips** - Display and manage attachments
|
||||||
|
25. **025-input-history** - Up/down arrow message history
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- `/command` autocomplete works
|
||||||
|
- `@file` picker searches files
|
||||||
|
- Drag & drop attaches files
|
||||||
|
- Attachment chips removable
|
||||||
|
- Previous messages accessible
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- Input feature parity with TUI
|
||||||
|
- File context easy to add
|
||||||
|
- Command discovery intuitive
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 6: Polish & UX (Week 6)
|
||||||
|
|
||||||
|
**Goal:** Production-ready user experience
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
26. **026-message-actions** - Copy, edit, regenerate messages
|
||||||
|
27. **027-search-in-session** - Find text in conversation
|
||||||
|
28. **028-session-management** - Rename, share, export sessions
|
||||||
|
29. **029-settings-ui** - Preferences and configuration
|
||||||
|
30. **030-native-menus** - Platform-native menu bar
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- Message context menus
|
||||||
|
- Search within conversation
|
||||||
|
- Session CRUD operations
|
||||||
|
- Settings dialog
|
||||||
|
- Native File/Edit/View menus
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- Feels polished and professional
|
||||||
|
- All common actions accessible
|
||||||
|
- Settings discoverable
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 7: System Integration (Week 7)
|
||||||
|
|
||||||
|
**Goal:** Native desktop app features
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
31. **031-system-tray** - Background running with tray icon
|
||||||
|
32. **032-notifications** - Desktop notifications for events
|
||||||
|
33. **033-auto-updater** - In-app update mechanism
|
||||||
|
34. **034-crash-reporting** - Error reporting and recovery
|
||||||
|
35. **035-performance-profiling** - Optimize rendering and memory
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- Runs in background
|
||||||
|
- Notifications for session activity
|
||||||
|
- Auto-updates on launch
|
||||||
|
- Crash logs captured
|
||||||
|
- Smooth performance with large sessions
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- App feels native to platform
|
||||||
|
- Updates seamlessly
|
||||||
|
- Crashes don't lose data
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Phase 8: Advanced Features (Week 8+)
|
||||||
|
|
||||||
|
**Goal:** Beyond MVP, power user features
|
||||||
|
|
||||||
|
### Tasks
|
||||||
|
|
||||||
|
36. **036-virtual-scrolling** - Handle 1000+ message sessions
|
||||||
|
37. **037-message-search-advanced** - Full-text search across sessions
|
||||||
|
38. **038-workspace-management** - Save/load workspace configurations
|
||||||
|
39. **039-theme-customization** - Custom themes and UI tweaks
|
||||||
|
40. **040-plugin-system** - Extension API for custom tools
|
||||||
|
|
||||||
|
### Deliverables
|
||||||
|
|
||||||
|
- Virtual scrolling for performance
|
||||||
|
- Cross-session search
|
||||||
|
- Workspace persistence
|
||||||
|
- Theme editor
|
||||||
|
- Plugin loader
|
||||||
|
|
||||||
|
### Success Criteria
|
||||||
|
|
||||||
|
- Handles massive sessions (5000+ messages)
|
||||||
|
- Can search entire project history
|
||||||
|
- Fully customizable
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Parallel Tracks
|
||||||
|
|
||||||
|
Some tasks can be worked on independently:
|
||||||
|
|
||||||
|
### Design Track
|
||||||
|
|
||||||
|
- Visual design refinements
|
||||||
|
- Icon creation
|
||||||
|
- Brand assets
|
||||||
|
- Marketing materials
|
||||||
|
|
||||||
|
### Documentation Track
|
||||||
|
|
||||||
|
- User guide
|
||||||
|
- Keyboard shortcuts reference
|
||||||
|
- Troubleshooting docs
|
||||||
|
- Video tutorials
|
||||||
|
|
||||||
|
### Infrastructure Track
|
||||||
|
|
||||||
|
- CI/CD pipeline
|
||||||
|
- Automated testing
|
||||||
|
- Release automation
|
||||||
|
- Analytics integration
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Release Strategy
|
||||||
|
|
||||||
|
### Alpha (After Phase 3)
|
||||||
|
|
||||||
|
- Internal testing only
|
||||||
|
- Frequent bugs expected
|
||||||
|
- Rapid iteration
|
||||||
|
|
||||||
|
### Beta (After Phase 6)
|
||||||
|
|
||||||
|
- Public beta program
|
||||||
|
- Feature complete
|
||||||
|
- Bug fixes and polish
|
||||||
|
|
||||||
|
### v1.0 (After Phase 7)
|
||||||
|
|
||||||
|
- Public release
|
||||||
|
- Stable and reliable
|
||||||
|
- Production-ready
|
||||||
|
|
||||||
|
### v1.x (Phase 8+)
|
||||||
|
|
||||||
|
- Regular feature updates
|
||||||
|
- Community-driven priorities
|
||||||
|
- Plugin ecosystem
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Success Metrics
|
||||||
|
|
||||||
|
### MVP Success
|
||||||
|
|
||||||
|
- 10 internal users daily
|
||||||
|
- Can complete full coding session
|
||||||
|
- <5 critical bugs
|
||||||
|
|
||||||
|
### Beta Success
|
||||||
|
|
||||||
|
- 100+ external users
|
||||||
|
- NPS >50
|
||||||
|
- <10 bugs per week
|
||||||
|
|
||||||
|
### v1.0 Success
|
||||||
|
|
||||||
|
- 1000+ users
|
||||||
|
- <1% crash rate
|
||||||
|
- Feature requests > bug reports
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Risk Mitigation
|
||||||
|
|
||||||
|
### Technical Risks
|
||||||
|
|
||||||
|
- **Process management complexity**
|
||||||
|
- Mitigation: Extensive testing, graceful degradation
|
||||||
|
- **SSE connection stability**
|
||||||
|
- Mitigation: Robust reconnection logic, offline mode
|
||||||
|
- **Performance with large sessions**
|
||||||
|
- Mitigation: NOT a concern for MVP - defer to Phase 8
|
||||||
|
- Accept slower performance initially, optimize later based on user feedback
|
||||||
|
|
||||||
|
### Product Risks
|
||||||
|
|
||||||
|
- **Feature creep**
|
||||||
|
- Mitigation: Strict MVP scope, user feedback prioritization
|
||||||
|
- **Over-optimization too early**
|
||||||
|
- Mitigation: Focus on functionality first, optimize in Phase 8
|
||||||
|
- Avoid premature performance optimization
|
||||||
|
- **Platform inconsistencies**
|
||||||
|
- Mitigation: Test on all platforms regularly
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependencies
|
||||||
|
|
||||||
|
### External
|
||||||
|
|
||||||
|
- OpenCode CLI availability
|
||||||
|
- OpenCode SDK stability
|
||||||
|
- Electron framework updates
|
||||||
|
|
||||||
|
### Internal
|
||||||
|
|
||||||
|
- Design assets
|
||||||
|
- Documentation
|
||||||
|
- Testing resources
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Milestone Checklist
|
||||||
|
|
||||||
|
### Pre-Alpha
|
||||||
|
|
||||||
|
- [ ] All Phase 1 tasks complete
|
||||||
|
- [ ] Can create instance and session
|
||||||
|
- [ ] Internal demo successful
|
||||||
|
|
||||||
|
### Alpha
|
||||||
|
|
||||||
|
- [ ] All Phase 2-3 tasks complete
|
||||||
|
- [ ] MVP feature complete
|
||||||
|
- [ ] 5+ internal users testing
|
||||||
|
|
||||||
|
### Beta
|
||||||
|
|
||||||
|
- [ ] All Phase 4-6 tasks complete
|
||||||
|
- [ ] Multi-instance stable
|
||||||
|
- [ ] 50+ external testers
|
||||||
|
|
||||||
|
### v1.0
|
||||||
|
|
||||||
|
- [ ] All Phase 7 tasks complete
|
||||||
|
- [ ] Documentation complete
|
||||||
|
- [ ] <5 known bugs
|
||||||
|
- [ ] Ready for public release
|
||||||
82
dev-docs/solidjs-llms.txt
Normal file
82
dev-docs/solidjs-llms.txt
Normal file
@@ -0,0 +1,82 @@
|
|||||||
|
# SolidJS Documentation
|
||||||
|
|
||||||
|
> Solid is a modern JavaScript framework for building user interfaces with fine-grained reactivity. It compiles JSX to real DOM elements and updates only what changes, delivering exceptional performance without a virtual DOM. Solid provides reactive primitives like signals, effects, and stores for predictable state management.
|
||||||
|
|
||||||
|
SolidJS is a declarative JavaScript framework that prioritizes performance and developer experience. Unlike frameworks that re-run components on every update, Solid components run once during initialization and set up a reactive system that precisely updates the DOM when dependencies change.
|
||||||
|
|
||||||
|
Key principles:
|
||||||
|
- Fine-grained reactivity: Updates only the specific DOM nodes that depend on changed data
|
||||||
|
- Compile-time optimization: JSX transforms into efficient DOM operations
|
||||||
|
- Unidirectional data flow: Props are read-only, promoting predictable state management
|
||||||
|
- Component lifecycle: Components run once, with reactive primitives handling updates
|
||||||
|
|
||||||
|
**Use your web fetch tool on any of the following links to understand the relevant concept**.
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
- [Overview](https://docs.solidjs.com/): Framework introduction and key advantages
|
||||||
|
- [Quick Start](https://docs.solidjs.com/quick-start): Installation and project setup with create-solid
|
||||||
|
- [Interactive Tutorial](https://www.solidjs.com/tutorial/introduction_basics): Learn Solid basics through guided examples
|
||||||
|
- [Playground](https://playground.solidjs.com/): Experiment with Solid directly in your browser
|
||||||
|
|
||||||
|
## Core Concepts
|
||||||
|
|
||||||
|
- [Intro to Reactivity](https://docs.solidjs.com/concepts/intro-to-reactivity): Signals, subscribers, and reactive principles
|
||||||
|
- [Understanding JSX](https://docs.solidjs.com/concepts/understanding-jsx): How Solid uses JSX and key differences from HTML
|
||||||
|
- [Components Basics](https://docs.solidjs.com/concepts/components/basics): Component trees, lifecycles, and composition patterns
|
||||||
|
- [Signals](https://docs.solidjs.com/concepts/signals): Core reactive primitive for state management with getters/setters
|
||||||
|
- [Effects](https://docs.solidjs.com/concepts/effects): Side effects, dependency tracking, and lifecycle functions
|
||||||
|
- [Stores](https://docs.solidjs.com/concepts/stores): Complex state management with proxy-based reactivity
|
||||||
|
- [Context](https://docs.solidjs.com/concepts/context): Cross-component state sharing without prop drilling
|
||||||
|
|
||||||
|
## Component APIs
|
||||||
|
|
||||||
|
- [Props](https://docs.solidjs.com/concepts/components/props): Passing data and handlers to child components
|
||||||
|
- [Event Handlers](https://docs.solidjs.com/concepts/components/event-handlers): Managing user interactions
|
||||||
|
- [Class and Style](https://docs.solidjs.com/concepts/components/class-style): Dynamic styling approaches
|
||||||
|
- [Refs](https://docs.solidjs.com/concepts/refs): Accessing DOM elements directly
|
||||||
|
|
||||||
|
## Control Flow
|
||||||
|
|
||||||
|
- [Conditional Rendering](https://docs.solidjs.com/concepts/control-flow/conditional-rendering): Show, Switch, and Match components
|
||||||
|
- [List Rendering](https://docs.solidjs.com/concepts/control-flow/list-rendering): For, Index, and keyed iteration
|
||||||
|
- [Dynamic](https://docs.solidjs.com/concepts/control-flow/dynamic): Dynamic component switching
|
||||||
|
- [Portal](https://docs.solidjs.com/concepts/control-flow/portal): Rendering outside component hierarchy
|
||||||
|
- [Error Boundary](https://docs.solidjs.com/concepts/control-flow/error-boundary): Graceful error handling
|
||||||
|
|
||||||
|
## Derived Values
|
||||||
|
|
||||||
|
- [Derived Signals](https://docs.solidjs.com/concepts/derived-values/derived-signals): Computed values from signals
|
||||||
|
- [Memos](https://docs.solidjs.com/concepts/derived-values/memos): Cached computed values for performance
|
||||||
|
|
||||||
|
## State Management
|
||||||
|
|
||||||
|
- [Basic State Management](https://docs.solidjs.com/guides/state-management): One-way data flow and lifting state
|
||||||
|
- [Complex State Management](https://docs.solidjs.com/guides/complex-state-management): Stores for scalable applications
|
||||||
|
- [Fetching Data](https://docs.solidjs.com/guides/fetching-data): Async data with createResource
|
||||||
|
|
||||||
|
## Routing
|
||||||
|
|
||||||
|
- [Routing & Navigation](https://docs.solidjs.com/guides/routing-and-navigation): @solidjs/router setup and usage
|
||||||
|
- [Dynamic Routes](https://docs.solidjs.com/guides/routing-and-navigation#dynamic-routes): Route parameters and validation
|
||||||
|
- [Nested Routes](https://docs.solidjs.com/guides/routing-and-navigation#nested-routes): Hierarchical route structures
|
||||||
|
- [Preload Functions](https://docs.solidjs.com/guides/routing-and-navigation#preload-functions): Parallel data fetching
|
||||||
|
|
||||||
|
## Advanced Topics
|
||||||
|
|
||||||
|
- [Fine-Grained Reactivity](https://docs.solidjs.com/advanced-concepts/fine-grained-reactivity): Deep dive into reactive system
|
||||||
|
- [TypeScript](https://docs.solidjs.com/configuration/typescript): Type safety and configuration
|
||||||
|
|
||||||
|
## Ecosystem
|
||||||
|
|
||||||
|
- [Solid Router](https://docs.solidjs.com/solid-router/): File-system routing and data APIs
|
||||||
|
- [SolidStart](https://docs.solidjs.com/solid-start/): Full-stack meta-framework
|
||||||
|
- [Solid Meta](https://docs.solidjs.com/solid-meta/): Document head management
|
||||||
|
- [Templates](https://github.com/solidjs/templates): Starter templates for different setups
|
||||||
|
|
||||||
|
## Optional
|
||||||
|
|
||||||
|
- [Ecosystem Libraries](https://www.solidjs.com/ecosystem): Community packages and tools
|
||||||
|
- [API Reference](https://docs.solidjs.com/reference/): Complete API documentation
|
||||||
|
- [Testing](https://docs.solidjs.com/guides/testing): Testing strategies and utilities
|
||||||
|
- [Deployment](https://docs.solidjs.com/guides/deploying-your-app): Build and deployment options
|
||||||
642
dev-docs/technical-implementation.md
Normal file
642
dev-docs/technical-implementation.md
Normal file
@@ -0,0 +1,642 @@
|
|||||||
|
# Technical Implementation Details
|
||||||
|
|
||||||
|
## Technology Stack
|
||||||
|
|
||||||
|
### Core Technologies
|
||||||
|
|
||||||
|
- **Electron** v28+ - Desktop application wrapper
|
||||||
|
- **SolidJS** v1.8+ - Reactive UI framework
|
||||||
|
- **TypeScript** v5.3+ - Type-safe development
|
||||||
|
- **Vite** v5+ - Fast build tool and dev server
|
||||||
|
|
||||||
|
### UI & Styling
|
||||||
|
|
||||||
|
- **TailwindCSS** v4+ - Utility-first styling
|
||||||
|
- **Kobalte** - Accessible UI primitives for SolidJS
|
||||||
|
- **Shiki** - Syntax highlighting for code blocks
|
||||||
|
- **Marked** - Markdown parsing
|
||||||
|
- **Lucide** - Icon library
|
||||||
|
|
||||||
|
### Communication
|
||||||
|
|
||||||
|
- **OpenCode SDK** (@opencode-ai/sdk) - API client
|
||||||
|
- **EventSource API** - Server-sent events
|
||||||
|
- **Node Child Process** - Process management
|
||||||
|
|
||||||
|
### Development Tools
|
||||||
|
|
||||||
|
- **electron-vite** - Electron + Vite integration
|
||||||
|
- **electron-builder** - Application packaging
|
||||||
|
- **ESLint** - Code linting
|
||||||
|
- **Prettier** - Code formatting
|
||||||
|
|
||||||
|
## Project Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
packages/opencode-client/
|
||||||
|
├── electron/
|
||||||
|
│ ├── main/
|
||||||
|
│ │ ├── main.ts # Electron main entry
|
||||||
|
│ │ ├── window.ts # Window management
|
||||||
|
│ │ ├── process-manager.ts # OpenCode server spawning
|
||||||
|
│ │ ├── ipc.ts # IPC handlers
|
||||||
|
│ │ └── menu.ts # Application menu
|
||||||
|
│ ├── preload/
|
||||||
|
│ │ └── index.ts # Preload script (IPC bridge)
|
||||||
|
│ └── resources/
|
||||||
|
│ └── icon.png # Application icon
|
||||||
|
├── src/
|
||||||
|
│ ├── components/
|
||||||
|
│ │ ├── instance-tabs.tsx # Level 1 tabs
|
||||||
|
│ │ ├── session-tabs.tsx # Level 2 tabs
|
||||||
|
│ │ ├── message-stream-v2.tsx # Messages display (normalized store)
|
||||||
|
│ │ ├── message-item.tsx # Single message
|
||||||
|
│ │ ├── tool-call.tsx # Tool execution display
|
||||||
|
│ │ ├── prompt-input.tsx # Input with attachments
|
||||||
|
│ │ ├── agent-selector.tsx # Agent dropdown
|
||||||
|
│ │ ├── model-selector.tsx # Model dropdown
|
||||||
|
│ │ ├── session-picker.tsx # Startup modal
|
||||||
|
│ │ ├── logs-view.tsx # Server logs
|
||||||
|
│ │ └── empty-state.tsx # No instances view
|
||||||
|
│ ├── stores/
|
||||||
|
│ │ ├── instances.ts # Instance state
|
||||||
|
│ │ ├── sessions.ts # Session state per instance
|
||||||
|
│ │ └── ui.ts # UI state (active tabs, etc)
|
||||||
|
│ ├── lib/
|
||||||
|
│ │ ├── sdk-manager.ts # SDK client management
|
||||||
|
│ │ ├── sse-manager.ts # SSE connection handling
|
||||||
|
│ │ ├── port-finder.ts # Find available ports
|
||||||
|
│ │ └── markdown.ts # Markdown rendering utils
|
||||||
|
│ ├── hooks/
|
||||||
|
│ │ ├── use-instance.ts # Instance operations
|
||||||
|
│ │ ├── use-session.ts # Session operations
|
||||||
|
│ │ └── use-messages.ts # Message operations
|
||||||
|
│ ├── types/
|
||||||
|
│ │ ├── instance.ts # Instance types
|
||||||
|
│ │ ├── session.ts # Session types
|
||||||
|
│ │ └── message.ts # Message types
|
||||||
|
│ ├── App.tsx # Root component
|
||||||
|
│ ├── main.tsx # Renderer entry
|
||||||
|
│ └── index.css # Global styles
|
||||||
|
├── docs/ # Documentation
|
||||||
|
├── tasks/ # Task tracking
|
||||||
|
├── package.json
|
||||||
|
├── tsconfig.json
|
||||||
|
├── electron.vite.config.ts
|
||||||
|
├── tailwind.config.js
|
||||||
|
└── README.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## State Management
|
||||||
|
|
||||||
|
### Instance Store
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface InstanceState {
|
||||||
|
instances: Map<string, Instance>
|
||||||
|
activeInstanceId: string | null
|
||||||
|
|
||||||
|
// Actions
|
||||||
|
createInstance(folder: string): Promise<void>
|
||||||
|
removeInstance(id: string): Promise<void>
|
||||||
|
setActiveInstance(id: string): void
|
||||||
|
}
|
||||||
|
|
||||||
|
interface Instance {
|
||||||
|
id: string // UUID
|
||||||
|
folder: string // Absolute path
|
||||||
|
port: number // Server port
|
||||||
|
pid: number // Process ID
|
||||||
|
status: InstanceStatus
|
||||||
|
client: OpenCodeClient // SDK client
|
||||||
|
eventSource: EventSource | null // SSE connection
|
||||||
|
sessions: Map<string, Session>
|
||||||
|
activeSessionId: string | null
|
||||||
|
logs: LogEntry[]
|
||||||
|
}
|
||||||
|
|
||||||
|
type InstanceStatus =
|
||||||
|
| "starting" // Server spawning
|
||||||
|
| "ready" // Server connected
|
||||||
|
| "error" // Failed to start
|
||||||
|
| "stopped" // Server killed
|
||||||
|
|
||||||
|
interface LogEntry {
|
||||||
|
timestamp: number
|
||||||
|
level: "info" | "error" | "warn"
|
||||||
|
message: string
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Session Store
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface SessionState {
|
||||||
|
// Per instance
|
||||||
|
getSessions(instanceId: string): Session[]
|
||||||
|
getActiveSession(instanceId: string): Session | null
|
||||||
|
|
||||||
|
// Actions
|
||||||
|
createSession(instanceId: string, agent: string): Promise<Session>
|
||||||
|
deleteSession(instanceId: string, sessionId: string): Promise<void>
|
||||||
|
setActiveSession(instanceId: string, sessionId: string): void
|
||||||
|
updateSession(instanceId: string, sessionId: string, updates: Partial<Session>): void
|
||||||
|
}
|
||||||
|
|
||||||
|
interface Session {
|
||||||
|
id: string
|
||||||
|
instanceId: string
|
||||||
|
title: string
|
||||||
|
parentId: string | null
|
||||||
|
agent: string
|
||||||
|
model: {
|
||||||
|
providerId: string
|
||||||
|
modelId: string
|
||||||
|
}
|
||||||
|
version: string
|
||||||
|
time: { created: number; updated: number }
|
||||||
|
revert?: {
|
||||||
|
messageID?: string
|
||||||
|
partID?: string
|
||||||
|
snapshot?: string
|
||||||
|
diff?: string
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Message content lives in the normalized message-v2 store
|
||||||
|
// keyed by instanceId/sessionId/messageId
|
||||||
|
|
||||||
|
type SessionStatus =
|
||||||
|
| "idle" // No activity
|
||||||
|
| "streaming" // Assistant responding
|
||||||
|
| "error" // Error occurred
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### UI Store
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface UIState {
|
||||||
|
// Tab state
|
||||||
|
instanceTabOrder: string[]
|
||||||
|
sessionTabOrder: Map<string, string[]> // instanceId -> sessionIds
|
||||||
|
|
||||||
|
// Modal state
|
||||||
|
showSessionPicker: string | null // instanceId or null
|
||||||
|
showSettings: boolean
|
||||||
|
|
||||||
|
// Actions
|
||||||
|
reorderInstanceTabs(newOrder: string[]): void
|
||||||
|
reorderSessionTabs(instanceId: string, newOrder: string[]): void
|
||||||
|
openSessionPicker(instanceId: string): void
|
||||||
|
closeSessionPicker(): void
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Process Management
|
||||||
|
|
||||||
|
### Server Spawning
|
||||||
|
|
||||||
|
**Strategy:** Spawn with port 0 (random), parse stdout for actual port
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface ProcessManager {
|
||||||
|
spawn(folder: string): Promise<ProcessInfo>
|
||||||
|
kill(pid: number): Promise<void>
|
||||||
|
restart(pid: number, folder: string): Promise<ProcessInfo>
|
||||||
|
}
|
||||||
|
|
||||||
|
interface ProcessInfo {
|
||||||
|
pid: number
|
||||||
|
port: number
|
||||||
|
stdout: Readable
|
||||||
|
stderr: Readable
|
||||||
|
}
|
||||||
|
|
||||||
|
// Implementation approach:
|
||||||
|
// 1. Check if opencode binary exists
|
||||||
|
// 2. Spawn: spawn('opencode', ['serve', '--port', '0'], { cwd: folder })
|
||||||
|
// 3. Listen to stdout
|
||||||
|
// 4. Parse line matching: "Server listening on port 4096"
|
||||||
|
// 5. Resolve promise with port
|
||||||
|
// 6. Timeout after 10 seconds
|
||||||
|
```
|
||||||
|
|
||||||
|
### Port Parsing
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Expected output from opencode serve:
|
||||||
|
// > Starting OpenCode server...
|
||||||
|
// > Server listening on port 4096
|
||||||
|
// > API available at http://localhost:4096
|
||||||
|
|
||||||
|
function parsePort(output: string): number | null {
|
||||||
|
const match = output.match(/port (\d+)/)
|
||||||
|
return match ? parseInt(match[1], 10) : null
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Error Handling
|
||||||
|
|
||||||
|
**Server fails to start:**
|
||||||
|
|
||||||
|
- Parse stderr for error message
|
||||||
|
- Display in instance tab with retry button
|
||||||
|
- Common errors: Port in use, permission denied, binary not found
|
||||||
|
|
||||||
|
**Server crashes after start:**
|
||||||
|
|
||||||
|
- Detect via process 'exit' event
|
||||||
|
- Attempt auto-restart once
|
||||||
|
- If restart fails, show error state
|
||||||
|
- Preserve session data for manual restart
|
||||||
|
|
||||||
|
## Communication Layer
|
||||||
|
|
||||||
|
### SDK Client Management
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface SDKManager {
|
||||||
|
createClient(port: number): OpenCodeClient
|
||||||
|
destroyClient(port: number): void
|
||||||
|
getClient(port: number): OpenCodeClient | null
|
||||||
|
}
|
||||||
|
|
||||||
|
// One client per instance
|
||||||
|
// Client lifecycle tied to instance lifecycle
|
||||||
|
```
|
||||||
|
|
||||||
|
### SSE Event Handling
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface SSEManager {
|
||||||
|
connect(instanceId: string, port: number): void
|
||||||
|
disconnect(instanceId: string): void
|
||||||
|
|
||||||
|
// Event routing
|
||||||
|
onMessageUpdate(handler: (instanceId: string, event: MessageUpdateEvent) => void): void
|
||||||
|
onSessionUpdate(handler: (instanceId: string, event: SessionUpdateEvent) => void): void
|
||||||
|
onError(handler: (instanceId: string, error: Error) => void): void
|
||||||
|
}
|
||||||
|
|
||||||
|
// Event flow:
|
||||||
|
// 1. EventSource connects to /event endpoint
|
||||||
|
// 2. Events arrive as JSON
|
||||||
|
// 3. Route to correct instance store
|
||||||
|
// 4. Update reactive state
|
||||||
|
// 5. UI auto-updates via signals
|
||||||
|
```
|
||||||
|
|
||||||
|
### Reconnection Logic
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// SSE disconnects:
|
||||||
|
// - Network issue
|
||||||
|
// - Server restart
|
||||||
|
// - Tab sleep (browser optimization)
|
||||||
|
|
||||||
|
class SSEConnection {
|
||||||
|
private reconnectAttempts = 0
|
||||||
|
private maxReconnectAttempts = 5
|
||||||
|
private reconnectDelay = 1000 // Start with 1s
|
||||||
|
|
||||||
|
reconnect() {
|
||||||
|
if (this.reconnectAttempts >= this.maxReconnectAttempts) {
|
||||||
|
this.emitError(new Error("Max reconnection attempts reached"))
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
setTimeout(() => {
|
||||||
|
this.connect()
|
||||||
|
this.reconnectAttempts++
|
||||||
|
this.reconnectDelay *= 2 // Exponential backoff
|
||||||
|
}, this.reconnectDelay)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Message Rendering
|
||||||
|
|
||||||
|
### Markdown Processing
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Use Marked + Shiki for syntax highlighting
|
||||||
|
import { marked } from "marked"
|
||||||
|
import { markedHighlight } from "marked-highlight"
|
||||||
|
import { getHighlighter } from "shiki"
|
||||||
|
|
||||||
|
const highlighter = await getHighlighter({
|
||||||
|
themes: ["github-dark", "github-light"],
|
||||||
|
langs: ["typescript", "javascript", "python", "bash", "json"],
|
||||||
|
})
|
||||||
|
|
||||||
|
marked.use(
|
||||||
|
markedHighlight({
|
||||||
|
highlight(code, lang) {
|
||||||
|
return highlighter.codeToHtml(code, {
|
||||||
|
lang,
|
||||||
|
theme: isDark ? "github-dark" : "github-light",
|
||||||
|
})
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Tool Call Rendering
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
interface ToolCallComponent {
|
||||||
|
tool: string // "bash", "edit", "read"
|
||||||
|
input: any // Tool-specific input
|
||||||
|
output?: any // Tool-specific output
|
||||||
|
status: "pending" | "running" | "success" | "error"
|
||||||
|
expanded: boolean // Collapse state
|
||||||
|
}
|
||||||
|
|
||||||
|
// Render logic:
|
||||||
|
// - Default: Collapsed, show summary
|
||||||
|
// - Click: Toggle expanded state
|
||||||
|
// - Running: Show spinner
|
||||||
|
// - Complete: Show checkmark
|
||||||
|
// - Error: Show error icon + message
|
||||||
|
```
|
||||||
|
|
||||||
|
### Streaming Updates
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Messages stream in via SSE
|
||||||
|
// Update strategy: Replace existing message parts
|
||||||
|
|
||||||
|
function handleMessagePartUpdate(event: MessagePartEvent) {
|
||||||
|
const session = getSession(event.sessionId)
|
||||||
|
const message = session.messages.find((m) => m.id === event.messageId)
|
||||||
|
|
||||||
|
if (!message) {
|
||||||
|
// New message
|
||||||
|
session.messages.push(createMessage(event))
|
||||||
|
} else {
|
||||||
|
// Update existing
|
||||||
|
const partIndex = message.parts.findIndex((p) => p.id === event.partId)
|
||||||
|
if (partIndex === -1) {
|
||||||
|
message.parts.push(event.part)
|
||||||
|
} else {
|
||||||
|
message.parts[partIndex] = event.part
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// SolidJS reactivity triggers re-render
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Performance Considerations
|
||||||
|
|
||||||
|
**MVP Approach: Don't optimize prematurely**
|
||||||
|
|
||||||
|
### Message Rendering (MVP)
|
||||||
|
|
||||||
|
**Simple approach - no optimization:**
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Render all messages - no virtual scrolling, no limits
|
||||||
|
<For each={messages()}>
|
||||||
|
{(message) => <MessageItem message={message} />}
|
||||||
|
</For>
|
||||||
|
|
||||||
|
// SolidJS will handle reactivity efficiently
|
||||||
|
// Only optimize if users report issues
|
||||||
|
```
|
||||||
|
|
||||||
|
### State Update Batching
|
||||||
|
|
||||||
|
**Not needed for MVP:**
|
||||||
|
|
||||||
|
- SolidJS reactivity is efficient enough
|
||||||
|
- SSE updates will just trigger normal re-renders
|
||||||
|
- Add batching only if performance issues arise
|
||||||
|
|
||||||
|
### Memory Management
|
||||||
|
|
||||||
|
**Not needed for MVP:**
|
||||||
|
|
||||||
|
- No message limits
|
||||||
|
- No pruning
|
||||||
|
- No lazy loading
|
||||||
|
- Let users create as many messages as they want
|
||||||
|
- Optimize later if problems occur
|
||||||
|
|
||||||
|
**When to add optimizations (post-MVP):**
|
||||||
|
|
||||||
|
- Users report slowness with large sessions
|
||||||
|
- Measurable performance degradation
|
||||||
|
- Memory usage becomes problematic
|
||||||
|
- See Phase 8 tasks for virtual scrolling and optimization
|
||||||
|
|
||||||
|
## IPC Communication
|
||||||
|
|
||||||
|
### Main Process → Renderer
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Events sent from main to renderer
|
||||||
|
type MainToRenderer = {
|
||||||
|
"instance:started": { id: string; port: number; pid: number }
|
||||||
|
"instance:error": { id: string; error: string }
|
||||||
|
"instance:stopped": { id: string }
|
||||||
|
"instance:log": { id: string; entry: LogEntry }
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Renderer → Main Process
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Commands sent from renderer to main
|
||||||
|
type RendererToMain = {
|
||||||
|
"folder:select": () => Promise<string | null>
|
||||||
|
"instance:create": (folder: string) => Promise<{ port: number; pid: number }>
|
||||||
|
"instance:stop": (pid: number) => Promise<void>
|
||||||
|
"app:quit": () => void
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Preload Script (Bridge)
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Expose safe IPC methods to renderer
|
||||||
|
contextBridge.exposeInMainWorld("electronAPI", {
|
||||||
|
selectFolder: () => ipcRenderer.invoke("folder:select"),
|
||||||
|
createInstance: (folder: string) => ipcRenderer.invoke("instance:create", folder),
|
||||||
|
stopInstance: (pid: number) => ipcRenderer.invoke("instance:stop", pid),
|
||||||
|
onInstanceStarted: (callback) => ipcRenderer.on("instance:started", callback),
|
||||||
|
onInstanceError: (callback) => ipcRenderer.on("instance:error", callback),
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
## Error Handling Strategy
|
||||||
|
|
||||||
|
### Network Errors
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// HTTP request fails
|
||||||
|
try {
|
||||||
|
const response = await client.session.list()
|
||||||
|
} catch (error) {
|
||||||
|
if (error.code === "ECONNREFUSED") {
|
||||||
|
// Server not responding
|
||||||
|
showError("Cannot connect to server. Is it running?")
|
||||||
|
} else if (error.code === "ETIMEDOUT") {
|
||||||
|
// Request timeout
|
||||||
|
showError("Request timed out. Retry?", { retry: true })
|
||||||
|
} else {
|
||||||
|
// Unknown error
|
||||||
|
showError(error.message)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### SSE Errors
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
eventSource.onerror = (error) => {
|
||||||
|
// Connection lost
|
||||||
|
if (eventSource.readyState === EventSource.CLOSED) {
|
||||||
|
// Attempt reconnect
|
||||||
|
reconnectSSE()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### User Input Errors
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// Validate before sending
|
||||||
|
function validatePrompt(text: string): string | null {
|
||||||
|
if (!text.trim()) {
|
||||||
|
return "Message cannot be empty"
|
||||||
|
}
|
||||||
|
if (text.length > 10000) {
|
||||||
|
return "Message too long (max 10000 characters)"
|
||||||
|
}
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Security Measures
|
||||||
|
|
||||||
|
### IPC Security
|
||||||
|
|
||||||
|
- Use `contextIsolation: true`
|
||||||
|
- Whitelist allowed IPC channels
|
||||||
|
- Validate all data from renderer
|
||||||
|
- No `nodeIntegration` in renderer
|
||||||
|
|
||||||
|
### Process Security
|
||||||
|
|
||||||
|
- Spawn OpenCode with user permissions only
|
||||||
|
- No shell execution of user input
|
||||||
|
- Sanitize file paths
|
||||||
|
|
||||||
|
### Content Security
|
||||||
|
|
||||||
|
- Sanitize markdown before rendering
|
||||||
|
- Use DOMPurify for HTML sanitization
|
||||||
|
- No `dangerouslySetInnerHTML` without sanitization
|
||||||
|
- CSP headers in renderer
|
||||||
|
|
||||||
|
## Testing Strategy (Future)
|
||||||
|
|
||||||
|
### Unit Tests
|
||||||
|
|
||||||
|
- State management logic
|
||||||
|
- Utility functions
|
||||||
|
- Message parsing
|
||||||
|
|
||||||
|
### Integration Tests
|
||||||
|
|
||||||
|
- Process spawning
|
||||||
|
- SDK client operations
|
||||||
|
- SSE event handling
|
||||||
|
|
||||||
|
### E2E Tests
|
||||||
|
|
||||||
|
- Complete user flows
|
||||||
|
- Multi-instance scenarios
|
||||||
|
- Error recovery
|
||||||
|
|
||||||
|
## Build & Packaging
|
||||||
|
|
||||||
|
### Development
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run dev # Start Electron + Vite dev server
|
||||||
|
npm run dev:main # Main process only
|
||||||
|
npm run dev:renderer # Renderer only
|
||||||
|
```
|
||||||
|
|
||||||
|
### Production
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run build # Build all
|
||||||
|
npm run build:main # Build main process
|
||||||
|
npm run build:renderer # Build renderer
|
||||||
|
npm run package # Create distributable
|
||||||
|
```
|
||||||
|
|
||||||
|
### Distribution
|
||||||
|
|
||||||
|
- macOS: DMG + auto-update
|
||||||
|
- Windows: NSIS installer + auto-update
|
||||||
|
- Linux: AppImage + deb/rpm
|
||||||
|
|
||||||
|
## Configuration Files
|
||||||
|
|
||||||
|
### electron.vite.config.ts
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
import { defineConfig } from "electron-vite"
|
||||||
|
import solid from "vite-plugin-solid"
|
||||||
|
|
||||||
|
export default defineConfig({
|
||||||
|
main: {
|
||||||
|
build: {
|
||||||
|
rollupOptions: {
|
||||||
|
external: ["electron"],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
preload: {
|
||||||
|
build: {
|
||||||
|
rollupOptions: {
|
||||||
|
external: ["electron"],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
renderer: {
|
||||||
|
plugins: [solid()],
|
||||||
|
resolve: {
|
||||||
|
alias: {
|
||||||
|
"@": "/src",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
})
|
||||||
|
```
|
||||||
|
|
||||||
|
### tsconfig.json
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"target": "ES2020",
|
||||||
|
"module": "ESNext",
|
||||||
|
"lib": ["ES2020", "DOM"],
|
||||||
|
"jsx": "preserve",
|
||||||
|
"jsxImportSource": "solid-js",
|
||||||
|
"moduleResolution": "bundler",
|
||||||
|
"strict": true,
|
||||||
|
"esModuleInterop": true,
|
||||||
|
"skipLibCheck": true,
|
||||||
|
"paths": {
|
||||||
|
"@/*": ["./src/*"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
493
dev-docs/user-interface.md
Normal file
493
dev-docs/user-interface.md
Normal file
@@ -0,0 +1,493 @@
|
|||||||
|
# User Interface Specification
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The CodeNomad interface consists of a two-level tabbed layout with instance tabs at the top and session tabs below. Each session displays a message stream and prompt input.
|
||||||
|
|
||||||
|
## Layout Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────────────────────────────────────────────────┐
|
||||||
|
│ File Edit View Window Help ● ○ ◐ │ ← Native menu bar
|
||||||
|
├──────────────────────────────────────────────────────────────┤
|
||||||
|
│ [~/project-a] [~/project-a (2)] [~/api-service] [+] │ ← Instance tabs (Level 1)
|
||||||
|
├──────────────────────────────────────────────────────────────┤
|
||||||
|
│ [Main] [Fix login] [Write tests] [Logs] [+] │ ← Session tabs (Level 2)
|
||||||
|
├──────────────────────────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ ┌────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ Messages Area │ │
|
||||||
|
│ │ │ │
|
||||||
|
│ │ User: How do I set up testing? │ │
|
||||||
|
│ │ │ │
|
||||||
|
│ │ Assistant: To set up testing, you'll need to... │ │
|
||||||
|
│ │ → bash: npm install vitest ✓ │ │
|
||||||
|
│ │ Output: added 50 packages │ │
|
||||||
|
│ │ │ │
|
||||||
|
│ └────────────────────────────────────────────────────────┘ │
|
||||||
|
│ │
|
||||||
|
├──────────────────────────────────────────────────────────────┤
|
||||||
|
│ Agent: Build ▼ Model: Claude 3.5 Sonnet ▼ │ ← Controls
|
||||||
|
├──────────────────────────────────────────────────────────────┤
|
||||||
|
│ [@file.ts] [@api.ts] [×] │ ← Attachments
|
||||||
|
│ ┌────────────────────────────────────────────────────────┐ │
|
||||||
|
│ │ Type your message or /command... │ │ ← Prompt input
|
||||||
|
│ │ │ │
|
||||||
|
│ └────────────────────────────────────────────────────────┘ │
|
||||||
|
│ [▶] │ ← Send button
|
||||||
|
└──────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## Components Specification
|
||||||
|
|
||||||
|
### 1. Instance Tabs (Level 1)
|
||||||
|
|
||||||
|
**Visual Design:**
|
||||||
|
|
||||||
|
- Horizontal tabs at top of window
|
||||||
|
- Each tab shows folder name
|
||||||
|
- Icon: Folder icon (🗂️)
|
||||||
|
- Close button (×) on hover
|
||||||
|
- Active tab: Highlighted with accent color
|
||||||
|
- Inactive tabs: Muted background
|
||||||
|
|
||||||
|
**Tab Label Format:**
|
||||||
|
|
||||||
|
- Single instance: `~/project-name`
|
||||||
|
- Multiple instances of same folder: `~/project-name (2)`, `~/project-name (3)`
|
||||||
|
- Max width: 200px with ellipsis for long paths
|
||||||
|
- Tooltip shows full path on hover
|
||||||
|
|
||||||
|
**Actions:**
|
||||||
|
|
||||||
|
- Click: Switch to that instance
|
||||||
|
- Close (×): Stop server and close instance (with confirmation)
|
||||||
|
- Drag: Reorder tabs (future)
|
||||||
|
|
||||||
|
**New Instance Button (+):**
|
||||||
|
|
||||||
|
- Always visible at right end
|
||||||
|
- Click: Opens folder picker dialog
|
||||||
|
- Keyboard: Cmd/Ctrl+N
|
||||||
|
|
||||||
|
**States:**
|
||||||
|
|
||||||
|
- Starting: Loading spinner + "Starting..."
|
||||||
|
- Ready: Normal appearance
|
||||||
|
- Error: Red indicator + error icon
|
||||||
|
- Stopped: Grayed out (should not be visible, tab closes)
|
||||||
|
|
||||||
|
### 2. Session Tabs (Level 2)
|
||||||
|
|
||||||
|
**Visual Design:**
|
||||||
|
|
||||||
|
- Horizontal tabs below instance tabs
|
||||||
|
- Smaller than instance tabs
|
||||||
|
- Each tab shows session title or "Untitled"
|
||||||
|
- Active tab: Underline or bold
|
||||||
|
- Parent-child relationship: No visual distinction (all siblings)
|
||||||
|
|
||||||
|
**Tab Types:**
|
||||||
|
|
||||||
|
**Session Tab:**
|
||||||
|
|
||||||
|
- Label: Session title (editable on double-click)
|
||||||
|
- Icon: Chat bubble (💬) or none
|
||||||
|
- Close button (×) on hover
|
||||||
|
- Max width: 150px with ellipsis
|
||||||
|
|
||||||
|
**Logs Tab:**
|
||||||
|
|
||||||
|
- Label: "Logs"
|
||||||
|
- Icon: Terminal (⚡)
|
||||||
|
- Always present per instance
|
||||||
|
- Non-closable
|
||||||
|
- Shows server stdout/stderr
|
||||||
|
|
||||||
|
**Actions:**
|
||||||
|
|
||||||
|
- Click: Switch to that session
|
||||||
|
- Double-click label: Rename session
|
||||||
|
- Close (×): Delete session (with confirmation if has messages)
|
||||||
|
- Right-click: Context menu (Share, Export, Delete)
|
||||||
|
|
||||||
|
**New Session Button (+):**
|
||||||
|
|
||||||
|
- Click: Creates new session with default agent
|
||||||
|
- Keyboard: Cmd/Ctrl+T
|
||||||
|
|
||||||
|
### 3. Messages Area
|
||||||
|
|
||||||
|
**Container:**
|
||||||
|
|
||||||
|
- Scrollable viewport
|
||||||
|
- Auto-scroll to bottom when new messages arrive
|
||||||
|
- Manual scroll up: Disable auto-scroll
|
||||||
|
- "Scroll to bottom" button appears when scrolled up
|
||||||
|
|
||||||
|
**Message Layout:**
|
||||||
|
|
||||||
|
**User Message:**
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────────────────────────────┐
|
||||||
|
│ You 10:32 AM │
|
||||||
|
│ How do I set up testing? │
|
||||||
|
│ │
|
||||||
|
│ [@src/app.ts] [@package.json] │ ← Attachments if any
|
||||||
|
└──────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**Assistant Message:**
|
||||||
|
|
||||||
|
````
|
||||||
|
┌──────────────────────────────────────────┐
|
||||||
|
│ Assistant • Build 10:32 AM │
|
||||||
|
│ To set up testing, you'll need to │
|
||||||
|
│ install Vitest and configure it. │
|
||||||
|
│ │
|
||||||
|
│ ▶ bash: npm install vitest ✓ │ ← Tool call (collapsed)
|
||||||
|
│ │
|
||||||
|
│ ▶ edit src/vitest.config.ts ✓ │
|
||||||
|
│ │
|
||||||
|
│ Here's the configuration I added: │
|
||||||
|
│ ```typescript │
|
||||||
|
│ export default { │
|
||||||
|
│ test: { globals: true } │
|
||||||
|
│ } │
|
||||||
|
│ ``` │
|
||||||
|
└──────────────────────────────────────────┘
|
||||||
|
````
|
||||||
|
|
||||||
|
**Tool Call (Collapsed):**
|
||||||
|
|
||||||
|
```
|
||||||
|
▶ bash: npm install vitest ✓
|
||||||
|
^ ^ ^
|
||||||
|
| | |
|
||||||
|
Icon Tool name + summary Status
|
||||||
|
```
|
||||||
|
|
||||||
|
**Tool Call (Expanded):**
|
||||||
|
|
||||||
|
```
|
||||||
|
▼ bash: npm install vitest ✓
|
||||||
|
|
||||||
|
Input:
|
||||||
|
{
|
||||||
|
"command": "npm install vitest"
|
||||||
|
}
|
||||||
|
|
||||||
|
Output:
|
||||||
|
added 50 packages, and audited 51 packages in 2s
|
||||||
|
found 0 vulnerabilities
|
||||||
|
```
|
||||||
|
|
||||||
|
**Status Icons:**
|
||||||
|
|
||||||
|
- ⏳ Pending (spinner)
|
||||||
|
- ✓ Success (green checkmark)
|
||||||
|
- ✗ Error (red X)
|
||||||
|
- ⚠ Warning (yellow triangle)
|
||||||
|
|
||||||
|
**File Change Display:**
|
||||||
|
|
||||||
|
```
|
||||||
|
▶ edit src/vitest.config.ts ✓
|
||||||
|
Modified: src/vitest.config.ts
|
||||||
|
+12 lines, -3 lines
|
||||||
|
```
|
||||||
|
|
||||||
|
Click to expand: Show diff inline
|
||||||
|
|
||||||
|
### 4. Controls Bar
|
||||||
|
|
||||||
|
**Agent Selector:**
|
||||||
|
|
||||||
|
- Dropdown button showing current agent
|
||||||
|
- Click: Opens dropdown with agent list
|
||||||
|
- Shows: Agent name + description
|
||||||
|
- Grouped by category (if applicable)
|
||||||
|
|
||||||
|
**Model Selector:**
|
||||||
|
|
||||||
|
- Dropdown button showing current model
|
||||||
|
- Click: Opens dropdown with model list
|
||||||
|
- Shows: Provider icon + Model name
|
||||||
|
- Grouped by provider
|
||||||
|
- Displays: Context window, capabilities icons
|
||||||
|
|
||||||
|
**Layout:**
|
||||||
|
|
||||||
|
```
|
||||||
|
┌────────────────────────────────────────────┐
|
||||||
|
│ Agent: Build ▼ Model: Claude 3.5 ▼ │
|
||||||
|
└────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Prompt Input
|
||||||
|
|
||||||
|
**Input Field:**
|
||||||
|
|
||||||
|
- Multi-line textarea
|
||||||
|
- Auto-expanding (max 10 lines)
|
||||||
|
- Placeholder: "Type your message or /command..."
|
||||||
|
- Supports keyboard shortcuts
|
||||||
|
|
||||||
|
**Features:**
|
||||||
|
|
||||||
|
**Slash Commands:**
|
||||||
|
|
||||||
|
- Type `/` → Autocomplete dropdown appears
|
||||||
|
- Shows: Command name + description
|
||||||
|
- Filter as you type
|
||||||
|
- Enter to execute
|
||||||
|
|
||||||
|
**File Mentions:**
|
||||||
|
|
||||||
|
- Type `@` → File picker appears
|
||||||
|
- Search files by name
|
||||||
|
- Shows: File icon + path
|
||||||
|
- Enter to attach
|
||||||
|
|
||||||
|
**Attachments:**
|
||||||
|
|
||||||
|
- Display as chips above input
|
||||||
|
- Format: [@filename] [×]
|
||||||
|
- Click × to remove
|
||||||
|
- Drag & drop files onto input area
|
||||||
|
|
||||||
|
**Send Button:**
|
||||||
|
|
||||||
|
- Icon: Arrow (▶) or paper plane
|
||||||
|
- Click: Submit message
|
||||||
|
- Keyboard: Enter (without Shift)
|
||||||
|
- Disabled when: Empty input or server busy
|
||||||
|
|
||||||
|
**Keyboard Shortcuts:**
|
||||||
|
|
||||||
|
- Enter: New line
|
||||||
|
- Cmd+Enter (macOS) / Ctrl+Enter (Windows/Linux): Send message
|
||||||
|
- Cmd/Ctrl+K: Clear input
|
||||||
|
- Cmd/Ctrl+V: Paste (handles files)
|
||||||
|
- Cmd/Ctrl+L: Focus input
|
||||||
|
- Up/Down: Navigate message history (when input empty)
|
||||||
|
|
||||||
|
## Overlays & Modals
|
||||||
|
|
||||||
|
### Session Picker (Startup)
|
||||||
|
|
||||||
|
Appears when instance starts:
|
||||||
|
|
||||||
|
```
|
||||||
|
┌────────────────────────────────────────┐
|
||||||
|
│ OpenCode • ~/project-a │
|
||||||
|
├────────────────────────────────────────┤
|
||||||
|
│ Resume a session: │
|
||||||
|
│ │
|
||||||
|
│ > Fix login bug 2h ago │
|
||||||
|
│ Add dark mode 5h ago │
|
||||||
|
│ Refactor API Yesterday │
|
||||||
|
│ │
|
||||||
|
│ ────────────── or ────────────── │
|
||||||
|
│ │
|
||||||
|
│ Start new session: │
|
||||||
|
│ Agent: [Build ▼] [Start] │
|
||||||
|
│ │
|
||||||
|
│ [Cancel] │
|
||||||
|
└────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**Actions:**
|
||||||
|
|
||||||
|
- Click session: Resume that session
|
||||||
|
- Click "Start": Create new session with selected agent
|
||||||
|
- Click "Cancel": Close instance
|
||||||
|
- Keyboard: Arrow keys to navigate, Enter to select
|
||||||
|
|
||||||
|
### Confirmation Dialogs
|
||||||
|
|
||||||
|
**Close Instance:**
|
||||||
|
|
||||||
|
```
|
||||||
|
┌────────────────────────────────────────┐
|
||||||
|
│ Stop OpenCode instance? │
|
||||||
|
├────────────────────────────────────────┤
|
||||||
|
│ This will stop the server for: │
|
||||||
|
│ ~/project-a │
|
||||||
|
│ │
|
||||||
|
│ Active sessions will be lost. │
|
||||||
|
│ │
|
||||||
|
│ [Cancel] [Stop Instance] │
|
||||||
|
└────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
**Delete Session:**
|
||||||
|
|
||||||
|
```
|
||||||
|
┌────────────────────────────────────────┐
|
||||||
|
│ Delete session? │
|
||||||
|
├────────────────────────────────────────┤
|
||||||
|
│ This will permanently delete: │
|
||||||
|
│ "Fix login bug" │
|
||||||
|
│ │
|
||||||
|
│ This cannot be undone. │
|
||||||
|
│ │
|
||||||
|
│ [Cancel] [Delete] │
|
||||||
|
└────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## Empty States
|
||||||
|
|
||||||
|
### No Instances
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────────────────────────────┐
|
||||||
|
│ │
|
||||||
|
│ [Folder Icon] │
|
||||||
|
│ │
|
||||||
|
│ Start Coding with AI │
|
||||||
|
│ │
|
||||||
|
│ Select a folder to start coding with AI │
|
||||||
|
│ │
|
||||||
|
│ [Select Folder] │
|
||||||
|
│ │
|
||||||
|
│ Keyboard shortcut: Cmd/Ctrl+N │
|
||||||
|
│ │
|
||||||
|
└──────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### No Messages (New Session)
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────────────────────────────┐
|
||||||
|
│ │
|
||||||
|
│ Start a conversation │
|
||||||
|
│ │
|
||||||
|
│ Type a message below or try: │
|
||||||
|
│ • /init-project │
|
||||||
|
│ • Ask about your codebase │
|
||||||
|
│ • Attach files with @ │
|
||||||
|
│ │
|
||||||
|
└──────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### Logs Tab (No Logs Yet)
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────────────────────────────┐
|
||||||
|
│ Waiting for server output... │
|
||||||
|
└──────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
## Visual Styling
|
||||||
|
|
||||||
|
### Color Scheme
|
||||||
|
|
||||||
|
**Light Mode:**
|
||||||
|
|
||||||
|
- Background: #FFFFFF
|
||||||
|
- Secondary background: #F5F5F5
|
||||||
|
- Border: #E0E0E0
|
||||||
|
- Text: #1A1A1A
|
||||||
|
- Muted text: #666666
|
||||||
|
- Accent: #0066FF
|
||||||
|
|
||||||
|
**Dark Mode:**
|
||||||
|
|
||||||
|
- Background: #1A1A1A
|
||||||
|
- Secondary background: #2A2A2A
|
||||||
|
- Border: #3A3A3A
|
||||||
|
- Text: #E0E0E0
|
||||||
|
- Muted text: #999999
|
||||||
|
- Accent: #0080FF
|
||||||
|
|
||||||
|
### Typography
|
||||||
|
|
||||||
|
- **Main text**: 14px, system font
|
||||||
|
- **Headers**: 16px, medium weight
|
||||||
|
- **Labels**: 12px, regular weight
|
||||||
|
- **Code**: Monospace font (Consolas, Monaco, Courier)
|
||||||
|
- **Line height**: 1.5
|
||||||
|
|
||||||
|
### Spacing
|
||||||
|
|
||||||
|
- **Padding**: 8px, 12px, 16px, 24px (consistent scale)
|
||||||
|
- **Margins**: Same as padding
|
||||||
|
- **Tab height**: 40px
|
||||||
|
- **Input height**: 80px (auto-expanding)
|
||||||
|
- **Message spacing**: 16px between messages
|
||||||
|
|
||||||
|
### Icons
|
||||||
|
|
||||||
|
- Use consistent icon set (Lucide, Heroicons, or similar)
|
||||||
|
- Size: 16px for inline, 20px for buttons
|
||||||
|
- Stroke width: 2px
|
||||||
|
|
||||||
|
## Responsive Behavior
|
||||||
|
|
||||||
|
### Minimum Window Size
|
||||||
|
|
||||||
|
- Width: 800px
|
||||||
|
- Height: 600px
|
||||||
|
|
||||||
|
### Behavior When Small
|
||||||
|
|
||||||
|
- Instance tabs: Scroll horizontally
|
||||||
|
- Session tabs: Scroll horizontally
|
||||||
|
- Messages: Always visible, scroll vertically
|
||||||
|
- Input: Fixed at bottom
|
||||||
|
|
||||||
|
## Accessibility
|
||||||
|
|
||||||
|
- All interactive elements keyboard-navigable
|
||||||
|
- ARIA labels for screen readers
|
||||||
|
- Focus indicators visible
|
||||||
|
- Color contrast WCAG AA compliant
|
||||||
|
- Tab trap in modals
|
||||||
|
- Escape key closes overlays
|
||||||
|
|
||||||
|
## Animation & Transitions
|
||||||
|
|
||||||
|
- Tab switching: Instant (no animation)
|
||||||
|
- Message appearance: Fade in (100ms)
|
||||||
|
- Tool expand/collapse: Slide (200ms)
|
||||||
|
- Dropdown menus: Fade + slide (150ms)
|
||||||
|
- Loading states: Spinner or skeleton
|
||||||
|
|
||||||
|
## Context Menus
|
||||||
|
|
||||||
|
### Session Tab Right-Click
|
||||||
|
|
||||||
|
- Rename
|
||||||
|
- Duplicate
|
||||||
|
- Share
|
||||||
|
- Export
|
||||||
|
- Delete
|
||||||
|
- Close Other Tabs
|
||||||
|
|
||||||
|
### Message Right-Click
|
||||||
|
|
||||||
|
- Copy message
|
||||||
|
- Copy code block
|
||||||
|
- Edit & regenerate
|
||||||
|
- Delete message
|
||||||
|
- Quote in reply
|
||||||
|
|
||||||
|
## Status Indicators
|
||||||
|
|
||||||
|
### Instance Tab
|
||||||
|
|
||||||
|
- Green dot: Server running
|
||||||
|
- Yellow dot: Server starting
|
||||||
|
- Red dot: Server error
|
||||||
|
- No dot: Server stopped
|
||||||
|
|
||||||
|
### Session Tab
|
||||||
|
|
||||||
|
- Blue pulse: Assistant responding
|
||||||
|
- No indicator: Idle
|
||||||
|
|
||||||
|
### Connection Status
|
||||||
|
|
||||||
|
- Bottom right corner: "Connected" or "Reconnecting..."
|
||||||
BIN
docs/screenshots/browser-support.png
Normal file
BIN
docs/screenshots/browser-support.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 845 KiB |
BIN
docs/screenshots/command-palette.png
Normal file
BIN
docs/screenshots/command-palette.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 835 KiB |
BIN
docs/screenshots/image-previews.png
Normal file
BIN
docs/screenshots/image-previews.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.4 MiB |
BIN
docs/screenshots/newSession.png
Normal file
BIN
docs/screenshots/newSession.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 966 KiB |
BIN
images/CodeNomad-Icon-original.png
Normal file
BIN
images/CodeNomad-Icon-original.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.3 MiB |
BIN
images/CodeNomad-Icon.png
Normal file
BIN
images/CodeNomad-Icon.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.3 MiB |
76
manual_test_guide.md
Normal file
76
manual_test_guide.md
Normal file
@@ -0,0 +1,76 @@
|
|||||||
|
# MultiX v2 - Verification & User Guide
|
||||||
|
|
||||||
|
**Date:** 2025-12-25
|
||||||
|
**Version:** 2.0.0 (Gold Master)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Feature Verification Guide
|
||||||
|
|
||||||
|
### A. Core Multi-Tasking & Parallel Execution
|
||||||
|
* **Goal:** Verify you can run multiple agents at once without freezing.
|
||||||
|
* **Steps:**
|
||||||
|
1. Create **Task 1**. Type "Write a long story about space" and hit Launch.
|
||||||
|
2. *While Task 1 is streaming*, click the **+** button to create **Task 2**.
|
||||||
|
3. Type "Write a python script for fibonacci" in Task 2 and hit Launch.
|
||||||
|
4. **Result:** Both tasks should stream simultaneously. Switching tabs should be instant.
|
||||||
|
|
||||||
|
### B. Per-Task Isolation (Agents & Models)
|
||||||
|
* **Goal:** Verify each task retains its own settings.
|
||||||
|
* **Steps:**
|
||||||
|
1. Go to **Task 1**. Select Agent: **"Software Engineer"** and Model: **"minimax-m2"**.
|
||||||
|
2. Go to **Task 2**. Select Agent: **"Writer"** and Model: **"deepseek-chat"**.
|
||||||
|
3. Switch back and forth.
|
||||||
|
4. **Result:** The selectors should update to reflect the saved state for each task.
|
||||||
|
|
||||||
|
### C. AI Agent Generator (NEW)
|
||||||
|
* **Goal:** Create a custom agent using AI.
|
||||||
|
* **Steps:**
|
||||||
|
1. Open the **Agent Selector** dropdown.
|
||||||
|
2. Click **"✨ AI Agent Generator"**.
|
||||||
|
3. Type: *"A rust expert who is sarcastic and funny"*.
|
||||||
|
4. Click **"Generate Agent"**.
|
||||||
|
5. Review the generated name, description, and system prompt.
|
||||||
|
6. Click **"Save & Use Agent"**.
|
||||||
|
7. **Result:** The new agent is saved and immediately selected.
|
||||||
|
|
||||||
|
### D. Prompt Enhancer
|
||||||
|
* **Goal:** strict Opus 4.5 prompt optimization.
|
||||||
|
* **Steps:**
|
||||||
|
1. Type a simple prompt: *"fix bug"*.
|
||||||
|
2. Click the **Magic Wand (✨)** button in the input area.
|
||||||
|
3. **Result:** The prompt is expanded into a professional, structured request using the active model.
|
||||||
|
|
||||||
|
### E. Compaction System
|
||||||
|
* **Goal:** Manage context window usage.
|
||||||
|
* **Steps:**
|
||||||
|
1. In a long chat, look for the **"Compact suggested"** banner at the top of the chat list.
|
||||||
|
2. Click **"Compact"** in the banner or the header bar.
|
||||||
|
3. **Result:** The session history is summarized, freeing up tokens while keeping context.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Menu & Wiring Check
|
||||||
|
|
||||||
|
| Button | Wired Action | Status |
|
||||||
|
|--------|--------------|--------|
|
||||||
|
| **MULTIX Badge** | Visual Indicator | ✅ Active |
|
||||||
|
| **SKILLS** | Opens Sidebar (Events) | ✅ Wired |
|
||||||
|
| **Active Task** | Shows current task name | ✅ Wired |
|
||||||
|
| **Pipeline Tab** | Switches to Dashboard | ✅ Wired |
|
||||||
|
| **Task Tabs** | Switch/Close Tasks | ✅ Wired |
|
||||||
|
| **Compact Btn** | Triggers Compaction | ✅ Wired |
|
||||||
|
| **API Key Btn** | Opens Settings Modal | ✅ Wired |
|
||||||
|
| **Agent Select** | Updates Task Session | ✅ Wired |
|
||||||
|
| **Model Select** | Updates Task Session | ✅ Wired |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Technical Status
|
||||||
|
|
||||||
|
* **Build:** Passing (No TypeScript errors).
|
||||||
|
* **Dev Server:** Running on port 3001.
|
||||||
|
* **Architecture:** Polling-based (150ms sync) to prevent UI thread blocking.
|
||||||
|
* **State:** Local signals + Non-reactive store references.
|
||||||
|
|
||||||
|
**Ready for deployment.**
|
||||||
10684
package-lock.json
generated
Normal file
10684
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
33
package.json
Normal file
33
package.json
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
{
|
||||||
|
"name": "codenomad-workspace",
|
||||||
|
"version": "0.5.0",
|
||||||
|
"private": true,
|
||||||
|
"description": "CodeNomad monorepo workspace",
|
||||||
|
"workspaces": {
|
||||||
|
"packages": [
|
||||||
|
"packages/*"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"dev": "npm run dev:electron --workspace @neuralnomads/codenomad-electron-app",
|
||||||
|
"dev:electron": "npm run dev:electron --workspace @neuralnomads/codenomad-electron-app",
|
||||||
|
"dev:tauri": "npm run dev --workspace @codenomad/tauri-app",
|
||||||
|
"build": "npm run build --workspace @neuralnomads/codenomad-electron-app",
|
||||||
|
"build:tauri": "npm run build --workspace @codenomad/tauri-app",
|
||||||
|
"build:ui": "npm run build --workspace @codenomad/ui",
|
||||||
|
"build:mac-x64": "npm run build:mac-x64 --workspace @neuralnomads/codenomad-electron-app",
|
||||||
|
"build:binaries": "npm run build:binaries --workspace @neuralnomads/codenomad-electron-app",
|
||||||
|
"typecheck": "npm run typecheck --workspace @codenomad/ui && npm run typecheck --workspace @neuralnomads/codenomad-electron-app",
|
||||||
|
"bumpVersion": "npm version --workspaces --include-workspace-root --no-git-tag-version"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"7zip-bin": "^5.2.0",
|
||||||
|
"google-auth-library": "^10.5.0"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"rollup": "^4.54.0"
|
||||||
|
},
|
||||||
|
"optionalDependencies": {
|
||||||
|
"@esbuild/win32-x64": "^0.27.2"
|
||||||
|
}
|
||||||
|
}
|
||||||
4
packages/electron-app/.gitignore
vendored
Normal file
4
packages/electron-app/.gitignore
vendored
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
node_modules/
|
||||||
|
dist/
|
||||||
|
release/
|
||||||
|
.vite/
|
||||||
40
packages/electron-app/README.md
Normal file
40
packages/electron-app/README.md
Normal file
@@ -0,0 +1,40 @@
|
|||||||
|
# CodeNomad App
|
||||||
|
|
||||||
|
This package contains the native desktop application shell for CodeNomad, built with [Electron](https://www.electronjs.org/).
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
The Electron app wraps the CodeNomad UI and Server into a standalone executable. It provides deeper system integration, such as:
|
||||||
|
- Native window management
|
||||||
|
- Global keyboard shortcuts
|
||||||
|
- Application menu integration
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
To run the Electron app in development mode:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
|
||||||
|
This will start the renderer (UI) and the main process with hot reloading.
|
||||||
|
|
||||||
|
## Building
|
||||||
|
|
||||||
|
To build the application for your current platform:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
To build for specific platforms (requires appropriate build tools):
|
||||||
|
|
||||||
|
- **macOS**: `npm run build:mac`
|
||||||
|
- **Windows**: `npm run build:win`
|
||||||
|
- **Linux**: `npm run build:linux`
|
||||||
|
|
||||||
|
## Structure
|
||||||
|
|
||||||
|
- `electron/main`: Main process code (window creation, IPC).
|
||||||
|
- `electron/preload`: Preload scripts for secure bridge between main and renderer.
|
||||||
|
- `electron/resources`: Static assets like icons.
|
||||||
72
packages/electron-app/electron.vite.config.ts
Normal file
72
packages/electron-app/electron.vite.config.ts
Normal file
@@ -0,0 +1,72 @@
|
|||||||
|
import { defineConfig, externalizeDepsPlugin } from "electron-vite"
|
||||||
|
import solid from "vite-plugin-solid"
|
||||||
|
import { resolve } from "path"
|
||||||
|
|
||||||
|
const uiRoot = resolve(__dirname, "../ui")
|
||||||
|
const uiSrc = resolve(uiRoot, "src")
|
||||||
|
const uiRendererRoot = resolve(uiRoot, "src/renderer")
|
||||||
|
const uiRendererEntry = resolve(uiRendererRoot, "index.html")
|
||||||
|
const uiRendererLoadingEntry = resolve(uiRendererRoot, "loading.html")
|
||||||
|
|
||||||
|
export default defineConfig({
|
||||||
|
main: {
|
||||||
|
plugins: [externalizeDepsPlugin()],
|
||||||
|
build: {
|
||||||
|
outDir: "dist/main",
|
||||||
|
lib: {
|
||||||
|
entry: resolve(__dirname, "electron/main/main.ts"),
|
||||||
|
},
|
||||||
|
rollupOptions: {
|
||||||
|
external: ["electron"],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
preload: {
|
||||||
|
plugins: [externalizeDepsPlugin()],
|
||||||
|
build: {
|
||||||
|
outDir: "dist/preload",
|
||||||
|
lib: {
|
||||||
|
entry: resolve(__dirname, "electron/preload/index.cjs"),
|
||||||
|
formats: ["cjs"],
|
||||||
|
fileName: () => "index.js",
|
||||||
|
},
|
||||||
|
rollupOptions: {
|
||||||
|
external: ["electron"],
|
||||||
|
output: {
|
||||||
|
entryFileNames: "index.js",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
renderer: {
|
||||||
|
root: uiRendererRoot,
|
||||||
|
plugins: [solid()],
|
||||||
|
css: {
|
||||||
|
postcss: resolve(uiRoot, "postcss.config.js"),
|
||||||
|
},
|
||||||
|
resolve: {
|
||||||
|
alias: {
|
||||||
|
"@": uiSrc,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
server: {
|
||||||
|
port: 3000,
|
||||||
|
},
|
||||||
|
build: {
|
||||||
|
minify: false,
|
||||||
|
cssMinify: false,
|
||||||
|
sourcemap: true,
|
||||||
|
outDir: resolve(__dirname, "dist/renderer"),
|
||||||
|
rollupOptions: {
|
||||||
|
input: {
|
||||||
|
main: uiRendererEntry,
|
||||||
|
loading: uiRendererLoadingEntry,
|
||||||
|
},
|
||||||
|
output: {
|
||||||
|
compact: false,
|
||||||
|
minifyInternalExports: false,
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
})
|
||||||
112
packages/electron-app/electron/main/ipc.ts
Normal file
112
packages/electron-app/electron/main/ipc.ts
Normal file
@@ -0,0 +1,112 @@
|
|||||||
|
import { BrowserWindow, dialog, ipcMain, type OpenDialogOptions } from "electron"
|
||||||
|
import path from "path"
|
||||||
|
import type { CliProcessManager, CliStatus } from "./process-manager"
|
||||||
|
import {
|
||||||
|
listUsers,
|
||||||
|
createUser,
|
||||||
|
updateUser,
|
||||||
|
deleteUser,
|
||||||
|
verifyPassword,
|
||||||
|
setActiveUser,
|
||||||
|
createGuestUser,
|
||||||
|
getActiveUser,
|
||||||
|
getUserDataRoot,
|
||||||
|
} from "./user-store"
|
||||||
|
|
||||||
|
interface DialogOpenRequest {
|
||||||
|
mode: "directory" | "file"
|
||||||
|
title?: string
|
||||||
|
defaultPath?: string
|
||||||
|
filters?: Array<{ name?: string; extensions: string[] }>
|
||||||
|
}
|
||||||
|
|
||||||
|
interface DialogOpenResult {
|
||||||
|
canceled: boolean
|
||||||
|
paths: string[]
|
||||||
|
}
|
||||||
|
|
||||||
|
export function setupCliIPC(mainWindow: BrowserWindow, cliManager: CliProcessManager) {
|
||||||
|
cliManager.on("status", (status: CliStatus) => {
|
||||||
|
if (!mainWindow.isDestroyed()) {
|
||||||
|
mainWindow.webContents.send("cli:status", status)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
cliManager.on("ready", (status: CliStatus) => {
|
||||||
|
if (!mainWindow.isDestroyed()) {
|
||||||
|
mainWindow.webContents.send("cli:ready", status)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
cliManager.on("error", (error: Error) => {
|
||||||
|
if (!mainWindow.isDestroyed()) {
|
||||||
|
mainWindow.webContents.send("cli:error", { message: error.message })
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
ipcMain.handle("cli:getStatus", async () => cliManager.getStatus())
|
||||||
|
|
||||||
|
ipcMain.handle("cli:restart", async () => {
|
||||||
|
const devMode = process.env.NODE_ENV === "development"
|
||||||
|
await cliManager.stop()
|
||||||
|
return cliManager.start({ dev: devMode })
|
||||||
|
})
|
||||||
|
|
||||||
|
ipcMain.handle("users:list", async () => listUsers())
|
||||||
|
ipcMain.handle("users:active", async () => getActiveUser())
|
||||||
|
ipcMain.handle("users:create", async (_, payload: { name: string; password: string }) => {
|
||||||
|
const user = createUser(payload.name, payload.password)
|
||||||
|
return user
|
||||||
|
})
|
||||||
|
ipcMain.handle("users:update", async (_, payload: { id: string; name?: string; password?: string }) => {
|
||||||
|
const user = updateUser(payload.id, { name: payload.name, password: payload.password })
|
||||||
|
return user
|
||||||
|
})
|
||||||
|
ipcMain.handle("users:delete", async (_, payload: { id: string }) => {
|
||||||
|
deleteUser(payload.id)
|
||||||
|
return { success: true }
|
||||||
|
})
|
||||||
|
ipcMain.handle("users:createGuest", async () => {
|
||||||
|
const user = createGuestUser()
|
||||||
|
return user
|
||||||
|
})
|
||||||
|
ipcMain.handle("users:login", async (_, payload: { id: string; password?: string }) => {
|
||||||
|
const ok = verifyPassword(payload.id, payload.password ?? "")
|
||||||
|
if (!ok) {
|
||||||
|
return { success: false }
|
||||||
|
}
|
||||||
|
const user = setActiveUser(payload.id)
|
||||||
|
const root = getUserDataRoot(user.id)
|
||||||
|
cliManager.setUserEnv({
|
||||||
|
CODENOMAD_USER_DIR: root,
|
||||||
|
CLI_CONFIG: path.join(root, "config.json"),
|
||||||
|
})
|
||||||
|
await cliManager.stop()
|
||||||
|
const devMode = process.env.NODE_ENV === "development"
|
||||||
|
await cliManager.start({ dev: devMode })
|
||||||
|
return { success: true, user }
|
||||||
|
})
|
||||||
|
|
||||||
|
ipcMain.handle("dialog:open", async (_, request: DialogOpenRequest): Promise<DialogOpenResult> => {
|
||||||
|
const properties: OpenDialogOptions["properties"] =
|
||||||
|
request.mode === "directory" ? ["openDirectory", "createDirectory"] : ["openFile"]
|
||||||
|
|
||||||
|
const filters = request.filters?.map((filter) => ({
|
||||||
|
name: filter.name ?? "Files",
|
||||||
|
extensions: filter.extensions,
|
||||||
|
}))
|
||||||
|
|
||||||
|
const windowTarget = mainWindow.isDestroyed() ? undefined : mainWindow
|
||||||
|
const dialogOptions: OpenDialogOptions = {
|
||||||
|
title: request.title,
|
||||||
|
defaultPath: request.defaultPath,
|
||||||
|
properties,
|
||||||
|
filters,
|
||||||
|
}
|
||||||
|
const result = windowTarget
|
||||||
|
? await dialog.showOpenDialog(windowTarget, dialogOptions)
|
||||||
|
: await dialog.showOpenDialog(dialogOptions)
|
||||||
|
|
||||||
|
return { canceled: result.canceled, paths: result.filePaths }
|
||||||
|
})
|
||||||
|
}
|
||||||
522
packages/electron-app/electron/main/main.ts
Normal file
522
packages/electron-app/electron/main/main.ts
Normal file
@@ -0,0 +1,522 @@
|
|||||||
|
import { app, BrowserView, BrowserWindow, nativeImage, session, shell } from "electron"
|
||||||
|
import { existsSync } from "fs"
|
||||||
|
import { dirname, join } from "path"
|
||||||
|
import { fileURLToPath } from "url"
|
||||||
|
import { createApplicationMenu } from "./menu"
|
||||||
|
import { setupCliIPC } from "./ipc"
|
||||||
|
import { CliProcessManager } from "./process-manager"
|
||||||
|
import { ensureDefaultUsers, getActiveUser, getUserDataRoot, clearGuestUsers } from "./user-store"
|
||||||
|
|
||||||
|
const mainFilename = fileURLToPath(import.meta.url)
|
||||||
|
const mainDirname = dirname(mainFilename)
|
||||||
|
|
||||||
|
const isMac = process.platform === "darwin"
|
||||||
|
|
||||||
|
const cliManager = new CliProcessManager()
|
||||||
|
let mainWindow: BrowserWindow | null = null
|
||||||
|
let currentCliUrl: string | null = null
|
||||||
|
let pendingCliUrl: string | null = null
|
||||||
|
let showingLoadingScreen = false
|
||||||
|
let preloadingView: BrowserView | null = null
|
||||||
|
|
||||||
|
// Retry logic constants
|
||||||
|
const MAX_RETRY_ATTEMPTS = 5
|
||||||
|
const LOAD_TIMEOUT_MS = 30000
|
||||||
|
let retryAttempts = 0
|
||||||
|
|
||||||
|
if (isMac) {
|
||||||
|
app.commandLine.appendSwitch("disable-spell-checking")
|
||||||
|
}
|
||||||
|
|
||||||
|
// Windows: Use Edge WebView2 rendering for better performance
|
||||||
|
if (process.platform === "win32") {
|
||||||
|
app.commandLine.appendSwitch("enable-features", "WebViewTagWebComponent,WebView2")
|
||||||
|
app.commandLine.appendSwitch("disable-gpu-sandbox")
|
||||||
|
app.commandLine.appendSwitch("enable-gpu-rasterization")
|
||||||
|
app.commandLine.appendSwitch("enable-zero-copy")
|
||||||
|
app.commandLine.appendSwitch("disable-background-timer-throttling")
|
||||||
|
app.commandLine.appendSwitch("disable-renderer-backgrounding")
|
||||||
|
}
|
||||||
|
|
||||||
|
function getIconPath() {
|
||||||
|
if (app.isPackaged) {
|
||||||
|
return join(process.resourcesPath, "icon.png")
|
||||||
|
}
|
||||||
|
|
||||||
|
return join(mainDirname, "../resources/icon.png")
|
||||||
|
}
|
||||||
|
|
||||||
|
type LoadingTarget =
|
||||||
|
| { type: "url"; source: string }
|
||||||
|
| { type: "file"; source: string }
|
||||||
|
|
||||||
|
function resolveDevLoadingUrl(): string | null {
|
||||||
|
if (app.isPackaged) {
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
const devBase = process.env.VITE_DEV_SERVER_URL || process.env.ELECTRON_RENDERER_URL
|
||||||
|
if (!devBase) {
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const normalized = devBase.endsWith("/") ? devBase : `${devBase}/`
|
||||||
|
return new URL("loading.html", normalized).toString()
|
||||||
|
} catch (error) {
|
||||||
|
console.warn("[cli] failed to construct dev loading URL", devBase, error)
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function resolveLoadingTarget(): LoadingTarget {
|
||||||
|
const devUrl = resolveDevLoadingUrl()
|
||||||
|
if (devUrl) {
|
||||||
|
return { type: "url", source: devUrl }
|
||||||
|
}
|
||||||
|
const filePath = resolveLoadingFilePath()
|
||||||
|
return { type: "file", source: filePath }
|
||||||
|
}
|
||||||
|
|
||||||
|
function resolveLoadingFilePath() {
|
||||||
|
const candidates = [
|
||||||
|
join(app.getAppPath(), "dist/renderer/loading.html"),
|
||||||
|
join(process.resourcesPath, "dist/renderer/loading.html"),
|
||||||
|
join(mainDirname, "../dist/renderer/loading.html"),
|
||||||
|
]
|
||||||
|
|
||||||
|
for (const candidate of candidates) {
|
||||||
|
if (existsSync(candidate)) {
|
||||||
|
return candidate
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return join(app.getAppPath(), "dist/renderer/loading.html")
|
||||||
|
}
|
||||||
|
|
||||||
|
function loadLoadingScreen(window: BrowserWindow) {
|
||||||
|
const target = resolveLoadingTarget()
|
||||||
|
const loader =
|
||||||
|
target.type === "url"
|
||||||
|
? window.loadURL(target.source)
|
||||||
|
: window.loadFile(target.source)
|
||||||
|
|
||||||
|
loader.catch((error) => {
|
||||||
|
console.error("[cli] failed to load loading screen:", error)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// Calculate exponential backoff delay
|
||||||
|
function getRetryDelay(attempt: number): number {
|
||||||
|
return Math.min(1000 * Math.pow(2, attempt), 16000) // 1s, 2s, 4s, 8s, 16s max
|
||||||
|
}
|
||||||
|
|
||||||
|
// Show user-friendly error screen
|
||||||
|
function showErrorScreen(window: BrowserWindow, errorMessage: string) {
|
||||||
|
const errorHtml = `
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<style>
|
||||||
|
body {
|
||||||
|
margin: 0;
|
||||||
|
padding: 40px;
|
||||||
|
font-family: system-ui, -apple-system, sans-serif;
|
||||||
|
background: #1a1a1a;
|
||||||
|
color: #fff;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
min-height: 100vh;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
.error-icon { font-size: 48px; margin-bottom: 20px; }
|
||||||
|
h1 { margin: 0 0 16px; font-size: 24px; font-weight: 600; }
|
||||||
|
p { margin: 0 0 24px; color: #888; font-size: 14px; text-align: center; max-width: 400px; }
|
||||||
|
.error-code { font-family: monospace; background: #2a2a2a; padding: 8px 16px; border-radius: 6px; font-size: 12px; color: #f87171; margin-bottom: 24px; }
|
||||||
|
button {
|
||||||
|
background: #6366f1;
|
||||||
|
color: white;
|
||||||
|
border: none;
|
||||||
|
padding: 12px 32px;
|
||||||
|
border-radius: 8px;
|
||||||
|
font-size: 14px;
|
||||||
|
font-weight: 600;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: all 0.2s;
|
||||||
|
}
|
||||||
|
button:hover { background: #818cf8; transform: scale(1.02); }
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="error-icon">⚠️</div>
|
||||||
|
<h1>Connection Failed</h1>
|
||||||
|
<p>NomadArch couldn't connect to the development server after multiple attempts. Please ensure the server is running.</p>
|
||||||
|
<div class="error-code">${errorMessage}</div>
|
||||||
|
<button onclick="location.reload()">Retry</button>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
|
`
|
||||||
|
window.loadURL(`data:text/html;charset=utf-8,${encodeURIComponent(errorHtml)}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
function getAllowedRendererOrigins(): string[] {
|
||||||
|
const origins = new Set<string>()
|
||||||
|
const rendererCandidates = [currentCliUrl, process.env.VITE_DEV_SERVER_URL, process.env.ELECTRON_RENDERER_URL]
|
||||||
|
for (const candidate of rendererCandidates) {
|
||||||
|
if (!candidate) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
origins.add(new URL(candidate).origin)
|
||||||
|
} catch (error) {
|
||||||
|
console.warn("[cli] failed to parse origin for", candidate, error)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return Array.from(origins)
|
||||||
|
}
|
||||||
|
|
||||||
|
function shouldOpenExternally(url: string): boolean {
|
||||||
|
try {
|
||||||
|
const parsed = new URL(url)
|
||||||
|
if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
const allowedOrigins = getAllowedRendererOrigins()
|
||||||
|
return !allowedOrigins.includes(parsed.origin)
|
||||||
|
} catch {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function setupNavigationGuards(window: BrowserWindow) {
|
||||||
|
const handleExternal = (url: string) => {
|
||||||
|
shell.openExternal(url).catch((error) => console.error("[cli] failed to open external URL", url, error))
|
||||||
|
}
|
||||||
|
|
||||||
|
window.webContents.setWindowOpenHandler(({ url }) => {
|
||||||
|
if (shouldOpenExternally(url)) {
|
||||||
|
handleExternal(url)
|
||||||
|
return { action: "deny" }
|
||||||
|
}
|
||||||
|
return { action: "allow" }
|
||||||
|
})
|
||||||
|
|
||||||
|
window.webContents.on("will-navigate", (event, url) => {
|
||||||
|
if (shouldOpenExternally(url)) {
|
||||||
|
event.preventDefault()
|
||||||
|
handleExternal(url)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
let cachedPreloadPath: string | null = null
|
||||||
|
function getPreloadPath() {
|
||||||
|
if (cachedPreloadPath && existsSync(cachedPreloadPath)) {
|
||||||
|
return cachedPreloadPath
|
||||||
|
}
|
||||||
|
|
||||||
|
const candidates = [
|
||||||
|
join(process.resourcesPath, "preload/index.js"),
|
||||||
|
join(mainDirname, "../preload/index.js"),
|
||||||
|
join(mainDirname, "../preload/index.cjs"),
|
||||||
|
join(mainDirname, "../../preload/index.cjs"),
|
||||||
|
join(mainDirname, "../../electron/preload/index.cjs"),
|
||||||
|
join(app.getAppPath(), "preload/index.cjs"),
|
||||||
|
join(app.getAppPath(), "electron/preload/index.cjs"),
|
||||||
|
]
|
||||||
|
|
||||||
|
for (const candidate of candidates) {
|
||||||
|
if (existsSync(candidate)) {
|
||||||
|
cachedPreloadPath = candidate
|
||||||
|
return candidate
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return join(mainDirname, "../preload/index.js")
|
||||||
|
}
|
||||||
|
|
||||||
|
function applyUserEnvToCli() {
|
||||||
|
const active = getActiveUser()
|
||||||
|
if (!active) {
|
||||||
|
const fallback = ensureDefaultUsers()
|
||||||
|
const fallbackRoot = getUserDataRoot(fallback.id)
|
||||||
|
cliManager.setUserEnv({
|
||||||
|
CODENOMAD_USER_DIR: fallbackRoot,
|
||||||
|
CLI_CONFIG: join(fallbackRoot, "config.json"),
|
||||||
|
})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
const root = getUserDataRoot(active.id)
|
||||||
|
cliManager.setUserEnv({
|
||||||
|
CODENOMAD_USER_DIR: root,
|
||||||
|
CLI_CONFIG: join(root, "config.json"),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function destroyPreloadingView(target?: BrowserView | null) {
|
||||||
|
const view = target ?? preloadingView
|
||||||
|
if (!view) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const contents = view.webContents as any
|
||||||
|
contents?.destroy?.()
|
||||||
|
} catch (error) {
|
||||||
|
console.warn("[cli] failed to destroy preloading view", error)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!target || view === preloadingView) {
|
||||||
|
preloadingView = null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function createWindow() {
|
||||||
|
const prefersDark = true
|
||||||
|
const backgroundColor = prefersDark ? "#1a1a1a" : "#ffffff"
|
||||||
|
const iconPath = getIconPath()
|
||||||
|
|
||||||
|
mainWindow = new BrowserWindow({
|
||||||
|
width: 1400,
|
||||||
|
height: 900,
|
||||||
|
minWidth: 800,
|
||||||
|
minHeight: 600,
|
||||||
|
backgroundColor,
|
||||||
|
icon: iconPath,
|
||||||
|
title: "NomadArch 1.0",
|
||||||
|
webPreferences: {
|
||||||
|
preload: getPreloadPath(),
|
||||||
|
contextIsolation: true,
|
||||||
|
nodeIntegration: false,
|
||||||
|
spellcheck: !isMac,
|
||||||
|
},
|
||||||
|
})
|
||||||
|
|
||||||
|
setupNavigationGuards(mainWindow)
|
||||||
|
|
||||||
|
if (isMac) {
|
||||||
|
mainWindow.webContents.session.setSpellCheckerEnabled(false)
|
||||||
|
}
|
||||||
|
|
||||||
|
showingLoadingScreen = true
|
||||||
|
currentCliUrl = null
|
||||||
|
loadLoadingScreen(mainWindow)
|
||||||
|
|
||||||
|
if (process.env.NODE_ENV === "development" && process.env.NOMADARCH_OPEN_DEVTOOLS === "true") {
|
||||||
|
mainWindow.webContents.openDevTools({ mode: "detach" })
|
||||||
|
}
|
||||||
|
|
||||||
|
createApplicationMenu(mainWindow)
|
||||||
|
setupCliIPC(mainWindow, cliManager)
|
||||||
|
|
||||||
|
mainWindow.on("closed", () => {
|
||||||
|
destroyPreloadingView()
|
||||||
|
mainWindow = null
|
||||||
|
currentCliUrl = null
|
||||||
|
pendingCliUrl = null
|
||||||
|
showingLoadingScreen = false
|
||||||
|
})
|
||||||
|
|
||||||
|
if (pendingCliUrl) {
|
||||||
|
const url = pendingCliUrl
|
||||||
|
pendingCliUrl = null
|
||||||
|
startCliPreload(url)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function showLoadingScreen(force = false) {
|
||||||
|
if (!mainWindow || mainWindow.isDestroyed()) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if (showingLoadingScreen && !force) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
destroyPreloadingView()
|
||||||
|
showingLoadingScreen = true
|
||||||
|
currentCliUrl = null
|
||||||
|
pendingCliUrl = null
|
||||||
|
loadLoadingScreen(mainWindow)
|
||||||
|
}
|
||||||
|
|
||||||
|
function startCliPreload(url: string) {
|
||||||
|
if (!mainWindow || mainWindow.isDestroyed()) {
|
||||||
|
pendingCliUrl = url
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if (currentCliUrl === url && !showingLoadingScreen) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
pendingCliUrl = url
|
||||||
|
destroyPreloadingView()
|
||||||
|
|
||||||
|
if (!showingLoadingScreen) {
|
||||||
|
showLoadingScreen(true)
|
||||||
|
}
|
||||||
|
|
||||||
|
const view = new BrowserView({
|
||||||
|
webPreferences: {
|
||||||
|
contextIsolation: true,
|
||||||
|
nodeIntegration: false,
|
||||||
|
spellcheck: !isMac,
|
||||||
|
},
|
||||||
|
})
|
||||||
|
|
||||||
|
preloadingView = view
|
||||||
|
|
||||||
|
view.webContents.once("did-finish-load", () => {
|
||||||
|
if (preloadingView !== view) {
|
||||||
|
destroyPreloadingView(view)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
finalizeCliSwap(url)
|
||||||
|
})
|
||||||
|
|
||||||
|
view.webContents.loadURL(url).catch((error) => {
|
||||||
|
console.error("[cli] failed to preload CLI view:", error)
|
||||||
|
if (preloadingView === view) {
|
||||||
|
destroyPreloadingView(view)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function finalizeCliSwap(url: string) {
|
||||||
|
destroyPreloadingView()
|
||||||
|
|
||||||
|
if (!mainWindow || mainWindow.isDestroyed()) {
|
||||||
|
pendingCliUrl = url
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
showingLoadingScreen = false
|
||||||
|
currentCliUrl = url
|
||||||
|
pendingCliUrl = null
|
||||||
|
|
||||||
|
// Reset retry counter on new URL
|
||||||
|
retryAttempts = 0
|
||||||
|
|
||||||
|
const loadWithRetry = () => {
|
||||||
|
if (!mainWindow || mainWindow.isDestroyed()) return
|
||||||
|
|
||||||
|
// Set timeout for load
|
||||||
|
const timeoutId = setTimeout(() => {
|
||||||
|
console.warn(`[cli] Load timeout after ${LOAD_TIMEOUT_MS}ms`)
|
||||||
|
handleLoadError(new Error(`Load timeout after ${LOAD_TIMEOUT_MS}ms`))
|
||||||
|
}, LOAD_TIMEOUT_MS)
|
||||||
|
|
||||||
|
mainWindow.loadURL(url)
|
||||||
|
.then(() => {
|
||||||
|
clearTimeout(timeoutId)
|
||||||
|
retryAttempts = 0 // Reset on success
|
||||||
|
console.info("[cli] Successfully loaded CLI view")
|
||||||
|
})
|
||||||
|
.catch((error) => {
|
||||||
|
clearTimeout(timeoutId)
|
||||||
|
handleLoadError(error)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
const handleLoadError = (error: Error) => {
|
||||||
|
const errorCode = (error as any).errno
|
||||||
|
console.error(`[cli] failed to load CLI view (attempt ${retryAttempts + 1}/${MAX_RETRY_ATTEMPTS}):`, error.message)
|
||||||
|
|
||||||
|
// Retry on network errors (errno -3)
|
||||||
|
if (errorCode === -3 && retryAttempts < MAX_RETRY_ATTEMPTS) {
|
||||||
|
retryAttempts++
|
||||||
|
const delay = getRetryDelay(retryAttempts)
|
||||||
|
console.info(`[cli] Retrying in ${delay}ms (attempt ${retryAttempts}/${MAX_RETRY_ATTEMPTS})`)
|
||||||
|
|
||||||
|
if (mainWindow && !mainWindow.isDestroyed()) {
|
||||||
|
loadLoadingScreen(mainWindow)
|
||||||
|
}
|
||||||
|
|
||||||
|
setTimeout(loadWithRetry, delay)
|
||||||
|
} else if (retryAttempts >= MAX_RETRY_ATTEMPTS) {
|
||||||
|
console.error("[cli] Max retry attempts reached, showing error screen")
|
||||||
|
if (mainWindow && !mainWindow.isDestroyed()) {
|
||||||
|
showErrorScreen(mainWindow, `Failed after ${MAX_RETRY_ATTEMPTS} attempts: ${error.message}`)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
loadWithRetry()
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
async function startCli() {
|
||||||
|
try {
|
||||||
|
const devMode = process.env.NODE_ENV === "development"
|
||||||
|
console.info("[cli] start requested (dev mode:", devMode, ")")
|
||||||
|
await cliManager.start({ dev: devMode })
|
||||||
|
} catch (error) {
|
||||||
|
const message = error instanceof Error ? error.message : String(error)
|
||||||
|
console.error("[cli] start failed:", message)
|
||||||
|
if (mainWindow && !mainWindow.isDestroyed()) {
|
||||||
|
mainWindow.webContents.send("cli:error", { message })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
cliManager.on("ready", (status) => {
|
||||||
|
if (!status.url) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
startCliPreload(status.url)
|
||||||
|
})
|
||||||
|
|
||||||
|
cliManager.on("status", (status) => {
|
||||||
|
if (status.state !== "ready") {
|
||||||
|
showLoadingScreen()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
if (isMac) {
|
||||||
|
app.on("web-contents-created", (_, contents) => {
|
||||||
|
contents.session.setSpellCheckerEnabled(false)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
app.whenReady().then(() => {
|
||||||
|
ensureDefaultUsers()
|
||||||
|
applyUserEnvToCli()
|
||||||
|
startCli()
|
||||||
|
|
||||||
|
if (isMac) {
|
||||||
|
session.defaultSession.setSpellCheckerEnabled(false)
|
||||||
|
app.on("browser-window-created", (_, window) => {
|
||||||
|
window.webContents.session.setSpellCheckerEnabled(false)
|
||||||
|
})
|
||||||
|
|
||||||
|
if (app.dock) {
|
||||||
|
const dockIcon = nativeImage.createFromPath(getIconPath())
|
||||||
|
if (!dockIcon.isEmpty()) {
|
||||||
|
app.dock.setIcon(dockIcon)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
createWindow()
|
||||||
|
|
||||||
|
app.on("activate", () => {
|
||||||
|
if (BrowserWindow.getAllWindows().length === 0) {
|
||||||
|
createWindow()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
app.on("before-quit", async (event) => {
|
||||||
|
event.preventDefault()
|
||||||
|
await cliManager.stop().catch(() => { })
|
||||||
|
clearGuestUsers()
|
||||||
|
app.exit(0)
|
||||||
|
})
|
||||||
|
|
||||||
|
app.on("window-all-closed", () => {
|
||||||
|
if (process.platform !== "darwin") {
|
||||||
|
app.quit()
|
||||||
|
}
|
||||||
|
})
|
||||||
84
packages/electron-app/electron/main/menu.ts
Normal file
84
packages/electron-app/electron/main/menu.ts
Normal file
@@ -0,0 +1,84 @@
|
|||||||
|
import { Menu, BrowserWindow, MenuItemConstructorOptions } from "electron"
|
||||||
|
|
||||||
|
export function createApplicationMenu(mainWindow: BrowserWindow) {
|
||||||
|
const isMac = process.platform === "darwin"
|
||||||
|
|
||||||
|
const template: MenuItemConstructorOptions[] = [
|
||||||
|
...(isMac
|
||||||
|
? [
|
||||||
|
{
|
||||||
|
label: "CodeNomad",
|
||||||
|
submenu: [
|
||||||
|
{ role: "about" as const },
|
||||||
|
{ type: "separator" as const },
|
||||||
|
{ role: "hide" as const },
|
||||||
|
{ role: "hideOthers" as const },
|
||||||
|
{ role: "unhide" as const },
|
||||||
|
{ type: "separator" as const },
|
||||||
|
{ role: "quit" as const },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
]
|
||||||
|
: []),
|
||||||
|
{
|
||||||
|
label: "File",
|
||||||
|
submenu: [
|
||||||
|
{
|
||||||
|
label: "New Instance",
|
||||||
|
accelerator: "CmdOrCtrl+N",
|
||||||
|
click: () => {
|
||||||
|
mainWindow.webContents.send("menu:newInstance")
|
||||||
|
},
|
||||||
|
},
|
||||||
|
{ type: "separator" as const },
|
||||||
|
isMac ? { role: "close" as const } : { role: "quit" as const },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: "Edit",
|
||||||
|
submenu: [
|
||||||
|
{ role: "undo" as const },
|
||||||
|
{ role: "redo" as const },
|
||||||
|
{ type: "separator" as const },
|
||||||
|
{ role: "cut" as const },
|
||||||
|
{ role: "copy" as const },
|
||||||
|
{ role: "paste" as const },
|
||||||
|
...(isMac
|
||||||
|
? [{ role: "pasteAndMatchStyle" as const }, { role: "delete" as const }, { role: "selectAll" as const }]
|
||||||
|
: [{ role: "delete" as const }, { type: "separator" as const }, { role: "selectAll" as const }]),
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: "View",
|
||||||
|
submenu: [
|
||||||
|
{ role: "reload" as const },
|
||||||
|
{ role: "forceReload" as const },
|
||||||
|
{ role: "toggleDevTools" as const },
|
||||||
|
{ type: "separator" as const },
|
||||||
|
{ role: "resetZoom" as const },
|
||||||
|
{ role: "zoomIn" as const },
|
||||||
|
{ role: "zoomOut" as const },
|
||||||
|
{ type: "separator" as const },
|
||||||
|
{ role: "togglefullscreen" as const },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: "Window",
|
||||||
|
submenu: [
|
||||||
|
{ role: "minimize" as const },
|
||||||
|
{ role: "zoom" as const },
|
||||||
|
...(isMac
|
||||||
|
? [
|
||||||
|
{ type: "separator" as const },
|
||||||
|
{ role: "front" as const },
|
||||||
|
{ type: "separator" as const },
|
||||||
|
{ role: "window" as const },
|
||||||
|
]
|
||||||
|
: [{ role: "close" as const }]),
|
||||||
|
],
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const menu = Menu.buildFromTemplate(template)
|
||||||
|
Menu.setApplicationMenu(menu)
|
||||||
|
}
|
||||||
371
packages/electron-app/electron/main/process-manager.ts
Normal file
371
packages/electron-app/electron/main/process-manager.ts
Normal file
@@ -0,0 +1,371 @@
|
|||||||
|
import { spawn, type ChildProcess } from "child_process"
|
||||||
|
import { app } from "electron"
|
||||||
|
import { createRequire } from "module"
|
||||||
|
import { EventEmitter } from "events"
|
||||||
|
import { existsSync, readFileSync } from "fs"
|
||||||
|
import os from "os"
|
||||||
|
import path from "path"
|
||||||
|
import { buildUserShellCommand, getUserShellEnv, supportsUserShell } from "./user-shell"
|
||||||
|
|
||||||
|
const nodeRequire = createRequire(import.meta.url)
|
||||||
|
|
||||||
|
|
||||||
|
type CliState = "starting" | "ready" | "error" | "stopped"
|
||||||
|
type ListeningMode = "local" | "all"
|
||||||
|
|
||||||
|
export interface CliStatus {
|
||||||
|
state: CliState
|
||||||
|
pid?: number
|
||||||
|
port?: number
|
||||||
|
url?: string
|
||||||
|
error?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CliLogEntry {
|
||||||
|
stream: "stdout" | "stderr"
|
||||||
|
message: string
|
||||||
|
}
|
||||||
|
|
||||||
|
interface StartOptions {
|
||||||
|
dev: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
interface CliEntryResolution {
|
||||||
|
entry: string
|
||||||
|
runner: "node" | "tsx"
|
||||||
|
runnerPath?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
const DEFAULT_CONFIG_PATH = "~/.config/codenomad/config.json"
|
||||||
|
|
||||||
|
function resolveConfigPath(configPath?: string): string {
|
||||||
|
const target = configPath && configPath.trim().length > 0 ? configPath : DEFAULT_CONFIG_PATH
|
||||||
|
if (target.startsWith("~/")) {
|
||||||
|
return path.join(os.homedir(), target.slice(2))
|
||||||
|
}
|
||||||
|
return path.resolve(target)
|
||||||
|
}
|
||||||
|
|
||||||
|
function resolveHostForMode(mode: ListeningMode): string {
|
||||||
|
return mode === "local" ? "127.0.0.1" : "0.0.0.0"
|
||||||
|
}
|
||||||
|
|
||||||
|
function readListeningModeFromConfig(): ListeningMode {
|
||||||
|
try {
|
||||||
|
const configPath = resolveConfigPath(process.env.CLI_CONFIG)
|
||||||
|
if (!existsSync(configPath)) return "local"
|
||||||
|
const content = readFileSync(configPath, "utf-8")
|
||||||
|
const parsed = JSON.parse(content)
|
||||||
|
const mode = parsed?.preferences?.listeningMode
|
||||||
|
if (mode === "local" || mode === "all") {
|
||||||
|
return mode
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.warn("[cli] failed to read listening mode from config", error)
|
||||||
|
}
|
||||||
|
return "local"
|
||||||
|
}
|
||||||
|
|
||||||
|
export declare interface CliProcessManager {
|
||||||
|
on(event: "status", listener: (status: CliStatus) => void): this
|
||||||
|
on(event: "ready", listener: (status: CliStatus) => void): this
|
||||||
|
on(event: "log", listener: (entry: CliLogEntry) => void): this
|
||||||
|
on(event: "exit", listener: (status: CliStatus) => void): this
|
||||||
|
on(event: "error", listener: (error: Error) => void): this
|
||||||
|
}
|
||||||
|
|
||||||
|
export class CliProcessManager extends EventEmitter {
|
||||||
|
private child?: ChildProcess
|
||||||
|
private status: CliStatus = { state: "stopped" }
|
||||||
|
private stdoutBuffer = ""
|
||||||
|
private stderrBuffer = ""
|
||||||
|
private userEnv: Record<string, string> = {}
|
||||||
|
|
||||||
|
setUserEnv(env: Record<string, string>) {
|
||||||
|
this.userEnv = { ...env }
|
||||||
|
}
|
||||||
|
|
||||||
|
async start(options: StartOptions): Promise<CliStatus> {
|
||||||
|
if (this.child) {
|
||||||
|
await this.stop()
|
||||||
|
}
|
||||||
|
|
||||||
|
this.stdoutBuffer = ""
|
||||||
|
this.stderrBuffer = ""
|
||||||
|
this.updateStatus({ state: "starting", port: undefined, pid: undefined, url: undefined, error: undefined })
|
||||||
|
|
||||||
|
const cliEntry = this.resolveCliEntry(options)
|
||||||
|
const listeningMode = this.resolveListeningMode()
|
||||||
|
const host = resolveHostForMode(listeningMode)
|
||||||
|
const args = this.buildCliArgs(options, host)
|
||||||
|
|
||||||
|
console.info(
|
||||||
|
`[cli] launching CodeNomad CLI (${options.dev ? "dev" : "prod"}) using ${cliEntry.runner} at ${cliEntry.entry} (host=${host})`,
|
||||||
|
)
|
||||||
|
|
||||||
|
const env = supportsUserShell() ? getUserShellEnv() : { ...process.env }
|
||||||
|
env.ELECTRON_RUN_AS_NODE = "1"
|
||||||
|
Object.assign(env, this.userEnv)
|
||||||
|
|
||||||
|
const spawnDetails = supportsUserShell()
|
||||||
|
? buildUserShellCommand(`ELECTRON_RUN_AS_NODE=1 exec ${this.buildCommand(cliEntry, args)}`)
|
||||||
|
: this.buildDirectSpawn(cliEntry, args)
|
||||||
|
|
||||||
|
const child = spawn(spawnDetails.command, spawnDetails.args, {
|
||||||
|
cwd: process.cwd(),
|
||||||
|
stdio: ["ignore", "pipe", "pipe"],
|
||||||
|
env,
|
||||||
|
shell: false,
|
||||||
|
})
|
||||||
|
|
||||||
|
console.info(`[cli] spawn command: ${spawnDetails.command} ${spawnDetails.args.join(" ")}`)
|
||||||
|
if (!child.pid) {
|
||||||
|
console.error("[cli] spawn failed: no pid")
|
||||||
|
}
|
||||||
|
|
||||||
|
this.child = child
|
||||||
|
this.updateStatus({ pid: child.pid ?? undefined })
|
||||||
|
|
||||||
|
child.stdout?.on("data", (data: Buffer) => {
|
||||||
|
this.handleStream(data.toString(), "stdout")
|
||||||
|
})
|
||||||
|
|
||||||
|
child.stderr?.on("data", (data: Buffer) => {
|
||||||
|
this.handleStream(data.toString(), "stderr")
|
||||||
|
})
|
||||||
|
|
||||||
|
child.on("error", (error) => {
|
||||||
|
console.error("[cli] failed to start CLI:", error)
|
||||||
|
this.updateStatus({ state: "error", error: error.message })
|
||||||
|
this.emit("error", error)
|
||||||
|
})
|
||||||
|
|
||||||
|
child.on("exit", (code, signal) => {
|
||||||
|
const failed = this.status.state !== "ready"
|
||||||
|
const error = failed ? this.status.error ?? `CLI exited with code ${code ?? 0}${signal ? ` (${signal})` : ""}` : undefined
|
||||||
|
console.info(`[cli] exit (code=${code}, signal=${signal || ""})${error ? ` error=${error}` : ""}`)
|
||||||
|
this.updateStatus({ state: failed ? "error" : "stopped", error })
|
||||||
|
if (failed && error) {
|
||||||
|
this.emit("error", new Error(error))
|
||||||
|
}
|
||||||
|
this.emit("exit", this.status)
|
||||||
|
this.child = undefined
|
||||||
|
})
|
||||||
|
|
||||||
|
return new Promise<CliStatus>((resolve, reject) => {
|
||||||
|
const timeout = setTimeout(() => {
|
||||||
|
this.handleTimeout()
|
||||||
|
reject(new Error("CLI startup timeout"))
|
||||||
|
}, 60000)
|
||||||
|
|
||||||
|
this.once("ready", (status) => {
|
||||||
|
clearTimeout(timeout)
|
||||||
|
resolve(status)
|
||||||
|
})
|
||||||
|
|
||||||
|
this.once("error", (error) => {
|
||||||
|
clearTimeout(timeout)
|
||||||
|
reject(error)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
async stop(): Promise<void> {
|
||||||
|
const child = this.child
|
||||||
|
if (!child) {
|
||||||
|
this.updateStatus({ state: "stopped" })
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
return new Promise((resolve) => {
|
||||||
|
const killTimeout = setTimeout(() => {
|
||||||
|
child.kill("SIGKILL")
|
||||||
|
}, 4000)
|
||||||
|
|
||||||
|
child.on("exit", () => {
|
||||||
|
clearTimeout(killTimeout)
|
||||||
|
this.child = undefined
|
||||||
|
console.info("[cli] CLI process exited")
|
||||||
|
this.updateStatus({ state: "stopped" })
|
||||||
|
resolve()
|
||||||
|
})
|
||||||
|
|
||||||
|
child.kill("SIGTERM")
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
getStatus(): CliStatus {
|
||||||
|
return { ...this.status }
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveListeningMode(): ListeningMode {
|
||||||
|
return readListeningModeFromConfig()
|
||||||
|
}
|
||||||
|
|
||||||
|
private handleTimeout() {
|
||||||
|
if (this.child) {
|
||||||
|
this.child.kill("SIGKILL")
|
||||||
|
this.child = undefined
|
||||||
|
}
|
||||||
|
this.updateStatus({ state: "error", error: "CLI did not start in time" })
|
||||||
|
this.emit("error", new Error("CLI did not start in time"))
|
||||||
|
}
|
||||||
|
|
||||||
|
private handleStream(chunk: string, stream: "stdout" | "stderr") {
|
||||||
|
if (stream === "stdout") {
|
||||||
|
this.stdoutBuffer += chunk
|
||||||
|
this.processBuffer("stdout")
|
||||||
|
} else {
|
||||||
|
this.stderrBuffer += chunk
|
||||||
|
this.processBuffer("stderr")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private processBuffer(stream: "stdout" | "stderr") {
|
||||||
|
const buffer = stream === "stdout" ? this.stdoutBuffer : this.stderrBuffer
|
||||||
|
const lines = buffer.split("\n")
|
||||||
|
const trailing = lines.pop() ?? ""
|
||||||
|
|
||||||
|
if (stream === "stdout") {
|
||||||
|
this.stdoutBuffer = trailing
|
||||||
|
} else {
|
||||||
|
this.stderrBuffer = trailing
|
||||||
|
}
|
||||||
|
|
||||||
|
for (const line of lines) {
|
||||||
|
if (!line.trim()) continue
|
||||||
|
console.info(`[cli][${stream}] ${line}`)
|
||||||
|
this.emit("log", { stream, message: line })
|
||||||
|
|
||||||
|
const port = this.extractPort(line)
|
||||||
|
if (port && this.status.state === "starting") {
|
||||||
|
const url = `http://127.0.0.1:${port}`
|
||||||
|
console.info(`[cli] ready on ${url}`)
|
||||||
|
this.updateStatus({ state: "ready", port, url })
|
||||||
|
this.emit("ready", this.status)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private extractPort(line: string): number | null {
|
||||||
|
const readyMatch = line.match(/CodeNomad Server is ready at http:\/\/[^:]+:(\d+)/i)
|
||||||
|
if (readyMatch) {
|
||||||
|
return parseInt(readyMatch[1], 10)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (line.toLowerCase().includes("http server listening")) {
|
||||||
|
const httpMatch = line.match(/:(\d{2,5})(?!.*:\d)/)
|
||||||
|
if (httpMatch) {
|
||||||
|
return parseInt(httpMatch[1], 10)
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
const parsed = JSON.parse(line)
|
||||||
|
if (typeof parsed.port === "number") {
|
||||||
|
return parsed.port
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
// not JSON, ignore
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
private updateStatus(patch: Partial<CliStatus>) {
|
||||||
|
this.status = { ...this.status, ...patch }
|
||||||
|
this.emit("status", this.status)
|
||||||
|
}
|
||||||
|
|
||||||
|
private buildCliArgs(options: StartOptions, host: string): string[] {
|
||||||
|
const args = ["serve", "--host", host, "--port", "0"]
|
||||||
|
|
||||||
|
if (options.dev) {
|
||||||
|
const uiPort = process.env.VITE_PORT || "3000"
|
||||||
|
args.push("--ui-dev-server", `http://localhost:${uiPort}`, "--log-level", "debug")
|
||||||
|
}
|
||||||
|
|
||||||
|
return args
|
||||||
|
}
|
||||||
|
|
||||||
|
private buildCommand(cliEntry: CliEntryResolution, args: string[]): string {
|
||||||
|
const parts = [JSON.stringify(process.execPath)]
|
||||||
|
if (cliEntry.runner === "tsx" && cliEntry.runnerPath) {
|
||||||
|
parts.push(JSON.stringify(cliEntry.runnerPath))
|
||||||
|
}
|
||||||
|
parts.push(JSON.stringify(cliEntry.entry))
|
||||||
|
args.forEach((arg) => parts.push(JSON.stringify(arg)))
|
||||||
|
return parts.join(" ")
|
||||||
|
}
|
||||||
|
|
||||||
|
private buildDirectSpawn(cliEntry: CliEntryResolution, args: string[]) {
|
||||||
|
if (cliEntry.runner === "tsx") {
|
||||||
|
return { command: process.execPath, args: [cliEntry.runnerPath!, cliEntry.entry, ...args] }
|
||||||
|
}
|
||||||
|
|
||||||
|
return { command: process.execPath, args: [cliEntry.entry, ...args] }
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveCliEntry(options: StartOptions): CliEntryResolution {
|
||||||
|
if (options.dev) {
|
||||||
|
const tsxPath = this.resolveTsx()
|
||||||
|
if (!tsxPath) {
|
||||||
|
throw new Error("tsx is required to run the CLI in development mode. Please install dependencies.")
|
||||||
|
}
|
||||||
|
const devEntry = this.resolveDevEntry()
|
||||||
|
return { entry: devEntry, runner: "tsx", runnerPath: tsxPath }
|
||||||
|
}
|
||||||
|
|
||||||
|
const distEntry = this.resolveProdEntry()
|
||||||
|
return { entry: distEntry, runner: "node" }
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveTsx(): string | null {
|
||||||
|
const candidates: Array<string | (() => string)> = [
|
||||||
|
() => nodeRequire.resolve("tsx/cli"),
|
||||||
|
() => nodeRequire.resolve("tsx/dist/cli.mjs"),
|
||||||
|
() => nodeRequire.resolve("tsx/dist/cli.cjs"),
|
||||||
|
path.resolve(process.cwd(), "node_modules", "tsx", "dist", "cli.mjs"),
|
||||||
|
path.resolve(process.cwd(), "node_modules", "tsx", "dist", "cli.cjs"),
|
||||||
|
path.resolve(process.cwd(), "..", "node_modules", "tsx", "dist", "cli.mjs"),
|
||||||
|
path.resolve(process.cwd(), "..", "node_modules", "tsx", "dist", "cli.cjs"),
|
||||||
|
path.resolve(process.cwd(), "..", "..", "node_modules", "tsx", "dist", "cli.mjs"),
|
||||||
|
path.resolve(process.cwd(), "..", "..", "node_modules", "tsx", "dist", "cli.cjs"),
|
||||||
|
path.resolve(app.getAppPath(), "..", "node_modules", "tsx", "dist", "cli.mjs"),
|
||||||
|
path.resolve(app.getAppPath(), "..", "node_modules", "tsx", "dist", "cli.cjs"),
|
||||||
|
]
|
||||||
|
|
||||||
|
for (const candidate of candidates) {
|
||||||
|
try {
|
||||||
|
const resolved = typeof candidate === "function" ? candidate() : candidate
|
||||||
|
if (resolved && existsSync(resolved)) {
|
||||||
|
return resolved
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveDevEntry(): string {
|
||||||
|
const entry = path.resolve(process.cwd(), "..", "server", "src", "index.ts")
|
||||||
|
if (!existsSync(entry)) {
|
||||||
|
throw new Error(`Dev CLI entry not found at ${entry}. Run npm run dev:electron from the repository root after installing dependencies.`)
|
||||||
|
}
|
||||||
|
return entry
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveProdEntry(): string {
|
||||||
|
try {
|
||||||
|
const entry = nodeRequire.resolve("@neuralnomads/codenomad/dist/bin.js")
|
||||||
|
if (existsSync(entry)) {
|
||||||
|
return entry
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
// fall through to error below
|
||||||
|
}
|
||||||
|
throw new Error("Unable to locate CodeNomad CLI build (dist/bin.js). Run npm run build --workspace @neuralnomads/codenomad.")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
121
packages/electron-app/electron/main/storage.ts
Normal file
121
packages/electron-app/electron/main/storage.ts
Normal file
@@ -0,0 +1,121 @@
|
|||||||
|
import { app, ipcMain } from "electron"
|
||||||
|
import { join } from "path"
|
||||||
|
import { readFile, writeFile, mkdir, unlink, stat } from "fs/promises"
|
||||||
|
import { existsSync } from "fs"
|
||||||
|
|
||||||
|
const CONFIG_DIR = join(app.getPath("home"), ".config", "codenomad")
|
||||||
|
const CONFIG_FILE = join(CONFIG_DIR, "config.json")
|
||||||
|
const INSTANCES_DIR = join(CONFIG_DIR, "instances")
|
||||||
|
|
||||||
|
// File watching for config changes
|
||||||
|
let configWatchers = new Set<number>()
|
||||||
|
let configLastModified = 0
|
||||||
|
let configCache: string | null = null
|
||||||
|
|
||||||
|
async function ensureDirectories() {
|
||||||
|
try {
|
||||||
|
await mkdir(CONFIG_DIR, { recursive: true })
|
||||||
|
await mkdir(INSTANCES_DIR, { recursive: true })
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Failed to create directories:", error)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function readConfigWithCache(): Promise<string> {
|
||||||
|
try {
|
||||||
|
const stats = await stat(CONFIG_FILE)
|
||||||
|
const currentModified = stats.mtime.getTime()
|
||||||
|
|
||||||
|
// If file hasn't been modified since last read, return cache
|
||||||
|
if (configCache && configLastModified >= currentModified) {
|
||||||
|
return configCache
|
||||||
|
}
|
||||||
|
|
||||||
|
const content = await readFile(CONFIG_FILE, "utf-8")
|
||||||
|
configCache = content
|
||||||
|
configLastModified = currentModified
|
||||||
|
return content
|
||||||
|
} catch (error) {
|
||||||
|
// File doesn't exist or can't be read
|
||||||
|
configCache = null
|
||||||
|
configLastModified = 0
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function invalidateConfigCache() {
|
||||||
|
configCache = null
|
||||||
|
configLastModified = 0
|
||||||
|
}
|
||||||
|
|
||||||
|
export function setupStorageIPC() {
|
||||||
|
ensureDirectories()
|
||||||
|
|
||||||
|
ipcMain.handle("storage:getConfigPath", async () => CONFIG_FILE)
|
||||||
|
ipcMain.handle("storage:getInstancesDir", async () => INSTANCES_DIR)
|
||||||
|
|
||||||
|
ipcMain.handle("storage:readConfigFile", async () => {
|
||||||
|
try {
|
||||||
|
return await readConfigWithCache()
|
||||||
|
} catch (error) {
|
||||||
|
// Return empty config if file doesn't exist
|
||||||
|
return JSON.stringify({ preferences: { showThinkingBlocks: false, thinkingBlocksExpansion: "expanded" }, recentFolders: [] }, null, 2)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
ipcMain.handle("storage:writeConfigFile", async (_, content: string) => {
|
||||||
|
try {
|
||||||
|
await writeFile(CONFIG_FILE, content, "utf-8")
|
||||||
|
invalidateConfigCache()
|
||||||
|
|
||||||
|
// Notify other renderer processes about config change
|
||||||
|
const windows = require("electron").BrowserWindow.getAllWindows()
|
||||||
|
windows.forEach((win: any) => {
|
||||||
|
if (win.webContents && !win.webContents.isDestroyed()) {
|
||||||
|
win.webContents.send("storage:configChanged")
|
||||||
|
}
|
||||||
|
})
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Failed to write config file:", error)
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
ipcMain.handle("storage:readInstanceFile", async (_, filename: string) => {
|
||||||
|
const instanceFile = join(INSTANCES_DIR, `${filename}.json`)
|
||||||
|
try {
|
||||||
|
return await readFile(instanceFile, "utf-8")
|
||||||
|
} catch (error) {
|
||||||
|
// Return empty instance data if file doesn't exist
|
||||||
|
return JSON.stringify({ messageHistory: [] }, null, 2)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
ipcMain.handle("storage:writeInstanceFile", async (_, filename: string, content: string) => {
|
||||||
|
const instanceFile = join(INSTANCES_DIR, `${filename}.json`)
|
||||||
|
try {
|
||||||
|
await writeFile(instanceFile, content, "utf-8")
|
||||||
|
} catch (error) {
|
||||||
|
console.error(`Failed to write instance file for ${filename}:`, error)
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
ipcMain.handle("storage:deleteInstanceFile", async (_, filename: string) => {
|
||||||
|
const instanceFile = join(INSTANCES_DIR, `${filename}.json`)
|
||||||
|
try {
|
||||||
|
if (existsSync(instanceFile)) {
|
||||||
|
await unlink(instanceFile)
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error(`Failed to delete instance file for ${filename}:`, error)
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// Clean up on app quit
|
||||||
|
app.on("before-quit", () => {
|
||||||
|
configCache = null
|
||||||
|
configLastModified = 0
|
||||||
|
})
|
||||||
139
packages/electron-app/electron/main/user-shell.ts
Normal file
139
packages/electron-app/electron/main/user-shell.ts
Normal file
@@ -0,0 +1,139 @@
|
|||||||
|
import { spawn, spawnSync } from "child_process"
|
||||||
|
import path from "path"
|
||||||
|
|
||||||
|
interface ShellCommand {
|
||||||
|
command: string
|
||||||
|
args: string[]
|
||||||
|
}
|
||||||
|
|
||||||
|
const isWindows = process.platform === "win32"
|
||||||
|
|
||||||
|
function getDefaultShellPath(): string {
|
||||||
|
if (process.env.SHELL && process.env.SHELL.trim().length > 0) {
|
||||||
|
return process.env.SHELL
|
||||||
|
}
|
||||||
|
|
||||||
|
if (process.platform === "darwin") {
|
||||||
|
return "/bin/zsh"
|
||||||
|
}
|
||||||
|
|
||||||
|
return "/bin/bash"
|
||||||
|
}
|
||||||
|
|
||||||
|
function wrapCommandForShell(command: string, shellPath: string): string {
|
||||||
|
const shellName = path.basename(shellPath)
|
||||||
|
|
||||||
|
if (shellName.includes("bash")) {
|
||||||
|
return 'if [ -f ~/.bashrc ]; then source ~/.bashrc >/dev/null 2>&1; fi; ' + command
|
||||||
|
}
|
||||||
|
|
||||||
|
if (shellName.includes("zsh")) {
|
||||||
|
return 'if [ -f ~/.zshrc ]; then source ~/.zshrc >/dev/null 2>&1; fi; ' + command
|
||||||
|
}
|
||||||
|
|
||||||
|
return command
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildShellArgs(shellPath: string): string[] {
|
||||||
|
const shellName = path.basename(shellPath)
|
||||||
|
if (shellName.includes("zsh")) {
|
||||||
|
return ["-l", "-i", "-c"]
|
||||||
|
}
|
||||||
|
return ["-l", "-c"]
|
||||||
|
}
|
||||||
|
|
||||||
|
function sanitizeShellEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
|
||||||
|
const cleaned = { ...env }
|
||||||
|
delete cleaned.npm_config_prefix
|
||||||
|
delete cleaned.NPM_CONFIG_PREFIX
|
||||||
|
return cleaned
|
||||||
|
}
|
||||||
|
|
||||||
|
export function supportsUserShell(): boolean {
|
||||||
|
return !isWindows
|
||||||
|
}
|
||||||
|
|
||||||
|
export function buildUserShellCommand(userCommand: string): ShellCommand {
|
||||||
|
if (!supportsUserShell()) {
|
||||||
|
throw new Error("User shell invocation is only supported on POSIX platforms")
|
||||||
|
}
|
||||||
|
|
||||||
|
const shellPath = getDefaultShellPath()
|
||||||
|
const script = wrapCommandForShell(userCommand, shellPath)
|
||||||
|
const args = buildShellArgs(shellPath)
|
||||||
|
|
||||||
|
return {
|
||||||
|
command: shellPath,
|
||||||
|
args: [...args, script],
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function getUserShellEnv(): NodeJS.ProcessEnv {
|
||||||
|
if (!supportsUserShell()) {
|
||||||
|
throw new Error("User shell invocation is only supported on POSIX platforms")
|
||||||
|
}
|
||||||
|
return sanitizeShellEnv(process.env)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function runUserShellCommand(userCommand: string, timeoutMs = 5000): Promise<string> {
|
||||||
|
if (!supportsUserShell()) {
|
||||||
|
return Promise.reject(new Error("User shell invocation is only supported on POSIX platforms"))
|
||||||
|
}
|
||||||
|
|
||||||
|
const { command, args } = buildUserShellCommand(userCommand)
|
||||||
|
const env = getUserShellEnv()
|
||||||
|
|
||||||
|
return new Promise((resolve, reject) => {
|
||||||
|
const child = spawn(command, args, {
|
||||||
|
stdio: ["ignore", "pipe", "pipe"],
|
||||||
|
env,
|
||||||
|
})
|
||||||
|
|
||||||
|
let stdout = ""
|
||||||
|
let stderr = ""
|
||||||
|
|
||||||
|
const timeout = setTimeout(() => {
|
||||||
|
child.kill("SIGTERM")
|
||||||
|
reject(new Error(`Shell command timed out after ${timeoutMs}ms`))
|
||||||
|
}, timeoutMs)
|
||||||
|
|
||||||
|
child.stdout?.on("data", (data) => {
|
||||||
|
stdout += data.toString()
|
||||||
|
})
|
||||||
|
|
||||||
|
child.stderr?.on("data", (data) => {
|
||||||
|
stderr += data.toString()
|
||||||
|
})
|
||||||
|
|
||||||
|
child.on("error", (error) => {
|
||||||
|
clearTimeout(timeout)
|
||||||
|
reject(error)
|
||||||
|
})
|
||||||
|
|
||||||
|
child.on("close", (code) => {
|
||||||
|
clearTimeout(timeout)
|
||||||
|
if (code === 0) {
|
||||||
|
resolve(stdout.trim())
|
||||||
|
} else {
|
||||||
|
reject(new Error(stderr.trim() || `Shell command exited with code ${code}`))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
export function runUserShellCommandSync(userCommand: string): string {
|
||||||
|
if (!supportsUserShell()) {
|
||||||
|
throw new Error("User shell invocation is only supported on POSIX platforms")
|
||||||
|
}
|
||||||
|
|
||||||
|
const { command, args } = buildUserShellCommand(userCommand)
|
||||||
|
const env = getUserShellEnv()
|
||||||
|
const result = spawnSync(command, args, { encoding: "utf-8", env })
|
||||||
|
|
||||||
|
if (result.status !== 0) {
|
||||||
|
const stderr = (result.stderr || "").toString().trim()
|
||||||
|
throw new Error(stderr || "Shell command failed")
|
||||||
|
}
|
||||||
|
|
||||||
|
return (result.stdout || "").toString().trim()
|
||||||
|
}
|
||||||
267
packages/electron-app/electron/main/user-store.ts
Normal file
267
packages/electron-app/electron/main/user-store.ts
Normal file
@@ -0,0 +1,267 @@
|
|||||||
|
import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync, cpSync } from "fs"
|
||||||
|
import os from "os"
|
||||||
|
import path from "path"
|
||||||
|
import crypto from "crypto"
|
||||||
|
|
||||||
|
interface UserRecord {
|
||||||
|
id: string
|
||||||
|
name: string
|
||||||
|
salt?: string
|
||||||
|
passwordHash?: string
|
||||||
|
isGuest?: boolean
|
||||||
|
createdAt: string
|
||||||
|
updatedAt: string
|
||||||
|
}
|
||||||
|
|
||||||
|
interface UserStoreState {
|
||||||
|
users: UserRecord[]
|
||||||
|
activeUserId?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
const CONFIG_ROOT = path.join(os.homedir(), ".config", "codenomad")
|
||||||
|
const USERS_FILE = path.join(CONFIG_ROOT, "users.json")
|
||||||
|
const USERS_ROOT = path.join(CONFIG_ROOT, "users")
|
||||||
|
const LEGACY_ROOT = CONFIG_ROOT
|
||||||
|
const LEGACY_INTEGRATIONS_ROOT = path.join(os.homedir(), ".nomadarch")
|
||||||
|
|
||||||
|
function nowIso() {
|
||||||
|
return new Date().toISOString()
|
||||||
|
}
|
||||||
|
|
||||||
|
function sanitizeId(value: string) {
|
||||||
|
return value
|
||||||
|
.toLowerCase()
|
||||||
|
.trim()
|
||||||
|
.replace(/[^a-z0-9-_]+/g, "-")
|
||||||
|
.replace(/-{2,}/g, "-")
|
||||||
|
.replace(/^-|-$/g, "")
|
||||||
|
}
|
||||||
|
|
||||||
|
function hashPassword(password: string, salt: string) {
|
||||||
|
return crypto.pbkdf2Sync(password, salt, 120000, 32, "sha256").toString("base64")
|
||||||
|
}
|
||||||
|
|
||||||
|
function generateSalt() {
|
||||||
|
return crypto.randomBytes(16).toString("base64")
|
||||||
|
}
|
||||||
|
|
||||||
|
function ensureDir(dir: string) {
|
||||||
|
if (!existsSync(dir)) {
|
||||||
|
mkdirSync(dir, { recursive: true })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function readStore(): UserStoreState {
|
||||||
|
try {
|
||||||
|
if (!existsSync(USERS_FILE)) {
|
||||||
|
return { users: [] }
|
||||||
|
}
|
||||||
|
const content = readFileSync(USERS_FILE, "utf-8")
|
||||||
|
const parsed = JSON.parse(content) as UserStoreState
|
||||||
|
return {
|
||||||
|
users: Array.isArray(parsed.users) ? parsed.users : [],
|
||||||
|
activeUserId: parsed.activeUserId,
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
return { users: [] }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function writeStore(state: UserStoreState) {
|
||||||
|
ensureDir(CONFIG_ROOT)
|
||||||
|
ensureDir(USERS_ROOT)
|
||||||
|
writeFileSync(USERS_FILE, JSON.stringify(state, null, 2), "utf-8")
|
||||||
|
}
|
||||||
|
|
||||||
|
function ensureUniqueId(base: string, existing: Set<string>) {
|
||||||
|
let candidate = sanitizeId(base) || "user"
|
||||||
|
let index = 1
|
||||||
|
while (existing.has(candidate)) {
|
||||||
|
candidate = `${candidate}-${index}`
|
||||||
|
index += 1
|
||||||
|
}
|
||||||
|
return candidate
|
||||||
|
}
|
||||||
|
|
||||||
|
function getUserDir(userId: string) {
|
||||||
|
return path.join(USERS_ROOT, userId)
|
||||||
|
}
|
||||||
|
|
||||||
|
function migrateLegacyData(targetDir: string) {
|
||||||
|
const legacyConfig = path.join(LEGACY_ROOT, "config.json")
|
||||||
|
const legacyInstances = path.join(LEGACY_ROOT, "instances")
|
||||||
|
const legacyWorkspaces = path.join(LEGACY_ROOT, "opencode-workspaces")
|
||||||
|
|
||||||
|
ensureDir(targetDir)
|
||||||
|
|
||||||
|
if (existsSync(legacyConfig)) {
|
||||||
|
cpSync(legacyConfig, path.join(targetDir, "config.json"), { force: true })
|
||||||
|
}
|
||||||
|
if (existsSync(legacyInstances)) {
|
||||||
|
cpSync(legacyInstances, path.join(targetDir, "instances"), { recursive: true, force: true })
|
||||||
|
}
|
||||||
|
if (existsSync(legacyWorkspaces)) {
|
||||||
|
cpSync(legacyWorkspaces, path.join(targetDir, "opencode-workspaces"), { recursive: true, force: true })
|
||||||
|
}
|
||||||
|
|
||||||
|
if (existsSync(LEGACY_INTEGRATIONS_ROOT)) {
|
||||||
|
cpSync(LEGACY_INTEGRATIONS_ROOT, path.join(targetDir, "integrations"), { recursive: true, force: true })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function ensureDefaultUsers(): UserRecord {
|
||||||
|
const store = readStore()
|
||||||
|
if (store.users.length > 0) {
|
||||||
|
const active = store.users.find((u) => u.id === store.activeUserId) ?? store.users[0]
|
||||||
|
if (!store.activeUserId) {
|
||||||
|
store.activeUserId = active.id
|
||||||
|
writeStore(store)
|
||||||
|
}
|
||||||
|
return active
|
||||||
|
}
|
||||||
|
|
||||||
|
const existingIds = new Set<string>()
|
||||||
|
const userId = ensureUniqueId("roman", existingIds)
|
||||||
|
const salt = generateSalt()
|
||||||
|
const passwordHash = hashPassword("q1w2e3r4", salt)
|
||||||
|
const record: UserRecord = {
|
||||||
|
id: userId,
|
||||||
|
name: "roman",
|
||||||
|
salt,
|
||||||
|
passwordHash,
|
||||||
|
createdAt: nowIso(),
|
||||||
|
updatedAt: nowIso(),
|
||||||
|
}
|
||||||
|
|
||||||
|
store.users.push(record)
|
||||||
|
store.activeUserId = record.id
|
||||||
|
writeStore(store)
|
||||||
|
|
||||||
|
const userDir = getUserDir(record.id)
|
||||||
|
migrateLegacyData(userDir)
|
||||||
|
|
||||||
|
return record
|
||||||
|
}
|
||||||
|
|
||||||
|
export function listUsers(): UserRecord[] {
|
||||||
|
return readStore().users
|
||||||
|
}
|
||||||
|
|
||||||
|
export function getActiveUser(): UserRecord | null {
|
||||||
|
const store = readStore()
|
||||||
|
if (!store.activeUserId) return null
|
||||||
|
return store.users.find((user) => user.id === store.activeUserId) ?? null
|
||||||
|
}
|
||||||
|
|
||||||
|
export function setActiveUser(userId: string) {
|
||||||
|
const store = readStore()
|
||||||
|
const user = store.users.find((u) => u.id === userId)
|
||||||
|
if (!user) {
|
||||||
|
throw new Error("User not found")
|
||||||
|
}
|
||||||
|
store.activeUserId = userId
|
||||||
|
writeStore(store)
|
||||||
|
return user
|
||||||
|
}
|
||||||
|
|
||||||
|
export function createUser(name: string, password: string) {
|
||||||
|
const store = readStore()
|
||||||
|
const existingIds = new Set(store.users.map((u) => u.id))
|
||||||
|
const id = ensureUniqueId(name, existingIds)
|
||||||
|
const salt = generateSalt()
|
||||||
|
const passwordHash = hashPassword(password, salt)
|
||||||
|
const record: UserRecord = {
|
||||||
|
id,
|
||||||
|
name,
|
||||||
|
salt,
|
||||||
|
passwordHash,
|
||||||
|
createdAt: nowIso(),
|
||||||
|
updatedAt: nowIso(),
|
||||||
|
}
|
||||||
|
store.users.push(record)
|
||||||
|
writeStore(store)
|
||||||
|
ensureDir(getUserDir(id))
|
||||||
|
return record
|
||||||
|
}
|
||||||
|
|
||||||
|
export function createGuestUser() {
|
||||||
|
const store = readStore()
|
||||||
|
const existingIds = new Set(store.users.map((u) => u.id))
|
||||||
|
const id = ensureUniqueId(`guest-${crypto.randomUUID().slice(0, 8)}`, existingIds)
|
||||||
|
const record: UserRecord = {
|
||||||
|
id,
|
||||||
|
name: "Guest",
|
||||||
|
isGuest: true,
|
||||||
|
createdAt: nowIso(),
|
||||||
|
updatedAt: nowIso(),
|
||||||
|
}
|
||||||
|
store.users.push(record)
|
||||||
|
store.activeUserId = id
|
||||||
|
writeStore(store)
|
||||||
|
ensureDir(getUserDir(id))
|
||||||
|
return record
|
||||||
|
}
|
||||||
|
|
||||||
|
export function updateUser(userId: string, updates: { name?: string; password?: string }) {
|
||||||
|
const store = readStore()
|
||||||
|
const target = store.users.find((u) => u.id === userId)
|
||||||
|
if (!target) {
|
||||||
|
throw new Error("User not found")
|
||||||
|
}
|
||||||
|
if (updates.name) {
|
||||||
|
target.name = updates.name
|
||||||
|
}
|
||||||
|
if (updates.password && !target.isGuest) {
|
||||||
|
const salt = generateSalt()
|
||||||
|
target.salt = salt
|
||||||
|
target.passwordHash = hashPassword(updates.password, salt)
|
||||||
|
}
|
||||||
|
target.updatedAt = nowIso()
|
||||||
|
writeStore(store)
|
||||||
|
return target
|
||||||
|
}
|
||||||
|
|
||||||
|
export function deleteUser(userId: string) {
|
||||||
|
const store = readStore()
|
||||||
|
const target = store.users.find((u) => u.id === userId)
|
||||||
|
if (!target) return
|
||||||
|
store.users = store.users.filter((u) => u.id !== userId)
|
||||||
|
if (store.activeUserId === userId) {
|
||||||
|
store.activeUserId = store.users[0]?.id
|
||||||
|
}
|
||||||
|
writeStore(store)
|
||||||
|
const dir = getUserDir(userId)
|
||||||
|
if (existsSync(dir)) {
|
||||||
|
rmSync(dir, { recursive: true, force: true })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function verifyPassword(userId: string, password: string): boolean {
|
||||||
|
const store = readStore()
|
||||||
|
const user = store.users.find((u) => u.id === userId)
|
||||||
|
if (!user) return false
|
||||||
|
if (user.isGuest) return true
|
||||||
|
if (!user.salt || !user.passwordHash) return false
|
||||||
|
return hashPassword(password, user.salt) === user.passwordHash
|
||||||
|
}
|
||||||
|
|
||||||
|
export function getUserDataRoot(userId: string) {
|
||||||
|
return getUserDir(userId)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function clearGuestUsers() {
|
||||||
|
const store = readStore()
|
||||||
|
const guests = store.users.filter((u) => u.isGuest)
|
||||||
|
if (guests.length === 0) return
|
||||||
|
store.users = store.users.filter((u) => !u.isGuest)
|
||||||
|
if (store.activeUserId && guests.some((u) => u.id === store.activeUserId)) {
|
||||||
|
store.activeUserId = store.users[0]?.id
|
||||||
|
}
|
||||||
|
writeStore(store)
|
||||||
|
for (const guest of guests) {
|
||||||
|
const dir = getUserDir(guest.id)
|
||||||
|
if (existsSync(dir)) {
|
||||||
|
rmSync(dir, { recursive: true, force: true })
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
24
packages/electron-app/electron/preload/index.cjs
Normal file
24
packages/electron-app/electron/preload/index.cjs
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
const { contextBridge, ipcRenderer } = require("electron")
|
||||||
|
|
||||||
|
const electronAPI = {
|
||||||
|
onCliStatus: (callback) => {
|
||||||
|
ipcRenderer.on("cli:status", (_, data) => callback(data))
|
||||||
|
return () => ipcRenderer.removeAllListeners("cli:status")
|
||||||
|
},
|
||||||
|
onCliError: (callback) => {
|
||||||
|
ipcRenderer.on("cli:error", (_, data) => callback(data))
|
||||||
|
return () => ipcRenderer.removeAllListeners("cli:error")
|
||||||
|
},
|
||||||
|
getCliStatus: () => ipcRenderer.invoke("cli:getStatus"),
|
||||||
|
restartCli: () => ipcRenderer.invoke("cli:restart"),
|
||||||
|
openDialog: (options) => ipcRenderer.invoke("dialog:open", options),
|
||||||
|
listUsers: () => ipcRenderer.invoke("users:list"),
|
||||||
|
getActiveUser: () => ipcRenderer.invoke("users:active"),
|
||||||
|
createUser: (payload) => ipcRenderer.invoke("users:create", payload),
|
||||||
|
updateUser: (payload) => ipcRenderer.invoke("users:update", payload),
|
||||||
|
deleteUser: (payload) => ipcRenderer.invoke("users:delete", payload),
|
||||||
|
createGuest: () => ipcRenderer.invoke("users:createGuest"),
|
||||||
|
loginUser: (payload) => ipcRenderer.invoke("users:login", payload),
|
||||||
|
}
|
||||||
|
|
||||||
|
contextBridge.exposeInMainWorld("electronAPI", electronAPI)
|
||||||
BIN
packages/electron-app/electron/resources/icon.icns
Normal file
BIN
packages/electron-app/electron/resources/icon.icns
Normal file
Binary file not shown.
BIN
packages/electron-app/electron/resources/icon.ico
Normal file
BIN
packages/electron-app/electron/resources/icon.ico
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 422 KiB |
BIN
packages/electron-app/electron/resources/icon.png
Normal file
BIN
packages/electron-app/electron/resources/icon.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.3 MiB |
7
packages/electron-app/electron/tsconfig.json
Normal file
7
packages/electron-app/electron/tsconfig.json
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
{
|
||||||
|
"extends": "../tsconfig.json",
|
||||||
|
"compilerOptions": {
|
||||||
|
"noEmit": true
|
||||||
|
},
|
||||||
|
"include": ["./**/*.ts", "./**/*.tsx"]
|
||||||
|
}
|
||||||
138
packages/electron-app/package.json
Normal file
138
packages/electron-app/package.json
Normal file
@@ -0,0 +1,138 @@
|
|||||||
|
{
|
||||||
|
"name": "@neuralnomads/codenomad-electron-app",
|
||||||
|
"version": "0.4.0",
|
||||||
|
"description": "CodeNomad - AI coding assistant",
|
||||||
|
"author": {
|
||||||
|
"name": "Neural Nomads",
|
||||||
|
"email": "codenomad@neuralnomads.ai"
|
||||||
|
},
|
||||||
|
"type": "module",
|
||||||
|
"main": "dist/main/main.js",
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "https://github.com/NeuralNomadsAI/CodeNomad.git"
|
||||||
|
},
|
||||||
|
"homepage": "https://github.com/NeuralNomadsAI/CodeNomad",
|
||||||
|
"scripts": {
|
||||||
|
"dev": "electron-vite dev",
|
||||||
|
"dev:electron": "cross-env NODE_ENV=development ELECTRON_ENABLE_LOGGING=1 NODE_OPTIONS=\"--import tsx\" electron electron/main/main.ts",
|
||||||
|
"build": "electron-vite build",
|
||||||
|
"typecheck": "tsc --noEmit -p tsconfig.json",
|
||||||
|
"preview": "electron-vite preview",
|
||||||
|
"build:binaries": "node scripts/build.js",
|
||||||
|
"build:mac": "node scripts/build.js mac",
|
||||||
|
"build:mac-x64": "node scripts/build.js mac-x64",
|
||||||
|
"build:mac-arm64": "node scripts/build.js mac-arm64",
|
||||||
|
"build:win": "node scripts/build.js win",
|
||||||
|
"build:win-arm64": "node scripts/build.js win-arm64",
|
||||||
|
"build:linux": "node scripts/build.js linux",
|
||||||
|
"build:linux-arm64": "node scripts/build.js linux-arm64",
|
||||||
|
"build:linux-rpm": "node scripts/build.js linux-rpm",
|
||||||
|
"build:all": "node scripts/build.js all",
|
||||||
|
"package:mac": "electron-builder --mac",
|
||||||
|
"package:win": "electron-builder --win",
|
||||||
|
"package:linux": "electron-builder --linux"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@neuralnomads/codenomad": "file:../server",
|
||||||
|
"@codenomad/ui": "file:../ui"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"7zip-bin": "^5.2.0",
|
||||||
|
"app-builder-bin": "^4.2.0",
|
||||||
|
"cross-env": "^7.0.3",
|
||||||
|
"electron": "39.0.0",
|
||||||
|
"electron-builder": "^24.0.0",
|
||||||
|
"electron-vite": "4.0.1",
|
||||||
|
"png2icons": "^2.0.1",
|
||||||
|
"pngjs": "^7.0.0",
|
||||||
|
"tsx": "^4.20.6",
|
||||||
|
"typescript": "^5.3.0",
|
||||||
|
"vite": "^5.0.0",
|
||||||
|
"vite-plugin-solid": "^2.10.0"
|
||||||
|
},
|
||||||
|
"build": {
|
||||||
|
"appId": "ai.opencode.client",
|
||||||
|
"productName": "CodeNomad",
|
||||||
|
"directories": {
|
||||||
|
"output": "release",
|
||||||
|
"buildResources": "electron/resources"
|
||||||
|
},
|
||||||
|
"files": [
|
||||||
|
"dist/**/*",
|
||||||
|
"package.json"
|
||||||
|
],
|
||||||
|
"extraResources": [
|
||||||
|
{
|
||||||
|
"from": "electron/resources",
|
||||||
|
"to": "",
|
||||||
|
"filter": [
|
||||||
|
"!icon.icns",
|
||||||
|
"!icon.ico"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"mac": {
|
||||||
|
"category": "public.app-category.developer-tools",
|
||||||
|
"target": [
|
||||||
|
{
|
||||||
|
"target": "zip",
|
||||||
|
"arch": [
|
||||||
|
"x64",
|
||||||
|
"arm64"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"artifactName": "CodeNomad-${version}-${os}-${arch}.${ext}",
|
||||||
|
"icon": "electron/resources/icon.icns"
|
||||||
|
},
|
||||||
|
"dmg": {
|
||||||
|
"contents": [
|
||||||
|
{
|
||||||
|
"x": 130,
|
||||||
|
"y": 220
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"x": 410,
|
||||||
|
"y": 220,
|
||||||
|
"type": "link",
|
||||||
|
"path": "/Applications"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"win": {
|
||||||
|
"target": [
|
||||||
|
{
|
||||||
|
"target": "zip",
|
||||||
|
"arch": [
|
||||||
|
"x64",
|
||||||
|
"arm64"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"artifactName": "CodeNomad-${version}-${os}-${arch}.${ext}",
|
||||||
|
"icon": "electron/resources/icon.ico"
|
||||||
|
},
|
||||||
|
"nsis": {
|
||||||
|
"oneClick": false,
|
||||||
|
"allowToChangeInstallationDirectory": true,
|
||||||
|
"createDesktopShortcut": true,
|
||||||
|
"createStartMenuShortcut": true
|
||||||
|
},
|
||||||
|
"linux": {
|
||||||
|
"target": [
|
||||||
|
{
|
||||||
|
"target": "zip",
|
||||||
|
"arch": [
|
||||||
|
"x64",
|
||||||
|
"arm64"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"artifactName": "CodeNomad-${version}-${os}-${arch}.${ext}",
|
||||||
|
"category": "Development",
|
||||||
|
"icon": "electron/resources/icon.png"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"private": true
|
||||||
|
}
|
||||||
131
packages/electron-app/scripts/build.js
Normal file
131
packages/electron-app/scripts/build.js
Normal file
@@ -0,0 +1,131 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
import { spawn } from "child_process"
|
||||||
|
import { existsSync } from "fs"
|
||||||
|
import { join } from "path"
|
||||||
|
import { fileURLToPath } from "url"
|
||||||
|
|
||||||
|
const __dirname = fileURLToPath(new URL(".", import.meta.url))
|
||||||
|
const appDir = join(__dirname, "..")
|
||||||
|
const workspaceRoot = join(appDir, "..", "..")
|
||||||
|
|
||||||
|
const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm"
|
||||||
|
const npxCmd = process.platform === "win32" ? "npx.cmd" : "npx"
|
||||||
|
const nodeModulesPath = join(appDir, "node_modules")
|
||||||
|
const workspaceNodeModulesPath = join(workspaceRoot, "node_modules")
|
||||||
|
|
||||||
|
const platforms = {
|
||||||
|
mac: {
|
||||||
|
args: ["--mac", "--x64", "--arm64"],
|
||||||
|
description: "macOS (Intel & Apple Silicon)",
|
||||||
|
},
|
||||||
|
"mac-x64": {
|
||||||
|
args: ["--mac", "--x64"],
|
||||||
|
description: "macOS (Intel only)",
|
||||||
|
},
|
||||||
|
"mac-arm64": {
|
||||||
|
args: ["--mac", "--arm64"],
|
||||||
|
description: "macOS (Apple Silicon only)",
|
||||||
|
},
|
||||||
|
win: {
|
||||||
|
args: ["--win", "--x64"],
|
||||||
|
description: "Windows (x64)",
|
||||||
|
},
|
||||||
|
"win-arm64": {
|
||||||
|
args: ["--win", "--arm64"],
|
||||||
|
description: "Windows (ARM64)",
|
||||||
|
},
|
||||||
|
linux: {
|
||||||
|
args: ["--linux", "--x64"],
|
||||||
|
description: "Linux (x64)",
|
||||||
|
},
|
||||||
|
"linux-arm64": {
|
||||||
|
args: ["--linux", "--arm64"],
|
||||||
|
description: "Linux (ARM64)",
|
||||||
|
},
|
||||||
|
"linux-rpm": {
|
||||||
|
args: ["--linux", "rpm", "--x64", "--arm64"],
|
||||||
|
description: "Linux RPM packages (x64 & ARM64)",
|
||||||
|
},
|
||||||
|
all: {
|
||||||
|
args: ["--mac", "--win", "--linux", "--x64", "--arm64"],
|
||||||
|
description: "All platforms (macOS, Windows, Linux)",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
function run(command, args, options = {}) {
|
||||||
|
return new Promise((resolve, reject) => {
|
||||||
|
const spawnOptions = {
|
||||||
|
cwd: appDir,
|
||||||
|
stdio: "inherit",
|
||||||
|
shell: process.platform === "win32",
|
||||||
|
...options,
|
||||||
|
env: { ...process.env, NODE_PATH: nodeModulesPath, ...(options.env || {}) },
|
||||||
|
}
|
||||||
|
|
||||||
|
const child = spawn(command, args, spawnOptions)
|
||||||
|
|
||||||
|
child.on("error", reject)
|
||||||
|
child.on("exit", (code) => {
|
||||||
|
if (code === 0) {
|
||||||
|
resolve(undefined)
|
||||||
|
} else {
|
||||||
|
reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`))
|
||||||
|
}
|
||||||
|
})
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function printAvailablePlatforms() {
|
||||||
|
console.error(`\nAvailable platforms:`)
|
||||||
|
for (const [name, cfg] of Object.entries(platforms)) {
|
||||||
|
console.error(` - ${name.padEnd(12)} : ${cfg.description}`)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function build(platform) {
|
||||||
|
const config = platforms[platform]
|
||||||
|
|
||||||
|
if (!config) {
|
||||||
|
console.error(`❌ Unknown platform: ${platform}`)
|
||||||
|
printAvailablePlatforms()
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log(`\n🔨 Building for: ${config.description}\n`)
|
||||||
|
|
||||||
|
try {
|
||||||
|
console.log("📦 Step 1/3: Building CLI dependency...\n")
|
||||||
|
await run(npmCmd, ["run", "build", "--workspace", "@neuralnomads/codenomad"], {
|
||||||
|
cwd: workspaceRoot,
|
||||||
|
env: { NODE_PATH: workspaceNodeModulesPath },
|
||||||
|
})
|
||||||
|
|
||||||
|
console.log("\n📦 Step 2/3: Building Electron app...\n")
|
||||||
|
await run(npmCmd, ["run", "build"])
|
||||||
|
|
||||||
|
console.log("\n📦 Step 3/3: Packaging binaries...\n")
|
||||||
|
const distPath = join(appDir, "dist")
|
||||||
|
if (!existsSync(distPath)) {
|
||||||
|
throw new Error("dist/ directory not found. Build failed.")
|
||||||
|
}
|
||||||
|
|
||||||
|
await run(npxCmd, ["electron-builder", "--publish=never", ...config.args])
|
||||||
|
|
||||||
|
console.log("\n✅ Build complete!")
|
||||||
|
console.log(`📁 Binaries available in: ${join(appDir, "release")}\n`)
|
||||||
|
} catch (error) {
|
||||||
|
console.error("\n❌ Build failed:", error)
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const platform = process.argv[2] || "mac"
|
||||||
|
|
||||||
|
console.log(`
|
||||||
|
╔════════════════════════════════════════╗
|
||||||
|
║ CodeNomad - Binary Builder ║
|
||||||
|
╚════════════════════════════════════════╝
|
||||||
|
`)
|
||||||
|
|
||||||
|
await build(platform)
|
||||||
30
packages/electron-app/scripts/dev.sh
Normal file
30
packages/electron-app/scripts/dev.sh
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
# ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
|
||||||
|
if ! command -v node >/dev/null 2>&1; then
|
||||||
|
echo "Node.js is required to run the development environment." >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Resolve the Electron binary via Node to avoid Bun resolution hiccups
|
||||||
|
ELECTRON_EXEC_PATH="$(node -p "require('electron')")"
|
||||||
|
|
||||||
|
if [[ -z "${ELECTRON_EXEC_PATH}" ]]; then
|
||||||
|
echo "Failed to resolve the Electron binary path." >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
export NODE_ENV="${NODE_ENV:-development}"
|
||||||
|
export ELECTRON_EXEC_PATH
|
||||||
|
|
||||||
|
# ELECTRON_VITE_BIN="$ROOT_DIR/node_modules/.bin/electron-vite"
|
||||||
|
|
||||||
|
if [[ ! -x "${ELECTRON_VITE_BIN}" ]]; then
|
||||||
|
echo "electron-vite binary not found. Have you installed dependencies?" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
exec "${ELECTRON_VITE_BIN}" dev "$@"
|
||||||
155
packages/electron-app/scripts/generate-icons.js
Normal file
155
packages/electron-app/scripts/generate-icons.js
Normal file
@@ -0,0 +1,155 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
import { mkdirSync, readFileSync, writeFileSync } from "fs"
|
||||||
|
import { resolve, join, basename } from "path"
|
||||||
|
import { PNG } from "pngjs"
|
||||||
|
import png2icons from "png2icons"
|
||||||
|
|
||||||
|
function printUsage() {
|
||||||
|
console.log(`\nUsage: node scripts/generate-icons.js <input.png> [outputDir] [--name icon] [--radius 0.22]\n\nOptions:\n --name Base filename for generated assets (default: icon)\n --radius Corner radius ratio between 0 and 0.5 (default: 0.22)\n --help Show this message\n`)
|
||||||
|
}
|
||||||
|
|
||||||
|
function parseArgs(argv) {
|
||||||
|
const args = [...argv]
|
||||||
|
const options = {
|
||||||
|
name: "icon",
|
||||||
|
radius: 0.22,
|
||||||
|
}
|
||||||
|
|
||||||
|
for (let i = 0; i < args.length; i++) {
|
||||||
|
const token = args[i]
|
||||||
|
if (token === "--help" || token === "-h") {
|
||||||
|
options.help = true
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if (token === "--name" && i + 1 < args.length) {
|
||||||
|
options.name = args[i + 1]
|
||||||
|
i++
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if (token === "--radius" && i + 1 < args.length) {
|
||||||
|
options.radius = Number(args[i + 1])
|
||||||
|
i++
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if (!options.input) {
|
||||||
|
options.input = token
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if (!options.output) {
|
||||||
|
options.output = token
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return options
|
||||||
|
}
|
||||||
|
|
||||||
|
function applyRoundedCorners(png, ratio) {
|
||||||
|
const { width, height, data } = png
|
||||||
|
const clamped = Math.max(0, Math.min(ratio, 0.5))
|
||||||
|
if (clamped === 0) return png
|
||||||
|
|
||||||
|
const radius = Math.max(1, Math.min(width, height) * clamped)
|
||||||
|
const radiusSq = radius * radius
|
||||||
|
const rightThreshold = width - radius
|
||||||
|
const bottomThreshold = height - radius
|
||||||
|
|
||||||
|
for (let y = 0; y < height; y++) {
|
||||||
|
for (let x = 0; x < width; x++) {
|
||||||
|
const idx = (width * y + x) * 4
|
||||||
|
if (data[idx + 3] === 0) continue
|
||||||
|
|
||||||
|
const px = x + 0.5
|
||||||
|
const py = y + 0.5
|
||||||
|
|
||||||
|
const inLeft = px < radius
|
||||||
|
const inRight = px > rightThreshold
|
||||||
|
const inTop = py < radius
|
||||||
|
const inBottom = py > bottomThreshold
|
||||||
|
|
||||||
|
let outside = false
|
||||||
|
|
||||||
|
if (inLeft && inTop) {
|
||||||
|
outside = (px - radius) ** 2 + (py - radius) ** 2 > radiusSq
|
||||||
|
} else if (inRight && inTop) {
|
||||||
|
outside = (px - rightThreshold) ** 2 + (py - radius) ** 2 > radiusSq
|
||||||
|
} else if (inLeft && inBottom) {
|
||||||
|
outside = (px - radius) ** 2 + (py - bottomThreshold) ** 2 > radiusSq
|
||||||
|
} else if (inRight && inBottom) {
|
||||||
|
outside = (px - rightThreshold) ** 2 + (py - bottomThreshold) ** 2 > radiusSq
|
||||||
|
}
|
||||||
|
|
||||||
|
if (outside) {
|
||||||
|
data[idx + 3] = 0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return png
|
||||||
|
}
|
||||||
|
|
||||||
|
async function main() {
|
||||||
|
const args = parseArgs(process.argv.slice(2))
|
||||||
|
|
||||||
|
if (args.help || !args.input) {
|
||||||
|
printUsage()
|
||||||
|
process.exit(args.help ? 0 : 1)
|
||||||
|
}
|
||||||
|
|
||||||
|
const inputPath = resolve(args.input)
|
||||||
|
const outputDir = resolve(args.output || "electron/resources")
|
||||||
|
const baseName = args.name || basename(inputPath, ".png")
|
||||||
|
const radiusRatio = Number.isFinite(args.radius) ? args.radius : 0.22
|
||||||
|
|
||||||
|
let buffer
|
||||||
|
try {
|
||||||
|
buffer = readFileSync(inputPath)
|
||||||
|
} catch (error) {
|
||||||
|
console.error(`Failed to read ${inputPath}:`, error.message)
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
let png
|
||||||
|
try {
|
||||||
|
png = PNG.sync.read(buffer)
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Input must be a valid PNG:", error.message)
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
applyRoundedCorners(png, radiusRatio)
|
||||||
|
|
||||||
|
const roundedBuffer = PNG.sync.write(png)
|
||||||
|
|
||||||
|
try {
|
||||||
|
mkdirSync(outputDir, { recursive: true })
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Failed to create output directory:", error.message)
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
const pngPath = join(outputDir, `${baseName}.png`)
|
||||||
|
writeFileSync(pngPath, roundedBuffer)
|
||||||
|
|
||||||
|
const icns = png2icons.createICNS(roundedBuffer, png2icons.BICUBIC, false)
|
||||||
|
if (!icns) {
|
||||||
|
console.error("Failed to create ICNS file. Make sure the source PNG is at least 256x256.")
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
writeFileSync(join(outputDir, `${baseName}.icns`), icns)
|
||||||
|
|
||||||
|
const ico = png2icons.createICO(roundedBuffer, png2icons.BICUBIC, false)
|
||||||
|
if (!ico) {
|
||||||
|
console.error("Failed to create ICO file. Make sure the source PNG is at least 256x256.")
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
writeFileSync(join(outputDir, `${baseName}.ico`), ico)
|
||||||
|
|
||||||
|
console.log(`\nGenerated assets in ${outputDir}:`)
|
||||||
|
console.log(`- ${baseName}.png`)
|
||||||
|
console.log(`- ${baseName}.icns`)
|
||||||
|
console.log(`- ${baseName}.ico`)
|
||||||
|
}
|
||||||
|
|
||||||
|
main()
|
||||||
18
packages/electron-app/tsconfig.json
Normal file
18
packages/electron-app/tsconfig.json
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"target": "ES2020",
|
||||||
|
"module": "ESNext",
|
||||||
|
"lib": ["ES2020"],
|
||||||
|
"moduleResolution": "bundler",
|
||||||
|
"resolveJsonModule": true,
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"strict": true,
|
||||||
|
"esModuleInterop": true,
|
||||||
|
"skipLibCheck": true,
|
||||||
|
"forceConsistentCasingInFileNames": true,
|
||||||
|
"isolatedModules": true,
|
||||||
|
"noEmit": true
|
||||||
|
},
|
||||||
|
"include": ["electron/**/*.ts", "electron.vite.config.ts"],
|
||||||
|
"exclude": ["node_modules", "dist"]
|
||||||
|
}
|
||||||
3
packages/opencode-config/opencode.jsonc
Normal file
3
packages/opencode-config/opencode.jsonc
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://opencode.ai/config.json"
|
||||||
|
}
|
||||||
8
packages/opencode-config/plugin/hello.js
Normal file
8
packages/opencode-config/plugin/hello.js
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
// NomadArch Plugin Template
|
||||||
|
// This file is a placeholder. OpenCode plugins are optional.
|
||||||
|
// To create a plugin, see: https://opencode.ai/docs/plugins
|
||||||
|
|
||||||
|
export async function init() {
|
||||||
|
// No-op placeholder - customize as needed
|
||||||
|
return {}
|
||||||
|
}
|
||||||
1
packages/server/.gitignore
vendored
Normal file
1
packages/server/.gitignore
vendored
Normal file
@@ -0,0 +1 @@
|
|||||||
|
public/
|
||||||
5
packages/server/.npmignore
Normal file
5
packages/server/.npmignore
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
node_modules
|
||||||
|
scripts/
|
||||||
|
src/
|
||||||
|
tsconfig.json
|
||||||
|
*.tsbuildinfo
|
||||||
58
packages/server/README.md
Normal file
58
packages/server/README.md
Normal file
@@ -0,0 +1,58 @@
|
|||||||
|
# CodeNomad Server
|
||||||
|
|
||||||
|
**CodeNomad Server** is the high-performance engine behind the CodeNomad cockpit. It transforms your machine into a robust development host, managing the lifecycle of multiple OpenCode instances and providing the low-latency data streams that long-haul builders demand. It bridges your local filesystem with the UI, ensuring that whether you are on localhost or a remote tunnel, you have the speed, clarity, and control of a native workspace.
|
||||||
|
|
||||||
|
## Features & Capabilities
|
||||||
|
|
||||||
|
### 🌍 Deployment Freedom
|
||||||
|
- **Remote Access**: Host CodeNomad on a powerful workstation and access it from your lightweight laptop.
|
||||||
|
- **Code Anywhere**: Tunnel in via VPN or SSH to code securely from coffee shops or while traveling.
|
||||||
|
- **Multi-Device**: The responsive web client works on tablets and iPads, turning any screen into a dev terminal.
|
||||||
|
- **Always-On**: Run as a background service so your sessions are always ready when you connect.
|
||||||
|
|
||||||
|
### ⚡️ Workspace Power
|
||||||
|
- **Multi-Instance**: Juggle multiple OpenCode sessions side-by-side with per-instance tabs.
|
||||||
|
- **Long-Context Native**: Scroll through massive transcripts without hitches.
|
||||||
|
- **Deep Task Awareness**: Monitor background tasks and child sessions without losing your flow.
|
||||||
|
- **Command Palette**: A single, global palette to jump tabs, launch tools, and fire shortcuts.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
- **OpenCode**: `opencode` must be installed and configured on your system.
|
||||||
|
- Node.js 18+ and npm (for running or building from source).
|
||||||
|
- A workspace folder on disk you want to serve.
|
||||||
|
- Optional: a Chromium-based browser if you want `--launch` to open the UI automatically.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### Run via npx (Recommended)
|
||||||
|
You can run CodeNomad directly without installing it:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npx @neuralnomads/codenomad --launch
|
||||||
|
```
|
||||||
|
|
||||||
|
### Install Globally
|
||||||
|
Or install it globally to use the `codenomad` command:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install -g @neuralnomads/codenomad
|
||||||
|
codenomad --launch
|
||||||
|
```
|
||||||
|
|
||||||
|
### Common Flags
|
||||||
|
You can configure the server using flags or environment variables:
|
||||||
|
|
||||||
|
| Flag | Env Variable | Description |
|
||||||
|
|------|--------------|-------------|
|
||||||
|
| `--port <number>` | `CLI_PORT` | HTTP port (default 9898) |
|
||||||
|
| `--host <addr>` | `CLI_HOST` | Interface to bind (default 127.0.0.1) |
|
||||||
|
| `--workspace-root <path>` | `CLI_WORKSPACE_ROOT` | Default root for new workspaces |
|
||||||
|
| `--unrestricted-root` | `CLI_UNRESTRICTED_ROOT` | Allow full-filesystem browsing |
|
||||||
|
| `--config <path>` | `CLI_CONFIG` | Config file location |
|
||||||
|
| `--launch` | `CLI_LAUNCH` | Open the UI in a Chromium-based browser |
|
||||||
|
| `--log-level <level>` | `CLI_LOG_LEVEL` | Logging level (trace, debug, info, warn, error) |
|
||||||
|
|
||||||
|
### Data Storage
|
||||||
|
- **Config**: `~/.config/codenomad/config.json`
|
||||||
|
- **Instance Data**: `~/.config/codenomad/instances` (chat history, etc.)
|
||||||
|
|
||||||
1333
packages/server/package-lock.json
generated
Normal file
1333
packages/server/package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
44
packages/server/package.json
Normal file
44
packages/server/package.json
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
{
|
||||||
|
"name": "@neuralnomads/codenomad",
|
||||||
|
"version": "0.4.0",
|
||||||
|
"description": "CodeNomad Server",
|
||||||
|
"author": {
|
||||||
|
"name": "Neural Nomads",
|
||||||
|
"email": "codenomad@neuralnomads.ai"
|
||||||
|
},
|
||||||
|
"repository": {
|
||||||
|
"type": "git",
|
||||||
|
"url": "https://github.com/NeuralNomadsAI/CodeNomad.git"
|
||||||
|
},
|
||||||
|
"type": "module",
|
||||||
|
"main": "dist/index.js",
|
||||||
|
"bin": {
|
||||||
|
"codenomad": "dist/bin.js"
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"build": "npm run build:ui && npm run prepare-ui && tsc -p tsconfig.json && npm run prepare-config",
|
||||||
|
"build:ui": "npm run build --prefix ../ui",
|
||||||
|
"prepare-ui": "node ./scripts/copy-ui-dist.mjs",
|
||||||
|
"prepare-config": "node ./scripts/copy-opencode-config.mjs",
|
||||||
|
"dev": "cross-env CODENOMAD_DEV=1 CLI_UI_DEV_SERVER=http://localhost:3000 tsx src/index.ts",
|
||||||
|
"typecheck": "tsc --noEmit -p tsconfig.json"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@fastify/cors": "^8.5.0",
|
||||||
|
"@fastify/reply-from": "^9.8.0",
|
||||||
|
"@fastify/static": "^7.0.4",
|
||||||
|
"commander": "^12.1.0",
|
||||||
|
"fastify": "^4.28.1",
|
||||||
|
"fuzzysort": "^2.0.4",
|
||||||
|
"pino": "^9.4.0",
|
||||||
|
"ulid": "^3.0.2",
|
||||||
|
"undici": "^6.19.8",
|
||||||
|
"zod": "^3.23.8"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"cross-env": "^7.0.3",
|
||||||
|
"ts-node": "^10.9.2",
|
||||||
|
"tsx": "^4.20.6",
|
||||||
|
"typescript": "^5.6.3"
|
||||||
|
}
|
||||||
|
}
|
||||||
21
packages/server/scripts/copy-opencode-config.mjs
Normal file
21
packages/server/scripts/copy-opencode-config.mjs
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
import { cpSync, existsSync, mkdirSync, rmSync } from "fs"
|
||||||
|
import path from "path"
|
||||||
|
import { fileURLToPath } from "url"
|
||||||
|
|
||||||
|
const __filename = fileURLToPath(import.meta.url)
|
||||||
|
const __dirname = path.dirname(__filename)
|
||||||
|
const cliRoot = path.resolve(__dirname, "..")
|
||||||
|
const sourceDir = path.resolve(cliRoot, "../opencode-config")
|
||||||
|
const targetDir = path.resolve(cliRoot, "dist/opencode-config")
|
||||||
|
|
||||||
|
if (!existsSync(sourceDir)) {
|
||||||
|
console.error(`[copy-opencode-config] Missing source directory at ${sourceDir}`)
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
rmSync(targetDir, { recursive: true, force: true })
|
||||||
|
mkdirSync(path.dirname(targetDir), { recursive: true })
|
||||||
|
cpSync(sourceDir, targetDir, { recursive: true })
|
||||||
|
|
||||||
|
console.log(`[copy-opencode-config] Copied ${sourceDir} -> ${targetDir}`)
|
||||||
21
packages/server/scripts/copy-ui-dist.mjs
Normal file
21
packages/server/scripts/copy-ui-dist.mjs
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
import { cpSync, existsSync, mkdirSync, rmSync } from "fs"
|
||||||
|
import path from "path"
|
||||||
|
import { fileURLToPath } from "url"
|
||||||
|
|
||||||
|
const __filename = fileURLToPath(import.meta.url)
|
||||||
|
const __dirname = path.dirname(__filename)
|
||||||
|
const cliRoot = path.resolve(__dirname, "..")
|
||||||
|
const uiDistDir = path.resolve(cliRoot, "../ui/src/renderer/dist")
|
||||||
|
const targetDir = path.resolve(cliRoot, "public")
|
||||||
|
|
||||||
|
if (!existsSync(uiDistDir)) {
|
||||||
|
console.error(`[copy-ui-dist] Expected UI build artifacts at ${uiDistDir}. Run the UI build before bundling the CLI.`)
|
||||||
|
process.exit(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
rmSync(targetDir, { recursive: true, force: true })
|
||||||
|
mkdirSync(targetDir, { recursive: true })
|
||||||
|
cpSync(uiDistDir, targetDir, { recursive: true })
|
||||||
|
|
||||||
|
console.log(`[copy-ui-dist] Copied UI bundle from ${uiDistDir} -> ${targetDir}`)
|
||||||
318
packages/server/src/api-types.ts
Normal file
318
packages/server/src/api-types.ts
Normal file
@@ -0,0 +1,318 @@
|
|||||||
|
import type {
|
||||||
|
AgentModelSelection,
|
||||||
|
AgentModelSelections,
|
||||||
|
ConfigFile,
|
||||||
|
ModelPreference,
|
||||||
|
OpenCodeBinary,
|
||||||
|
Preferences,
|
||||||
|
RecentFolder,
|
||||||
|
} from "./config/schema"
|
||||||
|
|
||||||
|
export type TaskStatus = "completed" | "interrupted" | "in-progress" | "pending"
|
||||||
|
|
||||||
|
export interface Task {
|
||||||
|
id: string
|
||||||
|
title: string
|
||||||
|
status: TaskStatus
|
||||||
|
timestamp: number
|
||||||
|
messageIds?: string[] // IDs of messages associated with this task
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface SessionTasks {
|
||||||
|
[sessionId: string]: Task[]
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface SkillSelection {
|
||||||
|
id: string
|
||||||
|
name: string
|
||||||
|
description?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface SkillDescriptor {
|
||||||
|
id: string
|
||||||
|
name: string
|
||||||
|
description?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface SkillDetail extends SkillDescriptor {
|
||||||
|
content: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface SkillCatalogResponse {
|
||||||
|
skills: SkillDescriptor[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Canonical HTTP/SSE contract for the CLI server.
|
||||||
|
* These types are consumed by both the CLI implementation and any UI clients.
|
||||||
|
*/
|
||||||
|
|
||||||
|
export type WorkspaceStatus = "starting" | "ready" | "stopped" | "error"
|
||||||
|
|
||||||
|
export interface WorkspaceDescriptor {
|
||||||
|
id: string
|
||||||
|
/** Absolute path on the server host. */
|
||||||
|
path: string
|
||||||
|
name?: string
|
||||||
|
status: WorkspaceStatus
|
||||||
|
/** PID/port are populated when the workspace is running. */
|
||||||
|
pid?: number
|
||||||
|
port?: number
|
||||||
|
/** Canonical proxy path the CLI exposes for this instance. */
|
||||||
|
proxyPath: string
|
||||||
|
/** Identifier of the binary resolved from config. */
|
||||||
|
binaryId: string
|
||||||
|
binaryLabel: string
|
||||||
|
binaryVersion?: string
|
||||||
|
createdAt: string
|
||||||
|
updatedAt: string
|
||||||
|
/** Present when `status` is "error". */
|
||||||
|
error?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface WorkspaceCreateRequest {
|
||||||
|
path: string
|
||||||
|
name?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export type WorkspaceCreateResponse = WorkspaceDescriptor
|
||||||
|
export type WorkspaceListResponse = WorkspaceDescriptor[]
|
||||||
|
export type WorkspaceDetailResponse = WorkspaceDescriptor
|
||||||
|
|
||||||
|
export interface WorkspaceExportRequest {
|
||||||
|
destination: string
|
||||||
|
includeConfig?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface WorkspaceExportResponse {
|
||||||
|
destination: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface WorkspaceImportRequest {
|
||||||
|
source: string
|
||||||
|
destination: string
|
||||||
|
includeConfig?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
export type WorkspaceImportResponse = WorkspaceDescriptor
|
||||||
|
|
||||||
|
export interface WorkspaceMcpConfig {
|
||||||
|
mcpServers?: Record<string, unknown>
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface WorkspaceMcpConfigResponse {
|
||||||
|
path: string
|
||||||
|
exists: boolean
|
||||||
|
config: WorkspaceMcpConfig
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface WorkspaceMcpConfigRequest {
|
||||||
|
config: WorkspaceMcpConfig
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface WorkspaceDeleteResponse {
|
||||||
|
id: string
|
||||||
|
status: WorkspaceStatus
|
||||||
|
}
|
||||||
|
|
||||||
|
export type LogLevel = "debug" | "info" | "warn" | "error"
|
||||||
|
|
||||||
|
export interface WorkspaceLogEntry {
|
||||||
|
workspaceId: string
|
||||||
|
timestamp: string
|
||||||
|
level: LogLevel
|
||||||
|
message: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface FileSystemEntry {
|
||||||
|
name: string
|
||||||
|
/** Path relative to the CLI server root ("." represents the root itself). */
|
||||||
|
path: string
|
||||||
|
/** Absolute path when available (unrestricted listings). */
|
||||||
|
absolutePath?: string
|
||||||
|
type: "file" | "directory"
|
||||||
|
size?: number
|
||||||
|
/** ISO timestamp of last modification when available. */
|
||||||
|
modifiedAt?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export type FileSystemScope = "restricted" | "unrestricted"
|
||||||
|
export type FileSystemPathKind = "relative" | "absolute" | "drives"
|
||||||
|
|
||||||
|
export interface FileSystemListingMetadata {
|
||||||
|
scope: FileSystemScope
|
||||||
|
/** Canonical identifier of the current view ("." for restricted roots, absolute paths otherwise). */
|
||||||
|
currentPath: string
|
||||||
|
/** Optional parent path if navigation upward is allowed. */
|
||||||
|
parentPath?: string
|
||||||
|
/** Absolute path representing the root or origin point for this listing. */
|
||||||
|
rootPath: string
|
||||||
|
/** Absolute home directory of the CLI host (useful defaults for unrestricted mode). */
|
||||||
|
homePath: string
|
||||||
|
/** Human-friendly label for the current path. */
|
||||||
|
displayPath: string
|
||||||
|
/** Indicates whether entry paths are relative, absolute, or represent drive roots. */
|
||||||
|
pathKind: FileSystemPathKind
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface FileSystemListResponse {
|
||||||
|
entries: FileSystemEntry[]
|
||||||
|
metadata: FileSystemListingMetadata
|
||||||
|
}
|
||||||
|
|
||||||
|
export const WINDOWS_DRIVES_ROOT = "__drives__"
|
||||||
|
|
||||||
|
export interface WorkspaceFileResponse {
|
||||||
|
workspaceId: string
|
||||||
|
relativePath: string
|
||||||
|
/** UTF-8 file contents; binary files should be base64 encoded by the caller. */
|
||||||
|
contents: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export type WorkspaceFileSearchResponse = FileSystemEntry[]
|
||||||
|
|
||||||
|
export interface WorkspaceGitStatusEntry {
|
||||||
|
path: string
|
||||||
|
status: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface WorkspaceGitStatus {
|
||||||
|
isRepo: boolean
|
||||||
|
branch: string | null
|
||||||
|
ahead: number
|
||||||
|
behind: number
|
||||||
|
changes: WorkspaceGitStatusEntry[]
|
||||||
|
error?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface InstanceData {
|
||||||
|
messageHistory: string[]
|
||||||
|
agentModelSelections: AgentModelSelection
|
||||||
|
sessionTasks?: SessionTasks // Multi-task chat support: tasks per session
|
||||||
|
sessionSkills?: Record<string, SkillSelection[]> // Selected skills per session
|
||||||
|
customAgents?: Array<{
|
||||||
|
name: string
|
||||||
|
description?: string
|
||||||
|
prompt: string
|
||||||
|
}>
|
||||||
|
}
|
||||||
|
|
||||||
|
export type InstanceStreamStatus = "connecting" | "connected" | "error" | "disconnected"
|
||||||
|
|
||||||
|
export interface InstanceStreamEvent {
|
||||||
|
type: string
|
||||||
|
properties?: Record<string, unknown>
|
||||||
|
[key: string]: unknown
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface BinaryRecord {
|
||||||
|
id: string
|
||||||
|
path: string
|
||||||
|
label: string
|
||||||
|
version?: string
|
||||||
|
|
||||||
|
/** Indicates that this binary will be picked when workspaces omit an explicit choice. */
|
||||||
|
isDefault: boolean
|
||||||
|
lastValidatedAt?: string
|
||||||
|
validationError?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export type AppConfig = ConfigFile
|
||||||
|
export type AppConfigResponse = AppConfig
|
||||||
|
export type AppConfigUpdateRequest = Partial<AppConfig>
|
||||||
|
|
||||||
|
export interface BinaryListResponse {
|
||||||
|
binaries: BinaryRecord[]
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface BinaryCreateRequest {
|
||||||
|
path: string
|
||||||
|
label?: string
|
||||||
|
makeDefault?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface BinaryUpdateRequest {
|
||||||
|
label?: string
|
||||||
|
makeDefault?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface BinaryValidationResult {
|
||||||
|
valid: boolean
|
||||||
|
version?: string
|
||||||
|
error?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export type WorkspaceEventType =
|
||||||
|
| "workspace.created"
|
||||||
|
| "workspace.started"
|
||||||
|
| "workspace.error"
|
||||||
|
| "workspace.stopped"
|
||||||
|
| "workspace.log"
|
||||||
|
| "config.appChanged"
|
||||||
|
| "config.binariesChanged"
|
||||||
|
| "instance.dataChanged"
|
||||||
|
| "instance.event"
|
||||||
|
| "instance.eventStatus"
|
||||||
|
| "app.releaseAvailable"
|
||||||
|
|
||||||
|
export type WorkspaceEventPayload =
|
||||||
|
| { type: "workspace.created"; workspace: WorkspaceDescriptor }
|
||||||
|
| { type: "workspace.started"; workspace: WorkspaceDescriptor }
|
||||||
|
| { type: "workspace.error"; workspace: WorkspaceDescriptor }
|
||||||
|
| { type: "workspace.stopped"; workspaceId: string }
|
||||||
|
| { type: "workspace.log"; entry: WorkspaceLogEntry }
|
||||||
|
| { type: "config.appChanged"; config: AppConfig }
|
||||||
|
| { type: "config.binariesChanged"; binaries: BinaryRecord[] }
|
||||||
|
| { type: "instance.dataChanged"; instanceId: string; data: InstanceData }
|
||||||
|
| { type: "instance.event"; instanceId: string; event: InstanceStreamEvent }
|
||||||
|
| { type: "instance.eventStatus"; instanceId: string; status: InstanceStreamStatus; reason?: string }
|
||||||
|
| { type: "app.releaseAvailable"; release: LatestReleaseInfo }
|
||||||
|
|
||||||
|
export interface NetworkAddress {
|
||||||
|
ip: string
|
||||||
|
family: "ipv4" | "ipv6"
|
||||||
|
scope: "external" | "internal" | "loopback"
|
||||||
|
url: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface LatestReleaseInfo {
|
||||||
|
version: string
|
||||||
|
tag: string
|
||||||
|
url: string
|
||||||
|
channel: "stable" | "dev"
|
||||||
|
publishedAt?: string
|
||||||
|
notes?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ServerMeta {
|
||||||
|
/** Base URL clients should target for REST calls (useful for Electron embedding). */
|
||||||
|
httpBaseUrl: string
|
||||||
|
/** SSE endpoint advertised to clients (`/api/events` by default). */
|
||||||
|
eventsUrl: string
|
||||||
|
/** Host the server is bound to (e.g., 127.0.0.1 or 0.0.0.0). */
|
||||||
|
host: string
|
||||||
|
/** Listening mode derived from host binding. */
|
||||||
|
listeningMode: "local" | "all"
|
||||||
|
/** Actual port in use after binding. */
|
||||||
|
port: number
|
||||||
|
/** Display label for the host (e.g., hostname or friendly name). */
|
||||||
|
hostLabel: string
|
||||||
|
/** Absolute path of the filesystem root exposed to clients. */
|
||||||
|
workspaceRoot: string
|
||||||
|
/** Reachable addresses for this server, external first. */
|
||||||
|
addresses: NetworkAddress[]
|
||||||
|
/** Optional metadata about the most recent public release. */
|
||||||
|
latestRelease?: LatestReleaseInfo
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface PortAvailabilityResponse {
|
||||||
|
port: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export type {
|
||||||
|
Preferences,
|
||||||
|
ModelPreference,
|
||||||
|
AgentModelSelections,
|
||||||
|
RecentFolder,
|
||||||
|
OpenCodeBinary,
|
||||||
|
}
|
||||||
29
packages/server/src/bin.ts
Normal file
29
packages/server/src/bin.ts
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
|
||||||
|
import { spawn } from "child_process"
|
||||||
|
import path from "path"
|
||||||
|
import { fileURLToPath, pathToFileURL } from "url"
|
||||||
|
|
||||||
|
const __filename = fileURLToPath(import.meta.url)
|
||||||
|
const __dirname = path.dirname(__filename)
|
||||||
|
const cliEntry = path.join(__dirname, "index.js")
|
||||||
|
const loaderFileUrl = pathToFileURL(path.join(__dirname, "loader.js")).href
|
||||||
|
const registerScript = `import { register } from "node:module"; import { pathToFileURL } from "node:url"; register("${encodeURI(loaderFileUrl)}", pathToFileURL("./"));`
|
||||||
|
const loaderArg = `data:text/javascript,${registerScript}`
|
||||||
|
|
||||||
|
const child = spawn(process.execPath, ["--import", loaderArg, cliEntry, ...process.argv.slice(2)], {
|
||||||
|
stdio: "inherit",
|
||||||
|
})
|
||||||
|
|
||||||
|
child.on("exit", (code, signal) => {
|
||||||
|
if (signal) {
|
||||||
|
process.kill(process.pid, signal)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
process.exit(code ?? 0)
|
||||||
|
})
|
||||||
|
|
||||||
|
child.on("error", (error) => {
|
||||||
|
console.error("Failed to launch CLI runtime", error)
|
||||||
|
process.exit(1)
|
||||||
|
})
|
||||||
156
packages/server/src/config/binaries.ts
Normal file
156
packages/server/src/config/binaries.ts
Normal file
@@ -0,0 +1,156 @@
|
|||||||
|
import {
|
||||||
|
BinaryCreateRequest,
|
||||||
|
BinaryRecord,
|
||||||
|
BinaryUpdateRequest,
|
||||||
|
BinaryValidationResult,
|
||||||
|
} from "../api-types"
|
||||||
|
import { ConfigStore } from "./store"
|
||||||
|
import { EventBus } from "../events/bus"
|
||||||
|
import type { ConfigFile } from "./schema"
|
||||||
|
import { Logger } from "../logger"
|
||||||
|
|
||||||
|
export class BinaryRegistry {
|
||||||
|
constructor(
|
||||||
|
private readonly configStore: ConfigStore,
|
||||||
|
private readonly eventBus: EventBus | undefined,
|
||||||
|
private readonly logger: Logger,
|
||||||
|
) {}
|
||||||
|
|
||||||
|
list(): BinaryRecord[] {
|
||||||
|
return this.mapRecords()
|
||||||
|
}
|
||||||
|
|
||||||
|
resolveDefault(): BinaryRecord {
|
||||||
|
const binaries = this.mapRecords()
|
||||||
|
if (binaries.length === 0) {
|
||||||
|
this.logger.warn("No configured binaries found, falling back to opencode")
|
||||||
|
return this.buildFallbackRecord("opencode")
|
||||||
|
}
|
||||||
|
return binaries.find((binary) => binary.isDefault) ?? binaries[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
create(request: BinaryCreateRequest): BinaryRecord {
|
||||||
|
this.logger.debug({ path: request.path }, "Registering OpenCode binary")
|
||||||
|
const entry = {
|
||||||
|
path: request.path,
|
||||||
|
version: undefined,
|
||||||
|
lastUsed: Date.now(),
|
||||||
|
label: request.label,
|
||||||
|
}
|
||||||
|
|
||||||
|
const config = this.configStore.get()
|
||||||
|
const nextConfig = this.cloneConfig(config)
|
||||||
|
const deduped = nextConfig.opencodeBinaries.filter((binary) => binary.path !== request.path)
|
||||||
|
nextConfig.opencodeBinaries = [entry, ...deduped]
|
||||||
|
|
||||||
|
if (request.makeDefault) {
|
||||||
|
nextConfig.preferences.lastUsedBinary = request.path
|
||||||
|
}
|
||||||
|
|
||||||
|
this.configStore.replace(nextConfig)
|
||||||
|
const record = this.getById(request.path)
|
||||||
|
this.emitChange()
|
||||||
|
return record
|
||||||
|
}
|
||||||
|
|
||||||
|
update(id: string, updates: BinaryUpdateRequest): BinaryRecord {
|
||||||
|
this.logger.debug({ id }, "Updating OpenCode binary")
|
||||||
|
const config = this.configStore.get()
|
||||||
|
const nextConfig = this.cloneConfig(config)
|
||||||
|
nextConfig.opencodeBinaries = nextConfig.opencodeBinaries.map((binary) =>
|
||||||
|
binary.path === id ? { ...binary, label: updates.label ?? binary.label } : binary,
|
||||||
|
)
|
||||||
|
|
||||||
|
if (updates.makeDefault) {
|
||||||
|
nextConfig.preferences.lastUsedBinary = id
|
||||||
|
}
|
||||||
|
|
||||||
|
this.configStore.replace(nextConfig)
|
||||||
|
const record = this.getById(id)
|
||||||
|
this.emitChange()
|
||||||
|
return record
|
||||||
|
}
|
||||||
|
|
||||||
|
remove(id: string) {
|
||||||
|
this.logger.debug({ id }, "Removing OpenCode binary")
|
||||||
|
const config = this.configStore.get()
|
||||||
|
const nextConfig = this.cloneConfig(config)
|
||||||
|
const remaining = nextConfig.opencodeBinaries.filter((binary) => binary.path !== id)
|
||||||
|
nextConfig.opencodeBinaries = remaining
|
||||||
|
|
||||||
|
if (nextConfig.preferences.lastUsedBinary === id) {
|
||||||
|
nextConfig.preferences.lastUsedBinary = remaining[0]?.path
|
||||||
|
}
|
||||||
|
|
||||||
|
this.configStore.replace(nextConfig)
|
||||||
|
this.emitChange()
|
||||||
|
}
|
||||||
|
|
||||||
|
validatePath(path: string): BinaryValidationResult {
|
||||||
|
this.logger.debug({ path }, "Validating OpenCode binary path")
|
||||||
|
return this.validateRecord({
|
||||||
|
id: path,
|
||||||
|
path,
|
||||||
|
label: this.prettyLabel(path),
|
||||||
|
isDefault: false,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
private cloneConfig(config: ConfigFile): ConfigFile {
|
||||||
|
return JSON.parse(JSON.stringify(config)) as ConfigFile
|
||||||
|
}
|
||||||
|
|
||||||
|
private mapRecords(): BinaryRecord[] {
|
||||||
|
|
||||||
|
const config = this.configStore.get()
|
||||||
|
const configuredBinaries = config.opencodeBinaries.map<BinaryRecord>((binary) => ({
|
||||||
|
id: binary.path,
|
||||||
|
path: binary.path,
|
||||||
|
label: binary.label ?? this.prettyLabel(binary.path),
|
||||||
|
version: binary.version,
|
||||||
|
isDefault: false,
|
||||||
|
}))
|
||||||
|
|
||||||
|
const defaultPath = config.preferences.lastUsedBinary ?? configuredBinaries[0]?.path ?? "opencode"
|
||||||
|
|
||||||
|
const annotated = configuredBinaries.map((binary) => ({
|
||||||
|
...binary,
|
||||||
|
isDefault: binary.path === defaultPath,
|
||||||
|
}))
|
||||||
|
|
||||||
|
if (!annotated.some((binary) => binary.path === defaultPath)) {
|
||||||
|
annotated.unshift(this.buildFallbackRecord(defaultPath))
|
||||||
|
}
|
||||||
|
|
||||||
|
return annotated
|
||||||
|
}
|
||||||
|
|
||||||
|
private getById(id: string): BinaryRecord {
|
||||||
|
return this.mapRecords().find((binary) => binary.id === id) ?? this.buildFallbackRecord(id)
|
||||||
|
}
|
||||||
|
|
||||||
|
private emitChange() {
|
||||||
|
this.logger.debug("Emitting binaries changed event")
|
||||||
|
this.eventBus?.publish({ type: "config.binariesChanged", binaries: this.mapRecords() })
|
||||||
|
}
|
||||||
|
|
||||||
|
private validateRecord(record: BinaryRecord): BinaryValidationResult {
|
||||||
|
// TODO: call actual binary -v check.
|
||||||
|
return { valid: true, version: record.version }
|
||||||
|
}
|
||||||
|
|
||||||
|
private buildFallbackRecord(path: string): BinaryRecord {
|
||||||
|
return {
|
||||||
|
id: path,
|
||||||
|
path,
|
||||||
|
label: this.prettyLabel(path),
|
||||||
|
isDefault: true,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private prettyLabel(path: string) {
|
||||||
|
const parts = path.split(/[\\/]/)
|
||||||
|
const last = parts[parts.length - 1] || path
|
||||||
|
return last || path
|
||||||
|
}
|
||||||
|
}
|
||||||
64
packages/server/src/config/schema.ts
Normal file
64
packages/server/src/config/schema.ts
Normal file
@@ -0,0 +1,64 @@
|
|||||||
|
import { z } from "zod"
|
||||||
|
|
||||||
|
const ModelPreferenceSchema = z.object({
|
||||||
|
providerId: z.string(),
|
||||||
|
modelId: z.string(),
|
||||||
|
})
|
||||||
|
|
||||||
|
const AgentModelSelectionSchema = z.record(z.string(), ModelPreferenceSchema)
|
||||||
|
const AgentModelSelectionsSchema = z.record(z.string(), AgentModelSelectionSchema)
|
||||||
|
|
||||||
|
const PreferencesSchema = z.object({
|
||||||
|
showThinkingBlocks: z.boolean().default(false),
|
||||||
|
thinkingBlocksExpansion: z.enum(["expanded", "collapsed"]).default("expanded"),
|
||||||
|
showTimelineTools: z.boolean().default(true),
|
||||||
|
lastUsedBinary: z.string().optional(),
|
||||||
|
environmentVariables: z.record(z.string()).default({}),
|
||||||
|
modelRecents: z.array(ModelPreferenceSchema).default([]),
|
||||||
|
diffViewMode: z.enum(["split", "unified"]).default("split"),
|
||||||
|
toolOutputExpansion: z.enum(["expanded", "collapsed"]).default("expanded"),
|
||||||
|
diagnosticsExpansion: z.enum(["expanded", "collapsed"]).default("expanded"),
|
||||||
|
showUsageMetrics: z.boolean().default(true),
|
||||||
|
autoCleanupBlankSessions: z.boolean().default(true),
|
||||||
|
listeningMode: z.enum(["local", "all"]).default("local"),
|
||||||
|
})
|
||||||
|
|
||||||
|
const RecentFolderSchema = z.object({
|
||||||
|
path: z.string(),
|
||||||
|
lastAccessed: z.number().nonnegative(),
|
||||||
|
})
|
||||||
|
|
||||||
|
const OpenCodeBinarySchema = z.object({
|
||||||
|
path: z.string(),
|
||||||
|
version: z.string().optional(),
|
||||||
|
lastUsed: z.number().nonnegative(),
|
||||||
|
label: z.string().optional(),
|
||||||
|
})
|
||||||
|
|
||||||
|
const ConfigFileSchema = z.object({
|
||||||
|
preferences: PreferencesSchema.default({}),
|
||||||
|
recentFolders: z.array(RecentFolderSchema).default([]),
|
||||||
|
opencodeBinaries: z.array(OpenCodeBinarySchema).default([]),
|
||||||
|
theme: z.enum(["light", "dark", "system"]).optional(),
|
||||||
|
})
|
||||||
|
|
||||||
|
const DEFAULT_CONFIG = ConfigFileSchema.parse({})
|
||||||
|
|
||||||
|
export {
|
||||||
|
ModelPreferenceSchema,
|
||||||
|
AgentModelSelectionSchema,
|
||||||
|
AgentModelSelectionsSchema,
|
||||||
|
PreferencesSchema,
|
||||||
|
RecentFolderSchema,
|
||||||
|
OpenCodeBinarySchema,
|
||||||
|
ConfigFileSchema,
|
||||||
|
DEFAULT_CONFIG,
|
||||||
|
}
|
||||||
|
|
||||||
|
export type ModelPreference = z.infer<typeof ModelPreferenceSchema>
|
||||||
|
export type AgentModelSelection = z.infer<typeof AgentModelSelectionSchema>
|
||||||
|
export type AgentModelSelections = z.infer<typeof AgentModelSelectionsSchema>
|
||||||
|
export type Preferences = z.infer<typeof PreferencesSchema>
|
||||||
|
export type RecentFolder = z.infer<typeof RecentFolderSchema>
|
||||||
|
export type OpenCodeBinary = z.infer<typeof OpenCodeBinarySchema>
|
||||||
|
export type ConfigFile = z.infer<typeof ConfigFileSchema>
|
||||||
78
packages/server/src/config/store.ts
Normal file
78
packages/server/src/config/store.ts
Normal file
@@ -0,0 +1,78 @@
|
|||||||
|
import fs from "fs"
|
||||||
|
import path from "path"
|
||||||
|
import { EventBus } from "../events/bus"
|
||||||
|
import { Logger } from "../logger"
|
||||||
|
import { ConfigFile, ConfigFileSchema, DEFAULT_CONFIG } from "./schema"
|
||||||
|
|
||||||
|
export class ConfigStore {
|
||||||
|
private cache: ConfigFile = DEFAULT_CONFIG
|
||||||
|
private loaded = false
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
private readonly configPath: string,
|
||||||
|
private readonly eventBus: EventBus | undefined,
|
||||||
|
private readonly logger: Logger,
|
||||||
|
) {}
|
||||||
|
|
||||||
|
load(): ConfigFile {
|
||||||
|
if (this.loaded) {
|
||||||
|
return this.cache
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const resolved = this.resolvePath(this.configPath)
|
||||||
|
if (fs.existsSync(resolved)) {
|
||||||
|
const content = fs.readFileSync(resolved, "utf-8")
|
||||||
|
const parsed = JSON.parse(content)
|
||||||
|
this.cache = ConfigFileSchema.parse(parsed)
|
||||||
|
this.logger.debug({ resolved }, "Loaded existing config file")
|
||||||
|
} else {
|
||||||
|
this.cache = DEFAULT_CONFIG
|
||||||
|
this.logger.debug({ resolved }, "No config file found, using defaults")
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.warn({ err: error }, "Failed to load config, using defaults")
|
||||||
|
this.cache = DEFAULT_CONFIG
|
||||||
|
}
|
||||||
|
|
||||||
|
this.loaded = true
|
||||||
|
return this.cache
|
||||||
|
}
|
||||||
|
|
||||||
|
get(): ConfigFile {
|
||||||
|
return this.load()
|
||||||
|
}
|
||||||
|
|
||||||
|
replace(config: ConfigFile) {
|
||||||
|
const validated = ConfigFileSchema.parse(config)
|
||||||
|
this.commit(validated)
|
||||||
|
}
|
||||||
|
|
||||||
|
private commit(next: ConfigFile) {
|
||||||
|
this.cache = next
|
||||||
|
this.loaded = true
|
||||||
|
this.persist()
|
||||||
|
const published = Boolean(this.eventBus)
|
||||||
|
this.eventBus?.publish({ type: "config.appChanged", config: this.cache })
|
||||||
|
this.logger.debug({ broadcast: published }, "Config SSE event emitted")
|
||||||
|
this.logger.trace({ config: this.cache }, "Config payload")
|
||||||
|
}
|
||||||
|
|
||||||
|
private persist() {
|
||||||
|
try {
|
||||||
|
const resolved = this.resolvePath(this.configPath)
|
||||||
|
fs.mkdirSync(path.dirname(resolved), { recursive: true })
|
||||||
|
fs.writeFileSync(resolved, JSON.stringify(this.cache, null, 2), "utf-8")
|
||||||
|
this.logger.debug({ resolved }, "Persisted config file")
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.warn({ err: error }, "Failed to persist config")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolvePath(filePath: string) {
|
||||||
|
if (filePath.startsWith("~/")) {
|
||||||
|
return path.join(process.env.HOME ?? "", filePath.slice(2))
|
||||||
|
}
|
||||||
|
return path.resolve(filePath)
|
||||||
|
}
|
||||||
|
}
|
||||||
189
packages/server/src/context-engine/client.ts
Normal file
189
packages/server/src/context-engine/client.ts
Normal file
@@ -0,0 +1,189 @@
|
|||||||
|
/**
|
||||||
|
* Context Engine HTTP Client
|
||||||
|
* Communicates with the Context-Engine RAG service for code retrieval and memory management.
|
||||||
|
*/
|
||||||
|
|
||||||
|
import { Logger } from "../logger"
|
||||||
|
|
||||||
|
export interface ContextEngineConfig {
|
||||||
|
/** Base URL of the Context-Engine API (default: http://localhost:8000) */
|
||||||
|
baseUrl: string
|
||||||
|
/** Request timeout in milliseconds (default: 30000) */
|
||||||
|
timeout: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IndexRequest {
|
||||||
|
path: string
|
||||||
|
recursive?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IndexResponse {
|
||||||
|
status: "started" | "completed" | "error"
|
||||||
|
indexed_files?: number
|
||||||
|
message?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface QueryRequest {
|
||||||
|
query: string
|
||||||
|
context_window?: number
|
||||||
|
top_k?: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface QueryResponse {
|
||||||
|
results: Array<{
|
||||||
|
content: string
|
||||||
|
file_path: string
|
||||||
|
score: number
|
||||||
|
metadata?: Record<string, unknown>
|
||||||
|
}>
|
||||||
|
total_results: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface MemoryRequest {
|
||||||
|
text: string
|
||||||
|
metadata?: Record<string, unknown>
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface MemoryResponse {
|
||||||
|
id: string
|
||||||
|
status: "added" | "error"
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface HealthResponse {
|
||||||
|
status: "healthy" | "unhealthy"
|
||||||
|
version?: string
|
||||||
|
indexed_files?: number
|
||||||
|
}
|
||||||
|
|
||||||
|
const DEFAULT_CONFIG: ContextEngineConfig = {
|
||||||
|
baseUrl: "http://localhost:8000",
|
||||||
|
timeout: 30000,
|
||||||
|
}
|
||||||
|
|
||||||
|
export class ContextEngineClient {
|
||||||
|
private config: ContextEngineConfig
|
||||||
|
private logger: Logger
|
||||||
|
|
||||||
|
constructor(config: Partial<ContextEngineConfig> = {}, logger: Logger) {
|
||||||
|
this.config = { ...DEFAULT_CONFIG, ...config }
|
||||||
|
this.logger = logger
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check if the Context-Engine is healthy and responding
|
||||||
|
*/
|
||||||
|
async health(): Promise<HealthResponse> {
|
||||||
|
try {
|
||||||
|
const response = await this.request<HealthResponse>("/health", {
|
||||||
|
method: "GET",
|
||||||
|
})
|
||||||
|
return response
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.debug({ error }, "Context-Engine health check failed")
|
||||||
|
return { status: "unhealthy" }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Trigger indexing for a project path
|
||||||
|
*/
|
||||||
|
async index(path: string, recursive = true): Promise<IndexResponse> {
|
||||||
|
this.logger.info({ path, recursive }, "Triggering Context-Engine indexing")
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.request<IndexResponse>("/index", {
|
||||||
|
method: "POST",
|
||||||
|
body: JSON.stringify({ path, recursive } as IndexRequest),
|
||||||
|
})
|
||||||
|
this.logger.info({ path, response }, "Context-Engine indexing response")
|
||||||
|
return response
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.error({ path, error }, "Context-Engine indexing failed")
|
||||||
|
return {
|
||||||
|
status: "error",
|
||||||
|
message: error instanceof Error ? error.message : "Unknown error",
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Query the Context-Engine for relevant code snippets
|
||||||
|
*/
|
||||||
|
async query(prompt: string, contextWindow = 4096, topK = 5): Promise<QueryResponse> {
|
||||||
|
this.logger.debug({ prompt: prompt.slice(0, 100), contextWindow, topK }, "Querying Context-Engine")
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.request<QueryResponse>("/query", {
|
||||||
|
method: "POST",
|
||||||
|
body: JSON.stringify({
|
||||||
|
query: prompt,
|
||||||
|
context_window: contextWindow,
|
||||||
|
top_k: topK,
|
||||||
|
} as QueryRequest),
|
||||||
|
})
|
||||||
|
this.logger.debug({ resultCount: response.results.length }, "Context-Engine query completed")
|
||||||
|
return response
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.warn({ error }, "Context-Engine query failed")
|
||||||
|
return { results: [], total_results: 0 }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add a memory/rule to the Context-Engine for session-specific context
|
||||||
|
*/
|
||||||
|
async addMemory(text: string, metadata?: Record<string, unknown>): Promise<MemoryResponse> {
|
||||||
|
this.logger.debug({ textLength: text.length }, "Adding memory to Context-Engine")
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.request<MemoryResponse>("/memory", {
|
||||||
|
method: "POST",
|
||||||
|
body: JSON.stringify({ text, metadata } as MemoryRequest),
|
||||||
|
})
|
||||||
|
return response
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.warn({ error }, "Context-Engine addMemory failed")
|
||||||
|
return { id: "", status: "error" }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the current indexing status
|
||||||
|
*/
|
||||||
|
async getStatus(): Promise<{ indexing: boolean; indexed_files: number; last_indexed?: string }> {
|
||||||
|
try {
|
||||||
|
const response = await this.request<{ indexing: boolean; indexed_files: number; last_indexed?: string }>("/status", {
|
||||||
|
method: "GET",
|
||||||
|
})
|
||||||
|
return response
|
||||||
|
} catch (error) {
|
||||||
|
return { indexing: false, indexed_files: 0 }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private async request<T>(endpoint: string, options: RequestInit): Promise<T> {
|
||||||
|
const url = `${this.config.baseUrl}${endpoint}`
|
||||||
|
const controller = new AbortController()
|
||||||
|
const timeoutId = setTimeout(() => controller.abort(), this.config.timeout)
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(url, {
|
||||||
|
...options,
|
||||||
|
headers: {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
...options.headers,
|
||||||
|
},
|
||||||
|
signal: controller.signal,
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const errorText = await response.text().catch(() => "")
|
||||||
|
throw new Error(`Context-Engine request failed: ${response.status} ${response.statusText} - ${errorText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
return await response.json() as T
|
||||||
|
} finally {
|
||||||
|
clearTimeout(timeoutId)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
13
packages/server/src/context-engine/index.ts
Normal file
13
packages/server/src/context-engine/index.ts
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
/**
|
||||||
|
* Context Engine module exports
|
||||||
|
*/
|
||||||
|
|
||||||
|
export { ContextEngineClient, type ContextEngineConfig, type QueryResponse, type IndexResponse } from "./client"
|
||||||
|
export {
|
||||||
|
ContextEngineService,
|
||||||
|
type ContextEngineServiceConfig,
|
||||||
|
type ContextEngineStatus,
|
||||||
|
getContextEngineService,
|
||||||
|
initializeContextEngineService,
|
||||||
|
shutdownContextEngineService,
|
||||||
|
} from "./service"
|
||||||
350
packages/server/src/context-engine/service.ts
Normal file
350
packages/server/src/context-engine/service.ts
Normal file
@@ -0,0 +1,350 @@
|
|||||||
|
/**
|
||||||
|
* Context Engine Service
|
||||||
|
* Manages the lifecycle of the Context-Engine process (Python sidecar)
|
||||||
|
* and provides access to the Context-Engine client.
|
||||||
|
*/
|
||||||
|
|
||||||
|
import { spawn, ChildProcess } from "child_process"
|
||||||
|
import { EventEmitter } from "events"
|
||||||
|
import { Logger } from "../logger"
|
||||||
|
import { ContextEngineClient, ContextEngineConfig, HealthResponse } from "./client"
|
||||||
|
|
||||||
|
export type ContextEngineStatus = "stopped" | "starting" | "ready" | "indexing" | "error"
|
||||||
|
|
||||||
|
export interface ContextEngineServiceConfig {
|
||||||
|
/** Path to the context-engine executable or Python script */
|
||||||
|
binaryPath?: string
|
||||||
|
/** Arguments to pass to the context-engine process */
|
||||||
|
args?: string[]
|
||||||
|
/** Port for the Context-Engine API (default: 8000) */
|
||||||
|
port: number
|
||||||
|
/** Host for the Context-Engine API (default: localhost) */
|
||||||
|
host: string
|
||||||
|
/** Whether to auto-start the engine when first needed (lazy start) */
|
||||||
|
lazyStart: boolean
|
||||||
|
/** Health check interval in milliseconds */
|
||||||
|
healthCheckInterval: number
|
||||||
|
/** Max retries for health check before marking as error */
|
||||||
|
maxHealthCheckRetries: number
|
||||||
|
}
|
||||||
|
|
||||||
|
const DEFAULT_SERVICE_CONFIG: ContextEngineServiceConfig = {
|
||||||
|
binaryPath: "context-engine",
|
||||||
|
args: [],
|
||||||
|
port: 8000,
|
||||||
|
host: "localhost",
|
||||||
|
lazyStart: true,
|
||||||
|
healthCheckInterval: 5000,
|
||||||
|
maxHealthCheckRetries: 3,
|
||||||
|
}
|
||||||
|
|
||||||
|
export class ContextEngineService extends EventEmitter {
|
||||||
|
private config: ContextEngineServiceConfig
|
||||||
|
private logger: Logger
|
||||||
|
private process: ChildProcess | null = null
|
||||||
|
private client: ContextEngineClient
|
||||||
|
private status: ContextEngineStatus = "stopped"
|
||||||
|
private healthCheckTimer: NodeJS.Timeout | null = null
|
||||||
|
private healthCheckFailures = 0
|
||||||
|
private indexingPaths = new Set<string>()
|
||||||
|
|
||||||
|
constructor(config: Partial<ContextEngineServiceConfig> = {}, logger: Logger) {
|
||||||
|
super()
|
||||||
|
this.config = { ...DEFAULT_SERVICE_CONFIG, ...config }
|
||||||
|
this.logger = logger
|
||||||
|
|
||||||
|
const clientConfig: Partial<ContextEngineConfig> = {
|
||||||
|
baseUrl: `http://${this.config.host}:${this.config.port}`,
|
||||||
|
timeout: 30000,
|
||||||
|
}
|
||||||
|
this.client = new ContextEngineClient(clientConfig, logger)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the current status of the Context-Engine
|
||||||
|
*/
|
||||||
|
getStatus(): ContextEngineStatus {
|
||||||
|
return this.status
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Check if the Context-Engine is ready to accept requests
|
||||||
|
*/
|
||||||
|
isReady(): boolean {
|
||||||
|
return this.status === "ready" || this.status === "indexing"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the Context-Engine client for making API calls
|
||||||
|
*/
|
||||||
|
getClient(): ContextEngineClient {
|
||||||
|
return this.client
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Start the Context-Engine process
|
||||||
|
*/
|
||||||
|
async start(): Promise<boolean> {
|
||||||
|
if (this.status === "ready" || this.status === "starting") {
|
||||||
|
this.logger.debug("Context-Engine already started or starting")
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
|
||||||
|
this.setStatus("starting")
|
||||||
|
this.logger.info({ config: this.config }, "Starting Context-Engine service")
|
||||||
|
|
||||||
|
// First, check if an external Context-Engine is already running
|
||||||
|
const externalHealth = await this.client.health()
|
||||||
|
if (externalHealth.status === "healthy") {
|
||||||
|
this.logger.info("External Context-Engine detected and healthy")
|
||||||
|
this.setStatus("ready")
|
||||||
|
this.startHealthCheck()
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
|
||||||
|
// Try to spawn the process
|
||||||
|
if (!this.config.binaryPath) {
|
||||||
|
this.logger.warn("No binary path configured for Context-Engine")
|
||||||
|
this.setStatus("error")
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const args = [
|
||||||
|
...(this.config.args || []),
|
||||||
|
"--port", String(this.config.port),
|
||||||
|
"--host", this.config.host,
|
||||||
|
]
|
||||||
|
|
||||||
|
this.logger.info({ binary: this.config.binaryPath, args }, "Spawning Context-Engine process")
|
||||||
|
|
||||||
|
this.process = spawn(this.config.binaryPath, args, {
|
||||||
|
stdio: ["ignore", "pipe", "pipe"],
|
||||||
|
shell: process.platform === "win32",
|
||||||
|
detached: false,
|
||||||
|
})
|
||||||
|
|
||||||
|
this.process.stdout?.on("data", (data) => {
|
||||||
|
this.logger.debug({ output: data.toString().trim() }, "Context-Engine stdout")
|
||||||
|
})
|
||||||
|
|
||||||
|
this.process.stderr?.on("data", (data) => {
|
||||||
|
this.logger.debug({ output: data.toString().trim() }, "Context-Engine stderr")
|
||||||
|
})
|
||||||
|
|
||||||
|
this.process.on("error", (error) => {
|
||||||
|
this.logger.error({ error }, "Context-Engine process error")
|
||||||
|
this.setStatus("error")
|
||||||
|
})
|
||||||
|
|
||||||
|
this.process.on("exit", (code, signal) => {
|
||||||
|
this.logger.info({ code, signal }, "Context-Engine process exited")
|
||||||
|
this.process = null
|
||||||
|
if (this.status !== "stopped") {
|
||||||
|
this.setStatus("error")
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
// Wait for the process to become ready
|
||||||
|
const ready = await this.waitForReady(30000)
|
||||||
|
if (ready) {
|
||||||
|
this.setStatus("ready")
|
||||||
|
this.startHealthCheck()
|
||||||
|
return true
|
||||||
|
} else {
|
||||||
|
this.logger.error("Context-Engine failed to become ready")
|
||||||
|
this.setStatus("error")
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.error({ error }, "Failed to spawn Context-Engine process")
|
||||||
|
this.setStatus("error")
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Stop the Context-Engine process
|
||||||
|
*/
|
||||||
|
async stop(): Promise<void> {
|
||||||
|
this.stopHealthCheck()
|
||||||
|
this.setStatus("stopped")
|
||||||
|
|
||||||
|
if (this.process) {
|
||||||
|
this.logger.info("Stopping Context-Engine process")
|
||||||
|
this.process.kill("SIGTERM")
|
||||||
|
|
||||||
|
// Wait for graceful shutdown
|
||||||
|
await new Promise<void>((resolve) => {
|
||||||
|
const timeout = setTimeout(() => {
|
||||||
|
if (this.process) {
|
||||||
|
this.logger.warn("Context-Engine did not exit gracefully, killing")
|
||||||
|
this.process.kill("SIGKILL")
|
||||||
|
}
|
||||||
|
resolve()
|
||||||
|
}, 5000)
|
||||||
|
|
||||||
|
if (this.process) {
|
||||||
|
this.process.once("exit", () => {
|
||||||
|
clearTimeout(timeout)
|
||||||
|
resolve()
|
||||||
|
})
|
||||||
|
} else {
|
||||||
|
clearTimeout(timeout)
|
||||||
|
resolve()
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
this.process = null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Trigger indexing for a workspace path (non-blocking)
|
||||||
|
*/
|
||||||
|
async indexPath(path: string): Promise<void> {
|
||||||
|
if (!this.config.lazyStart && !this.isReady()) {
|
||||||
|
this.logger.debug({ path }, "Context-Engine not ready, skipping indexing")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// Lazy start if needed
|
||||||
|
if (this.config.lazyStart && this.status === "stopped") {
|
||||||
|
this.logger.info({ path }, "Lazy-starting Context-Engine for indexing")
|
||||||
|
const started = await this.start()
|
||||||
|
if (!started) {
|
||||||
|
this.logger.warn({ path }, "Failed to start Context-Engine for indexing")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.indexingPaths.has(path)) {
|
||||||
|
this.logger.debug({ path }, "Path already being indexed")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
this.indexingPaths.add(path)
|
||||||
|
this.setStatus("indexing")
|
||||||
|
|
||||||
|
// Fire and forget - don't block workspace creation
|
||||||
|
this.client.index(path).then((response) => {
|
||||||
|
this.indexingPaths.delete(path)
|
||||||
|
if (response.status === "error") {
|
||||||
|
this.logger.warn({ path, response }, "Context-Engine indexing failed")
|
||||||
|
} else {
|
||||||
|
this.logger.info({ path, indexed_files: response.indexed_files }, "Context-Engine indexing completed")
|
||||||
|
}
|
||||||
|
if (this.indexingPaths.size === 0 && this.status === "indexing") {
|
||||||
|
this.setStatus("ready")
|
||||||
|
}
|
||||||
|
this.emit("indexComplete", { path, response })
|
||||||
|
}).catch((error) => {
|
||||||
|
this.indexingPaths.delete(path)
|
||||||
|
this.logger.error({ path, error }, "Context-Engine indexing error")
|
||||||
|
if (this.indexingPaths.size === 0 && this.status === "indexing") {
|
||||||
|
this.setStatus("ready")
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Query the Context-Engine for relevant code snippets
|
||||||
|
*/
|
||||||
|
async query(prompt: string, contextWindow?: number): Promise<string | null> {
|
||||||
|
if (!this.isReady()) {
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.client.query(prompt, contextWindow)
|
||||||
|
if (response.results.length === 0) {
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
// Format the results as a context block
|
||||||
|
const contextParts = response.results.map((result, index) => {
|
||||||
|
return `// File: ${result.file_path} (relevance: ${(result.score * 100).toFixed(1)}%)\n${result.content}`
|
||||||
|
})
|
||||||
|
|
||||||
|
return `<context_engine_retrieval>\n${contextParts.join("\n\n")}\n</context_engine_retrieval>`
|
||||||
|
} catch (error) {
|
||||||
|
this.logger.warn({ error }, "Context-Engine query failed")
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private setStatus(status: ContextEngineStatus): void {
|
||||||
|
if (this.status !== status) {
|
||||||
|
this.logger.info({ oldStatus: this.status, newStatus: status }, "Context-Engine status changed")
|
||||||
|
this.status = status
|
||||||
|
this.emit("statusChange", status)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private async waitForReady(timeoutMs: number): Promise<boolean> {
|
||||||
|
const startTime = Date.now()
|
||||||
|
const checkInterval = 500
|
||||||
|
|
||||||
|
while (Date.now() - startTime < timeoutMs) {
|
||||||
|
const health = await this.client.health()
|
||||||
|
if (health.status === "healthy") {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
await new Promise((resolve) => setTimeout(resolve, checkInterval))
|
||||||
|
}
|
||||||
|
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
private startHealthCheck(): void {
|
||||||
|
if (this.healthCheckTimer) return
|
||||||
|
|
||||||
|
this.healthCheckTimer = setInterval(async () => {
|
||||||
|
const health = await this.client.health()
|
||||||
|
if (health.status === "healthy") {
|
||||||
|
this.healthCheckFailures = 0
|
||||||
|
if (this.status === "error") {
|
||||||
|
this.setStatus("ready")
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
this.healthCheckFailures++
|
||||||
|
if (this.healthCheckFailures >= this.config.maxHealthCheckRetries) {
|
||||||
|
this.logger.warn("Context-Engine health check failed multiple times")
|
||||||
|
this.setStatus("error")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}, this.config.healthCheckInterval)
|
||||||
|
}
|
||||||
|
|
||||||
|
private stopHealthCheck(): void {
|
||||||
|
if (this.healthCheckTimer) {
|
||||||
|
clearInterval(this.healthCheckTimer)
|
||||||
|
this.healthCheckTimer = null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Singleton instance for global access
|
||||||
|
let globalContextEngineService: ContextEngineService | null = null
|
||||||
|
|
||||||
|
export function getContextEngineService(): ContextEngineService | null {
|
||||||
|
return globalContextEngineService
|
||||||
|
}
|
||||||
|
|
||||||
|
export function initializeContextEngineService(
|
||||||
|
config: Partial<ContextEngineServiceConfig>,
|
||||||
|
logger: Logger
|
||||||
|
): ContextEngineService {
|
||||||
|
if (globalContextEngineService) {
|
||||||
|
return globalContextEngineService
|
||||||
|
}
|
||||||
|
globalContextEngineService = new ContextEngineService(config, logger)
|
||||||
|
return globalContextEngineService
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function shutdownContextEngineService(): Promise<void> {
|
||||||
|
if (globalContextEngineService) {
|
||||||
|
await globalContextEngineService.stop()
|
||||||
|
globalContextEngineService = null
|
||||||
|
}
|
||||||
|
}
|
||||||
47
packages/server/src/events/bus.ts
Normal file
47
packages/server/src/events/bus.ts
Normal file
@@ -0,0 +1,47 @@
|
|||||||
|
import { EventEmitter } from "events"
|
||||||
|
import { WorkspaceEventPayload } from "../api-types"
|
||||||
|
import { Logger } from "../logger"
|
||||||
|
|
||||||
|
export class EventBus extends EventEmitter {
|
||||||
|
constructor(private readonly logger?: Logger) {
|
||||||
|
super()
|
||||||
|
}
|
||||||
|
|
||||||
|
publish(event: WorkspaceEventPayload): boolean {
|
||||||
|
if (event.type !== "instance.event" && event.type !== "instance.eventStatus") {
|
||||||
|
this.logger?.debug({ type: event.type }, "Publishing workspace event")
|
||||||
|
if (this.logger?.isLevelEnabled("trace")) {
|
||||||
|
this.logger.trace({ event }, "Workspace event payload")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return super.emit(event.type, event)
|
||||||
|
}
|
||||||
|
|
||||||
|
onEvent(listener: (event: WorkspaceEventPayload) => void) {
|
||||||
|
const handler = (event: WorkspaceEventPayload) => listener(event)
|
||||||
|
this.on("workspace.created", handler)
|
||||||
|
this.on("workspace.started", handler)
|
||||||
|
this.on("workspace.error", handler)
|
||||||
|
this.on("workspace.stopped", handler)
|
||||||
|
this.on("workspace.log", handler)
|
||||||
|
this.on("config.appChanged", handler)
|
||||||
|
this.on("config.binariesChanged", handler)
|
||||||
|
this.on("instance.dataChanged", handler)
|
||||||
|
this.on("instance.event", handler)
|
||||||
|
this.on("instance.eventStatus", handler)
|
||||||
|
this.on("app.releaseAvailable", handler)
|
||||||
|
return () => {
|
||||||
|
this.off("workspace.created", handler)
|
||||||
|
this.off("workspace.started", handler)
|
||||||
|
this.off("workspace.error", handler)
|
||||||
|
this.off("workspace.stopped", handler)
|
||||||
|
this.off("workspace.log", handler)
|
||||||
|
this.off("config.appChanged", handler)
|
||||||
|
this.off("config.binariesChanged", handler)
|
||||||
|
this.off("instance.dataChanged", handler)
|
||||||
|
this.off("instance.event", handler)
|
||||||
|
this.off("instance.eventStatus", handler)
|
||||||
|
this.off("app.releaseAvailable", handler)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
import assert from "node:assert/strict"
|
||||||
|
import { beforeEach, describe, it } from "node:test"
|
||||||
|
import type { FileSystemEntry } from "../../api-types"
|
||||||
|
import {
|
||||||
|
clearWorkspaceSearchCache,
|
||||||
|
getWorkspaceCandidates,
|
||||||
|
refreshWorkspaceCandidates,
|
||||||
|
WORKSPACE_CANDIDATE_CACHE_TTL_MS,
|
||||||
|
} from "../search-cache"
|
||||||
|
|
||||||
|
describe("workspace search cache", () => {
|
||||||
|
beforeEach(() => {
|
||||||
|
clearWorkspaceSearchCache()
|
||||||
|
})
|
||||||
|
|
||||||
|
it("expires cached candidates after the TTL", () => {
|
||||||
|
const workspacePath = "/tmp/workspace"
|
||||||
|
const startTime = 1_000
|
||||||
|
|
||||||
|
refreshWorkspaceCandidates(workspacePath, () => [createEntry("file-a")], startTime)
|
||||||
|
|
||||||
|
const beforeExpiry = getWorkspaceCandidates(
|
||||||
|
workspacePath,
|
||||||
|
startTime + WORKSPACE_CANDIDATE_CACHE_TTL_MS - 1,
|
||||||
|
)
|
||||||
|
assert.ok(beforeExpiry)
|
||||||
|
assert.equal(beforeExpiry.length, 1)
|
||||||
|
assert.equal(beforeExpiry[0].name, "file-a")
|
||||||
|
|
||||||
|
const afterExpiry = getWorkspaceCandidates(
|
||||||
|
workspacePath,
|
||||||
|
startTime + WORKSPACE_CANDIDATE_CACHE_TTL_MS + 1,
|
||||||
|
)
|
||||||
|
assert.equal(afterExpiry, undefined)
|
||||||
|
})
|
||||||
|
|
||||||
|
it("replaces cached entries when manually refreshed", () => {
|
||||||
|
const workspacePath = "/tmp/workspace"
|
||||||
|
|
||||||
|
refreshWorkspaceCandidates(workspacePath, () => [createEntry("file-a")], 5_000)
|
||||||
|
const initial = getWorkspaceCandidates(workspacePath)
|
||||||
|
assert.ok(initial)
|
||||||
|
assert.equal(initial[0].name, "file-a")
|
||||||
|
|
||||||
|
refreshWorkspaceCandidates(workspacePath, () => [createEntry("file-b")], 6_000)
|
||||||
|
const refreshed = getWorkspaceCandidates(workspacePath)
|
||||||
|
assert.ok(refreshed)
|
||||||
|
assert.equal(refreshed[0].name, "file-b")
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
function createEntry(name: string): FileSystemEntry {
|
||||||
|
return {
|
||||||
|
name,
|
||||||
|
path: name,
|
||||||
|
absolutePath: `/tmp/${name}`,
|
||||||
|
type: "file",
|
||||||
|
size: 1,
|
||||||
|
modifiedAt: new Date().toISOString(),
|
||||||
|
}
|
||||||
|
}
|
||||||
295
packages/server/src/filesystem/browser.ts
Normal file
295
packages/server/src/filesystem/browser.ts
Normal file
@@ -0,0 +1,295 @@
|
|||||||
|
import fs from "fs"
|
||||||
|
import os from "os"
|
||||||
|
import path from "path"
|
||||||
|
import {
|
||||||
|
FileSystemEntry,
|
||||||
|
FileSystemListResponse,
|
||||||
|
FileSystemListingMetadata,
|
||||||
|
WINDOWS_DRIVES_ROOT,
|
||||||
|
} from "../api-types"
|
||||||
|
|
||||||
|
interface FileSystemBrowserOptions {
|
||||||
|
rootDir: string
|
||||||
|
unrestricted?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
interface DirectoryReadOptions {
|
||||||
|
includeFiles: boolean
|
||||||
|
formatPath: (entryName: string) => string
|
||||||
|
formatAbsolutePath: (entryName: string) => string
|
||||||
|
}
|
||||||
|
|
||||||
|
const WINDOWS_DRIVE_LETTERS = Array.from({ length: 26 }, (_, i) => String.fromCharCode(65 + i))
|
||||||
|
|
||||||
|
export class FileSystemBrowser {
|
||||||
|
private readonly root: string
|
||||||
|
private readonly unrestricted: boolean
|
||||||
|
private readonly homeDir: string
|
||||||
|
private readonly isWindows: boolean
|
||||||
|
|
||||||
|
constructor(options: FileSystemBrowserOptions) {
|
||||||
|
this.root = path.resolve(options.rootDir)
|
||||||
|
this.unrestricted = Boolean(options.unrestricted)
|
||||||
|
this.homeDir = os.homedir()
|
||||||
|
this.isWindows = process.platform === "win32"
|
||||||
|
}
|
||||||
|
|
||||||
|
list(relativePath = ".", options: { includeFiles?: boolean } = {}): FileSystemEntry[] {
|
||||||
|
if (this.unrestricted) {
|
||||||
|
throw new Error("Relative listing is unavailable when running with unrestricted root")
|
||||||
|
}
|
||||||
|
const includeFiles = options.includeFiles ?? true
|
||||||
|
const normalizedPath = this.normalizeRelativePath(relativePath)
|
||||||
|
const absolutePath = this.toRestrictedAbsolute(normalizedPath)
|
||||||
|
return this.readDirectoryEntries(absolutePath, {
|
||||||
|
includeFiles,
|
||||||
|
formatPath: (entryName) => this.buildRelativePath(normalizedPath, entryName),
|
||||||
|
formatAbsolutePath: (entryName) => this.resolveRestrictedAbsoluteChild(normalizedPath, entryName),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
browse(targetPath?: string, options: { includeFiles?: boolean } = {}): FileSystemListResponse {
|
||||||
|
const includeFiles = options.includeFiles ?? true
|
||||||
|
if (this.unrestricted) {
|
||||||
|
return this.listUnrestricted(targetPath, includeFiles)
|
||||||
|
}
|
||||||
|
return this.listRestrictedWithMetadata(targetPath, includeFiles)
|
||||||
|
}
|
||||||
|
|
||||||
|
readFile(relativePath: string): string {
|
||||||
|
if (this.unrestricted) {
|
||||||
|
throw new Error("readFile is not available in unrestricted mode")
|
||||||
|
}
|
||||||
|
const resolved = this.toRestrictedAbsolute(relativePath)
|
||||||
|
return fs.readFileSync(resolved, "utf-8")
|
||||||
|
}
|
||||||
|
|
||||||
|
private listRestrictedWithMetadata(relativePath: string | undefined, includeFiles: boolean): FileSystemListResponse {
|
||||||
|
const normalizedPath = this.normalizeRelativePath(relativePath)
|
||||||
|
const absolutePath = this.toRestrictedAbsolute(normalizedPath)
|
||||||
|
const entries = this.readDirectoryEntries(absolutePath, {
|
||||||
|
includeFiles,
|
||||||
|
formatPath: (entryName) => this.buildRelativePath(normalizedPath, entryName),
|
||||||
|
formatAbsolutePath: (entryName) => this.resolveRestrictedAbsoluteChild(normalizedPath, entryName),
|
||||||
|
})
|
||||||
|
|
||||||
|
const metadata: FileSystemListingMetadata = {
|
||||||
|
scope: "restricted",
|
||||||
|
currentPath: normalizedPath,
|
||||||
|
parentPath: normalizedPath === "." ? undefined : this.getRestrictedParent(normalizedPath),
|
||||||
|
rootPath: this.root,
|
||||||
|
homePath: this.homeDir,
|
||||||
|
displayPath: this.resolveRestrictedAbsolute(normalizedPath),
|
||||||
|
pathKind: "relative",
|
||||||
|
}
|
||||||
|
|
||||||
|
return { entries, metadata }
|
||||||
|
}
|
||||||
|
|
||||||
|
private listUnrestricted(targetPath: string | undefined, includeFiles: boolean): FileSystemListResponse {
|
||||||
|
const resolvedPath = this.resolveUnrestrictedPath(targetPath)
|
||||||
|
|
||||||
|
if (this.isWindows && resolvedPath === WINDOWS_DRIVES_ROOT) {
|
||||||
|
return this.listWindowsDrives()
|
||||||
|
}
|
||||||
|
|
||||||
|
const entries = this.readDirectoryEntries(resolvedPath, {
|
||||||
|
includeFiles,
|
||||||
|
formatPath: (entryName) => this.resolveAbsoluteChild(resolvedPath, entryName),
|
||||||
|
formatAbsolutePath: (entryName) => this.resolveAbsoluteChild(resolvedPath, entryName),
|
||||||
|
})
|
||||||
|
|
||||||
|
const parentPath = this.getUnrestrictedParent(resolvedPath)
|
||||||
|
|
||||||
|
const metadata: FileSystemListingMetadata = {
|
||||||
|
scope: "unrestricted",
|
||||||
|
currentPath: resolvedPath,
|
||||||
|
parentPath,
|
||||||
|
rootPath: this.homeDir,
|
||||||
|
homePath: this.homeDir,
|
||||||
|
displayPath: resolvedPath,
|
||||||
|
pathKind: "absolute",
|
||||||
|
}
|
||||||
|
|
||||||
|
return { entries, metadata }
|
||||||
|
}
|
||||||
|
|
||||||
|
private listWindowsDrives(): FileSystemListResponse {
|
||||||
|
if (!this.isWindows) {
|
||||||
|
throw new Error("Drive listing is only supported on Windows hosts")
|
||||||
|
}
|
||||||
|
|
||||||
|
const entries: FileSystemEntry[] = []
|
||||||
|
for (const letter of WINDOWS_DRIVE_LETTERS) {
|
||||||
|
const drivePath = `${letter}:\\`
|
||||||
|
try {
|
||||||
|
if (fs.existsSync(drivePath)) {
|
||||||
|
entries.push({
|
||||||
|
name: `${letter}:`,
|
||||||
|
path: drivePath,
|
||||||
|
absolutePath: drivePath,
|
||||||
|
type: "directory",
|
||||||
|
})
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
// Ignore inaccessible drives
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Provide a generic UNC root entry so users can navigate to network shares manually.
|
||||||
|
entries.push({
|
||||||
|
name: "UNC Network",
|
||||||
|
path: "\\\\",
|
||||||
|
absolutePath: "\\\\",
|
||||||
|
type: "directory",
|
||||||
|
})
|
||||||
|
|
||||||
|
const metadata: FileSystemListingMetadata = {
|
||||||
|
scope: "unrestricted",
|
||||||
|
currentPath: WINDOWS_DRIVES_ROOT,
|
||||||
|
parentPath: undefined,
|
||||||
|
rootPath: this.homeDir,
|
||||||
|
homePath: this.homeDir,
|
||||||
|
displayPath: "Drives",
|
||||||
|
pathKind: "drives",
|
||||||
|
}
|
||||||
|
|
||||||
|
return { entries, metadata }
|
||||||
|
}
|
||||||
|
|
||||||
|
private readDirectoryEntries(directory: string, options: DirectoryReadOptions): FileSystemEntry[] {
|
||||||
|
const dirents = fs.readdirSync(directory, { withFileTypes: true })
|
||||||
|
const results: FileSystemEntry[] = []
|
||||||
|
|
||||||
|
for (const entry of dirents) {
|
||||||
|
if (!options.includeFiles && !entry.isDirectory()) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
const absoluteEntryPath = path.join(directory, entry.name)
|
||||||
|
let stats: fs.Stats
|
||||||
|
try {
|
||||||
|
stats = fs.statSync(absoluteEntryPath)
|
||||||
|
} catch {
|
||||||
|
// Skip entries we cannot stat (insufficient permissions, etc.)
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
const isDirectory = entry.isDirectory()
|
||||||
|
if (!options.includeFiles && !isDirectory) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
results.push({
|
||||||
|
name: entry.name,
|
||||||
|
path: options.formatPath(entry.name),
|
||||||
|
absolutePath: options.formatAbsolutePath(entry.name),
|
||||||
|
type: isDirectory ? "directory" : "file",
|
||||||
|
size: isDirectory ? undefined : stats.size,
|
||||||
|
modifiedAt: stats.mtime.toISOString(),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
return results.sort((a, b) => a.name.localeCompare(b.name))
|
||||||
|
}
|
||||||
|
|
||||||
|
private normalizeRelativePath(input: string | undefined) {
|
||||||
|
if (!input || input === "." || input === "./" || input === "/") {
|
||||||
|
return "."
|
||||||
|
}
|
||||||
|
let normalized = input.replace(/\\+/g, "/")
|
||||||
|
if (normalized.startsWith("./")) {
|
||||||
|
normalized = normalized.replace(/^\.\/+/, "")
|
||||||
|
}
|
||||||
|
if (normalized.startsWith("/")) {
|
||||||
|
normalized = normalized.replace(/^\/+/g, "")
|
||||||
|
}
|
||||||
|
return normalized === "" ? "." : normalized
|
||||||
|
}
|
||||||
|
|
||||||
|
private buildRelativePath(parent: string, child: string) {
|
||||||
|
if (!parent || parent === ".") {
|
||||||
|
return this.normalizeRelativePath(child)
|
||||||
|
}
|
||||||
|
return this.normalizeRelativePath(`${parent}/${child}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveRestrictedAbsolute(relativePath: string) {
|
||||||
|
return this.toRestrictedAbsolute(relativePath)
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveRestrictedAbsoluteChild(parent: string, child: string) {
|
||||||
|
const normalized = this.buildRelativePath(parent, child)
|
||||||
|
return this.toRestrictedAbsolute(normalized)
|
||||||
|
}
|
||||||
|
|
||||||
|
private toRestrictedAbsolute(relativePath: string) {
|
||||||
|
const normalized = this.normalizeRelativePath(relativePath)
|
||||||
|
const target = path.resolve(this.root, normalized)
|
||||||
|
const relativeToRoot = path.relative(this.root, target)
|
||||||
|
if (relativeToRoot.startsWith("..") || path.isAbsolute(relativeToRoot) && relativeToRoot !== "") {
|
||||||
|
throw new Error("Access outside of root is not allowed")
|
||||||
|
}
|
||||||
|
return target
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveUnrestrictedPath(input: string | undefined): string {
|
||||||
|
if (!input || input === "." || input === "./") {
|
||||||
|
return this.homeDir
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.isWindows) {
|
||||||
|
if (input === WINDOWS_DRIVES_ROOT) {
|
||||||
|
return WINDOWS_DRIVES_ROOT
|
||||||
|
}
|
||||||
|
const normalized = path.win32.normalize(input)
|
||||||
|
if (/^[a-zA-Z]:/.test(normalized) || normalized.startsWith("\\\\")) {
|
||||||
|
return normalized
|
||||||
|
}
|
||||||
|
return path.win32.resolve(this.homeDir, normalized)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (input.startsWith("/")) {
|
||||||
|
return path.posix.normalize(input)
|
||||||
|
}
|
||||||
|
|
||||||
|
return path.posix.resolve(this.homeDir, input)
|
||||||
|
}
|
||||||
|
|
||||||
|
private resolveAbsoluteChild(parent: string, child: string) {
|
||||||
|
if (this.isWindows) {
|
||||||
|
return path.win32.normalize(path.win32.join(parent, child))
|
||||||
|
}
|
||||||
|
return path.posix.normalize(path.posix.join(parent, child))
|
||||||
|
}
|
||||||
|
|
||||||
|
private getRestrictedParent(relativePath: string) {
|
||||||
|
const normalized = this.normalizeRelativePath(relativePath)
|
||||||
|
if (normalized === ".") {
|
||||||
|
return undefined
|
||||||
|
}
|
||||||
|
const segments = normalized.split("/")
|
||||||
|
segments.pop()
|
||||||
|
return segments.length === 0 ? "." : segments.join("/")
|
||||||
|
}
|
||||||
|
|
||||||
|
private getUnrestrictedParent(currentPath: string) {
|
||||||
|
if (this.isWindows) {
|
||||||
|
const normalized = path.win32.normalize(currentPath)
|
||||||
|
const parsed = path.win32.parse(normalized)
|
||||||
|
if (normalized === WINDOWS_DRIVES_ROOT) {
|
||||||
|
return undefined
|
||||||
|
}
|
||||||
|
if (normalized === parsed.root) {
|
||||||
|
return WINDOWS_DRIVES_ROOT
|
||||||
|
}
|
||||||
|
return path.win32.dirname(normalized)
|
||||||
|
}
|
||||||
|
|
||||||
|
const normalized = path.posix.normalize(currentPath)
|
||||||
|
if (normalized === "/") {
|
||||||
|
return undefined
|
||||||
|
}
|
||||||
|
return path.posix.dirname(normalized)
|
||||||
|
}
|
||||||
|
}
|
||||||
66
packages/server/src/filesystem/search-cache.ts
Normal file
66
packages/server/src/filesystem/search-cache.ts
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
import path from "path"
|
||||||
|
import type { FileSystemEntry } from "../api-types"
|
||||||
|
|
||||||
|
export const WORKSPACE_CANDIDATE_CACHE_TTL_MS = 30_000
|
||||||
|
|
||||||
|
interface WorkspaceCandidateCacheEntry {
|
||||||
|
expiresAt: number
|
||||||
|
candidates: FileSystemEntry[]
|
||||||
|
}
|
||||||
|
|
||||||
|
const workspaceCandidateCache = new Map<string, WorkspaceCandidateCacheEntry>()
|
||||||
|
|
||||||
|
export function getWorkspaceCandidates(rootDir: string, now = Date.now()): FileSystemEntry[] | undefined {
|
||||||
|
const key = normalizeKey(rootDir)
|
||||||
|
const cached = workspaceCandidateCache.get(key)
|
||||||
|
if (!cached) {
|
||||||
|
return undefined
|
||||||
|
}
|
||||||
|
|
||||||
|
if (cached.expiresAt <= now) {
|
||||||
|
workspaceCandidateCache.delete(key)
|
||||||
|
return undefined
|
||||||
|
}
|
||||||
|
|
||||||
|
return cloneEntries(cached.candidates)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function refreshWorkspaceCandidates(
|
||||||
|
rootDir: string,
|
||||||
|
builder: () => FileSystemEntry[],
|
||||||
|
now = Date.now(),
|
||||||
|
): FileSystemEntry[] {
|
||||||
|
const key = normalizeKey(rootDir)
|
||||||
|
const freshCandidates = builder()
|
||||||
|
|
||||||
|
if (!freshCandidates || freshCandidates.length === 0) {
|
||||||
|
workspaceCandidateCache.delete(key)
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
|
||||||
|
const storedCandidates = cloneEntries(freshCandidates)
|
||||||
|
workspaceCandidateCache.set(key, {
|
||||||
|
expiresAt: now + WORKSPACE_CANDIDATE_CACHE_TTL_MS,
|
||||||
|
candidates: storedCandidates,
|
||||||
|
})
|
||||||
|
|
||||||
|
return cloneEntries(storedCandidates)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function clearWorkspaceSearchCache(rootDir?: string) {
|
||||||
|
if (typeof rootDir === "undefined") {
|
||||||
|
workspaceCandidateCache.clear()
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
const key = normalizeKey(rootDir)
|
||||||
|
workspaceCandidateCache.delete(key)
|
||||||
|
}
|
||||||
|
|
||||||
|
function cloneEntries(entries: FileSystemEntry[]): FileSystemEntry[] {
|
||||||
|
return entries.map((entry) => ({ ...entry }))
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeKey(rootDir: string) {
|
||||||
|
return path.resolve(rootDir)
|
||||||
|
}
|
||||||
184
packages/server/src/filesystem/search.ts
Normal file
184
packages/server/src/filesystem/search.ts
Normal file
@@ -0,0 +1,184 @@
|
|||||||
|
import fs from "fs"
|
||||||
|
import path from "path"
|
||||||
|
import fuzzysort from "fuzzysort"
|
||||||
|
import type { FileSystemEntry } from "../api-types"
|
||||||
|
import { clearWorkspaceSearchCache, getWorkspaceCandidates, refreshWorkspaceCandidates } from "./search-cache"
|
||||||
|
|
||||||
|
const DEFAULT_LIMIT = 100
|
||||||
|
const MAX_LIMIT = 200
|
||||||
|
const MAX_CANDIDATES = 8000
|
||||||
|
const IGNORED_DIRECTORIES = new Set(
|
||||||
|
[".git", ".hg", ".svn", "node_modules", "dist", "build", ".next", ".nuxt", ".turbo", ".cache", "coverage"].map(
|
||||||
|
(name) => name.toLowerCase(),
|
||||||
|
),
|
||||||
|
)
|
||||||
|
|
||||||
|
export type WorkspaceFileSearchType = "all" | "file" | "directory"
|
||||||
|
|
||||||
|
export interface WorkspaceFileSearchOptions {
|
||||||
|
limit?: number
|
||||||
|
type?: WorkspaceFileSearchType
|
||||||
|
refresh?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
interface CandidateEntry {
|
||||||
|
entry: FileSystemEntry
|
||||||
|
key: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export function searchWorkspaceFiles(
|
||||||
|
rootDir: string,
|
||||||
|
query: string,
|
||||||
|
options: WorkspaceFileSearchOptions = {},
|
||||||
|
): FileSystemEntry[] {
|
||||||
|
const trimmedQuery = query.trim()
|
||||||
|
if (!trimmedQuery) {
|
||||||
|
throw new Error("Search query is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
const normalizedRoot = path.resolve(rootDir)
|
||||||
|
const limit = normalizeLimit(options.limit)
|
||||||
|
const typeFilter: WorkspaceFileSearchType = options.type ?? "all"
|
||||||
|
const refreshRequested = options.refresh === true
|
||||||
|
|
||||||
|
let entries: FileSystemEntry[] | undefined
|
||||||
|
|
||||||
|
try {
|
||||||
|
if (!refreshRequested) {
|
||||||
|
entries = getWorkspaceCandidates(normalizedRoot)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!entries) {
|
||||||
|
entries = refreshWorkspaceCandidates(normalizedRoot, () => collectCandidates(normalizedRoot))
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
clearWorkspaceSearchCache(normalizedRoot)
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!entries || entries.length === 0) {
|
||||||
|
clearWorkspaceSearchCache(normalizedRoot)
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
|
||||||
|
const candidates = buildCandidateEntries(entries, typeFilter)
|
||||||
|
|
||||||
|
if (candidates.length === 0) {
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
|
||||||
|
const matches = fuzzysort.go<CandidateEntry>(trimmedQuery, candidates, {
|
||||||
|
key: "key",
|
||||||
|
limit,
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!matches || matches.length === 0) {
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
|
||||||
|
return matches.map((match) => match.obj.entry)
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
function collectCandidates(rootDir: string): FileSystemEntry[] {
|
||||||
|
const queue: string[] = [""]
|
||||||
|
const entries: FileSystemEntry[] = []
|
||||||
|
|
||||||
|
while (queue.length > 0 && entries.length < MAX_CANDIDATES) {
|
||||||
|
const relativeDir = queue.pop() || ""
|
||||||
|
const absoluteDir = relativeDir ? path.join(rootDir, relativeDir) : rootDir
|
||||||
|
|
||||||
|
let dirents: fs.Dirent[]
|
||||||
|
try {
|
||||||
|
dirents = fs.readdirSync(absoluteDir, { withFileTypes: true })
|
||||||
|
} catch {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
for (const dirent of dirents) {
|
||||||
|
const entryName = dirent.name
|
||||||
|
const lowerName = entryName.toLowerCase()
|
||||||
|
const relativePath = relativeDir ? `${relativeDir}/${entryName}` : entryName
|
||||||
|
const absolutePath = path.join(absoluteDir, entryName)
|
||||||
|
|
||||||
|
if (dirent.isDirectory() && IGNORED_DIRECTORIES.has(lowerName)) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
let stats: fs.Stats
|
||||||
|
try {
|
||||||
|
stats = fs.statSync(absolutePath)
|
||||||
|
} catch {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
const isDirectory = stats.isDirectory()
|
||||||
|
|
||||||
|
if (isDirectory && !IGNORED_DIRECTORIES.has(lowerName)) {
|
||||||
|
if (entries.length < MAX_CANDIDATES) {
|
||||||
|
queue.push(relativePath)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const entryType: FileSystemEntry["type"] = isDirectory ? "directory" : "file"
|
||||||
|
const normalizedPath = normalizeRelativeEntryPath(relativePath)
|
||||||
|
const entry: FileSystemEntry = {
|
||||||
|
name: entryName,
|
||||||
|
path: normalizedPath,
|
||||||
|
absolutePath: path.resolve(rootDir, normalizedPath === "." ? "" : normalizedPath),
|
||||||
|
type: entryType,
|
||||||
|
size: entryType === "file" ? stats.size : undefined,
|
||||||
|
modifiedAt: stats.mtime.toISOString(),
|
||||||
|
}
|
||||||
|
|
||||||
|
entries.push(entry)
|
||||||
|
|
||||||
|
if (entries.length >= MAX_CANDIDATES) {
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return entries
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildCandidateEntries(entries: FileSystemEntry[], filter: WorkspaceFileSearchType): CandidateEntry[] {
|
||||||
|
const filtered: CandidateEntry[] = []
|
||||||
|
for (const entry of entries) {
|
||||||
|
if (!shouldInclude(entry.type, filter)) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
filtered.push({ entry, key: buildSearchKey(entry) })
|
||||||
|
}
|
||||||
|
return filtered
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeLimit(limit?: number) {
|
||||||
|
if (!limit || Number.isNaN(limit)) {
|
||||||
|
return DEFAULT_LIMIT
|
||||||
|
}
|
||||||
|
const clamped = Math.min(Math.max(limit, 1), MAX_LIMIT)
|
||||||
|
return clamped
|
||||||
|
}
|
||||||
|
|
||||||
|
function shouldInclude(entryType: FileSystemEntry["type"], filter: WorkspaceFileSearchType) {
|
||||||
|
return filter === "all" || entryType === filter
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeRelativeEntryPath(relativePath: string): string {
|
||||||
|
if (!relativePath) {
|
||||||
|
return "."
|
||||||
|
}
|
||||||
|
let normalized = relativePath.replace(/\\+/g, "/")
|
||||||
|
if (normalized.startsWith("./")) {
|
||||||
|
normalized = normalized.replace(/^\.\/+/, "")
|
||||||
|
}
|
||||||
|
if (normalized.startsWith("/")) {
|
||||||
|
normalized = normalized.replace(/^\/+/g, "")
|
||||||
|
}
|
||||||
|
return normalized || "."
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildSearchKey(entry: FileSystemEntry) {
|
||||||
|
return entry.path.toLowerCase()
|
||||||
|
}
|
||||||
246
packages/server/src/index.ts
Normal file
246
packages/server/src/index.ts
Normal file
@@ -0,0 +1,246 @@
|
|||||||
|
/**
|
||||||
|
* CLI entry point.
|
||||||
|
* For now this only wires the typed modules together; actual command handling comes later.
|
||||||
|
*/
|
||||||
|
import { Command, InvalidArgumentError, Option } from "commander"
|
||||||
|
import path from "path"
|
||||||
|
import { fileURLToPath } from "url"
|
||||||
|
import { createRequire } from "module"
|
||||||
|
import { createHttpServer } from "./server/http-server"
|
||||||
|
import { WorkspaceManager } from "./workspaces/manager"
|
||||||
|
import { ConfigStore } from "./config/store"
|
||||||
|
import { BinaryRegistry } from "./config/binaries"
|
||||||
|
import { FileSystemBrowser } from "./filesystem/browser"
|
||||||
|
import { EventBus } from "./events/bus"
|
||||||
|
import { ServerMeta } from "./api-types"
|
||||||
|
import { InstanceStore } from "./storage/instance-store"
|
||||||
|
import { InstanceEventBridge } from "./workspaces/instance-events"
|
||||||
|
import { createLogger } from "./logger"
|
||||||
|
import { getUserConfigPath } from "./user-data"
|
||||||
|
import { launchInBrowser } from "./launcher"
|
||||||
|
import { startReleaseMonitor } from "./releases/release-monitor"
|
||||||
|
import { initializeContextEngineService, shutdownContextEngineService } from "./context-engine"
|
||||||
|
|
||||||
|
const require = createRequire(import.meta.url)
|
||||||
|
|
||||||
|
const packageJson = require("../package.json") as { version: string }
|
||||||
|
const __filename = fileURLToPath(import.meta.url)
|
||||||
|
const __dirname = path.dirname(__filename)
|
||||||
|
const DEFAULT_UI_STATIC_DIR = path.resolve(__dirname, "../public")
|
||||||
|
|
||||||
|
interface CliOptions {
|
||||||
|
port: number
|
||||||
|
host: string
|
||||||
|
rootDir: string
|
||||||
|
configPath: string
|
||||||
|
unrestrictedRoot: boolean
|
||||||
|
logLevel?: string
|
||||||
|
logDestination?: string
|
||||||
|
uiStaticDir: string
|
||||||
|
uiDevServer?: string
|
||||||
|
launch: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
const DEFAULT_PORT = 9898
|
||||||
|
const DEFAULT_HOST = "127.0.0.1"
|
||||||
|
const DEFAULT_CONFIG_PATH = getUserConfigPath()
|
||||||
|
|
||||||
|
function parseCliOptions(argv: string[]): CliOptions {
|
||||||
|
const program = new Command()
|
||||||
|
.name("codenomad")
|
||||||
|
.description("CodeNomad CLI server")
|
||||||
|
.version(packageJson.version, "-v, --version", "Show the CLI version")
|
||||||
|
.addOption(new Option("--host <host>", "Host interface to bind").env("CLI_HOST").default(DEFAULT_HOST))
|
||||||
|
.addOption(new Option("--port <number>", "Port for the HTTP server").env("CLI_PORT").default(DEFAULT_PORT).argParser(parsePort))
|
||||||
|
.addOption(
|
||||||
|
new Option("--workspace-root <path>", "Workspace root directory").env("CLI_WORKSPACE_ROOT").default(process.cwd()),
|
||||||
|
)
|
||||||
|
.addOption(new Option("--root <path>").env("CLI_ROOT").hideHelp(true))
|
||||||
|
.addOption(new Option("--unrestricted-root", "Allow browsing the full filesystem").env("CLI_UNRESTRICTED_ROOT").default(false))
|
||||||
|
.addOption(new Option("--config <path>", "Path to the config file").env("CLI_CONFIG").default(DEFAULT_CONFIG_PATH))
|
||||||
|
.addOption(new Option("--log-level <level>", "Log level (trace|debug|info|warn|error)").env("CLI_LOG_LEVEL"))
|
||||||
|
.addOption(new Option("--log-destination <path>", "Log destination file (defaults to stdout)").env("CLI_LOG_DESTINATION"))
|
||||||
|
.addOption(
|
||||||
|
new Option("--ui-dir <path>", "Directory containing the built UI bundle").env("CLI_UI_DIR").default(DEFAULT_UI_STATIC_DIR),
|
||||||
|
)
|
||||||
|
.addOption(new Option("--ui-dev-server <url>", "Proxy UI requests to a running dev server").env("CLI_UI_DEV_SERVER"))
|
||||||
|
.addOption(new Option("--launch", "Launch the UI in a browser after start").env("CLI_LAUNCH").default(false))
|
||||||
|
|
||||||
|
program.parse(argv, { from: "user" })
|
||||||
|
const parsed = program.opts<{
|
||||||
|
host: string
|
||||||
|
port: number
|
||||||
|
workspaceRoot?: string
|
||||||
|
root?: string
|
||||||
|
unrestrictedRoot?: boolean
|
||||||
|
config: string
|
||||||
|
logLevel?: string
|
||||||
|
logDestination?: string
|
||||||
|
uiDir: string
|
||||||
|
uiDevServer?: string
|
||||||
|
launch?: boolean
|
||||||
|
}>()
|
||||||
|
|
||||||
|
const resolvedRoot = parsed.workspaceRoot ?? parsed.root ?? process.cwd()
|
||||||
|
|
||||||
|
const normalizedHost = resolveHost(parsed.host)
|
||||||
|
|
||||||
|
return {
|
||||||
|
port: parsed.port,
|
||||||
|
host: normalizedHost,
|
||||||
|
rootDir: resolvedRoot,
|
||||||
|
configPath: parsed.config,
|
||||||
|
unrestrictedRoot: Boolean(parsed.unrestrictedRoot),
|
||||||
|
logLevel: parsed.logLevel,
|
||||||
|
logDestination: parsed.logDestination,
|
||||||
|
uiStaticDir: parsed.uiDir,
|
||||||
|
uiDevServer: parsed.uiDevServer,
|
||||||
|
launch: Boolean(parsed.launch),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function parsePort(input: string): number {
|
||||||
|
const value = Number(input)
|
||||||
|
if (!Number.isInteger(value) || value < 0 || value > 65535) {
|
||||||
|
throw new InvalidArgumentError("Port must be an integer between 0 and 65535")
|
||||||
|
}
|
||||||
|
return value
|
||||||
|
}
|
||||||
|
|
||||||
|
function resolveHost(input: string | undefined): string {
|
||||||
|
if (input && input.trim() === "0.0.0.0") {
|
||||||
|
return "0.0.0.0"
|
||||||
|
}
|
||||||
|
return DEFAULT_HOST
|
||||||
|
}
|
||||||
|
|
||||||
|
async function main() {
|
||||||
|
const options = parseCliOptions(process.argv.slice(2))
|
||||||
|
const logger = createLogger({ level: options.logLevel, destination: options.logDestination, component: "app" })
|
||||||
|
const workspaceLogger = logger.child({ component: "workspace" })
|
||||||
|
const configLogger = logger.child({ component: "config" })
|
||||||
|
const eventLogger = logger.child({ component: "events" })
|
||||||
|
|
||||||
|
logger.info({ options }, "Starting CodeNomad CLI server")
|
||||||
|
|
||||||
|
const eventBus = new EventBus(eventLogger)
|
||||||
|
const configStore = new ConfigStore(options.configPath, eventBus, configLogger)
|
||||||
|
const binaryRegistry = new BinaryRegistry(configStore, eventBus, configLogger)
|
||||||
|
const workspaceManager = new WorkspaceManager({
|
||||||
|
rootDir: options.rootDir,
|
||||||
|
configStore,
|
||||||
|
binaryRegistry,
|
||||||
|
eventBus,
|
||||||
|
logger: workspaceLogger,
|
||||||
|
})
|
||||||
|
const fileSystemBrowser = new FileSystemBrowser({ rootDir: options.rootDir, unrestricted: options.unrestrictedRoot })
|
||||||
|
const instanceStore = new InstanceStore()
|
||||||
|
const instanceEventBridge = new InstanceEventBridge({
|
||||||
|
workspaceManager,
|
||||||
|
eventBus,
|
||||||
|
logger: logger.child({ component: "instance-events" }),
|
||||||
|
})
|
||||||
|
|
||||||
|
// Initialize Context-Engine service (lazy start - starts when first workspace opens)
|
||||||
|
const contextEngineService = initializeContextEngineService(
|
||||||
|
{
|
||||||
|
lazyStart: true,
|
||||||
|
port: 8000,
|
||||||
|
host: "localhost",
|
||||||
|
},
|
||||||
|
logger.child({ component: "context-engine" })
|
||||||
|
)
|
||||||
|
|
||||||
|
const serverMeta: ServerMeta = {
|
||||||
|
httpBaseUrl: `http://${options.host}:${options.port}`,
|
||||||
|
eventsUrl: `/api/events`,
|
||||||
|
host: options.host,
|
||||||
|
listeningMode: options.host === "0.0.0.0" ? "all" : "local",
|
||||||
|
port: options.port,
|
||||||
|
hostLabel: options.host,
|
||||||
|
workspaceRoot: options.rootDir,
|
||||||
|
addresses: [],
|
||||||
|
}
|
||||||
|
|
||||||
|
const releaseMonitor = startReleaseMonitor({
|
||||||
|
currentVersion: packageJson.version,
|
||||||
|
logger: logger.child({ component: "release-monitor" }),
|
||||||
|
onUpdate: (release) => {
|
||||||
|
if (release) {
|
||||||
|
serverMeta.latestRelease = release
|
||||||
|
eventBus.publish({ type: "app.releaseAvailable", release })
|
||||||
|
} else {
|
||||||
|
delete serverMeta.latestRelease
|
||||||
|
}
|
||||||
|
},
|
||||||
|
})
|
||||||
|
|
||||||
|
const server = createHttpServer({
|
||||||
|
host: options.host,
|
||||||
|
port: options.port,
|
||||||
|
workspaceManager,
|
||||||
|
configStore,
|
||||||
|
binaryRegistry,
|
||||||
|
fileSystemBrowser,
|
||||||
|
eventBus,
|
||||||
|
serverMeta,
|
||||||
|
instanceStore,
|
||||||
|
uiStaticDir: options.uiStaticDir,
|
||||||
|
uiDevServerUrl: options.uiDevServer,
|
||||||
|
logger,
|
||||||
|
})
|
||||||
|
|
||||||
|
const startInfo = await server.start()
|
||||||
|
logger.info({ port: startInfo.port, host: options.host }, "HTTP server listening")
|
||||||
|
console.log(`CodeNomad Server is ready at ${startInfo.url}`)
|
||||||
|
|
||||||
|
if (options.launch) {
|
||||||
|
await launchInBrowser(startInfo.url, logger.child({ component: "launcher" }))
|
||||||
|
}
|
||||||
|
|
||||||
|
let shuttingDown = false
|
||||||
|
|
||||||
|
const shutdown = async () => {
|
||||||
|
if (shuttingDown) {
|
||||||
|
logger.info("Shutdown already in progress, ignoring signal")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
shuttingDown = true
|
||||||
|
logger.info("Received shutdown signal, closing server")
|
||||||
|
try {
|
||||||
|
await server.stop()
|
||||||
|
logger.info("HTTP server stopped")
|
||||||
|
} catch (error) {
|
||||||
|
logger.error({ err: error }, "Failed to stop HTTP server")
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
instanceEventBridge.shutdown()
|
||||||
|
await workspaceManager.shutdown()
|
||||||
|
logger.info("Workspace manager shutdown complete")
|
||||||
|
} catch (error) {
|
||||||
|
logger.error({ err: error }, "Workspace manager shutdown failed")
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
await shutdownContextEngineService()
|
||||||
|
logger.info("Context-Engine shutdown complete")
|
||||||
|
} catch (error) {
|
||||||
|
logger.error({ err: error }, "Context-Engine shutdown failed")
|
||||||
|
}
|
||||||
|
|
||||||
|
releaseMonitor.stop()
|
||||||
|
|
||||||
|
logger.info("Exiting process")
|
||||||
|
process.exit(0)
|
||||||
|
}
|
||||||
|
|
||||||
|
process.on("SIGINT", shutdown)
|
||||||
|
process.on("SIGTERM", shutdown)
|
||||||
|
}
|
||||||
|
|
||||||
|
main().catch((error) => {
|
||||||
|
const logger = createLogger({ component: "app" })
|
||||||
|
logger.error({ err: error }, "CLI server crashed")
|
||||||
|
process.exit(1)
|
||||||
|
})
|
||||||
537
packages/server/src/integrations/ollama-cloud.ts
Normal file
537
packages/server/src/integrations/ollama-cloud.ts
Normal file
@@ -0,0 +1,537 @@
|
|||||||
|
import { z } from "zod"
|
||||||
|
import { getContextEngineService } from "../context-engine"
|
||||||
|
|
||||||
|
export const OllamaCloudConfigSchema = z.object({
|
||||||
|
apiKey: z.string().optional(),
|
||||||
|
endpoint: z.string().default("https://ollama.com"),
|
||||||
|
enabled: z.boolean().default(false)
|
||||||
|
})
|
||||||
|
|
||||||
|
export type OllamaCloudConfig = z.infer<typeof OllamaCloudConfigSchema>
|
||||||
|
|
||||||
|
// Schema is flexible since Ollama Cloud may return different fields than local Ollama
|
||||||
|
export const OllamaModelSchema = z.object({
|
||||||
|
name: z.string(),
|
||||||
|
model: z.string().optional(), // Some APIs return model instead of name
|
||||||
|
size: z.union([z.string(), z.number()]).optional(),
|
||||||
|
digest: z.string().optional(),
|
||||||
|
modified_at: z.string().optional(),
|
||||||
|
created_at: z.string().optional(),
|
||||||
|
details: z.any().optional() // Model details like family, parameter_size, etc.
|
||||||
|
})
|
||||||
|
|
||||||
|
export type OllamaModel = z.infer<typeof OllamaModelSchema>
|
||||||
|
|
||||||
|
export const ChatMessageSchema = z.object({
|
||||||
|
role: z.enum(["user", "assistant", "system"]),
|
||||||
|
content: z.string(),
|
||||||
|
images: z.array(z.string()).optional(),
|
||||||
|
tool_calls: z.array(z.any()).optional(),
|
||||||
|
thinking: z.string().optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ChatMessage = z.infer<typeof ChatMessageSchema>
|
||||||
|
|
||||||
|
export const ToolCallSchema = z.object({
|
||||||
|
name: z.string(),
|
||||||
|
arguments: z.record(z.any())
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ToolCall = z.infer<typeof ToolCallSchema>
|
||||||
|
|
||||||
|
export const ToolDefinitionSchema = z.object({
|
||||||
|
name: z.string(),
|
||||||
|
description: z.string(),
|
||||||
|
parameters: z.object({
|
||||||
|
type: z.enum(["object", "string", "number", "boolean", "array"]),
|
||||||
|
properties: z.record(z.any()),
|
||||||
|
required: z.array(z.string()).optional()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ToolDefinition = z.infer<typeof ToolDefinitionSchema>
|
||||||
|
|
||||||
|
export const ChatRequestSchema = z.object({
|
||||||
|
model: z.string(),
|
||||||
|
messages: z.array(ChatMessageSchema),
|
||||||
|
stream: z.boolean().default(false),
|
||||||
|
think: z.union([z.boolean(), z.enum(["low", "medium", "high"])]).optional(),
|
||||||
|
format: z.union([z.literal("json"), z.any()]).optional(),
|
||||||
|
tools: z.array(ToolDefinitionSchema).optional(),
|
||||||
|
web_search: z.boolean().optional(),
|
||||||
|
options: z.object({
|
||||||
|
temperature: z.number().min(0).max(2).optional(),
|
||||||
|
top_p: z.number().min(0).max(1).optional()
|
||||||
|
}).optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export const ChatResponseSchema = z.object({
|
||||||
|
model: z.string(),
|
||||||
|
created_at: z.string(),
|
||||||
|
message: ChatMessageSchema.extend({
|
||||||
|
thinking: z.string().optional(),
|
||||||
|
tool_calls: z.array(z.any()).optional()
|
||||||
|
}),
|
||||||
|
done: z.boolean().optional(),
|
||||||
|
total_duration: z.number().optional(),
|
||||||
|
load_duration: z.number().optional(),
|
||||||
|
prompt_eval_count: z.number().optional(),
|
||||||
|
prompt_eval_duration: z.number().optional(),
|
||||||
|
eval_count: z.number().optional(),
|
||||||
|
eval_duration: z.number().optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ChatRequest = z.infer<typeof ChatRequestSchema>
|
||||||
|
export type ChatResponse = z.infer<typeof ChatResponseSchema>
|
||||||
|
|
||||||
|
export const EmbeddingRequestSchema = z.object({
|
||||||
|
model: z.string(),
|
||||||
|
input: z.union([z.string(), z.array(z.string())])
|
||||||
|
})
|
||||||
|
|
||||||
|
export type EmbeddingRequest = z.infer<typeof EmbeddingRequestSchema>
|
||||||
|
|
||||||
|
export const EmbeddingResponseSchema = z.object({
|
||||||
|
model: z.string(),
|
||||||
|
embeddings: z.array(z.array(z.number()))
|
||||||
|
})
|
||||||
|
|
||||||
|
export type EmbeddingResponse = z.infer<typeof EmbeddingResponseSchema>
|
||||||
|
|
||||||
|
export class OllamaCloudClient {
|
||||||
|
private config: OllamaCloudConfig
|
||||||
|
private baseUrl: string
|
||||||
|
|
||||||
|
constructor(config: OllamaCloudConfig) {
|
||||||
|
this.config = config
|
||||||
|
this.baseUrl = config.endpoint.replace(/\/$/, "")
|
||||||
|
}
|
||||||
|
|
||||||
|
async testConnection(): Promise<boolean> {
|
||||||
|
try {
|
||||||
|
const response = await this.makeRequest("/tags", { method: "GET" })
|
||||||
|
return response.ok
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Ollama Cloud connection test failed:", error)
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async listModels(): Promise<OllamaModel[]> {
|
||||||
|
try {
|
||||||
|
const headers: Record<string, string> = {}
|
||||||
|
if (this.config.apiKey) {
|
||||||
|
headers["Authorization"] = `Bearer ${this.config.apiKey}`
|
||||||
|
}
|
||||||
|
|
||||||
|
const cloudResponse = await fetch(`${this.baseUrl}/v1/models`, {
|
||||||
|
method: "GET",
|
||||||
|
headers
|
||||||
|
})
|
||||||
|
|
||||||
|
if (cloudResponse.ok) {
|
||||||
|
const data = await cloudResponse.json()
|
||||||
|
const modelsArray = Array.isArray(data?.data) ? data.data : []
|
||||||
|
const parsedModels = modelsArray
|
||||||
|
.map((model: any) => ({
|
||||||
|
name: model.id || model.name || model.model,
|
||||||
|
model: model.id || model.model || model.name,
|
||||||
|
}))
|
||||||
|
.filter((model: any) => model.name)
|
||||||
|
|
||||||
|
if (parsedModels.length > 0) {
|
||||||
|
return parsedModels
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await this.makeRequest("/tags", { method: "GET" })
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const errorText = await response.text().catch(() => "Unknown error")
|
||||||
|
console.error(`[OllamaCloud] Failed to fetch models: ${response.status} ${response.statusText}`, errorText)
|
||||||
|
throw new Error(`Failed to fetch models: ${response.status} ${response.statusText} - ${errorText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await response.json()
|
||||||
|
console.log("[OllamaCloud] Models response:", JSON.stringify(data).substring(0, 500))
|
||||||
|
|
||||||
|
// Handle different response formats flexibly
|
||||||
|
const modelsArray = Array.isArray(data.models) ? data.models :
|
||||||
|
Array.isArray(data) ? data : []
|
||||||
|
|
||||||
|
// Parse with flexible schema, don't throw on validation failure
|
||||||
|
// Only include cloud-compatible models (ending in -cloud or known cloud models)
|
||||||
|
const parsedModels: OllamaModel[] = []
|
||||||
|
for (const model of modelsArray) {
|
||||||
|
try {
|
||||||
|
const modelName = model.name || model.model || ""
|
||||||
|
// Filter to only cloud-compatible models
|
||||||
|
const isCloudModel = modelName.endsWith("-cloud") ||
|
||||||
|
modelName.includes(":cloud") ||
|
||||||
|
modelName.startsWith("gpt-oss") ||
|
||||||
|
modelName.startsWith("qwen3-coder") ||
|
||||||
|
modelName.startsWith("deepseek-v3")
|
||||||
|
|
||||||
|
if (modelName && isCloudModel) {
|
||||||
|
parsedModels.push({
|
||||||
|
name: modelName,
|
||||||
|
model: model.model || modelName,
|
||||||
|
size: model.size,
|
||||||
|
digest: model.digest,
|
||||||
|
modified_at: model.modified_at,
|
||||||
|
created_at: model.created_at,
|
||||||
|
details: model.details
|
||||||
|
})
|
||||||
|
}
|
||||||
|
} catch (parseError) {
|
||||||
|
console.warn("[OllamaCloud] Skipping model due to parse error:", model, parseError)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log(`[OllamaCloud] Parsed ${parsedModels.length} cloud-compatible models`)
|
||||||
|
return parsedModels
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Failed to list Ollama Cloud models:", error)
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async chat(request: ChatRequest): Promise<AsyncIterable<ChatResponse>> {
|
||||||
|
if (!this.config.apiKey) {
|
||||||
|
throw new Error("Ollama Cloud API key is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
const headers: Record<string, string> = {
|
||||||
|
"Content-Type": "application/json"
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.config.apiKey) {
|
||||||
|
headers["Authorization"] = `Bearer ${this.config.apiKey}`
|
||||||
|
}
|
||||||
|
|
||||||
|
// Inject Context-Engine RAG context if available
|
||||||
|
let enrichedRequest = request
|
||||||
|
try {
|
||||||
|
const contextEngine = getContextEngineService()
|
||||||
|
if (contextEngine?.isReady()) {
|
||||||
|
// Get the last user message for context retrieval
|
||||||
|
const lastUserMessage = [...request.messages].reverse().find(m => m.role === "user")
|
||||||
|
if (lastUserMessage?.content) {
|
||||||
|
const contextBlock = await contextEngine.query(lastUserMessage.content, 4096)
|
||||||
|
if (contextBlock) {
|
||||||
|
// Clone messages and inject context into the last user message
|
||||||
|
const messagesWithContext = request.messages.map((msg, index) => {
|
||||||
|
if (msg === lastUserMessage) {
|
||||||
|
return {
|
||||||
|
...msg,
|
||||||
|
content: `${contextBlock}\n\n${msg.content}`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return msg
|
||||||
|
})
|
||||||
|
enrichedRequest = { ...request, messages: messagesWithContext }
|
||||||
|
console.log("[OllamaCloud] Context-Engine context injected")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (contextError) {
|
||||||
|
// Graceful fallback - continue without context if Context-Engine fails
|
||||||
|
console.warn("[OllamaCloud] Context-Engine query failed, continuing without RAG context:", contextError)
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.makeRequest("/chat", {
|
||||||
|
method: "POST",
|
||||||
|
headers,
|
||||||
|
body: JSON.stringify(enrichedRequest)
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const errorText = await response.text()
|
||||||
|
throw new Error(`Chat request failed: ${response.statusText} - ${errorText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (request.stream) {
|
||||||
|
return this.parseStreamingResponse(response)
|
||||||
|
} else {
|
||||||
|
const data = ChatResponseSchema.parse(await response.json())
|
||||||
|
return this.createAsyncIterable([data])
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Ollama Cloud chat request failed:", error)
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async chatWithThinking(request: ChatRequest): Promise<AsyncIterable<ChatResponse>> {
|
||||||
|
const requestWithThinking = {
|
||||||
|
...request,
|
||||||
|
think: true
|
||||||
|
}
|
||||||
|
return this.chat(requestWithThinking)
|
||||||
|
}
|
||||||
|
|
||||||
|
async chatWithStructuredOutput(request: ChatRequest, schema: any): Promise<AsyncIterable<ChatResponse>> {
|
||||||
|
const requestWithFormat = {
|
||||||
|
...request,
|
||||||
|
format: schema
|
||||||
|
}
|
||||||
|
return this.chat(requestWithFormat)
|
||||||
|
}
|
||||||
|
|
||||||
|
async chatWithVision(request: ChatRequest, images: string[]): Promise<AsyncIterable<ChatResponse>> {
|
||||||
|
if (!request.messages.length) {
|
||||||
|
throw new Error("At least one message is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
const messagesWithImages = [...request.messages]
|
||||||
|
const lastUserMessage = messagesWithImages.slice().reverse().find(m => m.role === "user")
|
||||||
|
|
||||||
|
if (lastUserMessage) {
|
||||||
|
lastUserMessage.images = images
|
||||||
|
}
|
||||||
|
|
||||||
|
return this.chat({ ...request, messages: messagesWithImages })
|
||||||
|
}
|
||||||
|
|
||||||
|
async chatWithTools(request: ChatRequest, tools: ToolDefinition[]): Promise<AsyncIterable<ChatResponse>> {
|
||||||
|
const requestWithTools = {
|
||||||
|
...request,
|
||||||
|
tools
|
||||||
|
}
|
||||||
|
return this.chat(requestWithTools)
|
||||||
|
}
|
||||||
|
|
||||||
|
async chatWithWebSearch(request: ChatRequest): Promise<AsyncIterable<ChatResponse>> {
|
||||||
|
const requestWithWebSearch = {
|
||||||
|
...request,
|
||||||
|
web_search: true
|
||||||
|
}
|
||||||
|
return this.chat(requestWithWebSearch)
|
||||||
|
}
|
||||||
|
|
||||||
|
async generateEmbeddings(request: EmbeddingRequest): Promise<EmbeddingResponse> {
|
||||||
|
if (!this.config.apiKey) {
|
||||||
|
throw new Error("Ollama Cloud API key is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
const headers: Record<string, string> = {
|
||||||
|
"Content-Type": "application/json"
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.config.apiKey) {
|
||||||
|
headers["Authorization"] = `Bearer ${this.config.apiKey}`
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.makeRequest("/embed", {
|
||||||
|
method: "POST",
|
||||||
|
headers,
|
||||||
|
body: JSON.stringify(request)
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`Embeddings request failed: ${response.statusText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await response.json()
|
||||||
|
return EmbeddingResponseSchema.parse(data)
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Ollama Cloud embeddings request failed:", error)
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async pullModel(modelName: string): Promise<void> {
|
||||||
|
const headers: Record<string, string> = {
|
||||||
|
"Content-Type": "application/json"
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.config.apiKey) {
|
||||||
|
headers["Authorization"] = `Bearer ${this.config.apiKey}`
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await this.makeRequest("/pull", {
|
||||||
|
method: "POST",
|
||||||
|
headers,
|
||||||
|
body: JSON.stringify({ name: modelName })
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`Failed to pull model ${modelName}: ${response.statusText}`)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private async *parseStreamingResponse(response: Response): AsyncIterable<ChatResponse> {
|
||||||
|
if (!response.body) {
|
||||||
|
throw new Error("Response body is missing")
|
||||||
|
}
|
||||||
|
|
||||||
|
const reader = response.body.getReader()
|
||||||
|
const decoder = new TextDecoder()
|
||||||
|
const STREAM_TIMEOUT_MS = 60000 // 60 second timeout per chunk
|
||||||
|
let lastActivity = Date.now()
|
||||||
|
|
||||||
|
const checkTimeout = () => {
|
||||||
|
if (Date.now() - lastActivity > STREAM_TIMEOUT_MS) {
|
||||||
|
reader.cancel().catch(() => { })
|
||||||
|
throw new Error("Stream timeout - no data received for 60 seconds")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
while (true) {
|
||||||
|
checkTimeout()
|
||||||
|
|
||||||
|
// Create a timeout promise
|
||||||
|
const timeoutPromise = new Promise<never>((_, reject) => {
|
||||||
|
setTimeout(() => reject(new Error("Read timeout")), STREAM_TIMEOUT_MS)
|
||||||
|
})
|
||||||
|
|
||||||
|
// Race the read against the timeout
|
||||||
|
let result: ReadableStreamReadResult<Uint8Array>
|
||||||
|
try {
|
||||||
|
result = await Promise.race([reader.read(), timeoutPromise])
|
||||||
|
} catch (timeoutError) {
|
||||||
|
reader.cancel().catch(() => { })
|
||||||
|
throw new Error("Stream read timeout")
|
||||||
|
}
|
||||||
|
|
||||||
|
const { done, value } = result
|
||||||
|
if (done) break
|
||||||
|
|
||||||
|
lastActivity = Date.now()
|
||||||
|
|
||||||
|
const lines = decoder.decode(value, { stream: true }).split('\n').filter(line => line.trim())
|
||||||
|
|
||||||
|
for (const line of lines) {
|
||||||
|
try {
|
||||||
|
const data = JSON.parse(line)
|
||||||
|
const chatResponse = ChatResponseSchema.parse(data)
|
||||||
|
yield chatResponse
|
||||||
|
|
||||||
|
if (chatResponse.done) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
} catch (parseError) {
|
||||||
|
console.warn("Failed to parse streaming line:", line, parseError)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
reader.releaseLock()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private async *createAsyncIterable<T>(items: T[]): AsyncIterable<T> {
|
||||||
|
for (const item of items) {
|
||||||
|
yield item
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private async makeRequest(endpoint: string, options: RequestInit, timeoutMs: number = 120000): Promise<Response> {
|
||||||
|
// Ensure endpoint starts with /api
|
||||||
|
const apiEndpoint = endpoint.startsWith('/api') ? endpoint : `/api${endpoint}`
|
||||||
|
const url = `${this.baseUrl}${apiEndpoint}`
|
||||||
|
|
||||||
|
const headers: Record<string, string> = {
|
||||||
|
...options.headers as Record<string, string>
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.config.apiKey) {
|
||||||
|
headers["Authorization"] = `Bearer ${this.config.apiKey}`
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log(`[OllamaCloud] Making request to: ${url}`)
|
||||||
|
|
||||||
|
// Add timeout to prevent indefinite hangs
|
||||||
|
const controller = new AbortController()
|
||||||
|
const timeoutId = setTimeout(() => controller.abort(), timeoutMs)
|
||||||
|
|
||||||
|
try {
|
||||||
|
return await fetch(url, {
|
||||||
|
...options,
|
||||||
|
headers,
|
||||||
|
signal: controller.signal
|
||||||
|
})
|
||||||
|
} finally {
|
||||||
|
clearTimeout(timeoutId)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async getCloudModels(): Promise<OllamaModel[]> {
|
||||||
|
const allModels = await this.listModels()
|
||||||
|
return allModels.filter(model => model.name.endsWith("-cloud"))
|
||||||
|
}
|
||||||
|
|
||||||
|
static validateApiKey(apiKey: string): boolean {
|
||||||
|
return typeof apiKey === "string" && apiKey.length > 0
|
||||||
|
}
|
||||||
|
|
||||||
|
async getCloudModelNames(): Promise<string[]> {
|
||||||
|
const cloudModels = await this.getCloudModels()
|
||||||
|
return cloudModels.map(model => model.name)
|
||||||
|
}
|
||||||
|
|
||||||
|
async getThinkingCapableModels(): Promise<string[]> {
|
||||||
|
const allModels = await this.listModels()
|
||||||
|
const thinkingModelPatterns = ["qwen3", "deepseek-r1", "gpt-oss", "deepseek-v3.1"]
|
||||||
|
return allModels
|
||||||
|
.map(m => m.name)
|
||||||
|
.filter(name => thinkingModelPatterns.some(pattern => name.toLowerCase().includes(pattern)))
|
||||||
|
}
|
||||||
|
|
||||||
|
async getVisionCapableModels(): Promise<string[]> {
|
||||||
|
const allModels = await this.listModels()
|
||||||
|
const visionModelPatterns = ["gemma3", "llama3.2-vision", "llava", "bakllava", "minicpm-v"]
|
||||||
|
return allModels
|
||||||
|
.map(m => m.name)
|
||||||
|
.filter(name => visionModelPatterns.some(pattern => name.toLowerCase().includes(pattern)))
|
||||||
|
}
|
||||||
|
|
||||||
|
async getEmbeddingModels(): Promise<string[]> {
|
||||||
|
const allModels = await this.listModels()
|
||||||
|
const embeddingModelPatterns = ["embeddinggemma", "qwen3-embedding", "all-minilm", "nomic-embed", "mxbai-embed"]
|
||||||
|
return allModels
|
||||||
|
.map(m => m.name)
|
||||||
|
.filter(name => embeddingModelPatterns.some(pattern => name.toLowerCase().includes(pattern)))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export const DEFAULT_CLOUD_MODELS = [
|
||||||
|
"gpt-oss:120b-cloud",
|
||||||
|
"llama3.1:70b-cloud",
|
||||||
|
"llama3.1:8b-cloud",
|
||||||
|
"qwen2.5:32b-cloud",
|
||||||
|
"qwen2.5:7b-cloud"
|
||||||
|
] as const
|
||||||
|
|
||||||
|
export type CloudModelName = typeof DEFAULT_CLOUD_MODELS[number]
|
||||||
|
|
||||||
|
export const THINKING_MODELS = [
|
||||||
|
"qwen3",
|
||||||
|
"deepseek-r1",
|
||||||
|
"deepseek-v3.1",
|
||||||
|
"gpt-oss:120b-cloud"
|
||||||
|
] as const
|
||||||
|
|
||||||
|
export type ThinkingModelName = typeof THINKING_MODELS[number]
|
||||||
|
|
||||||
|
export const VISION_MODELS = [
|
||||||
|
"gemma3",
|
||||||
|
"llava",
|
||||||
|
"bakllava",
|
||||||
|
"minicpm-v"
|
||||||
|
] as const
|
||||||
|
|
||||||
|
export type VisionModelName = typeof VISION_MODELS[number]
|
||||||
|
|
||||||
|
export const EMBEDDING_MODELS = [
|
||||||
|
"embeddinggemma",
|
||||||
|
"qwen3-embedding",
|
||||||
|
"all-minilm",
|
||||||
|
"nomic-embed-text",
|
||||||
|
"mxbai-embed-large"
|
||||||
|
] as const
|
||||||
|
|
||||||
|
export type EmbeddingModelName = typeof EMBEDDING_MODELS[number]
|
||||||
370
packages/server/src/integrations/opencode-zen.ts
Normal file
370
packages/server/src/integrations/opencode-zen.ts
Normal file
@@ -0,0 +1,370 @@
|
|||||||
|
/**
|
||||||
|
* OpenCode Zen API Integration
|
||||||
|
* Provides direct access to OpenCode's free "Zen" models without requiring opencode.exe
|
||||||
|
* Based on reverse-engineering the OpenCode source at https://github.com/sst/opencode
|
||||||
|
*
|
||||||
|
* Free models (cost.input === 0) can be accessed with apiKey: "public"
|
||||||
|
*/
|
||||||
|
|
||||||
|
import { z } from "zod"
|
||||||
|
|
||||||
|
// Configuration schema for OpenCode Zen
|
||||||
|
export const OpenCodeZenConfigSchema = z.object({
|
||||||
|
enabled: z.boolean().default(true), // Free models enabled by default
|
||||||
|
endpoint: z.string().default("https://opencode.ai/zen/v1"),
|
||||||
|
apiKey: z.string().optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type OpenCodeZenConfig = z.infer<typeof OpenCodeZenConfigSchema>
|
||||||
|
|
||||||
|
// Model schema matching models.dev format
|
||||||
|
export const ZenModelSchema = z.object({
|
||||||
|
id: z.string(),
|
||||||
|
name: z.string(),
|
||||||
|
family: z.string().optional(),
|
||||||
|
reasoning: z.boolean().optional(),
|
||||||
|
tool_call: z.boolean().optional(),
|
||||||
|
attachment: z.boolean().optional(),
|
||||||
|
temperature: z.boolean().optional(),
|
||||||
|
cost: z.object({
|
||||||
|
input: z.number(),
|
||||||
|
output: z.number(),
|
||||||
|
cache_read: z.number().optional(),
|
||||||
|
cache_write: z.number().optional()
|
||||||
|
}).optional(),
|
||||||
|
limit: z.object({
|
||||||
|
context: z.number(),
|
||||||
|
output: z.number()
|
||||||
|
}).optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ZenModel = z.infer<typeof ZenModelSchema>
|
||||||
|
|
||||||
|
// Chat message schema (OpenAI-compatible)
|
||||||
|
export const ChatMessageSchema = z.object({
|
||||||
|
role: z.enum(["user", "assistant", "system", "tool"]),
|
||||||
|
content: z.string().optional(),
|
||||||
|
tool_calls: z.array(z.object({
|
||||||
|
id: z.string(),
|
||||||
|
type: z.literal("function"),
|
||||||
|
function: z.object({
|
||||||
|
name: z.string(),
|
||||||
|
arguments: z.string()
|
||||||
|
})
|
||||||
|
})).optional(),
|
||||||
|
tool_call_id: z.string().optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ChatMessage = z.infer<typeof ChatMessageSchema>
|
||||||
|
|
||||||
|
// Chat request schema
|
||||||
|
// Tool Definition Schema
|
||||||
|
export const ToolDefinitionSchema = z.object({
|
||||||
|
type: z.literal("function"),
|
||||||
|
function: z.object({
|
||||||
|
name: z.string(),
|
||||||
|
description: z.string(),
|
||||||
|
parameters: z.object({
|
||||||
|
type: z.literal("object"),
|
||||||
|
properties: z.record(z.any()),
|
||||||
|
required: z.array(z.string()).optional()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ToolDefinition = z.infer<typeof ToolDefinitionSchema>
|
||||||
|
|
||||||
|
export const ChatRequestSchema = z.object({
|
||||||
|
model: z.string(),
|
||||||
|
messages: z.array(ChatMessageSchema),
|
||||||
|
stream: z.boolean().default(true),
|
||||||
|
temperature: z.number().optional(),
|
||||||
|
max_tokens: z.number().optional(),
|
||||||
|
tools: z.array(ToolDefinitionSchema).optional(),
|
||||||
|
tool_choice: z.union([
|
||||||
|
z.literal("auto"),
|
||||||
|
z.literal("none"),
|
||||||
|
z.object({
|
||||||
|
type: z.literal("function"),
|
||||||
|
function: z.object({ name: z.string() })
|
||||||
|
})
|
||||||
|
]).optional(),
|
||||||
|
workspacePath: z.string().optional(),
|
||||||
|
enableTools: z.boolean().optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ChatRequest = z.infer<typeof ChatRequestSchema>
|
||||||
|
|
||||||
|
// Chat response chunk schema
|
||||||
|
export const ChatChunkSchema = z.object({
|
||||||
|
id: z.string().optional(),
|
||||||
|
object: z.string().optional(),
|
||||||
|
created: z.number().optional(),
|
||||||
|
model: z.string().optional(),
|
||||||
|
choices: z.array(z.object({
|
||||||
|
index: z.number(),
|
||||||
|
delta: z.object({
|
||||||
|
role: z.string().optional(),
|
||||||
|
content: z.string().optional()
|
||||||
|
}).optional(),
|
||||||
|
message: z.object({
|
||||||
|
role: z.string(),
|
||||||
|
content: z.string()
|
||||||
|
}).optional(),
|
||||||
|
finish_reason: z.string().nullable().optional()
|
||||||
|
}))
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ChatChunk = z.infer<typeof ChatChunkSchema>
|
||||||
|
|
||||||
|
// Known free OpenCode Zen models (cost.input === 0)
|
||||||
|
// From models.dev API - these are the free tier models
|
||||||
|
export const FREE_ZEN_MODELS: ZenModel[] = [
|
||||||
|
{
|
||||||
|
id: "gpt-5-nano",
|
||||||
|
name: "GPT-5 Nano",
|
||||||
|
family: "gpt-5-nano",
|
||||||
|
reasoning: true,
|
||||||
|
tool_call: true,
|
||||||
|
attachment: true,
|
||||||
|
temperature: false,
|
||||||
|
cost: { input: 0, output: 0 },
|
||||||
|
limit: { context: 400000, output: 128000 }
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "big-pickle",
|
||||||
|
name: "Big Pickle",
|
||||||
|
family: "pickle",
|
||||||
|
reasoning: false,
|
||||||
|
tool_call: true,
|
||||||
|
attachment: false,
|
||||||
|
temperature: true,
|
||||||
|
cost: { input: 0, output: 0 },
|
||||||
|
limit: { context: 200000, output: 128000 }
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "grok-code",
|
||||||
|
name: "Grok Code Fast 1",
|
||||||
|
family: "grok",
|
||||||
|
reasoning: true,
|
||||||
|
tool_call: true,
|
||||||
|
attachment: false,
|
||||||
|
temperature: true,
|
||||||
|
cost: { input: 0, output: 0 },
|
||||||
|
limit: { context: 256000, output: 256000 }
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "glm-4.7-free",
|
||||||
|
name: "GLM-4.7",
|
||||||
|
family: "glm-free",
|
||||||
|
reasoning: true,
|
||||||
|
tool_call: true,
|
||||||
|
attachment: false,
|
||||||
|
temperature: true,
|
||||||
|
cost: { input: 0, output: 0 },
|
||||||
|
limit: { context: 204800, output: 131072 }
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "alpha-doubao-seed-code",
|
||||||
|
name: "Doubao Seed Code (alpha)",
|
||||||
|
family: "doubao",
|
||||||
|
reasoning: true,
|
||||||
|
tool_call: true,
|
||||||
|
attachment: false,
|
||||||
|
temperature: true,
|
||||||
|
cost: { input: 0, output: 0 },
|
||||||
|
limit: { context: 256000, output: 32000 }
|
||||||
|
}
|
||||||
|
]
|
||||||
|
|
||||||
|
export class OpenCodeZenClient {
|
||||||
|
private config: OpenCodeZenConfig
|
||||||
|
private baseUrl: string
|
||||||
|
private modelsCache: ZenModel[] | null = null
|
||||||
|
private modelsCacheTime: number = 0
|
||||||
|
private readonly CACHE_TTL_MS = 5 * 60 * 1000 // 5 minutes
|
||||||
|
|
||||||
|
constructor(config?: Partial<OpenCodeZenConfig>) {
|
||||||
|
this.config = OpenCodeZenConfigSchema.parse(config || {})
|
||||||
|
this.baseUrl = this.config.endpoint.replace(/\/$/, "")
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get free Zen models from OpenCode
|
||||||
|
*/
|
||||||
|
async getModels(): Promise<ZenModel[]> {
|
||||||
|
// Return cached models if still valid
|
||||||
|
const now = Date.now()
|
||||||
|
if (this.modelsCache && (now - this.modelsCacheTime) < this.CACHE_TTL_MS) {
|
||||||
|
return this.modelsCache
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
// Try to fetch fresh models from models.dev
|
||||||
|
const response = await fetch("https://models.dev/api.json", {
|
||||||
|
headers: {
|
||||||
|
"User-Agent": "NomadArch/1.0"
|
||||||
|
},
|
||||||
|
signal: AbortSignal.timeout(10000)
|
||||||
|
})
|
||||||
|
|
||||||
|
if (response.ok) {
|
||||||
|
const data = await response.json()
|
||||||
|
// Extract OpenCode provider and filter free models
|
||||||
|
const opencodeProvider = data["opencode"]
|
||||||
|
if (opencodeProvider && opencodeProvider.models) {
|
||||||
|
const freeModels: ZenModel[] = []
|
||||||
|
for (const [id, model] of Object.entries(opencodeProvider.models)) {
|
||||||
|
const m = model as any
|
||||||
|
if (m.cost && m.cost.input === 0) {
|
||||||
|
freeModels.push({
|
||||||
|
id,
|
||||||
|
name: m.name,
|
||||||
|
family: m.family,
|
||||||
|
reasoning: m.reasoning,
|
||||||
|
tool_call: m.tool_call,
|
||||||
|
attachment: m.attachment,
|
||||||
|
temperature: m.temperature,
|
||||||
|
cost: m.cost,
|
||||||
|
limit: m.limit
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (freeModels.length > 0) {
|
||||||
|
this.modelsCache = freeModels
|
||||||
|
this.modelsCacheTime = now
|
||||||
|
return freeModels
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.warn("Failed to fetch models from models.dev, using fallback:", error)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Fallback to hardcoded free models
|
||||||
|
this.modelsCache = FREE_ZEN_MODELS
|
||||||
|
this.modelsCacheTime = now
|
||||||
|
return FREE_ZEN_MODELS
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test connection to OpenCode Zen API
|
||||||
|
*/
|
||||||
|
async testConnection(): Promise<boolean> {
|
||||||
|
try {
|
||||||
|
const models = await this.getModels()
|
||||||
|
return models.length > 0
|
||||||
|
} catch (error) {
|
||||||
|
console.error("OpenCode Zen connection test failed:", error)
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Chat completion (streaming)
|
||||||
|
*/
|
||||||
|
async *chatStream(request: ChatRequest): AsyncGenerator<ChatChunk> {
|
||||||
|
const headers: Record<string, string> = {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
"User-Agent": "NomadArch/1.0",
|
||||||
|
"HTTP-Referer": "https://opencode.ai/",
|
||||||
|
"X-Title": "NomadArch"
|
||||||
|
}
|
||||||
|
if (this.config.apiKey) {
|
||||||
|
headers["Authorization"] = `Bearer ${this.config.apiKey}`
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await fetch(`${this.baseUrl}/chat/completions`, {
|
||||||
|
method: "POST",
|
||||||
|
headers,
|
||||||
|
body: JSON.stringify({
|
||||||
|
...request,
|
||||||
|
stream: true
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const errorText = await response.text()
|
||||||
|
throw new Error(`OpenCode Zen API error (${response.status}): ${errorText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!response.body) {
|
||||||
|
throw new Error("Response body is missing")
|
||||||
|
}
|
||||||
|
|
||||||
|
const reader = response.body.getReader()
|
||||||
|
const decoder = new TextDecoder()
|
||||||
|
let buffer = ""
|
||||||
|
|
||||||
|
try {
|
||||||
|
while (true) {
|
||||||
|
const { done, value } = await reader.read()
|
||||||
|
if (done) break
|
||||||
|
|
||||||
|
buffer += decoder.decode(value, { stream: true })
|
||||||
|
const lines = buffer.split("\n")
|
||||||
|
buffer = lines.pop() || ""
|
||||||
|
|
||||||
|
for (const line of lines) {
|
||||||
|
const trimmed = line.trim()
|
||||||
|
if (trimmed.startsWith("data: ")) {
|
||||||
|
const data = trimmed.slice(6)
|
||||||
|
if (data === "[DONE]") return
|
||||||
|
|
||||||
|
try {
|
||||||
|
const parsed = JSON.parse(data)
|
||||||
|
yield parsed as ChatChunk
|
||||||
|
|
||||||
|
// Check for finish
|
||||||
|
if (parsed.choices?.[0]?.finish_reason) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
// Skip invalid JSON
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
reader.releaseLock()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Chat completion (non-streaming)
|
||||||
|
*/
|
||||||
|
async chat(request: ChatRequest): Promise<ChatChunk> {
|
||||||
|
const headers: Record<string, string> = {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
"User-Agent": "NomadArch/1.0",
|
||||||
|
"HTTP-Referer": "https://opencode.ai/",
|
||||||
|
"X-Title": "NomadArch"
|
||||||
|
}
|
||||||
|
if (this.config.apiKey) {
|
||||||
|
headers["Authorization"] = `Bearer ${this.config.apiKey}`
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await fetch(`${this.baseUrl}/chat/completions`, {
|
||||||
|
method: "POST",
|
||||||
|
headers,
|
||||||
|
body: JSON.stringify({
|
||||||
|
...request,
|
||||||
|
stream: false
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const errorText = await response.text()
|
||||||
|
throw new Error(`OpenCode Zen API error (${response.status}): ${errorText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
return await response.json()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function getDefaultZenConfig(): OpenCodeZenConfig {
|
||||||
|
return {
|
||||||
|
enabled: true,
|
||||||
|
endpoint: "https://opencode.ai/zen/v1"
|
||||||
|
}
|
||||||
|
}
|
||||||
309
packages/server/src/integrations/zai-api.ts
Normal file
309
packages/server/src/integrations/zai-api.ts
Normal file
@@ -0,0 +1,309 @@
|
|||||||
|
import { z } from "zod"
|
||||||
|
import { createHmac } from "crypto"
|
||||||
|
|
||||||
|
export const ZAIConfigSchema = z.object({
|
||||||
|
apiKey: z.string().optional(),
|
||||||
|
endpoint: z.string().default("https://api.z.ai/api/coding/paas/v4"),
|
||||||
|
enabled: z.boolean().default(false),
|
||||||
|
timeout: z.number().default(300000)
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ZAIConfig = z.infer<typeof ZAIConfigSchema>
|
||||||
|
|
||||||
|
export const ZAIMessageSchema = z.object({
|
||||||
|
role: z.enum(["user", "assistant", "system", "tool"]),
|
||||||
|
content: z.string().optional(),
|
||||||
|
tool_calls: z.array(z.object({
|
||||||
|
id: z.string(),
|
||||||
|
type: z.literal("function"),
|
||||||
|
function: z.object({
|
||||||
|
name: z.string(),
|
||||||
|
arguments: z.string()
|
||||||
|
})
|
||||||
|
})).optional(),
|
||||||
|
tool_call_id: z.string().optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ZAIMessage = z.infer<typeof ZAIMessageSchema>
|
||||||
|
|
||||||
|
// Tool Definition Schema (OpenAI-compatible)
|
||||||
|
export const ZAIToolSchema = z.object({
|
||||||
|
type: z.literal("function"),
|
||||||
|
function: z.object({
|
||||||
|
name: z.string(),
|
||||||
|
description: z.string(),
|
||||||
|
parameters: z.object({
|
||||||
|
type: z.literal("object"),
|
||||||
|
properties: z.record(z.object({
|
||||||
|
type: z.string(),
|
||||||
|
description: z.string().optional()
|
||||||
|
})),
|
||||||
|
required: z.array(z.string()).optional()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ZAITool = z.infer<typeof ZAIToolSchema>
|
||||||
|
|
||||||
|
export const ZAIChatRequestSchema = z.object({
|
||||||
|
model: z.string().default("glm-4.7"),
|
||||||
|
messages: z.array(ZAIMessageSchema),
|
||||||
|
max_tokens: z.number().default(8192),
|
||||||
|
stream: z.boolean().default(true),
|
||||||
|
temperature: z.number().optional(),
|
||||||
|
tools: z.array(ZAIToolSchema).optional(),
|
||||||
|
tool_choice: z.union([
|
||||||
|
z.literal("auto"),
|
||||||
|
z.literal("none"),
|
||||||
|
z.object({
|
||||||
|
type: z.literal("function"),
|
||||||
|
function: z.object({ name: z.string() })
|
||||||
|
})
|
||||||
|
]).optional(),
|
||||||
|
thinking: z.object({
|
||||||
|
type: z.enum(["enabled", "disabled"]).optional()
|
||||||
|
}).optional()
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ZAIChatRequest = z.infer<typeof ZAIChatRequestSchema>
|
||||||
|
|
||||||
|
export const ZAIChatResponseSchema = z.object({
|
||||||
|
id: z.string(),
|
||||||
|
object: z.string(),
|
||||||
|
created: z.number(),
|
||||||
|
model: z.string(),
|
||||||
|
choices: z.array(z.object({
|
||||||
|
index: z.number(),
|
||||||
|
message: z.object({
|
||||||
|
role: z.string(),
|
||||||
|
content: z.string().optional().nullable(),
|
||||||
|
reasoning_content: z.string().optional(),
|
||||||
|
tool_calls: z.array(z.object({
|
||||||
|
id: z.string(),
|
||||||
|
type: z.literal("function"),
|
||||||
|
function: z.object({
|
||||||
|
name: z.string(),
|
||||||
|
arguments: z.string()
|
||||||
|
})
|
||||||
|
})).optional()
|
||||||
|
}),
|
||||||
|
finish_reason: z.string()
|
||||||
|
})),
|
||||||
|
usage: z.object({
|
||||||
|
prompt_tokens: z.number(),
|
||||||
|
completion_tokens: z.number(),
|
||||||
|
total_tokens: z.number()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ZAIChatResponse = z.infer<typeof ZAIChatResponseSchema>
|
||||||
|
|
||||||
|
export const ZAIStreamChunkSchema = z.object({
|
||||||
|
id: z.string(),
|
||||||
|
object: z.string(),
|
||||||
|
created: z.number(),
|
||||||
|
model: z.string(),
|
||||||
|
choices: z.array(z.object({
|
||||||
|
index: z.number(),
|
||||||
|
delta: z.object({
|
||||||
|
role: z.string().optional(),
|
||||||
|
content: z.string().optional().nullable(),
|
||||||
|
reasoning_content: z.string().optional(),
|
||||||
|
tool_calls: z.array(z.object({
|
||||||
|
index: z.number().optional(),
|
||||||
|
id: z.string().optional(),
|
||||||
|
type: z.literal("function").optional(),
|
||||||
|
function: z.object({
|
||||||
|
name: z.string().optional(),
|
||||||
|
arguments: z.string().optional()
|
||||||
|
}).optional()
|
||||||
|
})).optional()
|
||||||
|
}),
|
||||||
|
finish_reason: z.string().nullable().optional()
|
||||||
|
}))
|
||||||
|
})
|
||||||
|
|
||||||
|
export type ZAIStreamChunk = z.infer<typeof ZAIStreamChunkSchema>
|
||||||
|
|
||||||
|
export const ZAI_MODELS = [
|
||||||
|
"glm-4.7",
|
||||||
|
"glm-4.6",
|
||||||
|
"glm-4.5",
|
||||||
|
"glm-4.5-air",
|
||||||
|
"glm-4.5-flash",
|
||||||
|
"glm-4.5-long"
|
||||||
|
] as const
|
||||||
|
|
||||||
|
export type ZAIModelName = typeof ZAI_MODELS[number]
|
||||||
|
|
||||||
|
export class ZAIClient {
|
||||||
|
private config: ZAIConfig
|
||||||
|
private baseUrl: string
|
||||||
|
|
||||||
|
constructor(config: ZAIConfig) {
|
||||||
|
this.config = config
|
||||||
|
this.baseUrl = config.endpoint.replace(/\/$/, "")
|
||||||
|
}
|
||||||
|
|
||||||
|
async testConnection(): Promise<boolean> {
|
||||||
|
if (!this.config.apiKey) {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(`${this.baseUrl}/chat/completions`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: this.getHeaders(),
|
||||||
|
body: JSON.stringify({
|
||||||
|
model: "glm-4.7",
|
||||||
|
max_tokens: 1,
|
||||||
|
messages: [{ role: "user", content: "test" }]
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const text = await response.text()
|
||||||
|
console.error(`Z.AI connection failed (${response.status}): ${text}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
return response.ok
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Z.AI connection test failed:", error)
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async listModels(): Promise<string[]> {
|
||||||
|
return [...ZAI_MODELS]
|
||||||
|
}
|
||||||
|
|
||||||
|
async *chatStream(request: ZAIChatRequest): AsyncGenerator<ZAIStreamChunk> {
|
||||||
|
if (!this.config.apiKey) {
|
||||||
|
throw new Error("Z.AI API key is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await fetch(`${this.baseUrl}/chat/completions`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: this.getHeaders(),
|
||||||
|
body: JSON.stringify({
|
||||||
|
...request,
|
||||||
|
stream: true
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const errorText = await response.text()
|
||||||
|
throw new Error(`Z.AI API error (${response.status}): ${errorText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!response.body) {
|
||||||
|
throw new Error("Response body is missing")
|
||||||
|
}
|
||||||
|
|
||||||
|
const reader = response.body.getReader()
|
||||||
|
const decoder = new TextDecoder()
|
||||||
|
let buffer = ""
|
||||||
|
|
||||||
|
try {
|
||||||
|
while (true) {
|
||||||
|
const { done, value } = await reader.read()
|
||||||
|
if (done) break
|
||||||
|
|
||||||
|
buffer += decoder.decode(value, { stream: true })
|
||||||
|
const lines = buffer.split("\n")
|
||||||
|
buffer = lines.pop() || ""
|
||||||
|
|
||||||
|
for (const line of lines) {
|
||||||
|
if (line.startsWith("data: ")) {
|
||||||
|
const data = line.slice(6).trim()
|
||||||
|
if (data === "[DONE]") return
|
||||||
|
|
||||||
|
try {
|
||||||
|
const parsed = JSON.parse(data)
|
||||||
|
yield parsed as ZAIStreamChunk
|
||||||
|
} catch (e) {
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
reader.releaseLock()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async chat(request: ZAIChatRequest): Promise<ZAIChatResponse> {
|
||||||
|
if (!this.config.apiKey) {
|
||||||
|
throw new Error("Z.AI API key is required")
|
||||||
|
}
|
||||||
|
|
||||||
|
const response = await fetch(`${this.baseUrl}/chat/completions`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: this.getHeaders(),
|
||||||
|
body: JSON.stringify({
|
||||||
|
...request,
|
||||||
|
stream: false
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
const errorText = await response.text()
|
||||||
|
throw new Error(`Z.AI API error (${response.status}): ${errorText}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
return await response.json()
|
||||||
|
}
|
||||||
|
|
||||||
|
private getHeaders(): Record<string, string> {
|
||||||
|
const token = this.generateToken(this.config.apiKey!)
|
||||||
|
return {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
"Authorization": `Bearer ${token}`
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private generateToken(apiKey: string, expiresIn: number = 3600): string {
|
||||||
|
try {
|
||||||
|
const [id, secret] = apiKey.split(".")
|
||||||
|
if (!id || !secret) return apiKey // Fallback or handle error
|
||||||
|
|
||||||
|
const now = Date.now()
|
||||||
|
const payload = {
|
||||||
|
api_key: id,
|
||||||
|
exp: now + expiresIn * 1000,
|
||||||
|
timestamp: now
|
||||||
|
}
|
||||||
|
|
||||||
|
const header = {
|
||||||
|
alg: "HS256",
|
||||||
|
sign_type: "SIGN"
|
||||||
|
}
|
||||||
|
|
||||||
|
const base64UrlEncode = (obj: any) => {
|
||||||
|
return Buffer.from(JSON.stringify(obj))
|
||||||
|
.toString('base64')
|
||||||
|
.replace(/\+/g, '-')
|
||||||
|
.replace(/\//g, '_')
|
||||||
|
.replace(/=+$/, '')
|
||||||
|
}
|
||||||
|
|
||||||
|
const encodedHeader = base64UrlEncode(header)
|
||||||
|
const encodedPayload = base64UrlEncode(payload)
|
||||||
|
|
||||||
|
const signature = createHmac("sha256", secret)
|
||||||
|
.update(`${encodedHeader}.${encodedPayload}`)
|
||||||
|
.digest("base64")
|
||||||
|
.replace(/\+/g, '-')
|
||||||
|
.replace(/\//g, '_')
|
||||||
|
.replace(/=+$/, '')
|
||||||
|
|
||||||
|
return `${encodedHeader}.${encodedPayload}.${signature}`
|
||||||
|
} catch (e) {
|
||||||
|
console.warn("Failed to generate JWT, using raw key", e)
|
||||||
|
return apiKey
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
static validateApiKey(apiKey: string): boolean {
|
||||||
|
return typeof apiKey === "string" && apiKey.length > 0
|
||||||
|
}
|
||||||
|
}
|
||||||
177
packages/server/src/launcher.ts
Normal file
177
packages/server/src/launcher.ts
Normal file
@@ -0,0 +1,177 @@
|
|||||||
|
import { spawn } from "child_process"
|
||||||
|
import os from "os"
|
||||||
|
import path from "path"
|
||||||
|
import type { Logger } from "./logger"
|
||||||
|
|
||||||
|
interface BrowserCandidate {
|
||||||
|
name: string
|
||||||
|
command: string
|
||||||
|
args: (url: string) => string[]
|
||||||
|
}
|
||||||
|
|
||||||
|
const APP_ARGS = (url: string) => [`--app=${url}`, "--new-window"]
|
||||||
|
|
||||||
|
export async function launchInBrowser(url: string, logger: Logger): Promise<boolean> {
|
||||||
|
const { platform, candidates, manualExamples } = buildPlatformCandidates(url)
|
||||||
|
|
||||||
|
console.log(`Attempting to launch browser (${platform}) using:`)
|
||||||
|
candidates.forEach((candidate) => console.log(` - ${candidate.name}: ${candidate.command}`))
|
||||||
|
|
||||||
|
for (const candidate of candidates) {
|
||||||
|
const success = await tryLaunch(candidate, url, logger)
|
||||||
|
if (success) {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
console.error(
|
||||||
|
"No supported browser found to launch. Run without --launch and use one of the commands below or install a compatible browser.",
|
||||||
|
)
|
||||||
|
if (manualExamples.length > 0) {
|
||||||
|
console.error("Manual launch commands:")
|
||||||
|
manualExamples.forEach((line) => console.error(` ${line}`))
|
||||||
|
}
|
||||||
|
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
async function tryLaunch(candidate: BrowserCandidate, url: string, logger: Logger): Promise<boolean> {
|
||||||
|
return new Promise((resolve) => {
|
||||||
|
let resolved = false
|
||||||
|
try {
|
||||||
|
const args = candidate.args(url)
|
||||||
|
const child = spawn(candidate.command, args, { stdio: "ignore", detached: true })
|
||||||
|
|
||||||
|
child.once("error", (error) => {
|
||||||
|
if (resolved) return
|
||||||
|
resolved = true
|
||||||
|
logger.debug({ err: error, candidate: candidate.name, command: candidate.command, args }, "Browser launch failed")
|
||||||
|
resolve(false)
|
||||||
|
})
|
||||||
|
|
||||||
|
child.once("spawn", () => {
|
||||||
|
if (resolved) return
|
||||||
|
resolved = true
|
||||||
|
logger.info(
|
||||||
|
{
|
||||||
|
browser: candidate.name,
|
||||||
|
command: candidate.command,
|
||||||
|
args,
|
||||||
|
fullCommand: [candidate.command, ...args].join(" "),
|
||||||
|
},
|
||||||
|
"Launched browser in app mode",
|
||||||
|
)
|
||||||
|
child.unref()
|
||||||
|
resolve(true)
|
||||||
|
})
|
||||||
|
} catch (error) {
|
||||||
|
if (resolved) return
|
||||||
|
resolved = true
|
||||||
|
logger.debug({ err: error, candidate: candidate.name, command: candidate.command }, "Browser spawn threw")
|
||||||
|
resolve(false)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildPlatformCandidates(url: string) {
|
||||||
|
switch (os.platform()) {
|
||||||
|
case "darwin":
|
||||||
|
return {
|
||||||
|
platform: "macOS",
|
||||||
|
candidates: buildMacCandidates(),
|
||||||
|
manualExamples: buildMacManualExamples(url),
|
||||||
|
}
|
||||||
|
case "win32":
|
||||||
|
return {
|
||||||
|
platform: "Windows",
|
||||||
|
candidates: buildWindowsCandidates(),
|
||||||
|
manualExamples: buildWindowsManualExamples(url),
|
||||||
|
}
|
||||||
|
default:
|
||||||
|
return {
|
||||||
|
platform: "Linux",
|
||||||
|
candidates: buildLinuxCandidates(),
|
||||||
|
manualExamples: buildLinuxManualExamples(url),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildMacCandidates(): BrowserCandidate[] {
|
||||||
|
const apps = [
|
||||||
|
{ name: "Google Chrome", path: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" },
|
||||||
|
{ name: "Google Chrome Canary", path: "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary" },
|
||||||
|
{ name: "Microsoft Edge", path: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge" },
|
||||||
|
{ name: "Brave Browser", path: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser" },
|
||||||
|
{ name: "Chromium", path: "/Applications/Chromium.app/Contents/MacOS/Chromium" },
|
||||||
|
{ name: "Vivaldi", path: "/Applications/Vivaldi.app/Contents/MacOS/Vivaldi" },
|
||||||
|
{ name: "Arc", path: "/Applications/Arc.app/Contents/MacOS/Arc" },
|
||||||
|
]
|
||||||
|
|
||||||
|
return apps.map((entry) => ({ name: entry.name, command: entry.path, args: APP_ARGS }))
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildWindowsCandidates(): BrowserCandidate[] {
|
||||||
|
const programFiles = process.env["ProgramFiles"]
|
||||||
|
const programFilesX86 = process.env["ProgramFiles(x86)"]
|
||||||
|
const localAppData = process.env["LocalAppData"]
|
||||||
|
|
||||||
|
const paths = [
|
||||||
|
[programFiles, "Google/Chrome/Application/chrome.exe", "Google Chrome"],
|
||||||
|
[programFilesX86, "Google/Chrome/Application/chrome.exe", "Google Chrome (x86)"],
|
||||||
|
[localAppData, "Google/Chrome/Application/chrome.exe", "Google Chrome (User)"],
|
||||||
|
[programFiles, "Microsoft/Edge/Application/msedge.exe", "Microsoft Edge"],
|
||||||
|
[programFilesX86, "Microsoft/Edge/Application/msedge.exe", "Microsoft Edge (x86)"],
|
||||||
|
[localAppData, "Microsoft/Edge/Application/msedge.exe", "Microsoft Edge (User)"],
|
||||||
|
[programFiles, "BraveSoftware/Brave-Browser/Application/brave.exe", "Brave"],
|
||||||
|
[localAppData, "BraveSoftware/Brave-Browser/Application/brave.exe", "Brave (User)"],
|
||||||
|
[programFiles, "Chromium/Application/chromium.exe", "Chromium"],
|
||||||
|
] as const
|
||||||
|
|
||||||
|
return paths
|
||||||
|
.filter(([root]) => Boolean(root))
|
||||||
|
.map(([root, rel, name]) => ({
|
||||||
|
name,
|
||||||
|
command: path.join(root as string, rel),
|
||||||
|
args: APP_ARGS,
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildLinuxCandidates(): BrowserCandidate[] {
|
||||||
|
const names = [
|
||||||
|
"google-chrome",
|
||||||
|
"google-chrome-stable",
|
||||||
|
"chromium",
|
||||||
|
"chromium-browser",
|
||||||
|
"brave-browser",
|
||||||
|
"microsoft-edge",
|
||||||
|
"microsoft-edge-stable",
|
||||||
|
"vivaldi",
|
||||||
|
]
|
||||||
|
|
||||||
|
return names.map((name) => ({ name, command: name, args: APP_ARGS }))
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildMacManualExamples(url: string) {
|
||||||
|
return [
|
||||||
|
`"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --app="${url}" --new-window`,
|
||||||
|
`"/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge" --app="${url}" --new-window`,
|
||||||
|
`"/Applications/Brave Browser.app/Contents/MacOS/Brave Browser" --app="${url}" --new-window`,
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildWindowsManualExamples(url: string) {
|
||||||
|
return [
|
||||||
|
`"%ProgramFiles%\\Google\\Chrome\\Application\\chrome.exe" --app="${url}" --new-window`,
|
||||||
|
`"%ProgramFiles%\\Microsoft\\Edge\\Application\\msedge.exe" --app="${url}" --new-window`,
|
||||||
|
`"%ProgramFiles%\\BraveSoftware\\Brave-Browser\\Application\\brave.exe" --app="${url}" --new-window`,
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
function buildLinuxManualExamples(url: string) {
|
||||||
|
return [
|
||||||
|
`google-chrome --app="${url}" --new-window`,
|
||||||
|
`chromium --app="${url}" --new-window`,
|
||||||
|
`brave-browser --app="${url}" --new-window`,
|
||||||
|
`microsoft-edge --app="${url}" --new-window`,
|
||||||
|
]
|
||||||
|
}
|
||||||
21
packages/server/src/loader.ts
Normal file
21
packages/server/src/loader.ts
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
export async function resolve(specifier: string, context: any, defaultResolve: any) {
|
||||||
|
try {
|
||||||
|
return await defaultResolve(specifier, context, defaultResolve)
|
||||||
|
} catch (error: any) {
|
||||||
|
if (shouldRetry(specifier, error)) {
|
||||||
|
const retried = specifier.endsWith(".js") ? specifier : `${specifier}.js`
|
||||||
|
return defaultResolve(retried, context, defaultResolve)
|
||||||
|
}
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function shouldRetry(specifier: string, error: any) {
|
||||||
|
if (!error || error.code !== "ERR_MODULE_NOT_FOUND") {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
if (specifier.startsWith("./") || specifier.startsWith("../")) {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
133
packages/server/src/logger.ts
Normal file
133
packages/server/src/logger.ts
Normal file
@@ -0,0 +1,133 @@
|
|||||||
|
import { Transform } from "node:stream"
|
||||||
|
import pino, { Logger as PinoLogger } from "pino"
|
||||||
|
|
||||||
|
export type Logger = PinoLogger
|
||||||
|
|
||||||
|
interface LoggerOptions {
|
||||||
|
level?: string
|
||||||
|
destination?: string
|
||||||
|
component?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
const LEVEL_LABELS: Record<number, string> = {
|
||||||
|
10: "trace",
|
||||||
|
20: "debug",
|
||||||
|
30: "info",
|
||||||
|
40: "warn",
|
||||||
|
50: "error",
|
||||||
|
60: "fatal",
|
||||||
|
}
|
||||||
|
|
||||||
|
const LIFECYCLE_COMPONENTS = new Set(["app", "workspace"])
|
||||||
|
const OMITTED_FIELDS = new Set(["time", "msg", "level", "component", "module"])
|
||||||
|
|
||||||
|
export function createLogger(options: LoggerOptions = {}): Logger {
|
||||||
|
const level = (options.level ?? process.env.CLI_LOG_LEVEL ?? "info").toLowerCase()
|
||||||
|
const destination = options.destination ?? process.env.CLI_LOG_DESTINATION ?? "stdout"
|
||||||
|
const baseComponent = options.component ?? "app"
|
||||||
|
const loggerOptions = {
|
||||||
|
level,
|
||||||
|
base: { component: baseComponent },
|
||||||
|
timestamp: false,
|
||||||
|
} as const
|
||||||
|
|
||||||
|
if (destination && destination !== "stdout") {
|
||||||
|
const stream = pino.destination({ dest: destination, mkdir: true, sync: false })
|
||||||
|
return pino(loggerOptions, stream)
|
||||||
|
}
|
||||||
|
|
||||||
|
const lifecycleStream = new LifecycleLogStream({ restrictInfoToLifecycle: level === "info" })
|
||||||
|
lifecycleStream.pipe(process.stdout)
|
||||||
|
return pino(loggerOptions, lifecycleStream)
|
||||||
|
}
|
||||||
|
|
||||||
|
interface LifecycleStreamOptions {
|
||||||
|
restrictInfoToLifecycle: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
class LifecycleLogStream extends Transform {
|
||||||
|
private buffer = ""
|
||||||
|
|
||||||
|
constructor(private readonly options: LifecycleStreamOptions) {
|
||||||
|
super()
|
||||||
|
}
|
||||||
|
|
||||||
|
_transform(chunk: Buffer, _encoding: BufferEncoding, callback: () => void) {
|
||||||
|
this.buffer += chunk.toString()
|
||||||
|
let newlineIndex = this.buffer.indexOf("\n")
|
||||||
|
while (newlineIndex >= 0) {
|
||||||
|
const line = this.buffer.slice(0, newlineIndex)
|
||||||
|
this.buffer = this.buffer.slice(newlineIndex + 1)
|
||||||
|
this.pushFormatted(line)
|
||||||
|
newlineIndex = this.buffer.indexOf("\n")
|
||||||
|
}
|
||||||
|
callback()
|
||||||
|
}
|
||||||
|
|
||||||
|
_flush(callback: () => void) {
|
||||||
|
if (this.buffer.length > 0) {
|
||||||
|
this.pushFormatted(this.buffer)
|
||||||
|
this.buffer = ""
|
||||||
|
}
|
||||||
|
callback()
|
||||||
|
}
|
||||||
|
|
||||||
|
private pushFormatted(line: string) {
|
||||||
|
if (!line.trim()) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
let entry: Record<string, unknown>
|
||||||
|
try {
|
||||||
|
entry = JSON.parse(line)
|
||||||
|
} catch {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
const levelNumber = typeof entry.level === "number" ? entry.level : 30
|
||||||
|
const levelLabel = LEVEL_LABELS[levelNumber] ?? "info"
|
||||||
|
const component = (entry.component as string | undefined) ?? (entry.module as string | undefined) ?? "app"
|
||||||
|
|
||||||
|
if (this.options.restrictInfoToLifecycle && levelNumber <= 30 && !LIFECYCLE_COMPONENTS.has(component)) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
const message = typeof entry.msg === "string" ? entry.msg : ""
|
||||||
|
const metadata = this.formatMetadata(entry)
|
||||||
|
const formatted = metadata.length > 0 ? `[${levelLabel.toUpperCase()}] [${component}] ${message} ${metadata}` : `[${levelLabel.toUpperCase()}] [${component}] ${message}`
|
||||||
|
this.push(`${formatted}\n`)
|
||||||
|
}
|
||||||
|
|
||||||
|
private formatMetadata(entry: Record<string, unknown>): string {
|
||||||
|
const pairs: string[] = []
|
||||||
|
for (const [key, value] of Object.entries(entry)) {
|
||||||
|
if (OMITTED_FIELDS.has(key)) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if (key === "err" && value && typeof value === "object") {
|
||||||
|
const err = value as { type?: string; message?: string; stack?: string }
|
||||||
|
const errLabel = err.type ?? "Error"
|
||||||
|
const errMessage = err.message ? `: ${err.message}` : ""
|
||||||
|
pairs.push(`err=${errLabel}${errMessage}`)
|
||||||
|
if (err.stack) {
|
||||||
|
pairs.push(`stack="${err.stack}"`)
|
||||||
|
}
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
pairs.push(`${key}=${this.stringifyValue(value)}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
return pairs.join(" ").trim()
|
||||||
|
}
|
||||||
|
|
||||||
|
private stringifyValue(value: unknown): string {
|
||||||
|
if (value === undefined) return "undefined"
|
||||||
|
if (value === null) return "null"
|
||||||
|
if (typeof value === "string") return value
|
||||||
|
if (typeof value === "number" || typeof value === "boolean") return String(value)
|
||||||
|
if (value instanceof Error) return value.message ?? value.name
|
||||||
|
return JSON.stringify(value)
|
||||||
|
}
|
||||||
|
}
|
||||||
532
packages/server/src/mcp/client.ts
Normal file
532
packages/server/src/mcp/client.ts
Normal file
@@ -0,0 +1,532 @@
|
|||||||
|
/**
|
||||||
|
* MCP Client - Connects to MCP (Model Context Protocol) servers
|
||||||
|
* and provides tool discovery and execution capabilities.
|
||||||
|
*
|
||||||
|
* Supports:
|
||||||
|
* - stdio-based MCP servers (command + args)
|
||||||
|
* - HTTP/SSE-based remote MCP servers
|
||||||
|
*/
|
||||||
|
|
||||||
|
import { spawn, ChildProcess } from "child_process"
|
||||||
|
import { createLogger } from "../logger"
|
||||||
|
import path from "path"
|
||||||
|
|
||||||
|
const log = createLogger({ component: "mcp-client" })
|
||||||
|
|
||||||
|
// MCP Protocol Types
|
||||||
|
export interface McpServerConfig {
|
||||||
|
command?: string
|
||||||
|
args?: string[]
|
||||||
|
env?: Record<string, string>
|
||||||
|
type?: "stdio" | "remote" | "http" | "sse" | "streamable-http"
|
||||||
|
url?: string
|
||||||
|
headers?: Record<string, string>
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface McpToolDefinition {
|
||||||
|
name: string
|
||||||
|
description: string
|
||||||
|
inputSchema: {
|
||||||
|
type: "object"
|
||||||
|
properties: Record<string, { type: string; description?: string }>
|
||||||
|
required?: string[]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface McpToolCall {
|
||||||
|
name: string
|
||||||
|
arguments: Record<string, unknown>
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface McpToolResult {
|
||||||
|
content: Array<{
|
||||||
|
type: "text" | "image" | "resource"
|
||||||
|
text?: string
|
||||||
|
data?: string
|
||||||
|
mimeType?: string
|
||||||
|
}>
|
||||||
|
isError?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
// MCP JSON-RPC Message Types
|
||||||
|
interface JsonRpcRequest {
|
||||||
|
jsonrpc: "2.0"
|
||||||
|
id: number | string
|
||||||
|
method: string
|
||||||
|
params?: unknown
|
||||||
|
}
|
||||||
|
|
||||||
|
interface JsonRpcResponse {
|
||||||
|
jsonrpc: "2.0"
|
||||||
|
id: number | string
|
||||||
|
result?: unknown
|
||||||
|
error?: { code: number; message: string; data?: unknown }
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* MCP Client for a single server
|
||||||
|
*/
|
||||||
|
export class McpClient {
|
||||||
|
private config: McpServerConfig
|
||||||
|
private process: ChildProcess | null = null
|
||||||
|
private messageId = 0
|
||||||
|
private pendingRequests: Map<number | string, {
|
||||||
|
resolve: (value: unknown) => void
|
||||||
|
reject: (reason: unknown) => void
|
||||||
|
}> = new Map()
|
||||||
|
private buffer = ""
|
||||||
|
private tools: McpToolDefinition[] = []
|
||||||
|
private connected = false
|
||||||
|
private serverName: string
|
||||||
|
|
||||||
|
constructor(serverName: string, config: McpServerConfig) {
|
||||||
|
this.serverName = serverName
|
||||||
|
this.config = config
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Start and connect to the MCP server
|
||||||
|
*/
|
||||||
|
async connect(): Promise<void> {
|
||||||
|
if (this.connected) return
|
||||||
|
|
||||||
|
if (this.config.type === "remote" || this.config.type === "http" || this.config.type === "sse") {
|
||||||
|
// HTTP-based server - just mark as connected
|
||||||
|
this.connected = true
|
||||||
|
log.info({ server: this.serverName, type: this.config.type }, "Connected to remote MCP server")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
// Stdio-based server
|
||||||
|
if (!this.config.command) {
|
||||||
|
throw new Error(`MCP server ${this.serverName} has no command configured`)
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info({ server: this.serverName, command: this.config.command, args: this.config.args }, "Starting MCP server")
|
||||||
|
|
||||||
|
this.process = spawn(this.config.command, this.config.args || [], {
|
||||||
|
stdio: ["pipe", "pipe", "pipe"],
|
||||||
|
env: { ...process.env, ...this.config.env },
|
||||||
|
shell: true
|
||||||
|
})
|
||||||
|
|
||||||
|
this.process.stdout?.on("data", (data) => this.handleData(data.toString()))
|
||||||
|
this.process.stderr?.on("data", (data) => log.warn({ server: this.serverName }, `MCP stderr: ${data}`))
|
||||||
|
this.process.on("error", (err) => log.error({ server: this.serverName, error: err }, "MCP process error"))
|
||||||
|
this.process.on("exit", (code) => {
|
||||||
|
log.info({ server: this.serverName, code }, "MCP process exited")
|
||||||
|
this.connected = false
|
||||||
|
})
|
||||||
|
|
||||||
|
// Wait for process to start
|
||||||
|
await new Promise(resolve => setTimeout(resolve, 500))
|
||||||
|
|
||||||
|
// Initialize the server
|
||||||
|
try {
|
||||||
|
await this.sendRequest("initialize", {
|
||||||
|
protocolVersion: "2024-11-05",
|
||||||
|
capabilities: { tools: {} },
|
||||||
|
clientInfo: { name: "NomadArch", version: "0.4.0" }
|
||||||
|
})
|
||||||
|
|
||||||
|
await this.sendRequest("notifications/initialized", {})
|
||||||
|
this.connected = true
|
||||||
|
log.info({ server: this.serverName }, "MCP server initialized")
|
||||||
|
} catch (error) {
|
||||||
|
log.error({ server: this.serverName, error }, "Failed to initialize MCP server")
|
||||||
|
this.disconnect()
|
||||||
|
throw error
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Disconnect from the MCP server
|
||||||
|
*/
|
||||||
|
disconnect(): void {
|
||||||
|
if (this.process) {
|
||||||
|
this.process.kill()
|
||||||
|
this.process = null
|
||||||
|
}
|
||||||
|
this.connected = false
|
||||||
|
this.tools = []
|
||||||
|
this.pendingRequests.clear()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* List available tools from this MCP server
|
||||||
|
*/
|
||||||
|
async listTools(): Promise<McpToolDefinition[]> {
|
||||||
|
if (!this.connected) {
|
||||||
|
await this.connect()
|
||||||
|
}
|
||||||
|
|
||||||
|
if (this.config.type === "remote" || this.config.type === "http") {
|
||||||
|
// For HTTP servers, fetch tools via HTTP
|
||||||
|
return this.fetchToolsHttp()
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.sendRequest("tools/list", {}) as { tools?: McpToolDefinition[] }
|
||||||
|
this.tools = response.tools || []
|
||||||
|
return this.tools
|
||||||
|
} catch (error) {
|
||||||
|
log.error({ server: this.serverName, error }, "Failed to list MCP tools")
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Execute a tool on this MCP server
|
||||||
|
*/
|
||||||
|
async executeTool(name: string, args: Record<string, unknown>): Promise<McpToolResult> {
|
||||||
|
if (!this.connected) {
|
||||||
|
await this.connect()
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info({ server: this.serverName, tool: name, args }, "Executing MCP tool")
|
||||||
|
|
||||||
|
if (this.config.type === "remote" || this.config.type === "http") {
|
||||||
|
return this.executeToolHttp(name, args)
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await this.sendRequest("tools/call", { name, arguments: args }) as McpToolResult
|
||||||
|
return response
|
||||||
|
} catch (error) {
|
||||||
|
log.error({ server: this.serverName, tool: name, error }, "MCP tool execution failed")
|
||||||
|
return {
|
||||||
|
content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
|
||||||
|
isError: true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Send a JSON-RPC request to the MCP server
|
||||||
|
*/
|
||||||
|
private async sendRequest(method: string, params?: unknown): Promise<unknown> {
|
||||||
|
if (!this.process?.stdin) {
|
||||||
|
throw new Error("MCP server not running")
|
||||||
|
}
|
||||||
|
|
||||||
|
const id = ++this.messageId
|
||||||
|
const request: JsonRpcRequest = {
|
||||||
|
jsonrpc: "2.0",
|
||||||
|
id,
|
||||||
|
method,
|
||||||
|
params
|
||||||
|
}
|
||||||
|
|
||||||
|
return new Promise((resolve, reject) => {
|
||||||
|
this.pendingRequests.set(id, { resolve, reject })
|
||||||
|
|
||||||
|
const message = JSON.stringify(request) + "\n"
|
||||||
|
this.process!.stdin!.write(message)
|
||||||
|
|
||||||
|
// Timeout after 30 seconds
|
||||||
|
setTimeout(() => {
|
||||||
|
if (this.pendingRequests.has(id)) {
|
||||||
|
this.pendingRequests.delete(id)
|
||||||
|
reject(new Error(`MCP request timeout: ${method}`))
|
||||||
|
}
|
||||||
|
}, 30000)
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Handle incoming data from the MCP server
|
||||||
|
*/
|
||||||
|
private handleData(data: string): void {
|
||||||
|
this.buffer += data
|
||||||
|
const lines = this.buffer.split("\n")
|
||||||
|
this.buffer = lines.pop() || ""
|
||||||
|
|
||||||
|
for (const line of lines) {
|
||||||
|
if (!line.trim()) continue
|
||||||
|
try {
|
||||||
|
const message = JSON.parse(line) as JsonRpcResponse
|
||||||
|
if (message.id !== undefined && this.pendingRequests.has(message.id)) {
|
||||||
|
const pending = this.pendingRequests.get(message.id)!
|
||||||
|
this.pendingRequests.delete(message.id)
|
||||||
|
|
||||||
|
if (message.error) {
|
||||||
|
pending.reject(new Error(message.error.message))
|
||||||
|
} else {
|
||||||
|
pending.resolve(message.result)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e) {
|
||||||
|
log.warn({ server: this.serverName }, `Failed to parse MCP message: ${line}`)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Fetch tools from HTTP-based MCP server
|
||||||
|
*/
|
||||||
|
private async fetchToolsHttp(): Promise<McpToolDefinition[]> {
|
||||||
|
if (!this.config.url) return []
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(`${this.config.url}/tools/list`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
...this.config.headers
|
||||||
|
},
|
||||||
|
body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list", params: {} })
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`HTTP ${response.status}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await response.json() as JsonRpcResponse
|
||||||
|
const result = data.result as { tools?: McpToolDefinition[] }
|
||||||
|
return result.tools || []
|
||||||
|
} catch (error) {
|
||||||
|
log.error({ server: this.serverName, error }, "Failed to fetch HTTP MCP tools")
|
||||||
|
return []
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Execute tool on HTTP-based MCP server
|
||||||
|
*/
|
||||||
|
private async executeToolHttp(name: string, args: Record<string, unknown>): Promise<McpToolResult> {
|
||||||
|
if (!this.config.url) {
|
||||||
|
return { content: [{ type: "text", text: "No URL configured" }], isError: true }
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const response = await fetch(`${this.config.url}/tools/call`, {
|
||||||
|
method: "POST",
|
||||||
|
headers: {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
...this.config.headers
|
||||||
|
},
|
||||||
|
body: JSON.stringify({
|
||||||
|
jsonrpc: "2.0",
|
||||||
|
id: 1,
|
||||||
|
method: "tools/call",
|
||||||
|
params: { name, arguments: args }
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`HTTP ${response.status}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
const data = await response.json() as JsonRpcResponse
|
||||||
|
return data.result as McpToolResult
|
||||||
|
} catch (error) {
|
||||||
|
return {
|
||||||
|
content: [{ type: "text", text: `HTTP error: ${error instanceof Error ? error.message : String(error)}` }],
|
||||||
|
isError: true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
isConnected(): boolean {
|
||||||
|
return this.connected
|
||||||
|
}
|
||||||
|
|
||||||
|
getServerName(): string {
|
||||||
|
return this.serverName
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* MCP Manager - Manages multiple MCP server connections
|
||||||
|
*/
|
||||||
|
export class McpManager {
|
||||||
|
private clients: Map<string, McpClient> = new Map()
|
||||||
|
private configPath: string | null = null
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Load MCP config from a workspace
|
||||||
|
*/
|
||||||
|
async loadConfig(workspacePath: string): Promise<void> {
|
||||||
|
const configPath = path.join(workspacePath, ".mcp.json")
|
||||||
|
this.configPath = configPath
|
||||||
|
|
||||||
|
try {
|
||||||
|
const fs = await import("fs")
|
||||||
|
if (!fs.existsSync(configPath)) {
|
||||||
|
log.info({ path: configPath }, "No MCP config found")
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
const content = fs.readFileSync(configPath, "utf-8")
|
||||||
|
const config = JSON.parse(content) as { mcpServers?: Record<string, McpServerConfig> }
|
||||||
|
|
||||||
|
if (config.mcpServers) {
|
||||||
|
for (const [name, serverConfig] of Object.entries(config.mcpServers)) {
|
||||||
|
this.addServer(name, serverConfig)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info({ servers: Object.keys(config.mcpServers || {}) }, "Loaded MCP config")
|
||||||
|
} catch (error) {
|
||||||
|
log.error({ path: configPath, error }, "Failed to load MCP config")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Add an MCP server
|
||||||
|
*/
|
||||||
|
addServer(name: string, config: McpServerConfig): void {
|
||||||
|
if (this.clients.has(name)) {
|
||||||
|
this.clients.get(name)!.disconnect()
|
||||||
|
}
|
||||||
|
this.clients.set(name, new McpClient(name, config))
|
||||||
|
log.info({ server: name }, "Added MCP server")
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Remove an MCP server
|
||||||
|
*/
|
||||||
|
removeServer(name: string): void {
|
||||||
|
const client = this.clients.get(name)
|
||||||
|
if (client) {
|
||||||
|
client.disconnect()
|
||||||
|
this.clients.delete(name)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get all available tools from all connected servers
|
||||||
|
*/
|
||||||
|
async getAllTools(): Promise<Array<McpToolDefinition & { serverName: string }>> {
|
||||||
|
const allTools: Array<McpToolDefinition & { serverName: string }> = []
|
||||||
|
|
||||||
|
for (const [name, client] of this.clients) {
|
||||||
|
try {
|
||||||
|
const tools = await client.listTools()
|
||||||
|
for (const tool of tools) {
|
||||||
|
allTools.push({ ...tool, serverName: name })
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
log.warn({ server: name, error }, "Failed to get tools from MCP server")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return allTools
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Convert MCP tools to OpenAI-compatible format
|
||||||
|
*/
|
||||||
|
async getToolsAsOpenAIFormat(): Promise<Array<{
|
||||||
|
type: "function"
|
||||||
|
function: {
|
||||||
|
name: string
|
||||||
|
description: string
|
||||||
|
parameters: McpToolDefinition["inputSchema"]
|
||||||
|
}
|
||||||
|
}>> {
|
||||||
|
const mcpTools = await this.getAllTools()
|
||||||
|
|
||||||
|
return mcpTools.map(tool => ({
|
||||||
|
type: "function" as const,
|
||||||
|
function: {
|
||||||
|
// Prefix with server name to avoid conflicts
|
||||||
|
name: `mcp_${tool.serverName}_${tool.name}`,
|
||||||
|
description: `[MCP: ${tool.serverName}] ${tool.description}`,
|
||||||
|
parameters: tool.inputSchema
|
||||||
|
}
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Execute a tool by its full name (mcp_servername_toolname)
|
||||||
|
*/
|
||||||
|
async executeTool(fullName: string, args: Record<string, unknown>): Promise<string> {
|
||||||
|
// Parse mcp_servername_toolname format
|
||||||
|
const match = fullName.match(/^mcp_([^_]+)_(.+)$/)
|
||||||
|
if (!match) {
|
||||||
|
return `Error: Invalid MCP tool name format: ${fullName}`
|
||||||
|
}
|
||||||
|
|
||||||
|
const [, serverName, toolName] = match
|
||||||
|
const client = this.clients.get(serverName)
|
||||||
|
|
||||||
|
if (!client) {
|
||||||
|
return `Error: MCP server not found: ${serverName}`
|
||||||
|
}
|
||||||
|
|
||||||
|
const result = await client.executeTool(toolName, args)
|
||||||
|
|
||||||
|
// Convert result to string
|
||||||
|
const texts = result.content
|
||||||
|
.filter(c => c.type === "text" && c.text)
|
||||||
|
.map(c => c.text!)
|
||||||
|
|
||||||
|
return texts.join("\n") || (result.isError ? "Tool execution failed" : "Tool executed successfully")
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Connect all configured servers
|
||||||
|
*/
|
||||||
|
async connectAll(): Promise<Record<string, { connected: boolean; error?: string }>> {
|
||||||
|
const results: Record<string, { connected: boolean; error?: string }> = {}
|
||||||
|
|
||||||
|
for (const [name, client] of this.clients) {
|
||||||
|
try {
|
||||||
|
// Add timeout for connection
|
||||||
|
const connectPromise = client.connect()
|
||||||
|
const timeoutPromise = new Promise<never>((_, reject) =>
|
||||||
|
setTimeout(() => reject(new Error("Connection timeout")), 15000)
|
||||||
|
)
|
||||||
|
|
||||||
|
await Promise.race([connectPromise, timeoutPromise])
|
||||||
|
results[name] = { connected: true }
|
||||||
|
log.info({ server: name }, "MCP server connected successfully")
|
||||||
|
} catch (error) {
|
||||||
|
const errorMsg = error instanceof Error ? error.message : String(error)
|
||||||
|
log.warn({ server: name, error: errorMsg }, "Failed to connect MCP server")
|
||||||
|
results[name] = { connected: false, error: errorMsg }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return results
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Disconnect all servers
|
||||||
|
*/
|
||||||
|
disconnectAll(): void {
|
||||||
|
for (const client of this.clients.values()) {
|
||||||
|
client.disconnect()
|
||||||
|
}
|
||||||
|
this.clients.clear()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get status of all servers
|
||||||
|
*/
|
||||||
|
getStatus(): Record<string, { connected: boolean }> {
|
||||||
|
const status: Record<string, { connected: boolean }> = {}
|
||||||
|
for (const [name, client] of this.clients) {
|
||||||
|
status[name] = { connected: client.isConnected() }
|
||||||
|
}
|
||||||
|
return status
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Singleton instance
|
||||||
|
let globalMcpManager: McpManager | null = null
|
||||||
|
|
||||||
|
export function getMcpManager(): McpManager {
|
||||||
|
if (!globalMcpManager) {
|
||||||
|
globalMcpManager = new McpManager()
|
||||||
|
}
|
||||||
|
return globalMcpManager
|
||||||
|
}
|
||||||
|
|
||||||
|
export function resetMcpManager(): void {
|
||||||
|
if (globalMcpManager) {
|
||||||
|
globalMcpManager.disconnectAll()
|
||||||
|
globalMcpManager = null
|
||||||
|
}
|
||||||
|
}
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user