@nordsym/apiclaw 1.5.17 → 1.5.19

package/dist/src/utils/config.js

@@ -1,220 +0,0 @@
-/**
- * Config Management
- * Handles JSON read/write/merge operations for MCP config files
- */
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { dirname } from 'path';
-import { createBackup } from './backup.js';
-/**
- * Read and parse a JSON config file
- */
-export function readConfig(configPath) {
-    try {
-        if (!existsSync(configPath)) {
-            return {
-                success: true,
-                config: {},
-                isNew: true,
-            };
-        }
-        const content = readFileSync(configPath, 'utf-8');
-        // Handle empty files
-        if (!content.trim()) {
-            return {
-                success: true,
-                config: {},
-                isNew: true,
-            };
-        }
-        const config = JSON.parse(content);
-        return {
-            success: true,
-            config,
-            isNew: false,
-        };
-    }
-    catch (error) {
-        if (error instanceof SyntaxError) {
-            return {
-                success: false,
-                config: null,
-                error: `Invalid JSON in config file: ${error.message}`,
-            };
-        }
-        return {
-            success: false,
-            config: null,
-            error: error instanceof Error ? error.message : 'Unknown error reading config',
-        };
-    }
-}
-/**
- * Write config to file with backup
- */
-export function writeConfig(configPath, config, createBackupFirst = true) {
-    try {
-        // Ensure directory exists
-        const dir = dirname(configPath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        // Create backup if file exists and backup requested
-        let backupPath = null;
-        if (createBackupFirst && existsSync(configPath)) {
-            const backupResult = createBackup(configPath);
-            if (!backupResult.success) {
-                return {
-                    success: false,
-                    error: `Failed to create backup: ${backupResult.error}`,
-                };
-            }
-            backupPath = backupResult.backupPath;
-        }
-        // Validate JSON before writing
-        const content = JSON.stringify(config, null, 2);
-        JSON.parse(content); // Validation parse
-        // Write file
-        writeFileSync(configPath, content, 'utf-8');
-        return {
-            success: true,
-            backupPath,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : 'Unknown error writing config',
-        };
-    }
-}
-/**
- * Deep merge two objects
- */
-export function deepMerge(target, source) {
-    const result = { ...target };
-    for (const key in source) {
-        const sourceValue = source[key];
-        const targetValue = result[key];
-        if (sourceValue !== null &&
-            typeof sourceValue === 'object' &&
-            !Array.isArray(sourceValue) &&
-            targetValue !== null &&
-            typeof targetValue === 'object' &&
-            !Array.isArray(targetValue)) {
-            // Recursively merge objects
-            result[key] = deepMerge(targetValue, sourceValue);
-        }
-        else {
-            // Overwrite value
-            result[key] = sourceValue;
-        }
-    }
-    return result;
-}
-/**
- * Generate APIClaw MCP server configuration
- */
-export function generateApiclawConfig(options = {}) {
-    const config = {
-        command: 'npx',
-        args: ['-y', '@nordsym/apiclaw'],
-    };
-    if (options.workspace) {
-        config.env = {
-            APICLAW_WORKSPACE: options.workspace,
-        };
-    }
-    return config;
-}
-/**
- * Generate APIClaw config for Continue (array format)
- */
-export function generateApiclawContinueConfig(options = {}) {
-    const config = {
-        name: options.serverName || 'apiclaw',
-        command: 'npx',
-        args: ['-y', '@nordsym/apiclaw'],
-    };
-    if (options.workspace) {
-        config.env = {
-            APICLAW_WORKSPACE: options.workspace,
-        };
-    }
-    return config;
-}
-/**
- * Check if APIClaw is already configured
- */
-export function hasApiclawConfig(config, serverName = 'apiclaw') {
-    // Handle Continue's array format
-    if (Array.isArray(config.mcpServers)) {
-        const continueConfig = config;
-        return continueConfig.mcpServers?.some(s => s.name === serverName) || false;
-    }
-    // Handle standard object format
-    const mcpConfig = config;
-    return mcpConfig.mcpServers?.[serverName] !== undefined;
-}
-/**
- * Merge APIClaw config into existing config (standard format)
- */
-export function mergeApiclawConfig(existingConfig, options = {}) {
-    const serverName = options.serverName || 'apiclaw';
-    const apiclawConfig = generateApiclawConfig(options);
-    return deepMerge(existingConfig, {
-        mcpServers: {
-            ...existingConfig.mcpServers,
-            [serverName]: apiclawConfig,
-        },
-    });
-}
-/**
- * Merge APIClaw config into Continue config (array format)
- */
-export function mergeApiclawContinueConfig(existingConfig, options = {}) {
-    const serverName = options.serverName || 'apiclaw';
-    const apiclawConfig = generateApiclawContinueConfig(options);
-    const existingServers = existingConfig.mcpServers || [];
-    // Check if already exists
-    const existingIndex = existingServers.findIndex(s => s.name === serverName);
-    let newServers;
-    if (existingIndex >= 0) {
-        // Update existing
-        newServers = [...existingServers];
-        newServers[existingIndex] = apiclawConfig;
-    }
-    else {
-        // Add new
-        newServers = [...existingServers, apiclawConfig];
-    }
-    return {
-        ...existingConfig,
-        mcpServers: newServers,
-    };
-}
-/**
- * Remove APIClaw from config
- */
-export function removeApiclawConfig(config, serverName = 'apiclaw') {
-    // Handle Continue's array format
-    if (Array.isArray(config.mcpServers)) {
-        const continueConfig = config;
-        return {
-            ...continueConfig,
-            mcpServers: continueConfig.mcpServers?.filter(s => s.name !== serverName),
-        };
-    }
-    // Handle standard object format
-    const mcpConfig = config;
-    const { [serverName]: _, ...remainingServers } = mcpConfig.mcpServers || {};
-    return {
-        ...mcpConfig,
-        mcpServers: remainingServers,
-    };
-}
-/**
- * Detect if config uses Continue's array format
- */
-export function isContinueFormat(config) {
-    return Array.isArray(config.mcpServers);
-}

package/dist/src/utils/os.js

@@ -1,105 +0,0 @@
-/**
- * OS Detection Utility
- * Detects the operating system and provides platform-specific helpers
- */
-import { platform, homedir } from 'os';
-import { join } from 'path';
-/**
- * Detect the current operating system
- */
-export function detectOS() {
-    const os = platform();
-    switch (os) {
-        case 'darwin':
-            return 'mac';
-        case 'win32':
-            return 'win';
-        case 'linux':
-            return 'linux';
-        default:
-            // Default to linux for other Unix-like systems
-            return 'linux';
-    }
-}
-/**
- * Get the home directory for the current user
- */
-export function getHomeDir() {
-    return homedir();
-}
-/**
- * Get the app data directory based on OS
- * - macOS: ~/Library/Application Support
- * - Windows: %APPDATA%
- * - Linux: ~/.config
- */
-export function getAppDataDir() {
-    const home = getHomeDir();
-    const os = detectOS();
-    switch (os) {
-        case 'mac':
-            return join(home, 'Library', 'Application Support');
-        case 'win':
-            return process.env.APPDATA || join(home, 'AppData', 'Roaming');
-        case 'linux':
-            return process.env.XDG_CONFIG_HOME || join(home, '.config');
-    }
-}
-/**
- * Get the user profile directory (Windows-specific, falls back to home)
- */
-export function getUserProfileDir() {
-    return process.env.USERPROFILE || getHomeDir();
-}
-/**
- * Check if running as root/admin
- */
-export function isElevated() {
-    const os = detectOS();
-    if (os === 'win') {
-        // Windows admin check is more complex, skip for now
-        return false;
-    }
-    // Unix-like: check if UID is 0
-    return process.getuid?.() === 0;
-}
-/**
- * Get OS-specific path separator
- */
-export function getPathSeparator() {
-    return detectOS() === 'win' ? '\\' : '/';
-}
-/**
- * Normalize path for current OS
- */
-export function normalizePath(path) {
-    const os = detectOS();
-    if (os === 'win') {
-        // Convert forward slashes to backslashes on Windows
-        return path.replace(/\//g, '\\');
-    }
-    return path;
-}
-/**
- * Expand ~ to home directory
- */
-export function expandHome(path) {
-    if (path.startsWith('~')) {
-        return join(getHomeDir(), path.slice(1));
-    }
-    return path;
-}
-/**
- * Get OS display name
- */
-export function getOSDisplayName() {
-    const os = detectOS();
-    switch (os) {
-        case 'mac':
-            return 'macOS';
-        case 'win':
-            return 'Windows';
-        case 'linux':
-            return 'Linux';
-    }
-}

package/dist/src/utils/paths.js

@@ -1,159 +0,0 @@
-/**
- * Config Path Resolver
- * Resolves config file paths for all MCP clients across all operating systems
- */
-import { join } from 'path';
-import { detectOS, getHomeDir, getAppDataDir, getUserProfileDir } from './os.js';
-/**
- * Get config path for Claude Desktop
- */
-function getClaudeDesktopPath(os) {
-    const home = getHomeDir();
-    const appData = getAppDataDir();
-    switch (os) {
-        case 'mac':
-            return join(appData, 'Claude', 'claude_desktop_config.json');
-        case 'win':
-            return join(appData, 'Claude', 'claude_desktop_config.json');
-        case 'linux':
-            return join(home, '.config', 'Claude', 'claude_desktop_config.json');
-    }
-}
-/**
- * Get config path for Cursor
- */
-function getCursorPath(os) {
-    const home = getHomeDir();
-    const appData = getAppDataDir();
-    switch (os) {
-        case 'mac':
-            return join(appData, 'Cursor', 'User', 'globalStorage', 'cursor.mcp', 'config.json');
-        case 'win':
-            return join(appData, 'Cursor', 'User', 'globalStorage', 'cursor.mcp', 'config.json');
-        case 'linux':
-            return join(home, '.config', 'Cursor', 'User', 'globalStorage', 'cursor.mcp', 'config.json');
-    }
-}
-/**
- * Get config path for Windsurf
- */
-function getWindsurfPath(os) {
-    const home = getHomeDir();
-    const userProfile = getUserProfileDir();
-    switch (os) {
-        case 'mac':
-        case 'linux':
-            return join(home, '.codeium', 'windsurf', 'mcp_config.json');
-        case 'win':
-            return join(userProfile, '.codeium', 'windsurf', 'mcp_config.json');
-    }
-}
-/**
- * Get config path for Cline (VS Code extension)
- */
-function getClinePath(os) {
-    const home = getHomeDir();
-    const appData = getAppDataDir();
-    const relativePath = join('Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
-    switch (os) {
-        case 'mac':
-            return join(appData, relativePath);
-        case 'win':
-            return join(appData, relativePath);
-        case 'linux':
-            return join(home, '.config', relativePath);
-    }
-}
-/**
- * Get config path for Continue
- */
-function getContinuePath(os) {
-    const home = getHomeDir();
-    const userProfile = getUserProfileDir();
-    switch (os) {
-        case 'mac':
-        case 'linux':
-            return join(home, '.continue', 'config.json');
-        case 'win':
-            return join(userProfile, '.continue', 'config.json');
-    }
-}
-/**
- * Get the config path for a specific MCP client
- */
-export function getConfigPath(client, os) {
-    const currentOS = os || detectOS();
-    switch (client) {
-        case 'claude-desktop':
-            return getClaudeDesktopPath(currentOS);
-        case 'cursor':
-            return getCursorPath(currentOS);
-        case 'windsurf':
-            return getWindsurfPath(currentOS);
-        case 'cline':
-            return getClinePath(currentOS);
-        case 'continue':
-            return getContinuePath(currentOS);
-    }
-}
-/**
- * Get full client configuration info
- */
-export function getClientConfig(client, os) {
-    const configPath = getConfigPath(client, os);
-    const pathParts = configPath.split(/[/\\]/);
-    const configFile = pathParts.pop() || '';
-    const configDir = pathParts.join('/');
-    const displayNames = {
-        'claude-desktop': 'Claude Desktop',
-        'cursor': 'Cursor',
-        'windsurf': 'Windsurf',
-        'cline': 'Cline',
-        'continue': 'Continue',
-    };
-    return {
-        name: client,
-        displayName: displayNames[client],
-        configPath,
-        configDir,
-        configFile,
-    };
-}
-/**
- * Get all supported MCP clients
- */
-export function getAllClients() {
-    return ['claude-desktop', 'cursor', 'windsurf', 'cline', 'continue'];
-}
-/**
- * Get config paths for all clients
- */
-export function getAllConfigPaths(os) {
-    const paths = new Map();
-    for (const client of getAllClients()) {
-        paths.set(client, getClientConfig(client, os));
-    }
-    return paths;
-}
-/**
- * Validate that a client name is valid
- */
-export function isValidClient(client) {
-    return getAllClients().includes(client);
-}
-/**
- * Parse client argument (accepts various formats)
- */
-export function parseClientArg(arg) {
-    const normalized = arg.toLowerCase().replace(/[_\s]/g, '-');
-    const aliases = {
-        'claude': 'claude-desktop',
-        'claude-desktop': 'claude-desktop',
-        'claudedesktop': 'claude-desktop',
-        'cursor': 'cursor',
-        'windsurf': 'windsurf',
-        'cline': 'cline',
-        'continue': 'continue',
-    };
-    return aliases[normalized] || null;
-}

package/landing/pages/api/discover.ts

@@ -1,43 +0,0 @@
-/**
- * APIClaw Discovery API - Next.js API Route
- * GET /api/discover?query=...&agentId=...
- */
-
-import type { NextApiRequest, NextApiResponse } from 'next';
-
-// Import from built dist (since we can't easily import TS from parent)
-// For now, return a simple response - we'll implement full logic after verifying deployment
-
-export default async function handler(
-  req: NextApiRequest,
-  res: NextApiResponse
-) {
-  // CORS
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
-  res.setHeader('Access-Control-Allow-Headers', 'Content-Type, X-Agent-Id');
-  
-  if (req.method === 'OPTIONS') {
-    return res.status(200).end();
-  }
-  
-  if (req.method !== 'GET') {
-    return res.status(405).json({ error: 'Method not allowed' });
-  }
-  
-  const { query, agentId, category, maxResults } = req.query;
-  
-  if (!query || typeof query !== 'string') {
-    return res.status(400).json({ error: 'Missing query parameter' });
-  }
-  
-  // TODO: Import actual whitelist + discovery logic
-  // For now, simple passthrough
-  return res.status(200).json({
-    success: true,
-    query,
-    agentId: typeof agentId === 'string' ? agentId : undefined,
-    message: 'APIClaw Discovery API - implementation pending',
-    timestamp: new Date().toISOString(),
-  });
-}

package/landing/pages/api/health.ts

@@ -1,20 +0,0 @@
-/**
- * APIClaw Health Check - Next.js API Route
- * GET /api/health
- */
-
-import type { NextApiRequest, NextApiResponse } from 'next';
-
-export default async function handler(
-  req: NextApiRequest,
-  res: NextApiResponse
-) {
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  
-  return res.status(200).json({
-    status: 'ok',
-    service: 'apiclaw-http-api',
-    version: '2.0.0',
-    timestamp: new Date().toISOString(),
-  });
-}

package/scripts/test-whitelist-v2.sh

@@ -1,128 +0,0 @@
-#!/bin/bash
-# Test script for APIClaw Whitelist v2.0
-# Tests whitelist, access control, and analytics
-
-set -e
-
-echo "🧪 APIClaw Whitelist v2.0 Test Suite"
-echo "===================================="
-echo ""
-
-API_URL="${APICLAW_API_URL:-http://localhost:3000}"
-
-# Colors
-GREEN='\033[0;32m'
-RED='\033[0;31m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-function test_case() {
-  local name=$1
-  local expected=$2
-  local cmd=$3
-  
-  echo -n "Testing: $name ... "
-  
-  response=$(eval "$cmd" 2>&1)
-  status=$?
-  
-  if echo "$response" | grep -q "$expected"; then
-    echo -e "${GREEN}✓ PASS${NC}"
-    return 0
-  else
-    echo -e "${RED}✗ FAIL${NC}"
-    echo "  Expected: $expected"
-    echo "  Got: $response"
-    return 1
-  fi
-}
-
-echo "1. Test Whitelist Authorization"
-echo "--------------------------------"
-
-# Test 1: Whitelisted agent (namespaced)
-test_case \
-  "Namespaced agent (hivr:bytebee) authorized" \
-  "200\|success" \
-  "curl -s '$API_URL/api/discover?query=web&agentId=hivr:bytebee'"
-
-# Test 2: Whitelisted agent (legacy format)
-test_case \
-  "Legacy agent (bytebee) authorized" \
-  "200\|success" \
-  "curl -s '$API_URL/api/discover?query=web&agentId=bytebee'"
-
-# Test 3: Unauthorized agent
-test_case \
-  "Unauthorized agent denied" \
-  "403\|Unauthorized\|Access Denied" \
-  "curl -s '$API_URL/api/discover?query=web&agentId=hacker:evil'"
-
-echo ""
-echo "2. Test Access Control"
-echo "----------------------"
-
-# Test 4: Hivr agent accessing allowed provider
-test_case \
-  "Hivr agent accessing brave_search (allowed)" \
-  "200\|success" \
-  "curl -s -X POST '$API_URL/api/call_api' -H 'Content-Type: application/json' -d '{\"agentId\":\"hivr:bytebee\",\"provider\":\"brave_search\",\"action\":\"search\",\"params\":{\"query\":\"test\"}}'"
-
-# Test 5: Restricted access (if NordSym configured)
-# This will fail if NordSym not configured yet, which is OK
-echo -n "Testing: NordSym agent restricted access ... "
-if curl -s -X POST "$API_URL/api/call_api" \
-  -H "Content-Type: application/json" \
-  -d '{"agentId":"nordsym:test","provider":"restricted_api","action":"call","params":{}}' \
-  | grep -q "403\|Access Denied\|not whitelisted"; then
-  echo -e "${GREEN}✓ PASS${NC} (correctly denied)"
-else
-  echo -e "${YELLOW}⊘ SKIP${NC} (NordSym not configured)"
-fi
-
-echo ""
-echo "3. Test Analytics"
-echo "-----------------"
-
-# Test 6: Product field in logs
-if [ -f ~/.apiclaw/logs/api-calls.jsonl ]; then
-  recent_logs=$(tail -5 ~/.apiclaw/logs/api-calls.jsonl)
-  
-  echo -n "Testing: Product field in logs ... "
-  if echo "$recent_logs" | grep -q '"product":"hivr"'; then
-    echo -e "${GREEN}✓ PASS${NC}"
-  else
-    echo -e "${YELLOW}⊘ WARN${NC} (no recent Hivr calls logged)"
-  fi
-else
-  echo -e "${YELLOW}⊘ SKIP${NC} (no log file yet)"
-fi
-
-echo ""
-echo "4. Test Cache Behavior"
-echo "----------------------"
-
-# Test 7: Multiple requests use cache
-echo -n "Testing: Cache performance ... "
-start=$(date +%s%N)
-for i in {1..5}; do
-  curl -s "$API_URL/api/discover?query=web&agentId=hivr:bytebee" > /dev/null
-done
-end=$(date +%s%N)
-elapsed=$(( (end - start) / 1000000 )) # Convert to ms
-
-if [ $elapsed -lt 1000 ]; then
-  echo -e "${GREEN}✓ PASS${NC} (${elapsed}ms for 5 requests)"
-else
-  echo -e "${YELLOW}⊘ WARN${NC} (${elapsed}ms - cache might not be working)"
-fi
-
-echo ""
-echo "===================================="
-echo "Test suite complete!"
-echo ""
-echo "Next steps:"
-echo "1. Check logs: tail -f ~/.apiclaw/logs/api-calls.jsonl"
-echo "2. Monitor analytics for product field"
-echo "3. Add NordSym product source when ready"
-echo ""