@codemieai/code 0.0.33 → 0.0.34

package/dist/skills/utils/frontmatter.js

@@ -0,0 +1,114 @@
+import { parse as parseYaml } from 'yaml';
+/**
+ * Error thrown when frontmatter parsing fails
+ */
+export class FrontmatterParseError extends Error {
+    filePath;
+    cause;
+    constructor(message, filePath, cause) {
+        super(message);
+        this.filePath = filePath;
+        this.cause = cause;
+        this.name = 'FrontmatterParseError';
+    }
+}
+/**
+ * Parse YAML frontmatter from a markdown file
+ *
+ * Expected format:
+ * ```
+ * ---
+ * key: value
+ * ---
+ * Content here
+ * ```
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed frontmatter metadata and markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export function parseFrontmatter(fileContent, filePath) {
+    // Trim leading/trailing whitespace
+    const trimmed = fileContent.trim();
+    // Check if file starts with frontmatter delimiter
+    if (!trimmed.startsWith('---')) {
+        throw new FrontmatterParseError('File must start with frontmatter delimiter (---)', filePath);
+    }
+    // Find the closing delimiter
+    const lines = trimmed.split('\n');
+    let closingDelimiterIndex = -1;
+    // Start from line 1 (skip opening ---)
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            closingDelimiterIndex = i;
+            break;
+        }
+    }
+    if (closingDelimiterIndex === -1) {
+        throw new FrontmatterParseError('Missing closing frontmatter delimiter (---)', filePath);
+    }
+    // Extract YAML content (between delimiters)
+    const yamlLines = lines.slice(1, closingDelimiterIndex);
+    const yamlContent = yamlLines.join('\n');
+    // Extract markdown content (after closing delimiter)
+    const contentLines = lines.slice(closingDelimiterIndex + 1);
+    const content = contentLines.join('\n').trim();
+    // Parse YAML
+    let metadata;
+    try {
+        const parsed = parseYaml(yamlContent);
+        // Ensure we got an object
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error('Frontmatter must be a YAML object (key-value pairs)');
+        }
+        metadata = parsed;
+    }
+    catch (error) {
+        throw new FrontmatterParseError(`Failed to parse YAML frontmatter: ${error instanceof Error ? error.message : String(error)}`, filePath, error);
+    }
+    return {
+        metadata,
+        content,
+    };
+}
+/**
+ * Check if a file has valid frontmatter format (non-throwing)
+ *
+ * @param fileContent - Raw file content
+ * @returns true if file has valid frontmatter structure
+ */
+export function hasFrontmatter(fileContent) {
+    try {
+        parseFrontmatter(fileContent);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extract just the metadata without validating content
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed metadata
+ * @throws FrontmatterParseError if parsing fails
+ */
+export function extractMetadata(fileContent, filePath) {
+    const result = parseFrontmatter(fileContent, filePath);
+    return result.metadata;
+}
+/**
+ * Extract just the content without validating metadata
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export function extractContent(fileContent, filePath) {
+    const result = parseFrontmatter(fileContent, filePath);
+    return result.content;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/skills/utils/frontmatter.js.map

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

package/dist/skills/utils/pattern-matcher.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pattern matcher for skill invocation detection
+ *
+ * Detects /skill-name patterns in user messages and extracts skill names.
+ * Excludes URLs and built-in CLI commands.
+ */
+/**
+ * Skill pattern detected in a message
+ */
+export interface SkillPattern {
+    /** Skill name (e.g., 'mr', 'commit') */
+    name: string;
+    /** Position in message where pattern starts */
+    position: number;
+    /** Optional arguments after skill name */
+    args?: string;
+    /** Full matched pattern (e.g., '/mr', '/commit -m "fix"') */
+    raw: string;
+}
+/**
+ * Result of pattern matching
+ */
+export interface PatternMatchResult {
+    /** Detected skill patterns */
+    patterns: SkillPattern[];
+    /** Original message */
+    originalMessage: string;
+    /** Whether any patterns were found */
+    hasPatterns: boolean;
+}
+/**
+ * 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 declare function extractSkillPatterns(message: string): PatternMatchResult;
+/**
+ * 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 declare function isValidSkillName(name: string): boolean;
+//# sourceMappingURL=pattern-matcher.d.ts.map

package/dist/skills/utils/pattern-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-matcher.d.ts","sourceRoot":"","sources":["../../../src/skills/utils/pattern-matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;CACtB;AAyBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA8CxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

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/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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"}