@codemieai/code 0.0.32 → 0.0.34

package/dist/skills/utils/pattern-matcher.js

@@ -0,0 +1,97 @@
+/**
+ * Pattern matcher for skill invocation detection
+ *
+ * Detects /skill-name patterns in user messages and extracts skill names.
+ * Excludes URLs and built-in CLI commands.
+ */
+/**
+ * Built-in CLI commands that should NOT be treated as skills
+ */
+const BUILT_IN_COMMANDS = new Set([
+    'help',
+    'clear',
+    'exit',
+    'quit',
+    'stats',
+    'todos',
+    'config',
+    'health',
+]);
+/**
+ * Regex pattern for skill invocation
+ *
+ * Matches: /skill-name with optional arguments
+ * Excludes: URLs (negative lookbehind for : or alphanumeric before /)
+ * Format: /[a-z][a-z0-9-]{0,49} (lowercase, alphanumeric + hyphens, 1-50 chars)
+ */
+const SKILL_PATTERN = /(?<![:\w])\/([a-z][a-z0-9-]{0,49})(?:\s+([^\n/]+))?/g;
+/**
+ * Extract skill patterns from a user message
+ *
+ * @param message - User message to scan
+ * @returns Pattern match result with detected skills
+ *
+ * @example
+ * ```typescript
+ * const result = extractSkillPatterns('/mr');
+ * // result.patterns = [{ name: 'mr', position: 0, raw: '/mr' }]
+ *
+ * const result2 = extractSkillPatterns('ensure you can /commit this');
+ * // result2.patterns = [{ name: 'commit', position: 15, args: 'this', raw: '/commit this' }]
+ * ```
+ */
+export function extractSkillPatterns(message) {
+    const patterns = [];
+    const seenNames = new Set();
+    // Reset regex state
+    SKILL_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = SKILL_PATTERN.exec(message)) !== null) {
+        const [fullMatch, skillName, args] = match;
+        const position = match.index;
+        // Skip if this is part of a URL
+        // Check if there's http:// or https:// within the last 100 chars before this position
+        const lookback = Math.min(100, position);
+        const beforeMatch = message.slice(position - lookback, position);
+        // If we find a protocol and no whitespace between it and this slash, it's part of a URL
+        if (/https?:\/\/[^\s]*$/.test(beforeMatch)) {
+            continue;
+        }
+        // Skip built-in commands
+        if (BUILT_IN_COMMANDS.has(skillName)) {
+            continue;
+        }
+        // Deduplicate by skill name (keep first occurrence)
+        if (seenNames.has(skillName)) {
+            continue;
+        }
+        seenNames.add(skillName);
+        patterns.push({
+            name: skillName,
+            position,
+            args: args?.trim(),
+            raw: fullMatch,
+        });
+    }
+    return {
+        patterns,
+        originalMessage: message,
+        hasPatterns: patterns.length > 0,
+    };
+}
+/**
+ * Validate a skill name
+ *
+ * @param name - Skill name to validate
+ * @returns True if valid, false otherwise
+ *
+ * Rules:
+ * - Lowercase letters only
+ * - Can include digits and hyphens
+ * - Must start with a letter
+ * - 1-50 characters
+ */
+export function isValidSkillName(name) {
+    return /^[a-z][a-z0-9-]{0,49}$/.test(name);
+}
+//# sourceMappingURL=pattern-matcher.js.map

package/dist/skills/utils/pattern-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.js","sourceRoot":"","sources":["../../../src/skills/utils/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH;;GAEG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,sDAAsD,CAAC;AAE7E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,oBAAoB;IACpB,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC;IAE5B,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;QAE7B,gCAAgC;QAChC,sFAAsF;QACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEjE,wFAAwF;QACxF,IAAI,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,yBAAyB;QACzB,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,oDAAoD;QACpD,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEzB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,SAAS;YACf,QAAQ;YACR,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;YAClB,GAAG,EAAE,SAAS;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/utils/exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA6ErB"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA2FrB"}

package/dist/utils/exec.js

