@kernel.chat/kbot 2.9.1 → 2.10.1

package/dist/voice.js

@@ -0,0 +1,336 @@
+import { execSync, spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, unlinkSync } from 'node:fs';
+import chalk from 'chalk';
+// ---------------------------------------------------------------------------
+// Platform detection helpers
+// ---------------------------------------------------------------------------
+const platform = process.platform;
+function commandExists(cmd) {
+    try {
+        execSync(`which ${cmd}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function detectTTSEngine() {
+    if (platform === 'darwin')
+        return 'say';
+    if (commandExists('espeak'))
+        return 'espeak';
+    if (commandExists('festival'))
+        return 'festival';
+    return null;
+}
+function detectSTT() {
+    return commandExists('whisper') || commandExists('whisper.cpp');
+}
+function detectRecorder() {
+    if (commandExists('rec'))
+        return 'rec';
+    if (commandExists('arecord'))
+        return 'arecord';
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Text sanitization
+// ---------------------------------------------------------------------------
+/** Strip markdown formatting so TTS reads clean prose. */
+function stripMarkdown(text) {
+    let cleaned = text;
+    // Replace code blocks with a spoken description of the language
+    cleaned = cleaned.replace(/```(\w+)?\n[\s\S]*?```/g, (_match, lang) => {
+        return lang
+            ? `Here's a ${lang} snippet.`
+            : 'Here\'s a code snippet.';
+    });
+    // Remove inline code
+    cleaned = cleaned.replace(/`([^`]+)`/g, '$1');
+    // Remove headings markers
+    cleaned = cleaned.replace(/^#{1,6}\s+/gm, '');
+    // Remove bold / italic markers
+    cleaned = cleaned.replace(/\*{1,3}([^*]+)\*{1,3}/g, '$1');
+    cleaned = cleaned.replace(/_{1,3}([^_]+)_{1,3}/g, '$1');
+    // Remove strikethrough
+    cleaned = cleaned.replace(/~~([^~]+)~~/g, '$1');
+    // Remove links — keep the label
+    cleaned = cleaned.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1');
+    // Remove images
+    cleaned = cleaned.replace(/!\[([^\]]*)\]\([^)]+\)/g, '$1');
+    // Remove blockquote markers
+    cleaned = cleaned.replace(/^>\s+/gm, '');
+    // Remove horizontal rules
+    cleaned = cleaned.replace(/^[-*_]{3,}\s*$/gm, '');
+    // Remove list markers (unordered)
+    cleaned = cleaned.replace(/^[\s]*[-*+]\s+/gm, '');
+    // Remove list markers (ordered)
+    cleaned = cleaned.replace(/^[\s]*\d+\.\s+/gm, '');
+    // Collapse multiple newlines
+    cleaned = cleaned.replace(/\n{3,}/g, '\n\n');
+    return cleaned.trim();
+}
+/** Sanitize text for safe shell usage — strip characters that could be interpreted. */
+function sanitizeForShell(text) {
+    // Remove characters that are dangerous in shell context
+    return text.replace(/[;&|`$(){}[\]!#\\]/g, '');
+}
+// ---------------------------------------------------------------------------
+// 1. initVoice
+// ---------------------------------------------------------------------------
+export function initVoice(options) {
+    const ttsEngine = detectTTSEngine();
+    const sttAvailable = options?.stt ? detectSTT() : false;
+    const enabled = options?.tts !== false && ttsEngine !== null;
+    if (!ttsEngine) {
+        console.warn(chalk.yellow('⚠ No TTS engine found. ') +
+            (platform === 'darwin'
+                ? 'Expected "say" — this should be available on macOS.'
+                : 'Install espeak or festival for TTS support.'));
+    }
+    if (options?.stt && !sttAvailable) {
+        console.warn(chalk.yellow('⚠ STT requested but whisper not found. ') +
+            'Install whisper.cpp or openai-whisper for speech-to-text.');
+    }
+    const defaultVoice = platform === 'darwin' ? 'Alex' : 'default';
+    return {
+        enabled,
+        sttAvailable,
+        voice: options?.voice ?? defaultVoice,
+        rate: options?.rate ?? 200,
+    };
+}
+// ---------------------------------------------------------------------------
+// 2. speak
+// ---------------------------------------------------------------------------
+export async function speak(text, state) {
+    if (!state.enabled)
+        return;
+    // Kill any in-progress speech first
+    stopSpeaking(state);
+    const cleaned = sanitizeForShell(stripMarkdown(text));
+    if (!cleaned)
+        return;
+    const ttsEngine = detectTTSEngine();
+    if (!ttsEngine)
+        return;
+    return new Promise((resolve) => {
+        let proc;
+        switch (ttsEngine) {
+            case 'say':
+                proc = spawn('say', ['-v', state.voice, '-r', String(state.rate), cleaned], {
+                    stdio: 'ignore',
+                });
+                break;
+            case 'espeak':
+                proc = spawn('espeak', [cleaned], {
+                    stdio: 'ignore',
+                });
+                break;
+            case 'festival': {
+                proc = spawn('festival', ['--tts'], {
+                    stdio: ['pipe', 'ignore', 'ignore'],
+                });
+                proc.stdin?.write(cleaned);
+                proc.stdin?.end();
+                break;
+            }
+            default:
+                resolve();
+                return;
+        }
+        state.ttsProcess = proc;
+        proc.on('close', () => {
+            if (state.ttsProcess === proc) {
+                state.ttsProcess = undefined;
+            }
+            resolve();
+        });
+        proc.on('error', () => {
+            if (state.ttsProcess === proc) {
+                state.ttsProcess = undefined;
+            }
+            resolve();
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// 3. stopSpeaking
+// ---------------------------------------------------------------------------
+export function stopSpeaking(state) {
+    if (state.ttsProcess) {
+        state.ttsProcess.kill('SIGTERM');
+        state.ttsProcess = undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// 4. listen
+// ---------------------------------------------------------------------------
+export async function listen(state) {
+    if (!state.sttAvailable) {
+        // Fall back to readline text input
+        return readlineInput();
+    }
+    const recorder = detectRecorder();
+    if (!recorder) {
+        console.warn(chalk.yellow('⚠ No audio recorder found (rec or arecord). Falling back to text input.'));
+        return readlineInput();
+    }
+    const tempFile = join(tmpdir(), `kbot-voice-${Date.now()}.wav`);
+    try {
+        // Record audio (up to 10 seconds)
+        console.log(chalk.cyan('🎙  Listening... (up to 10s, press Ctrl+C to stop)'));
+        await new Promise((resolve, reject) => {
+            let proc;
+            if (recorder === 'rec') {
+                // sox rec: record 16kHz mono WAV, max 10 seconds
+                proc = spawn('rec', [
+                    tempFile,
+                    'rate', '16k',
+                    'channels', '1',
+                    'trim', '0', '10',
+                ], {
+                    stdio: ['ignore', 'ignore', 'ignore'],
+                });
+            }
+            else {
+                // arecord: record 16kHz mono WAV, max 10 seconds
+                proc = spawn('arecord', [
+                    '-f', 'S16_LE',
+                    '-r', '16000',
+                    '-c', '1',
+                    '-d', '10',
+                    tempFile,
+                ], {
+                    stdio: ['ignore', 'ignore', 'ignore'],
+                });
+            }
+            proc.on('close', (code) => {
+                if (code === 0 || code === null) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Recording failed with exit code ${code}`));
+                }
+            });
+            proc.on('error', (err) => reject(err));
+        });
+        if (!existsSync(tempFile)) {
+            console.warn(chalk.yellow('⚠ Recording failed — no audio file produced.'));
+            return readlineInput();
+        }
+        // Transcribe with whisper
+        console.log(chalk.dim('Transcribing...'));
+        const whisperCmd = commandExists('whisper') ? 'whisper' : 'whisper.cpp';
+        const transcription = execSync(`${whisperCmd} "${tempFile}" --model base --output_format txt --language en 2>/dev/null`, { encoding: 'utf-8', timeout: 30_000 }).trim();
+        return transcription || await readlineInput();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn(chalk.yellow(`⚠ STT failed: ${message}. Falling back to text input.`));
+        return readlineInput();
+    }
+    finally {
+        // Clean up temp file
+        try {
+            if (existsSync(tempFile))
+                unlinkSync(tempFile);
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    }
+}
+/** Readline fallback for text input when STT is unavailable. */
+function readlineInput() {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(chalk.cyan('You: '), (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// 5. listVoices
+// ---------------------------------------------------------------------------
+export function listVoices() {
+    const ttsEngine = detectTTSEngine();
+    if (!ttsEngine)
+        return [];
+    try {
+        switch (ttsEngine) {
+            case 'say': {
+                // macOS: `say -v ?` outputs lines like "Alex  en_US  # Most people recognize me by my voice."
+                const output = execSync('say -v ?', { encoding: 'utf-8' });
+                return output
+                    .split('\n')
+                    .filter(Boolean)
+                    .map((line) => {
+                    const match = line.match(/^(\S+)/);
+                    return match ? match[1] : '';
+                })
+                    .filter(Boolean);
+            }
+            case 'espeak': {
+                const output = execSync('espeak --voices', { encoding: 'utf-8' });
+                return output
+                    .split('\n')
+                    .slice(1) // skip header
+                    .filter(Boolean)
+                    .map((line) => {
+                    const parts = line.trim().split(/\s+/);
+                    // voice name is typically the 4th column
+                    return parts[3] ?? '';
+                })
+                    .filter(Boolean);
+            }
+            case 'festival': {
+                try {
+                    const output = execSync('echo "(voice.list)" | festival --pipe 2>/dev/null', { encoding: 'utf-8' });
+                    const match = output.match(/\(([^)]+)\)/);
+                    if (match) {
+                        return match[1].split(/\s+/).filter(Boolean);
+                    }
+                }
+                catch {
+                    // festival voice listing can be finicky
+                }
+                return [];
+            }
+            default:
+                return [];
+        }
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// 6. formatVoiceStatus
+// ---------------------------------------------------------------------------
+export function formatVoiceStatus(state) {
+    const lines = [];
+    lines.push(chalk.bold('Voice Mode'));
+    lines.push('');
+    const ttsEngine = detectTTSEngine();
+    lines.push(`  TTS:      ${state.enabled
+        ? chalk.green('enabled') + chalk.dim(` (${ttsEngine ?? 'unknown'})`)
+        : chalk.red('disabled')}`);
+    lines.push(`  Voice:    ${chalk.cyan(state.voice)}`);
+    lines.push(`  Rate:     ${state.rate} wpm`);
+    lines.push(`  STT:      ${state.sttAvailable
+        ? chalk.green('available') + chalk.dim(' (whisper)')
+        : chalk.dim('not available')}`);
+    lines.push(`  Speaking: ${state.ttsProcess
+        ? chalk.yellow('in progress')
+        : chalk.dim('idle')}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=voice.js.map

package/dist/voice.js.map

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

package/dist/watch.d.ts

@@ -0,0 +1,37 @@
+export interface WatchOptions {
+    /** Directory to watch (default: cwd) */
+    path?: string;
+    /** File extensions to watch (default: common source extensions) */
+    extensions?: string[];
+    /** Whether to run analysis on changes (default: true) */
+    analyze?: boolean;
+    /** Callback for change events */
+    onChange?: (event: WatchEvent) => void;
+}
+export interface WatchEvent {
+    file: string;
+    type: 'change' | 'rename';
+    timestamp: Date;
+    analysis?: FileAnalysis;
+}
+export interface FileAnalysis {
+    todos: number;
+    debugStatements: number;
+    syntaxIssues: string[];
+    lineCount: number;
+}
+export declare function startWatch(path?: string, options?: WatchOptions): Promise<void>;
+export declare function stopWatch(): void;
+/**
+ * Get the recent change log (last 20 file changes).
+ */
+export declare function getChangeLog(): WatchEvent[];
+/**
+ * Clear the change log.
+ */
+export declare function clearChangeLog(): void;
+/**
+ * Check whether the watcher is currently active.
+ */
+export declare function isWatching(): boolean;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACvC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;IACzB,SAAS,EAAE,IAAI,CAAA;IACf,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAySD,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgGrF;AAED,wBAAgB,SAAS,IAAI,IAAI,CAahC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,UAAU,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}