aiusd-skill 1.0.0

package/scripts/reauth.js

@@ -0,0 +1,324 @@
+#!/usr/bin/env node
+
+/**
+ * AIUSD Skill - Re-authentication Script
+ *
+ * This script clears cached authentication data and performs fresh OAuth login:
+ * 1. Clears mcporter credentials
+ * 2. Clears local token files
+ * 3. Performs fresh OAuth authentication
+ * 4. Verifies new authentication
+ */
+
+import { execSync } from 'child_process';
+import { existsSync, rmSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = join(__dirname, '..');
+
+const colors = {
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  reset: '\x1b[0m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function logStep(step, message) {
+  log(`\n🔄 Step ${step}: ${message}`, 'blue');
+}
+
+function logSuccess(message) {
+  log(`✅ ${message}`, 'green');
+}
+
+function logError(message) {
+  log(`❌ ${message}`, 'red');
+}
+
+function logWarning(message) {
+  log(`⚠️  ${message}`, 'yellow');
+}
+
+class ReAuthenticator {
+  constructor() {
+    this.mcporterDir = join(homedir(), '.mcporter');
+    this.mcpHubDir = join(homedir(), '.mcp-hub');
+    this.serverUrl = 'https://mcp.alpha.dev/api/mcp-hub/mcp';
+  }
+
+  async run() {
+    try {
+      log('\n🔐 AIUSD Skill - Re-authentication', 'magenta');
+      log('====================================', 'magenta');
+      log('This will clear all cached authentication and login fresh', 'cyan');
+
+      // Step 1: Clear cached credentials
+      await this.clearCachedAuth();
+
+      // Step 2: Clear environment variables (inform user)
+      this.clearEnvironmentVars();
+
+      // Step 3: Perform fresh OAuth login
+      await this.performFreshLogin();
+
+      // Step 4: Verify new authentication
+      await this.verifyAuthentication();
+
+      log('\n🎉 Re-authentication completed successfully!', 'green');
+      log('💡 You can now use the skill with fresh credentials', 'cyan');
+
+    } catch (error) {
+      logError(`Re-authentication failed: ${error.message}`);
+      process.exit(1);
+    }
+  }
+
+  async clearCachedAuth() {
+    logStep(1, 'Clearing cached authentication data');
+
+    let cleared = false;
+
+    // Clear mcporter credentials
+    if (existsSync(this.mcporterDir)) {
+      log('🗑️  Removing mcporter credentials...', 'yellow');
+      try {
+        rmSync(this.mcporterDir, { recursive: true });
+        logSuccess('mcporter credentials cleared');
+        cleared = true;
+      } catch (error) {
+        logWarning(`Failed to clear mcporter credentials: ${error.message}`);
+      }
+    }
+
+    // Clear local token files
+    if (existsSync(this.mcpHubDir)) {
+      log('🗑️  Removing local token files...', 'yellow');
+      try {
+        rmSync(this.mcpHubDir, { recursive: true });
+        logSuccess('Local token files cleared');
+        cleared = true;
+      } catch (error) {
+        logWarning(`Failed to clear local token files: ${error.message}`);
+      }
+    }
+
+    // Clear any other common auth files
+    const otherAuthFiles = [
+      join(homedir(), 'auth.json'),
+      join(homedir(), 'token.json'),
+      join(homedir(), 'credentials.json')
+    ];
+
+    for (const authFile of otherAuthFiles) {
+      if (existsSync(authFile)) {
+        try {
+          rmSync(authFile);
+          log(`🗑️  Removed ${authFile}`, 'yellow');
+          cleared = true;
+        } catch (error) {
+          logWarning(`Failed to remove ${authFile}: ${error.message}`);
+        }
+      }
+    }
+
+    if (!cleared) {
+      log('📝 No cached authentication data found', 'cyan');
+    }
+  }
+
+  clearEnvironmentVars() {
+    logStep(2, 'Checking environment variables');
+
+    const envVars = ['MCP_HUB_TOKEN', 'AIUSD_TOKEN'];
+    let hasEnvVars = false;
+
+    for (const envVar of envVars) {
+      if (process.env[envVar]) {
+        hasEnvVars = true;
+        break;
+      }
+    }
+
+    if (hasEnvVars) {
+      logWarning('Environment variables detected:');
+      for (const envVar of envVars) {
+        if (process.env[envVar]) {
+          log(`   ${envVar}=${process.env[envVar].slice(0, 20)}...`, 'yellow');
+        }
+      }
+      log('');
+      log('📋 To clear environment variables, run:', 'cyan');
+      for (const envVar of envVars) {
+        if (process.env[envVar]) {
+          log(`   unset ${envVar}`, 'blue');
+        }
+      }
+      log('');
+    } else {
+      logSuccess('No environment authentication variables found');
+    }
+  }
+
+  async performFreshLogin() {
+    logStep(3, 'Performing fresh OAuth login');
+
+    // Check if mcporter is available
+    try {
+      execSync('which mcporter', { stdio: 'pipe' });
+      log('📱 mcporter found, attempting OAuth login...', 'blue');
+    } catch (error) {
+      log('📥 Installing mcporter...', 'blue');
+      try {
+        execSync('npm install -g mcporter', { stdio: 'inherit' });
+        log('✅ mcporter installed', 'green');
+      } catch (installError) {
+        logError('Failed to install mcporter. Please install manually: npm install -g mcporter');
+        throw installError;
+      }
+    }
+
+    // Create fresh mcporter directory
+    mkdirSync(this.mcporterDir, { recursive: true });
+
+    log('🔐 Starting OAuth authentication flow...', 'blue');
+    log('Please complete authentication in your browser', 'cyan');
+    log('After completing authentication, you can check your account balance or wallet status in chat', 'yellow');
+
+    try {
+      const result = execSync(
+        `npx mcporter list --http-url ${this.serverUrl} --name aiusd`,
+        {
+          cwd: projectRoot,
+          encoding: 'utf8',
+          stdio: 'pipe', 
+          timeout: 60000 // 1 minutes timeout
+        }
+      );
+
+      logSuccess('OAuth authentication completed');
+    } catch (error) {
+      // Check if OAuth actually succeeded despite the error
+      log('🔍 Checking if OAuth succeeded despite error...', 'blue');
+
+      const credentialsPath = join(this.mcporterDir, 'credentials.json');
+      if (existsSync(credentialsPath)) {
+        try {
+          const fs = await import('fs');
+          const credentials = JSON.parse(fs.readFileSync(credentialsPath, 'utf8'));
+
+          // Look for any entry with access_token
+          const hasValidToken = Object.values(credentials.entries || {}).some(
+            entry => entry.tokens && entry.tokens.access_token
+          );
+
+          if (hasValidToken) {
+            logSuccess('OAuth tokens found! Authentication actually succeeded');
+            log('💡 The timeout/error was a mcporter display issue, not a real failure', 'cyan');
+            return; // Continue with success
+          }
+        } catch (parseError) {
+          // Credentials file exists but couldn't parse it
+        }
+      }
+
+      // If we get here, OAuth really did fail
+      if (error.code === 'TIMEOUT') {
+        logError('Authentication timed out. Please try again.');
+      } else if (error.stderr && error.stderr.includes('User denied')) {
+        logError('Authentication was cancelled by user');
+      } else {
+        logError(`Authentication failed: ${error.message}`);
+      }
+      throw error;
+    }
+  }
+
+  async verifyAuthentication() {
+    logStep(4, 'Verifying new authentication');
+
+    // Wait a moment for credentials to be saved
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    try {
+      log('🔍 Testing MCP connection...', 'blue');
+      const result = execSync('node dist/index.js test', {
+        cwd: projectRoot,
+        encoding: 'utf8',
+        timeout: 15000
+      });
+
+      if (result.includes('successful')) {
+        logSuccess('Authentication verification passed');
+
+        // Also test tool listing
+        try {
+          log('🔍 Testing tool access...', 'blue');
+          const toolsResult = execSync('node dist/index.js tools', {
+            cwd: projectRoot,
+            encoding: 'utf8',
+            timeout: 15000
+          });
+
+          const toolCount = (toolsResult.match(/•/g) || []).length;
+          if (toolCount > 0) {
+            logSuccess(`Found ${toolCount} available tools`);
+          } else {
+            logWarning('Tools listed but count unclear');
+          }
+        } catch (error) {
+          logWarning('Tool listing test failed, but basic auth works');
+        }
+
+      } else {
+        logWarning('Authentication verification completed with warnings');
+      }
+    } catch (error) {
+      logError('Authentication verification failed');
+      logError('Please check your credentials and try again');
+      throw error;
+    }
+  }
+}
+
+// Show usage if help requested
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(`
+🔐 AIUSD Skill Re-authentication
+
+This script clears all cached authentication data and performs fresh OAuth login.
+
+Usage:
+  node scripts/reauth.js
+  npm run reauth
+
+What it does:
+  1. Clears mcporter credentials (~/.mcporter/)
+  2. Clears local token files (~/.mcp-hub/)
+  3. Clears other cached auth files
+  4. Performs fresh OAuth browser login
+  5. Verifies new authentication works
+
+Options:
+  --help, -h    Show this help message
+`);
+  process.exit(0);
+}
+
+// Main execution
+async function main() {
+  const reauth = new ReAuthenticator();
+  await reauth.run();
+}
+
+main().catch(console.error);

