@xagent-ai/cli 1.2.2 → 1.3.0

package/src/shell.ts

@@ -0,0 +1,133 @@
+import { existsSync } from 'fs';
+import { spawn, spawnSync } from 'child_process';
+
+/**
+ * Find bash executable on PATH (Windows).
+ */
+function findBashOnPath(): string | null {
+	try {
+		const result = spawnSync('where', ['bash.exe'], { encoding: 'utf-8', timeout: 5000 });
+		if (result.status === 0 && result.stdout) {
+			const firstMatch = result.stdout.trim().split(/\r?\n/)[0];
+			if (firstMatch && existsSync(firstMatch)) {
+				return firstMatch;
+			}
+		}
+	} catch {
+		// Ignore errors
+	}
+	return null;
+}
+
+/**
+ * Get PowerShell version on Windows.
+ * @returns Version string (e.g., "5.1.22621") or "Unknown" if detection fails
+ */
+export function getPowerShellVersion(): string {
+	if (process.platform !== 'win32') {
+		return 'N/A';
+	}
+
+	try {
+		const result = spawnSync('powershell', ['-NoProfile', '-Command', '($PSVersionTable.PSVersion | Select-Object -ExpandProperty Major), ($PSVersionTable.PSVersion | Select-Object -ExpandProperty Minor), ($PSVersionTable.PSVersion | Select-Object -ExpandProperty Build) -join "."'], {
+			encoding: 'utf-8',
+			timeout: 5000
+		});
+
+		if (result.status === 0 && result.stdout.trim()) {
+			return result.stdout.trim();
+		}
+	} catch {
+		// Ignore errors
+	}
+	return 'Unknown';
+}
+
+interface ShellConfig {
+	/** Path to the shell executable */
+	shell: string;
+	/** Arguments to pass to the shell */
+	args: string[];
+}
+
+let cachedShellConfig: ShellConfig | null = null;
+
+/**
+ * Get shell configuration based on platform.
+ * Resolution order:
+ * 1. On Windows: PowerShell (preferred), then Git Bash as fallback
+ * 2. On Unix: /bin/bash
+ *
+ * @returns ShellConfig with shell path and args
+ */
+export function getShellConfig(): ShellConfig {
+	if (cachedShellConfig) {
+		return cachedShellConfig;
+	}
+
+	if (process.platform === 'win32') {
+		// On Windows, prefer PowerShell for better compatibility and output handling
+		// Use -NoProfile to avoid profile script interference
+		// -Command executes the command string as PowerShell script
+		cachedShellConfig = {
+			shell: 'powershell',
+			args: ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command']
+		};
+		return cachedShellConfig;
+	}
+
+	// Unix: prefer bash over sh
+	if (existsSync('/bin/bash')) {
+		cachedShellConfig = { shell: '/bin/bash', args: ['-c'] };
+	} else {
+		cachedShellConfig = { shell: 'sh', args: ['-c'] };
+	}
+	return cachedShellConfig;
+}
+
+/**
+ * Get a shell command string with proper quoting for the platform.
+ * @param command The command to execute
+ * @returns A properly quoted command string
+ */
+export function quoteShellCommand(command: string): string {
+	if (process.platform === 'win32') {
+		// For PowerShell -Command, the command string is passed directly
+		// PowerShell will parse and execute it as a script
+		// No additional quoting needed - just return the command as-is
+		return command;
+	} else {
+		// For bash/sh, use single quotes
+		return `'${command.replace(/'/g, "'\\''")}'`;
+	}
+}
+
+/**
+ * Kill a process and all its children (cross-platform).
+ * @param pid Process ID to kill
+ */
+export function killProcessTree(pid: number): void {
+	if (process.platform === 'win32') {
+		// Use taskkill on Windows to kill process tree
+		try {
+			spawn('taskkill', ['/F', '/T', '/PID', String(pid)], {
+				stdio: 'ignore',
+				detached: true,
+			});
+		} catch (error) {
+			console.warn(`[shell] Failed to kill process tree (PID ${pid}): ${error instanceof Error ? error.message : String(error)}`);
+		}
+	} else {
+		// Use SIGKILL on Unix/Linux/Mac
+		try {
+			process.kill(-pid, 'SIGKILL');
+		} catch (error) {
+			// Fallback to killing just the child if process group kill fails
+			try {
+				process.kill(pid, 'SIGKILL');
+			} catch (fallbackError) {
+				console.warn(`[shell] Failed to kill process (PID ${pid}): ${fallbackError instanceof Error ? fallbackError.message : String(fallbackError)}`);
+			}
+		}
+	}
+}