@@ -28,7 +28,17 @@ export async function exec(command, args = [], options = {}) {
         }
         // Interactive mode: inherit stdio for user prompts
         const stdio = options.interactive ? 'inherit' : 'pipe';
-        const child = spawn(command, args, {
+        // When using shell: true, merge args into command string to avoid DEP0190
+        // Node.js deprecation warning: shell mode doesn't escape array arguments, only concatenates them
+        let finalCommand = command;
+        let finalArgs = args;
+        if (useShell && args.length > 0) {
+            // Quote arguments that contain spaces or special characters
+            const quotedArgs = args.map(arg => arg.includes(' ') || arg.includes('"') ? `"${arg.replace(/"/g, '\\"')}"` : arg);
+            finalCommand = `${command} ${quotedArgs.join(' ')}`;
+            finalArgs = [];
+        }
+        const child = spawn(finalCommand, finalArgs, {
             cwd: options.cwd || process.cwd(),
             env: { ...process.env, ...options.env },
             shell: useShell,

package/dist/utils/exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"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"}

package/dist/utils/installation-detector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Simple installation method detector for external agents
+ * Detects whether agents were installed via npm or native installers
+ */
+/**
+ * Installation method type
+ */
+export type InstallationMethod = 'npm' | 'native' | 'unknown';
+/**
+ * Detect if a command was installed via npm by checking its path
+ *
+ * @param commandName - Command to check (e.g., 'claude')
+ * @returns Installation method: 'npm', 'native', or 'unknown'
+ *
+ * @example
+ * const method = await detectInstallationMethod('claude');
+ * if (method === 'npm') {
+ *   console.log('Installed via npm (deprecated)');
+ * }
+ */
+export declare function detectInstallationMethod(commandName: string): Promise<InstallationMethod>;
+//# sourceMappingURL=installation-detector.d.ts.map

package/dist/utils/installation-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation-detector.d.ts","sourceRoot":"","sources":["../../src/utils/installation-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiC/F"}

package/dist/utils/installation-detector.js

@@ -0,0 +1,49 @@
+/**
+ * Simple installation method detector for external agents
+ * Detects whether agents were installed via npm or native installers
+ */
+import { getCommandPath } from './processes.js';
+/**
+ * Detect if a command was installed via npm by checking its path
+ *
+ * @param commandName - Command to check (e.g., 'claude')
+ * @returns Installation method: 'npm', 'native', or 'unknown'
+ *
+ * @example
+ * const method = await detectInstallationMethod('claude');
+ * if (method === 'npm') {
+ *   console.log('Installed via npm (deprecated)');
+ * }
+ */
+export async function detectInstallationMethod(commandName) {
+    try {
+        // Get the full path to the command
+        const commandPath = await getCommandPath(commandName);
+        if (!commandPath) {
+            return 'unknown';
+        }
+        // npm-specific path patterns (cross-platform)
+        const npmPatterns = [
+            '/node_modules/', // Unix: npm global/local
+            '/.nvm/', // Unix: nvm installations
+            '/.npm-global/', // Unix: npm custom prefix
+            '\\node_modules\\', // Windows: npm global/local
+            '\\npm\\', // Windows: npm directories
+            'AppData\\npm', // Windows: user npm directory
+            'Program Files\\nodejs\\node_modules', // Windows: system npm
+        ];
+        // Check if path contains any npm-specific pattern
+        for (const pattern of npmPatterns) {
+            if (commandPath.includes(pattern)) {
+                return 'npm';
+            }
+        }
+        // If not in npm directory, assume native installation
+        return 'native';
+    }
+    catch {
+        // If detection fails, return unknown
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=installation-detector.js.map

package/dist/utils/installation-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation-detector.js","sourceRoot":"","sources":["../../src/utils/installation-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOhD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,WAAmB;IACjE,IAAI,CAAC;QACJ,mCAAmC;QACnC,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAEtD,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,OAAO,SAAS,CAAC;QAClB,CAAC;QAED,8CAA8C;QAC9C,MAAM,WAAW,GAAG;YACnB,gBAAgB,EAAM,yBAAyB;YAC/C,QAAQ,EAAc,0BAA0B;YAChD,eAAe,EAAO,0BAA0B;YAChD,kBAAkB,EAAI,4BAA4B;YAClD,SAAS,EAAa,2BAA2B;YACjD,cAAc,EAAQ,8BAA8B;YACpD,qCAAqC,EAAE,sBAAsB;SAC7D,CAAC;QAEF,kDAAkD;QAClD,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;YACnC,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,sDAAsD;QACtD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACR,qCAAqC;QACrC,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/utils/native-installer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Native installer utilities for platform-specific agent installation
+ * Used for Claude Code native installation management
+ */
+/**
+ * Platform-specific installer URLs
+ */
+export interface PlatformInstallerUrls {
+    macOS: string;
+    windows: string;
+    linux: string;
+}
+/**
+ * Native installation options
+ */
+export interface NativeInstallOptions {
+    timeout?: number;
+    env?: Record<string, string>;
+    verifyCommand?: string;
+    installFlags?: string[];
+}
+/**
+ * Native installation result
+ */
+export interface NativeInstallResult {
+    success: boolean;
+    installedVersion: string | null;
+    output: string;
+}
+/**
+ * Install agent using native platform installer
+ * Detects platform and executes appropriate installation script
+ *
+ * @param agentName - Agent name for logging (e.g., 'claude')
+ * @param installerUrls - Platform-specific installer URLs
+ * @param version - Version to install (e.g., '2.0.30', 'latest', 'stable', or undefined)
+ * @param options - Installation options (timeout, env, etc.)
+ * @returns Installation result with success status and installed version
+ * @throws {AgentInstallationError} If installation fails
+ *
+ * @example
+ * await installNativeAgent('claude', {
+ *   macOS: 'https://claude.ai/install.sh',
+ *   windows: 'https://claude.ai/install.ps1',
+ *   linux: 'https://claude.ai/install.sh'
+ * }, '2.0.30');
+ */
+export declare function installNativeAgent(agentName: string, installerUrls: PlatformInstallerUrls, version?: string, options?: NativeInstallOptions): Promise<NativeInstallResult>;
+//# sourceMappingURL=native-installer.d.ts.map

package/dist/utils/native-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-installer.d.ts","sourceRoot":"","sources":["../../src/utils/native-installer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CACf;AA0HD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACvC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,qBAAqB,EACpC,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAuF9B"}

package/dist/utils/native-installer.js

@@ -0,0 +1,194 @@
+/**
+ * Native installer utilities for platform-specific agent installation
+ * Used for Claude Code native installation management
+ */
+import { exec } from './processes.js';
+import { AgentInstallationError } from './errors.js';
+import { logger } from './logger.js';
+import { sanitizeLogArgs, sanitizeValue } from './security.js';
+import { isValidSemanticVersion } from './version-utils.js';
+/**
+ * Detect current platform
+ * @returns Platform identifier: 'macOS' | 'windows' | 'linux'
+ */
+function detectPlatform() {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        return 'macOS';
+    }
+    else if (platform === 'win32') {
+        return 'windows';
+    }
+    else {
+        // Assume Linux for all other platforms (linux, freebsd, etc.)
+        return 'linux';
+    }
+}
+/**
+ * Build installer command for the detected platform
+ *
+ * @param agentName - Agent name for error messages
+ * @param installerUrls - Platform-specific installer URLs
+ * @param version - Optional version to install
+ * @param platform - Detected platform
+ * @param installFlags - Additional flags to pass to installer (e.g., ['--force'])
+ * @returns Command string to execute
+ */
+function buildInstallerCommand(agentName, installerUrls, version, platform, installFlags) {
+    // Validate installer URLs are HTTPS (security requirement)
+    const url = installerUrls[platform];
+    if (!url.startsWith('https://')) {
+        throw new AgentInstallationError(agentName, `Installer URL must use HTTPS: ${url}`);
+    }
+    // SECURITY: Validate version string to prevent command injection
+    // Only allow semantic versions or special channels (latest, stable)
+    if (version) {
+        const allowedChannels = ['latest', 'stable'];
+        const isValidChannel = allowedChannels.includes(version.toLowerCase());
+        const isValidVersion = isValidSemanticVersion(version);
+        if (!isValidChannel && !isValidVersion) {
+            throw new AgentInstallationError(agentName, `Invalid version format: "${version}". Expected semantic version (e.g., "2.0.30"), "latest", or "stable".`);
+        }
+    }
+    // SECURITY: Validate install flags against whitelist
+    // Only allow known safe flags to prevent command injection
+    const allowedFlags = ['--force', '--silent', '--yes', '-y', '-f', '--no-progress'];
+    if (installFlags && installFlags.length > 0) {
+        for (const flag of installFlags) {
+            if (!allowedFlags.includes(flag)) {
+                throw new AgentInstallationError(agentName, `Invalid install flag: "${flag}". Allowed flags: ${allowedFlags.join(', ')}`);
+            }
+        }
+    }
+    // Build platform-specific command
+    if (platform === 'windows') {
+        // Windows CMD command (simpler and more universal than PowerShell)
+        // Download install.cmd, execute with args, then delete
+        const versionArg = version ? ` ${version}` : '';
+        const flagsArg = installFlags && installFlags.length > 0 ? ` ${installFlags.join(' ')}` : '';
+        return `curl -fsSL ${url} -o install.cmd && install.cmd${versionArg}${flagsArg} && del install.cmd`;
+    }
+    else {
+        // macOS/Linux shell script command
+        const versionArg = version ? ` -s -- ${version}` : '';
+        const scriptFlags = installFlags && installFlags.length > 0 ? ` ${installFlags.join(' ')}` : '';
+        return `curl -fsSL ${url} | bash${versionArg}${scriptFlags}`;
+    }
+}
+/**
+ * Verify installation by running the verify command
+ *
+ * @param verifyCommand - Command to verify (e.g., 'claude')
+ * @returns Installed version string or null if verification failed
+ */
+async function verifyInstallation(verifyCommand) {
+    try {
+        // Run version check command (e.g., 'claude --version')
+        const result = await exec(verifyCommand, ['--version'], {
+            timeout: 5000, // 5 second timeout for version check
+        });
+        if (result.code === 0 && result.stdout) {
+            // Parse version from output (usually first line, may have 'v' prefix)
+            const versionMatch = result.stdout.trim().match(/v?(\d+\.\d+\.\d+)/);
+            if (versionMatch) {
+                return versionMatch[1];
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        logger.debug('Installation verification failed', ...sanitizeLogArgs({ error }));
+        return null;
+    }
+}
+/**
+ * Install agent using native platform installer
+ * Detects platform and executes appropriate installation script
+ *
+ * @param agentName - Agent name for logging (e.g., 'claude')
+ * @param installerUrls - Platform-specific installer URLs
+ * @param version - Version to install (e.g., '2.0.30', 'latest', 'stable', or undefined)
+ * @param options - Installation options (timeout, env, etc.)
+ * @returns Installation result with success status and installed version
+ * @throws {AgentInstallationError} If installation fails
+ *
+ * @example
+ * await installNativeAgent('claude', {
+ *   macOS: 'https://claude.ai/install.sh',
+ *   windows: 'https://claude.ai/install.ps1',
+ *   linux: 'https://claude.ai/install.sh'
+ * }, '2.0.30');
+ */
+export async function installNativeAgent(agentName, installerUrls, version, options) {
+    const platform = detectPlatform();
+    const timeout = options?.timeout || 120000; // 2 minute default timeout
+    logger.debug('Starting native agent installation', {
+        agentName,
+        platform,
+        version: version || 'latest',
+    });
+    try {
+        // Build installer command
+        const command = buildInstallerCommand(agentName, installerUrls, version, platform, options?.installFlags);
+        logger.debug('Executing installer command', {
+            agentName,
+            platform,
+            // Don't log full command (may contain sensitive URLs)
+        });
+        // Execute installer
+        const result = await exec(command, [], {
+            timeout,
+            env: options?.env,
+            shell: true, // Required for piped commands (curl | bash)
+        });
+        // Check if installation succeeded
+        if (result.code !== 0) {
+            // SECURITY: Sanitize output before including in error message
+            // Installer scripts might echo sensitive environment variables
+            const sanitizedOutput = sanitizeValue(result.stderr || result.stdout);
+            throw new AgentInstallationError(agentName, `Installer exited with code ${result.code}. Output: ${sanitizedOutput}`);
+        }
+        logger.debug('Installer completed successfully', {
+            agentName,
+            platform,
+        });
+        // Verify installation if verify command provided
+        let installedVersion = null;
+        if (options?.verifyCommand) {
+            logger.debug('Verifying installation', {
+                agentName,
+                verifyCommand: options.verifyCommand,
+            });
+            installedVersion = await verifyInstallation(options.verifyCommand);
+            if (!installedVersion) {
+                logger.warn('Installation verification failed', {
+                    agentName,
+                    verifyCommand: options.verifyCommand,
+                });
+            }
+            else {
+                logger.debug('Installation verified', {
+                    agentName,
+                    installedVersion,
+                });
+            }
+        }
+        // SECURITY: Sanitize output before returning
+        // Prevents exposure of sensitive data in logs or UI
+        const sanitizedOutput = sanitizeValue(result.stdout || result.stderr || '');
+        return {
+            success: true,
+            installedVersion,
+            output: sanitizedOutput,
+        };
+    }
+    catch (error) {
+        // If it's already an AgentInstallationError, rethrow
+        if (error instanceof AgentInstallationError) {
+            throw error;
+        }
+        // Wrap other errors
+        throw new AgentInstallationError(agentName, `Failed to install: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=native-installer.js.map

package/dist/utils/native-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-installer.js","sourceRoot":"","sources":["../../src/utils/native-installer.ts"],"names":[],"mappings":"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"}

package/dist/utils/version-utils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Version comparison utilities for semantic versioning
+ * Used for Claude Code version management
+ */
+/**
+ * Semantic version components
+ */
+export interface SemanticVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    raw: string;
+}
+/**
+ * Parse semantic version string into comparable components
+ *
+ * @param version - Version string (e.g., '2.0.30')
+ * @returns Version components { major, minor, patch, raw }
+ * @throws {Error} If version string is invalid
+ *
+ * @example
+ * parseSemanticVersion('2.0.30') // Returns { major: 2, minor: 0, patch: 30, raw: '2.0.30' }
+ */
+export declare function parseSemanticVersion(version: string): SemanticVersion;
+/**
+ * Check if version string is valid semantic version
+ *
+ * @param version - Version string to validate
+ * @returns true if valid semantic version
+ *
+ * @example
+ * isValidSemanticVersion('2.0.30') // true
+ * isValidSemanticVersion('v2.0.30') // true
+ * isValidSemanticVersion('invalid') // false
+ */
+export declare function isValidSemanticVersion(version: string): boolean;
+/**
+ * Compare two semantic versions
+ *
+ * @param version1 - First version string (e.g., '2.0.30')
+ * @param version2 - Second version string (e.g., '2.0.45')
+ * @returns -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ *
+ * @example
+ * compareVersions('2.0.30', '2.0.45') // Returns -1
+ * compareVersions('2.0.45', '2.0.30') // Returns 1
+ * compareVersions('2.0.30', '2.0.30') // Returns 0
+ */
+export declare function compareVersions(version1: string, version2: string): number;
+//# sourceMappingURL=version-utils.d.ts.map

package/dist/utils/version-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../src/utils/version-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAmBrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoC1E"}

package/dist/utils/version-utils.js

@@ -0,0 +1,92 @@
+/**
+ * Version comparison utilities for semantic versioning
+ * Used for Claude Code version management
+ */
+/**
+ * Parse semantic version string into comparable components
+ *
+ * @param version - Version string (e.g., '2.0.30')
+ * @returns Version components { major, minor, patch, raw }
+ * @throws {Error} If version string is invalid
+ *
+ * @example
+ * parseSemanticVersion('2.0.30') // Returns { major: 2, minor: 0, patch: 30, raw: '2.0.30' }
+ */
+export function parseSemanticVersion(version) {
+    // Remove 'v' prefix if present
+    const cleanVersion = version.trim().replace(/^v/, '');
+    // Match semantic version pattern: major.minor.patch
+    const match = cleanVersion.match(/^(\d+)\.(\d+)\.(\d+)$/);
+    if (!match) {
+        throw new Error(`Invalid semantic version format: "${version}". Expected format: major.minor.patch (e.g., "2.0.30")`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
+        raw: version,
+    };
+}
+/**
+ * Check if version string is valid semantic version
+ *
+ * @param version - Version string to validate
+ * @returns true if valid semantic version
+ *
+ * @example
+ * isValidSemanticVersion('2.0.30') // true
+ * isValidSemanticVersion('v2.0.30') // true
+ * isValidSemanticVersion('invalid') // false
+ */
+export function isValidSemanticVersion(version) {
+    try {
+        parseSemanticVersion(version);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Compare two semantic versions
+ *
+ * @param version1 - First version string (e.g., '2.0.30')
+ * @param version2 - Second version string (e.g., '2.0.45')
+ * @returns -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ *
+ * @example
+ * compareVersions('2.0.30', '2.0.45') // Returns -1
+ * compareVersions('2.0.45', '2.0.30') // Returns 1
+ * compareVersions('2.0.30', '2.0.30') // Returns 0
+ */
+export function compareVersions(version1, version2) {
+    // Handle special channel names (treat as highest version)
+    const isSpecialChannel = (v) => ['latest', 'stable'].includes(v.toLowerCase());
+    if (isSpecialChannel(version1) && isSpecialChannel(version2)) {
+        return 0; // Both special channels, consider equal
+    }
+    if (isSpecialChannel(version1)) {
+        return 1; // v1 is latest/stable, higher than any specific version
+    }
+    if (isSpecialChannel(version2)) {
+        return -1; // v2 is latest/stable, higher than v1
+    }
+    // Parse both versions
+    const v1 = parseSemanticVersion(version1);
+    const v2 = parseSemanticVersion(version2);
+    // Compare major version
+    if (v1.major !== v2.major) {
+        return v1.major < v2.major ? -1 : 1;
+    }
+    // Compare minor version
+    if (v1.minor !== v2.minor) {
+        return v1.minor < v2.minor ? -1 : 1;
+    }
+    // Compare patch version
+    if (v1.patch !== v2.patch) {
+        return v1.patch < v2.patch ? -1 : 1;
+    }
+    // Versions are equal
+    return 0;
+}
+//# sourceMappingURL=version-utils.js.map

package/dist/utils/version-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-utils.js","sourceRoot":"","sources":["../../src/utils/version-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IACnD,+BAA+B;IAC/B,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEtD,oDAAoD;IACpD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAE1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACd,qCAAqC,OAAO,wDAAwD,CACpG,CAAC;IACH,CAAC;IAED,OAAO;QACN,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,GAAG,EAAE,OAAO;KACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACrD,IAAI,CAAC;QACJ,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB;IACjE,0DAA0D;IAC1D,MAAM,gBAAgB,GAAG,CAAC,CAAS,EAAW,EAAE,CAC/C,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAEhD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,CAAC,CAAC,wCAAwC;IACnD,CAAC;IACD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,CAAC,CAAC,wDAAwD;IACnE,CAAC;IACD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,CAAC,CAAC,CAAC,sCAAsC;IAClD,CAAC;IAED,sBAAsB;IACtB,MAAM,EAAE,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAE1C,wBAAwB;IACxB,IAAI,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,wBAAwB;IACxB,IAAI,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,wBAAwB;IACxB,IAAI,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,qBAAqB;IACrB,OAAO,CAAC,CAAC;AACV,CAAC"}