package/scripts/reauth.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+#
+# AIUSD Skill Re-authentication Script
+# Quick shell wrapper for the Node.js re-authentication script
+#
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+NC='\033[0m' # No Color
+
+log_info() { echo -e "${BLUE}ℹ️${NC} $1"; }
+log_success() { echo -e "${GREEN}✅${NC} $1"; }
+log_warning() { echo -e "${YELLOW}⚠️${NC} $1"; }
+log_error() { echo -e "${RED}❌${NC} $1"; }
+
+# Project directory - go up one level from scripts/
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_ROOT"
+
+echo -e "${MAGENTA}🔐 AIUSD Skill Re-authentication${NC}"
+echo "================================="
+
+# Check if Node.js is available
+if ! command -v node >/dev/null 2>&1; then
+    log_error "Node.js not found. Please install Node.js 18+ from https://nodejs.org"
+    exit 1
+fi
+
+# Check if the JavaScript version exists
+if [[ ! -f "scripts/reauth.js" ]]; then
+    log_error "Re-authentication script not found: scripts/reauth.js"
+    exit 1
+fi
+
+# Execute the Node.js re-authentication script
+log_info "Executing re-authentication script..."
+exec node scripts/reauth.js "$@"

package/scripts/skill-init.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+
+/**
+ * AIUSD Skill Auto-Setup
+ *
+ * This script automatically handles:
+ * 1. Dependency installation
+ * 2. Project building
+ * 3. Authentication setup
+ * 4. Connection testing
+ * 5. Tool availability
+ */
+
+import { spawn, execSync } from 'child_process';
+import { existsSync, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = join(__dirname, '..');
+
+// Colors for console output
+const colors = {
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  reset: '\x1b[0m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function logStep(step, message) {
+  log(`\n🔄 Step ${step}: ${message}`, 'blue');
+}
+
+function logSuccess(message) {
+  log(`✅ ${message}`, 'green');
+}
+
+function logError(message) {
+  log(`❌ ${message}`, 'red');
+}
+
+function logWarning(message) {
+  log(`⚠️  ${message}`, 'yellow');
+}
+
+class SkillSetup {
+  constructor() {
+    this.projectRoot = projectRoot;
+    this.isFirstRun = !existsSync(join(this.projectRoot, 'dist'));
+  }
+
+  async run() {
+    try {
+      log('\n🚀 AIUSD Skill Auto-Setup', 'magenta');
+      log('================================', 'magenta');
+
+      if (this.isFirstRun) {
+        log('🎯 First-time setup detected', 'cyan');
+      } else {
+        log('🔄 Re-running setup', 'cyan');
+      }
+
+      // Step 1: Check dependencies
+      await this.installDependencies();
+
+      // Step 2: Build project
+      await this.buildProject();
+
+      // Step 3: Setup authentication
+      await this.setupAuthentication();
+
+      // Step 4: Test connection
+      await this.testConnection();
+
+      // Step 5: Show available tools
+      await this.showTools();
+
+      log('\n🎉 Setup completed successfully!', 'green');
+      log('💡 You can now use the skill for AIUSD operations', 'cyan');
+
+    } catch (error) {
+      logError(`Setup failed: ${error.message}`);
+      process.exit(1);
+    }
+  }
+
+  async installDependencies() {
+    logStep(1, 'Installing dependencies');
+
+    if (!existsSync(join(this.projectRoot, 'node_modules'))) {
+      log('📦 Installing npm packages...', 'blue');
+      execSync('npm install', {
+        cwd: this.projectRoot,
+        stdio: 'inherit'
+      });
+      logSuccess('Dependencies installed');
+    } else {
+      logSuccess('Dependencies already installed');
+    }
+  }
+
+  async buildProject() {
+    logStep(2, 'Building TypeScript project');
+
+    if (!existsSync(join(this.projectRoot, 'dist')) || this.needsRebuild()) {
+      log('🔨 Compiling TypeScript...', 'blue');
+      execSync('npm run build', {
+        cwd: this.projectRoot,
+        stdio: 'inherit'
+      });
+      logSuccess('Project built successfully');
+    } else {
+      logSuccess('Project already built');
+    }
+  }
+
+  needsRebuild() {
+    try {
+      const srcStat = execSync('find src -name "*.ts" -newer dist 2>/dev/null | wc -l', {
+        cwd: this.projectRoot,
+        encoding: 'utf8'
+      });
+      return parseInt(srcStat.trim()) > 0;
+    } catch {
+      return true;
+    }
+  }
+
+  async setupAuthentication() {
+    logStep(3, 'Setting up authentication');
+
+    // Check for existing authentication
+    if (process.env.MCP_HUB_TOKEN || process.env.AIUSD_TOKEN) {
+      logSuccess('Environment token found');
+      return;
+    }
+
+    // Check for mcporter
+    try {
+      execSync('which mcporter', { stdio: 'pipe' });
+      log('🔐 Checking mcporter authentication...', 'blue');
+
+      try {
+        const result = execSync(
+          'npx mcporter list --http-url https://mcp.alpha.dev/api/mcp-hub/mcp --name aiusd',
+          { cwd: this.projectRoot, encoding: 'utf8', timeout: 10000 }
+        );
+
+        if (result.includes('tools')) {
+          logSuccess('mcporter authentication verified');
+          return;
+        }
+      } catch (error) {
+        logWarning('mcporter authentication needed');
+      }
+    } catch {
+      logWarning('mcporter not available');
+    }
+
+    // Show setup instructions
+    log('\n📋 Authentication Setup Required:', 'yellow');
+    log('Choose one of these methods:', 'cyan');
+    log('');
+    log('1. Environment Variable:', 'blue');
+    log('   export MCP_HUB_TOKEN="Bearer your_token_here"', 'cyan');
+    log('');
+    log('2. Use mcporter (Recommended):', 'blue');
+    log('   npx mcporter list --http-url https://mcp.alpha.dev/api/mcp-hub/mcp --name aiusd', 'cyan');
+    log('');
+    log('3. Get token from: https://mcp.alpha.dev/oauth/login', 'blue');
+    log('');
+  }
+
+  async testConnection() {
+    logStep(4, 'Testing MCP connection');
+
+    try {
+      const result = execSync('node dist/index.js test', {
+        cwd: this.projectRoot,
+        encoding: 'utf8',
+        timeout: 15000
+      });
+
+      if (result.includes('successful')) {
+        logSuccess('MCP connection test passed');
+      } else {
+        logWarning('Connection test completed with warnings');
+        log(result, 'yellow');
+      }
+    } catch (error) {
+      logWarning('Connection test skipped (authentication required)');
+      log('   Set up authentication and run: npm test', 'cyan');
+    }
+  }
+
+  async showTools() {
+    logStep(5, 'Available tools');
+
+    try {
+      const result = execSync('node dist/index.js tools', {
+        cwd: this.projectRoot,
+        encoding: 'utf8',
+        timeout: 15000
+      });
+      log(result, 'cyan');
+    } catch (error) {
+      log('📋 Core AIUSD Tools Available:', 'cyan');
+      log('• genalpha_get_balances - Check account balances', 'blue');
+      log('• genalpha_execute_intent - Execute trading orders', 'blue');
+      log('• genalpha_stake_aiusd - Stake AIUSD tokens', 'blue');
+      log('• genalpha_withdraw_to_wallet - Withdraw to external wallet', 'blue');
+      log('• genalpha_get_transactions - View transaction history', 'blue');
+      log('');
+      log('💡 Authenticate to see full tool details', 'yellow');
+    }
+  }
+}
+
+// Main execution
+async function main() {
+  const setup = new SkillSetup();
+  await setup.run();
+}
+
+main().catch(console.error);

package/scripts/test-client.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+#
+# Test script for AIUSD Skills MCP Client
+#
+
+set -euo pipefail
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log_info() { echo -e "${BLUE}ℹ️${NC} $1"; }
+log_success() { echo -e "${GREEN}✅${NC} $1"; }
+log_warning() { echo -e "${YELLOW}⚠️${NC} $1"; }
+log_error() { echo -e "${RED}❌${NC} $1"; }
+
+# Project directory - go up one level from scripts/
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+cd "$PROJECT_ROOT"
+
+echo "🧪 Testing AIUSD Skills MCP Client"
+echo "================================="
+
+# Check if built
+if [[ ! -f "dist/index.js" ]]; then
+    log_error "Project not built. Run 'npm run build' first"
+    exit 1
+fi
+
+# Test 1: Version check
+log_info "Testing version command..."
+if node dist/index.js --version >/dev/null 2>&1; then
+    log_success "Version command works"
+else
+    log_error "Version command failed"
+    exit 1
+fi
+
+# Test 2: Help command
+log_info "Testing help command..."
+if node dist/index.js --help >/dev/null 2>&1; then
+    log_success "Help command works"
+else
+    log_error "Help command failed"
+    exit 1
+fi
+
+# Test 3: Connection test (may require auth)
+log_info "Testing MCP connection..."
+if node dist/index.js test >/dev/null 2>&1; then
+    log_success "Connection test passed"
+else
+    log_warning "Connection test failed (may need authentication)"
+fi
+
+# Test 4: Tools listing (may require auth)
+log_info "Testing tools listing..."
+if node dist/index.js tools >/dev/null 2>&1; then
+    log_success "Tools listing works"
+else
+    log_warning "Tools listing failed (may need authentication)"
+fi
+
+# Test 5: Balance check (requires auth)
+log_info "Testing balance check..."
+if node dist/index.js balances >/dev/null 2>&1; then
+    log_success "Balance check works"
+    echo ""
+    echo "📊 Current balances:"
+    node dist/index.js balances --pretty
+else
+    log_warning "Balance check failed (authentication required)"
+    echo ""
+    echo "🔐 To enable full testing, set up authentication:"
+    echo "   export MCP_HUB_TOKEN=\"Bearer your_token\""
+    echo "   OR use: npm run setup"
+fi
+
+echo ""
+log_success "Basic functionality tests completed!"
+
+echo ""
+echo "🚀 Manual testing commands:"
+echo "  npm test                    # This test script"
+echo "  node dist/index.js test     # Connection test"
+echo "  node dist/index.js tools    # List available tools"
+echo "  node dist/index.js balances # Check balances"