aios-core 2.1.0

package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+/**
+ * LLM Routing Installation Module
+ *
+ * Installs claude-max and claude-free commands for cost-effective
+ * LLM usage with Claude Code.
+ *
+ * - claude-max: Uses Claude Max subscription (OAuth)
+ * - claude-free: Uses DeepSeek API (~$0.14/M tokens)
+ *
+ * @module llm-routing
+ * @location .aios-core/infrastructure/scripts/llm-routing/
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const isWindows = os.platform() === 'win32';
+const LLM_ROUTING_VERSION = '1.0.0';
+
+/**
+ * Get the installation directory for commands
+ * @returns {string} Installation directory path
+ */
+function getInstallDir() {
+  if (isWindows) {
+    // Try npm global directory first (usually in PATH)
+    const appData = process.env.APPDATA;
+    if (appData) {
+      const npmGlobal = path.join(appData, 'npm');
+      // Create npm directory if it doesn't exist
+      if (!fs.existsSync(npmGlobal)) {
+        fs.mkdirSync(npmGlobal, { recursive: true });
+      }
+      return npmGlobal;
+    }
+    // Fallback to user profile when APPDATA is not set
+    return os.homedir();
+  } else {
+    // macOS/Linux: /usr/local/bin or ~/bin
+    const localBin = '/usr/local/bin';
+    const homeBin = path.join(os.homedir(), 'bin');
+
+    // Check if /usr/local/bin is writable
+    try {
+      fs.accessSync(localBin, fs.constants.W_OK);
+      return localBin;
+    } catch {
+      // Create ~/bin if it doesn't exist
+      if (!fs.existsSync(homeBin)) {
+        fs.mkdirSync(homeBin, { recursive: true });
+      }
+      return homeBin;
+    }
+  }
+}
+
+/**
+ * Install LLM Routing commands
+ * @param {Object} options - Installation options
+ * @param {string} options.projectRoot - Project root directory
+ * @param {string} options.templatesDir - Templates directory
+ * @param {Function} options.onProgress - Progress callback
+ * @param {Function} options.onError - Error callback
+ * @returns {Object} Installation result
+ */
+function installLLMRouting(options = {}) {
+  const {
+    projectRoot = process.cwd(),
+    templatesDir = path.join(__dirname, 'templates'),
+    onProgress = console.log,
+    onError = console.error
+  } = options;
+
+  const result = {
+    success: true,
+    installDir: null,
+    filesInstalled: [],
+    envCreated: false,
+    errors: []
+  };
+
+  // Check templates exist
+  if (!fs.existsSync(templatesDir)) {
+    result.success = false;
+    result.errors.push(`Templates directory not found: ${templatesDir}`);
+    onError(`❌ Templates directory not found: ${templatesDir}`);
+    return result;
+  }
+
+  const installDir = getInstallDir();
+  result.installDir = installDir;
+  onProgress(`📂 Installing to: ${installDir}`);
+
+  // Determine which scripts to install
+  const scripts = isWindows
+    ? ['claude-free.cmd', 'claude-max.cmd']
+    : ['claude-free.sh', 'claude-max.sh'];
+
+  const targetNames = isWindows
+    ? ['claude-free.cmd', 'claude-max.cmd']
+    : ['claude-free', 'claude-max'];
+
+  // Install each script
+  scripts.forEach((script, index) => {
+    const src = path.join(templatesDir, script);
+    const dest = path.join(installDir, targetNames[index]);
+
+    if (!fs.existsSync(src)) {
+      result.success = false;
+      result.errors.push(`Source file not found: ${src}`);
+      onError(`❌ Source file not found: ${src}`);
+      return;
+    }
+
+    try {
+      fs.copyFileSync(src, dest);
+
+      // Make executable on Unix
+      if (!isWindows) {
+        fs.chmodSync(dest, 0o755);
+      }
+
+      result.filesInstalled.push(targetNames[index]);
+      onProgress(`✅ Installed: ${targetNames[index]}`);
+    } catch (error) {
+      result.success = false;
+      result.errors.push(`Failed to install ${targetNames[index]}: ${error.message}`);
+      onError(`❌ Failed to install ${targetNames[index]}: ${error.message}`);
+
+      if (!isWindows && error.code === 'EACCES') {
+        onProgress(`   Try: sudo node ${process.argv[1]}`);
+      }
+    }
+  });
+
+  // Handle .env file
+  const envExample = path.join(projectRoot, '.env.example');
+  const envFile = path.join(projectRoot, '.env');
+
+  if (fs.existsSync(envExample) && !fs.existsSync(envFile)) {
+    try {
+      fs.copyFileSync(envExample, envFile);
+      result.envCreated = true;
+      onProgress(`✅ Created .env from .env.example`);
+    } catch (error) {
+      result.success = false;
+      result.errors.push(`Failed to create .env: ${error.message}`);
+      onError(`❌ Failed to create .env: ${error.message}`);
+    }
+  }
+
+  // Final guard: if any errors were collected, mark as failure
+  if (result.errors.length > 0) {
+    result.success = false;
+  }
+
+  // Only update ~/.claude.json when installation succeeded
+  if (result.success) {
+    updateClaudeConfig();
+  }
+
+  return result;
+}
+
+/**
+ * Update ~/.claude.json to mark LLM routing as installed
+ */
+function updateClaudeConfig() {
+  const claudeConfigPath = path.join(os.homedir(), '.claude.json');
+
+  try {
+    let config = {};
+
+    if (fs.existsSync(claudeConfigPath)) {
+      config = JSON.parse(fs.readFileSync(claudeConfigPath, 'utf8'));
+    }
+
+    config.aiosLLMRouting = {
+      version: LLM_ROUTING_VERSION,
+      installedAt: new Date().toISOString(),
+      commands: ['claude-max', 'claude-free']
+    };
+
+    fs.writeFileSync(claudeConfigPath, JSON.stringify(config, null, 2));
+  } catch {
+    // Ignore errors updating config
+  }
+}
+
+/**
+ * Check if LLM Routing is already installed
+ * @returns {boolean}
+ */
+function isLLMRoutingInstalled() {
+  const installDir = getInstallDir();
+
+  if (isWindows) {
+    return fs.existsSync(path.join(installDir, 'claude-max.cmd')) &&
+           fs.existsSync(path.join(installDir, 'claude-free.cmd'));
+  } else {
+    return fs.existsSync(path.join(installDir, 'claude-max')) &&
+           fs.existsSync(path.join(installDir, 'claude-free'));
+  }
+}
+
+/**
+ * Get installation summary for display
+ * @param {Object} result - Installation result
+ * @returns {string[]} Summary lines
+ */
+function getInstallationSummary(result) {
+  const summary = [];
+
+  if (result.success) {
+    summary.push('');
+    summary.push('📋 LLM Routing Installation Complete!');
+    summary.push('═'.repeat(50));
+    summary.push('');
+    summary.push('Commands installed:');
+    summary.push('  • claude-max   → Uses your Claude Max subscription');
+    summary.push('  • claude-free  → Uses DeepSeek (~$0.14/M tokens)');
+    summary.push('');
+
+    if (result.envCreated) {
+      summary.push('Next steps:');
+      summary.push('  1. Edit .env and add your DEEPSEEK_API_KEY');
+      summary.push('     Get key at: https://platform.deepseek.com/api_keys');
+      summary.push('');
+    }
+
+    summary.push('Usage:');
+    summary.push('  claude-max   # For premium Claude experience');
+    summary.push('  claude-free  # For cost-effective development');
+    summary.push('');
+  } else {
+    summary.push('');
+    summary.push('❌ LLM Routing installation failed:');
+    result.errors.forEach(err => summary.push(`   • ${err}`));
+    summary.push('');
+  }
+
+  return summary;
+}
+
+// Export for use as module
+module.exports = {
+  installLLMRouting,
+  isLLMRoutingInstalled,
+  getInstallDir,
+  getInstallationSummary,
+  LLM_ROUTING_VERSION
+};
+
+// Run if executed directly
+if (require.main === module) {
+  console.log('\n🚀 AIOS LLM Routing Installer\n');
+
+  const result = installLLMRouting({
+    projectRoot: process.cwd(),
+    templatesDir: path.join(__dirname, 'templates')
+  });
+
+  const summary = getInstallationSummary(result);
+  summary.forEach(line => console.log(line));
+}