package/src/skill-installer.ts

@@ -0,0 +1,518 @@
+/**
+ * Skill Installer - Handles remote skill installation
+ * Supports: GitHub shorthand, GitHub URLs, direct SKILL.md URLs
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { mkdtemp, rm } from 'fs/promises';
+import { tmpdir } from 'os';
+import simpleGit from 'simple-git';
+import { getConfigManager } from './config.js';
+import { getLogger } from './logger.js';
+
+const logger = getLogger();
+const CLONE_TIMEOUT_MS = 60000; // 60 seconds
+
+export interface RemoteSource {
+  type: 'github' | 'direct-url' | 'local';
+  url: string;
+  ref?: string;        // Branch/tag
+  subpath?: string;    // Path to skill within repo
+  skillName?: string;  // For @owner/repo@syntax
+}
+
+export interface InstallResult {
+  success: boolean;
+  skillName?: string;
+  skillPath?: string;
+  error?: string;
+}
+
+/**
+ * Parse a source string into structured format
+ */
+export function parseSource(input: string): RemoteSource {
+  const trimmed = input.trim();
+
+  // Check if local path
+  if (isLocalPath(trimmed)) {
+    return { type: 'local', url: trimmed };
+  }
+
+  // Direct SKILL.md URL (non-GitHub)
+  if (isDirectSkillUrl(trimmed)) {
+    return { type: 'direct-url', url: trimmed };
+  }
+
+  // GitHub URL with path: https://github.com/owner/repo/tree/branch/path/to/skill
+  const githubTreeWithPathMatch = trimmed.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/);
+  if (githubTreeWithPathMatch) {
+    const [, owner, repo, ref, subpath] = githubTreeWithPathMatch;
+    return {
+      type: 'github',
+      url: `https://github.com/${owner}/${repo}.git`,
+      ref,
+      subpath
+    };
+  }
+
+  // GitHub URL with branch only: https://github.com/owner/repo/tree/branch
+  const githubTreeMatch = trimmed.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)$/);
+  if (githubTreeMatch) {
+    const [, owner, repo, ref] = githubTreeMatch;
+    return {
+      type: 'github',
+      url: `https://github.com/${owner}/${repo}.git`,
+      ref
+    };
+  }
+
+  // GitHub URL: https://github.com/owner/repo
+  const githubRepoMatch = trimmed.match(/github\.com\/([^/]+)\/([^/]+)/);
+  if (githubRepoMatch) {
+    const [, owner, repo] = githubRepoMatch;
+    const cleanRepo = repo.replace(/\.git$/, '');
+    return {
+      type: 'github',
+      url: `https://github.com/${owner}/${cleanRepo}.git`
+    };
+  }
+
+  // GitHub shorthand: owner/repo, owner/repo@skill-name
+  const atSkillMatch = trimmed.match(/^([^/]+)\/([^/@]+)@(.+)$/);
+  if (atSkillMatch && !trimmed.includes(':') && !trimmed.startsWith('.') && !trimmed.startsWith('/')) {
+    const [, owner, repo, skillName] = atSkillMatch;
+    return {
+      type: 'github',
+      url: `https://github.com/${owner}/${repo}.git`,
+      skillName
+    };
+  }
+
+  const shorthandMatch = trimmed.match(/^([^/]+)\/([^/]+)(?:\/(.+))?$/);
+  if (shorthandMatch && !trimmed.includes(':') && !trimmed.startsWith('.') && !trimmed.startsWith('/')) {
+    const [, owner, repo, subpath] = shorthandMatch;
+    return {
+      type: 'github',
+      url: `https://github.com/${owner}/${repo}.git`,
+      subpath
+    };
+  }
+
+  // Fallback: treat as direct URL
+  return { type: 'direct-url', url: trimmed };
+}
+
+/**
+ * Check if input is a local path
+ */
+function isLocalPath(input: string): boolean {
+  return (
+    path.isAbsolute(input) ||
+    input.startsWith('./') ||
+    input.startsWith('../') ||
+    input === '.' ||
+    input === '..' ||
+    /^[a-zA-Z]:[/\\]/.test(input)
+  );
+}
+
+/**
+ * Check if URL is a direct link to SKILL.md file
+ */
+function isDirectSkillUrl(input: string): boolean {
+  if (!input.startsWith('http://') && !input.startsWith('https://')) {
+    return false;
+  }
+
+  if (!input.toLowerCase().endsWith('/skill.md') && !input.toLowerCase().endsWith('/skill')) {
+    return false;
+  }
+
+  // Exclude GitHub/GitLab URLs (they have their own handling)
+  if (input.includes('github.com/') && !input.includes('raw.githubusercontent.com')) {
+    return false;
+  }
+  if (input.includes('gitlab.com/') && !input.includes('/-/raw/')) {
+    return false;
+  }
+
+  return true;
+}
+
+/**
+ * Extract skill name from SKILL.md content
+ */
+function extractSkillName(content: string): string | null {
+  const nameMatch = content.match(/^name:\s*(.+)$/m);
+  return nameMatch ? nameMatch[1].trim() : null;
+}
+
+/**
+ * Ensure directory exists
+ */
+async function ensureDir(dirPath: string): Promise<void> {
+  await fs.mkdir(dirPath, { recursive: true });
+}
+
+/**
+ * Remove directory recursively
+ */
+async function removeDir(dirPath: string): Promise<void> {
+  try {
+    await fs.rm(dirPath, { recursive: true, force: true });
+  } catch {
+    // Ignore if doesn't exist
+  }
+}
+
+/**
+ * Copy directory contents
+ */
+async function copyDir(src: string, dest: string): Promise<void> {
+  await ensureDir(dest);
+  const entries = await fs.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath);
+    } else if (entry.isFile()) {
+      await fs.copyFile(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Find SKILL.md in a directory
+ */
+async function findSkillMd(dirPath: string): Promise<string | null> {
+  try {
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry.name);
+
+      if (entry.isDirectory()) {
+        // Skip hidden directories (except .)
+        if (entry.name.startsWith('.') && entry.name !== '.') continue;
+
+        // Check subdirectory for SKILL.md
+        const result = await findSkillMd(fullPath);
+        if (result) return result;
+      } else if (entry.isFile() && entry.name.toUpperCase() === 'SKILL.MD') {
+        return fullPath;
+      }
+    }
+  } catch {
+    // Ignore errors
+  }
+  return null;
+}
+
+/**
+ * Fetch remote file content via HTTP with timeout
+ */
+async function fetchRemoteFile(url: string, timeoutMs: number = 30000): Promise<string> {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetch(url, { signal: controller.signal });
+    clearTimeout(timeoutId);
+    
+    if (!response.ok) {
+      throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+  } catch (error) {
+    clearTimeout(timeoutId);
+    if (error instanceof Error && error.name === 'AbortError') {
+      throw new Error(`Request timed out after ${timeoutMs}ms: ${url}`);
+    }
+    throw error;
+  }
+}
+
+/**
+ * Clone a GitHub repository to a temporary directory
+ */
+async function cloneRepo(url: string, ref?: string): Promise<string> {
+  const tempDir = await mkdtemp(path.join(tmpdir(), 'xagent-skills-'));
+  const git = simpleGit({ timeout: { block: CLONE_TIMEOUT_MS } });
+  const cloneOptions = ref ? ['--depth', '1', '--branch', ref] : ['--depth', '1'];
+
+  try {
+    await git.clone(url, tempDir, cloneOptions);
+    return tempDir;
+  } catch (error) {
+    // Clean up temp dir on failure
+    await rm(tempDir, { recursive: true, force: true }).catch(() => {});
+    
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const isTimeout = errorMessage.includes('block timeout') || errorMessage.includes('timed out');
+    
+    if (isTimeout) {
+      throw new Error(
+        `Clone timed out after 60s. This often happens with private repos that require authentication.\n` +
+        `  Ensure you have access and your SSH keys or credentials are configured.`
+      );
+    }
+
+    throw new Error(`Failed to clone ${url}: ${errorMessage}`);
+  }
+}
+
+/**
+ * Install skill from direct URL (single SKILL.md file)
+ */
+async function installFromDirectUrl(source: RemoteSource): Promise<InstallResult> {
+  const configManager = getConfigManager();
+  const userSkillsPath = configManager.getUserSkillsPath() || path.join(os.homedir(), '.xagent', 'skills');
+
+  try {
+    const content = await fetchRemoteFile(source.url);
+    const skillName = extractSkillName(content);
+
+    if (!skillName) {
+      return { success: false, error: 'Could not extract skill name from SKILL.md' };
+    }
+
+    const skillPath = path.join(userSkillsPath, skillName);
+    
+    // Check if skill already exists
+    try {
+      await fs.access(skillPath);
+      return { success: false, error: `Skill "${skillName}" already installed` };
+    } catch {
+      // Doesn't exist, proceed
+    }
+
+    // Create skill directory
+    await ensureDir(skillPath);
+
+    // Write SKILL.md
+    await fs.writeFile(path.join(skillPath, 'SKILL.md'), content, 'utf-8');
+
+    return { success: true, skillName, skillPath };
+  } catch (error) {
+    return { success: false, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+/**
+ * Install skill from GitHub repository using git clone
+ */
+async function installFromGitHub(source: RemoteSource): Promise<InstallResult> {
+  const configManager = getConfigManager();
+  const userSkillsPath = configManager.getUserSkillsPath() || path.join(os.homedir(), '.xagent', 'skills');
+
+  // Parse owner/repo from URL
+  const urlMatch = source.url.match(/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/);
+  if (!urlMatch) {
+    return { success: false, error: 'Invalid GitHub URL' };
+  }
+
+  const [, owner, repo] = urlMatch;
+  const cleanRepo = repo.replace(/\.git$/, '');
+  const ref = source.ref || 'main';
+
+  let tempDir: string | null = null;
+
+  try {
+    // Clone the repository to a temporary directory
+    tempDir = await cloneRepo(source.url, ref);
+
+    // Find the skill directory in the cloned repo
+    let skillDir: string;
+    
+    if (source.subpath) {
+      // Specific path to skill provided
+      skillDir = path.join(tempDir, source.subpath);
+      try {
+        await fs.access(skillDir);
+      } catch {
+        return { success: false, error: `Path "${source.subpath}" not found in repository` };
+      }
+    } else if (source.skillName) {
+      // @owner/repo@syntax - skill is in skills/<skill-name>/
+      skillDir = path.join(tempDir, 'skills', source.skillName);
+      try {
+        await fs.access(skillDir);
+      } catch {
+        return { success: false, error: `Skill "${source.skillName}" not found in skills/` };
+      }
+    } else {
+      // No specific path - find SKILL.md in the repo
+      const skillMdPath = await findSkillMd(tempDir);
+      if (!skillMdPath) {
+        return { success: false, error: 'No SKILL.md found in repository' };
+      }
+      skillDir = path.dirname(skillMdPath);
+    }
+
+    // Read SKILL.md to get skill name
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    let skillContent: string;
+    try {
+      skillContent = await fs.readFile(skillMdPath, 'utf-8');
+    } catch {
+      return { success: false, error: 'SKILL.md not found in skill directory' };
+    }
+
+    const skillName = extractSkillName(skillContent);
+    if (!skillName) {
+      return { success: false, error: 'Could not extract skill name from SKILL.md' };
+    }
+
+    const skillPath = path.join(userSkillsPath, skillName);
+
+    // Check if skill already exists
+    try {
+      await fs.access(skillPath);
+      return { success: false, error: `Skill "${skillName}" already installed` };
+    } catch {
+      // Doesn't exist, proceed
+    }
+
+    // Copy skill files to user skills directory
+    await copyDir(skillDir, skillPath);
+
+    return { success: true, skillName, skillPath };
+  } catch (error) {
+    return { success: false, error: error instanceof Error ? error.message : String(error) };
+  } finally {
+    // Clean up temporary directory
+    if (tempDir) {
+      await rm(tempDir, { recursive: true, force: true }).catch(() => {});
+    }
+  }
+}
+
+/**
+ * Install skill from local path
+ */
+async function installFromLocal(source: RemoteSource): Promise<InstallResult> {
+  const configManager = getConfigManager();
+  const userSkillsPath = configManager.getUserSkillsPath() || path.join(os.homedir(), '.xagent', 'skills');
+
+  try {
+    const resolvedPath = path.resolve(source.url);
+    
+    // Check if source exists
+    await fs.access(resolvedPath);
+
+    // Find SKILL.md
+    const skillMdPath = await findSkillMd(resolvedPath);
+    if (!skillMdPath) {
+      return { success: false, error: 'SKILL.md not found in source directory' };
+    }
+
+    const content = await fs.readFile(skillMdPath, 'utf-8');
+    const skillName = extractSkillName(content);
+
+    if (!skillName) {
+      return { success: false, error: 'Could not extract skill name from SKILL.md' };
+    }
+
+    const skillPath = path.join(userSkillsPath, skillName);
+
+    // Check if skill already exists
+    try {
+      await fs.access(skillPath);
+      return { success: false, error: `Skill "${skillName}" already installed` };
+    } catch {
+      // Doesn't exist, proceed
+    }
+
+    // Copy the skill directory
+    const sourceDir = path.dirname(skillMdPath);
+    await copyDir(sourceDir, skillPath);
+
+    return { success: true, skillName, skillPath };
+  } catch (error) {
+    return { success: false, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+/**
+ * Main function to install a skill from source
+ */
+export async function installSkill(source: string): Promise<InstallResult> {
+  const parsed = parseSource(source);
+
+  switch (parsed.type) {
+    case 'direct-url':
+      return installFromDirectUrl(parsed);
+    case 'github':
+      return installFromGitHub(parsed);
+    case 'local':
+      return installFromLocal(parsed);
+    default:
+      return { success: false, error: 'Unknown source type' };
+  }
+}
+
+/**
+ * Remove an installed skill
+ */
+export async function removeSkill(skillName: string): Promise<InstallResult> {
+  const configManager = getConfigManager();
+  const userSkillsPath = configManager.getUserSkillsPath() || path.join(os.homedir(), '.xagent', 'skills');
+  const skillPath = path.join(userSkillsPath, skillName);
+
+  try {
+    await fs.access(skillPath);
+    await removeDir(skillPath);
+    return { success: true, skillName, skillPath };
+  } catch {
+    return { success: false, error: `Skill "${skillName}" not found` };
+  }
+}
+
+/**
+ * List installed user skills
+ */
+export async function listUserSkills(): Promise<Array<{ name: string; description: string; path: string }>> {
+  const configManager = getConfigManager();
+  const userSkillsPath = configManager.getUserSkillsPath() || path.join(os.homedir(), '.xagent', 'skills');
+
+  const skills: Array<{ name: string; description: string; path: string }> = [];
+
+  try {
+    const entries = await fs.readdir(userSkillsPath, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        const skillPath = path.join(userSkillsPath, entry.name);
+        const skillMdPath = path.join(skillPath, 'SKILL.md');
+
+        try {
+          const content = await fs.readFile(skillMdPath, 'utf-8');
+          const nameMatch = content.match(/^name:\s*(.+)$/m);
+          const descMatch = content.match(/^description:\s*(.+)$/m);
+
+          skills.push({
+            name: nameMatch ? nameMatch[1].trim() : entry.name,
+            description: descMatch ? descMatch[1].trim() : 'No description',
+            path: skillPath
+          });
+        } catch {
+          skills.push({
+            name: entry.name,
+            description: '(Missing SKILL.md)',
+            path: skillPath
+          });
+        }
+      }
+    }
+  } catch {
+    // Directory doesn't exist or is empty
+  }
+
+  return skills;
+}