@codemieai/code 0.0.37 → 0.0.40

package/dist/agents/plugins/claude/sounds-installer.js

@@ -0,0 +1,164 @@
+/**
+ * Sounds Installer
+ *
+ * Automated installation of the sound hooks system for Claude Code.
+ * Creates hook directories, installs play-random-sound.sh script, and configures hooks.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { exec } from '../../../utils/exec.js';
+import { getCodemiePath } from '../../../utils/paths.js';
+import { existsSync } from 'fs';
+import { mkdir } from 'fs/promises';
+import { join } from 'path';
+import { logger } from '../../../utils/logger.js';
+import { createErrorContext } from '../../../utils/errors.js';
+/**
+ * Check if required audio player is available
+ * @returns Audio player command name if found, null otherwise
+ */
+async function checkAudioPlayer() {
+    const players = ['afplay', 'aplay', 'paplay', 'mpg123'];
+    for (const player of players) {
+        try {
+            await exec('command', ['-v', player]);
+            logger.debug('Audio player found', { player, feature: 'sounds' });
+            return player;
+        }
+        catch (error) {
+            // Log the specific error for debugging
+            logger.debug('Audio player not available', {
+                player,
+                feature: 'sounds',
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    logger.debug('No audio players found', {
+        checkedPlayers: players,
+        feature: 'sounds',
+        note: 'User needs to install an audio player for sounds to work'
+    });
+    return null;
+}
+/**
+ * Create hook directories for sound files
+ */
+async function createSoundDirectories() {
+    const soundsDir = getCodemiePath('sounds');
+    const directories = ['SessionStart', 'UserPromptSubmit', 'PermissionRequest', 'Stop'];
+    // Create directories in parallel for better performance
+    await Promise.all(directories.map(dir => mkdir(join(soundsDir, dir), { recursive: true })));
+}
+/**
+ * Display post-installation instructions
+ *
+ * NOTE: This function violates typical utils layer pattern by handling UI directly.
+ * This is an intentional exception because:
+ * 1. The instructions are tightly coupled to the installation implementation details
+ * 2. The installation function is only called from CLI contexts (setup command)
+ * 3. Extracting to CLI layer would require passing extensive path information
+ *
+ * Future refactor: Consider returning an InstallationResult data structure
+ * and moving display logic to CLI layer if this utility needs reuse in non-CLI contexts.
+ */
+function displayPostInstallInstructions() {
+    const soundsDir = getCodemiePath('sounds');
+    console.log();
+    console.log(chalk.bold.green('🎉 Sounds installed successfully!'));
+    console.log();
+    console.log(chalk.cyan('📂 Next Steps:'));
+    console.log();
+    console.log(chalk.white('1. Download your favorite sound effects (WAV or MP3 format)'));
+    console.log(chalk.white('2. Add them to these directories:'));
+    console.log(chalk.dim(`   ${join(soundsDir, 'SessionStart')}/`), chalk.white('(plays when starting)'));
+    console.log(chalk.dim(`   ${join(soundsDir, 'UserPromptSubmit')}/`), chalk.white('(plays when you send a message)'));
+    console.log(chalk.dim(`   ${join(soundsDir, 'PermissionRequest')}/`), chalk.white('(plays when you claude asks for clarification or permission)'));
+    console.log(chalk.dim(`   ${join(soundsDir, 'Stop')}/`), chalk.white('(plays when Claude completes)'));
+    console.log();
+    console.log(chalk.white('💡 Suggestions:'));
+    console.log(chalk.dim('   • SessionStart:'), chalk.white('Welcome sounds, greetings'));
+    console.log(chalk.dim('   • UserPromptSubmit:'), chalk.white('Acknowledgment sounds (e.g., "Roger")'));
+    console.log(chalk.dim('   • PermissionRequest:'), chalk.white('Question sounds (e.g., "Proceed?")'));
+    console.log(chalk.dim('   • Stop:'), chalk.white('Completion sounds (e.g., "Done")'));
+    console.log();
+    console.log(chalk.white('🎮 Example sound packs:'));
+    console.log(chalk.dim('   • Warcraft peon sounds (classic "Work work", "Yes milord")'));
+    console.log(chalk.dim('   • StarCraft unit acknowledgments'));
+    console.log(chalk.dim('   • Portal 2 GLaDOS quotes'));
+    console.log();
+    console.log(chalk.white('💾 Where to download sounds:'));
+    console.log(chalk.blueBright('   https://x.com/delba_oliveira/status/2020515010985005255'));
+    console.log();
+    console.log(chalk.dim(`⚙️  Hooks configuration saved in: ${getCodemiePath('claude-plugin/hooks/hooks.json')}`));
+    console.log(chalk.dim(`📜 Script location: ${join(soundsDir, 'play-random-sound.sh')}`));
+    console.log(chalk.dim('   Script would appear after codemie-claude first run'));
+    console.log(chalk.white('💡 If script did not appear, remove ~/.codemie/claude-plugin directory and restart codemie-claude'));
+    console.log();
+    console.log(chalk.bold.yellow('⚠️  WINDOWS USERS:'));
+    console.log(chalk.yellow('   After codemie-claude first run, edit ~/.codemie/claude-plugin/hooks/hooks.json'));
+    console.log(chalk.yellow('   Change all instances of "play-random-sound.sh" to "play-random-sound.ps1"'));
+    console.log();
+}
+/**
+ * Install fun sounds system
+ * Creates directories, installs script, and saves hooks configuration to ~/.claude/settings.json
+ *
+ * @returns Hooks configuration object if successful, null if installation failed
+ */
+export async function installSounds() {
+    try {
+        // 1. Pre-flight: Check audio player
+        const spinner = ora('Checking audio player...').start();
+        const audioPlayer = await checkAudioPlayer();
+        if (!audioPlayer) {
+            spinner.fail(chalk.red('No audio player found'));
+            logger.warn('Sounds installation skipped - no audio player available', {
+                operation: 'installSounds',
+                feature: 'sounds',
+                checkedPlayers: ['afplay', 'aplay', 'paplay', 'mpg123']
+            });
+            console.log();
+            console.log(chalk.yellow('⚠️  Sounds require an audio player to work.'));
+            console.log(chalk.white('Checked for: afplay, aplay, paplay, mpg123'));
+            console.log();
+            console.log(chalk.white('Install instructions:'));
+            console.log(chalk.white('  macOS:'), chalk.dim('afplay (built-in)'));
+            console.log(chalk.white('  Linux:'), chalk.dim('sudo apt install alsa-utils (aplay)'));
+            console.log(chalk.white('         '), chalk.dim('or sudo apt install pulseaudio-utils (paplay)'));
+            console.log(chalk.white('  Windows:'), chalk.dim('Install mpg123 via Chocolatey: choco install mpg123'));
+            console.log(chalk.white('  Alternative:'), chalk.dim('brew install mpg123 (macOS), sudo apt install mpg123 (Linux)'));
+            console.log();
+            return null;
+        }
+        spinner.succeed(chalk.green(`Audio player found: ${audioPlayer}`));
+        // 2. Create hook directories
+        const dirSpinner = ora('Creating sound directories...').start();
+        await createSoundDirectories();
+        dirSpinner.succeed(chalk.green('Sound directories created'));
+        // 3. Display post-install instructions
+        displayPostInstallInstructions();
+        return "success";
+    }
+    catch (error) {
+        const errorContext = createErrorContext(error);
+        logger.error('Sounds installation failed', {
+            ...errorContext,
+            operation: 'installSounds'
+        });
+        console.log();
+        console.log(chalk.red('❌ Sounds installation failed'));
+        console.log(chalk.yellow('You can try again later by running: codemie install claude --sounds'));
+        console.log();
+        return null;
+    }
+}
+/**
+ * Check if sounds are already installed
+ * @returns true if exist sounds directory
+ */
+export function isSoundsInstalled() {
+    const soundsDir = getCodemiePath('sounds');
+    return existsSync(soundsDir);
+}
+//# sourceMappingURL=sounds-installer.js.map

package/dist/agents/plugins/claude/sounds-installer.js.map

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

package/dist/cli/commands/hook.d.ts

@@ -1,4 +1,76 @@
 import { Command } from 'commander';
+import type { BaseHookEvent } from '../../agents/core/types.js';
+/**
+ * Hook event handlers for agent lifecycle events
+ * Called by agent plugin hooks via stdin JSON
+ *
+ * This is a unified hook handler that routes based on hook_event_name
+ * from the JSON payload. All agent hooks send their event type.
+ */
+/**
+ * SessionStart event
+ */
+export interface SessionStartEvent extends BaseHookEvent {
+    hook_event_name: 'SessionStart';
+    source: string;
+}
+/**
+ * SessionEnd event
+ */
+export interface SessionEndEvent extends BaseHookEvent {
+    hook_event_name: 'SessionEnd';
+    reason: string;
+    cwd: string;
+}
+/**
+ * SubagentStop event
+ */
+export interface SubagentStopEvent extends BaseHookEvent {
+    hook_event_name: 'SubagentStop';
+    agent_id: string;
+    agent_transcript_path: string;
+    stop_hook_active: boolean;
+    cwd: string;
+}
+/**
+ * Configuration for hook event processing
+ * Used for programmatic API usage (when not using environment variables)
+ */
+export interface HookProcessingConfig {
+    /** Agent name (e.g., 'claude', 'gemini') */
+    agentName: string;
+    /** CodeMie session ID */
+    sessionId: string;
+    /** Provider name (e.g., 'ai-run-sso') */
+    provider?: string;
+    /** API base URL */
+    apiBaseUrl?: string;
+    /** SSO cookies for authentication */
+    cookies?: string;
+    /** API key for localhost development */
+    apiKey?: string;
+    /** Client type identifier (e.g., 'vscode-codemie', 'codemie-cli') */
+    clientType?: string;
+    /** Client version */
+    version?: string;
+    /** Profile name for logging */
+    profileName?: string;
+    /** Project name */
+    project?: string;
+    /** Model name */
+    model?: string;
+    /** SSO URL for credential loading */
+    ssoUrl?: string;
+}
+/**
+ * Process a hook event programmatically
+ * Main entry point for programmatic API usage (e.g., VSCode plugin)
+ *
+ * @param event - Hook event to process
+ * @param config - Optional configuration object (if not provided, reads from environment variables)
+ * @throws Error if event processing fails and config is provided
+ */
+export declare function processEvent(event: BaseHookEvent, config?: HookProcessingConfig): Promise<void>;
 /**
  * Create unified hook command
  * Routes to appropriate handler based on hook_event_name in JSON payload

package/dist/cli/commands/hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA45BpC;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAqH3C"}
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,aAAa,EAAqC,MAAM,4BAA4B,CAAC;AAGnG;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,eAAe,EAAE,cAAc,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,eAAe,EAAE,YAAY,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,eAAe,EAAE,cAAc,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+iCD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA8F3C"}