package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free.cmd

@@ -0,0 +1,80 @@
+@echo off
+:: Claude Code - DeepSeek Native Mode (Low-Cost)
+:: Loads API key from project .env file
+:: Cost: ~$0.14/M tokens with tool calling support
+
+setlocal enabledelayedexpansion
+
+:: Find project root (look for .env file)
+:: Loop guard prevents infinite loop on UNC paths
+set "PROJECT_ROOT=%CD%"
+set /a "LOOP_COUNT=0"
+:find_env
+set /a "LOOP_COUNT+=1"
+if %LOOP_COUNT% gtr 50 goto :no_env
+if exist "%PROJECT_ROOT%\.env" goto :found_env
+if "%PROJECT_ROOT%"=="%PROJECT_ROOT:~0,3%" goto :no_env
+for %%i in ("%PROJECT_ROOT%\..") do set "PROJECT_ROOT=%%~fi"
+goto :find_env
+
+:no_env
+:: Check if DEEPSEEK_API_KEY is set in environment
+if not "%DEEPSEEK_API_KEY%"=="" goto :use_env_key
+
+echo.
+echo [91mERROR: No .env file found and DEEPSEEK_API_KEY not set![0m
+echo.
+echo Options:
+echo   1. Create .env in your project: cp .env.example .env
+echo   2. Set DEEPSEEK_API_KEY in the .env file
+echo   3. Or set it globally: setx DEEPSEEK_API_KEY "sk-your-key"
+echo.
+echo Get your API key at: https://platform.deepseek.com/api_keys
+echo.
+pause
+exit /b 1
+
+:found_env
+:: Load DEEPSEEK_API_KEY from .env (skip comments starting with #)
+for /f "usebackq eol=# tokens=1,* delims==" %%a in ("%PROJECT_ROOT%\.env") do (
+    if "%%a"=="DEEPSEEK_API_KEY" set "DEEPSEEK_API_KEY=%%b"
+)
+
+:: Remove quotes if present
+set "DEEPSEEK_API_KEY=!DEEPSEEK_API_KEY:"=!"
+
+if "!DEEPSEEK_API_KEY!"=="" (
+    echo.
+    echo [91mERROR: DEEPSEEK_API_KEY not found in .env![0m
+    echo.
+    echo Add to your .env file:
+    echo   DEEPSEEK_API_KEY=sk-your-key
+    echo.
+    echo Get your API key at: https://platform.deepseek.com/api_keys
+    echo.
+    pause
+    exit /b 1
+)
+
+:use_env_key
+:: Set DeepSeek native Anthropic endpoint (SUPPORTS TOOL CALLING!)
+set ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
+set ANTHROPIC_API_KEY=%DEEPSEEK_API_KEY%
+set ANTHROPIC_MODEL=deepseek-chat
+set API_TIMEOUT_MS=600000
+
+echo.
+echo [92mClaude Code - DeepSeek Native Mode[0m
+echo Endpoint: api.deepseek.com/anthropic
+echo [92mTool Calling: SUPPORTED[0m
+echo Cost: ~$0.14/M tokens
+echo.
+
+endlocal & set "ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic" & set "ANTHROPIC_API_KEY=%DEEPSEEK_API_KEY%" & set "ANTHROPIC_MODEL=deepseek-chat" & set "API_TIMEOUT_MS=600000"
+
+>&2 echo.
+>&2 echo [93mWARNING: Running with --dangerously-skip-permissions (no confirmation prompts)[0m
+>&2 echo [93mOnly use in trusted repositories/environments.[0m
+>&2 echo.
+
+claude --dangerously-skip-permissions %*

package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-free.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+# Claude Code - DeepSeek Native Mode (Low-Cost)
+# Loads API key from project .env file
+# Cost: ~$0.14/M tokens with tool calling support
+
+# Find project root (look for .env file)
+find_env() {
+    local dir="$PWD"
+    while [[ "$dir" != "/" ]]; do
+        if [[ -f "$dir/.env" ]]; then
+            echo "$dir"
+            return 0
+        fi
+        dir="$(dirname "$dir")"
+    done
+    return 1
+}
+
+# Try to load from .env
+PROJECT_ROOT=$(find_env)
+
+if [[ -n "$PROJECT_ROOT" ]]; then
+    # Load DEEPSEEK_API_KEY from .env
+    if [[ -f "$PROJECT_ROOT/.env" ]]; then
+        export $(grep -E '^DEEPSEEK_API_KEY=' "$PROJECT_ROOT/.env" | xargs)
+    fi
+fi
+
+# Check if key is set (from .env or environment)
+if [[ -z "$DEEPSEEK_API_KEY" ]]; then
+    echo ""
+    echo -e "\033[91mERROR: DEEPSEEK_API_KEY not found!\033[0m"
+    echo ""
+    echo "Options:"
+    echo "  1. Create .env in your project: cp .env.example .env"
+    echo "  2. Add DEEPSEEK_API_KEY=sk-your-key to .env"
+    echo "  3. Or export it: export DEEPSEEK_API_KEY=sk-your-key"
+    echo ""
+    echo "Get your API key at: https://platform.deepseek.com/api_keys"
+    echo ""
+    exit 1
+fi
+
+# Set DeepSeek native Anthropic endpoint (SUPPORTS TOOL CALLING!)
+export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
+export ANTHROPIC_API_KEY="$DEEPSEEK_API_KEY"
+export ANTHROPIC_MODEL="deepseek-chat"
+export API_TIMEOUT_MS=600000
+
+echo ""
+echo -e "\033[92mClaude Code - DeepSeek Native Mode\033[0m"
+echo "Endpoint: api.deepseek.com/anthropic"
+echo -e "\033[92mTool Calling: SUPPORTED\033[0m"
+echo "Cost: ~\$0.14/M tokens"
+echo ""
+
+>&2 echo ""
+>&2 echo -e "\033[93mWARNING: Running with --dangerously-skip-permissions (no confirmation prompts)\033[0m"
+>&2 echo -e "\033[93mOnly use in trusted repositories/environments.\033[0m"
+>&2 echo ""
+
+claude --dangerously-skip-permissions "$@"

package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-max.cmd

@@ -0,0 +1,26 @@
+@echo off
+:: Claude Code - Claude Max Mode
+:: Uses your Claude Max subscription via OAuth (claude.ai login)
+:: This is the premium Claude Code experience
+
+:: Clear ALL alternative provider settings to force OAuth
+set "ANTHROPIC_BASE_URL="
+set "ANTHROPIC_AUTH_TOKEN="
+set "ANTHROPIC_MODEL="
+set "ANTHROPIC_SMALL_FAST_MODEL="
+set "ANTHROPIC_API_KEY="
+set "DEEPSEEK_API_KEY="
+set "OPENROUTER_API_KEY="
+set "API_TIMEOUT_MS="
+
+echo.
+echo [92m========================================[0m
+echo [92m  Claude Max Mode - OAuth/Claude.ai[0m
+echo [92m========================================[0m
+echo.
+echo Using your Claude Max subscription (claude.ai login)
+echo If you see "API Usage Billing", run: claude /logout
+echo Then restart and login again with your Max account.
+echo.
+
+claude --dangerously-skip-permissions %*

package/.aios-core/infrastructure/scripts/llm-routing/templates/claude-max.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Claude Code - Claude Max Mode
+# Uses your Claude Max subscription with bypass permissions
+# This is the default Claude Code experience
+
+# Clear any alternative provider settings
+unset ANTHROPIC_BASE_URL
+unset ANTHROPIC_AUTH_TOKEN
+unset ANTHROPIC_MODEL
+unset ANTHROPIC_SMALL_FAST_MODEL
+unset ANTHROPIC_API_KEY
+
+echo ""
+echo -e "\033[92mClaude Max Mode - Starting...\033[0m"
+echo "Using your Claude Max subscription"
+echo ""
+
+claude --dangerously-skip-permissions "$@"