sona-ai-voice 0.1.5

package/README.md

@@ -0,0 +1,164 @@
+# Sona
+
+A production-ready voice-to-voice CLI companion powered by OpenAI's Realtime API. Natural speech-to-speech interaction with codebase awareness and web search capabilities.
+
+## Features
+
+- **Real-time voice conversation** - Natural speech-to-speech interaction
+- **Codebase awareness** - Indexes your project and understands your code
+- **Web search** - Search the web for current information (no API key needed)
+- **Particle GUI** - Visual feedback (optional)
+- **Secure** - API keys stored locally with restricted permissions
+- **Barge-in support** - Interrupt Sona mid-sentence
+- **Echo cancellation** - Prevents feedback loops
+
+## Prerequisites
+
+- **Node.js** >= 18.0.0
+- **sox** (for audio capture/playback)
+  ```bash
+  # macOS
+  brew install sox
+  
+  # Ubuntu/Debian
+  sudo apt-get install sox
+  
+  # Windows
+  choco install sox
+  ```
+- **OpenAI API key** with Realtime API access
+
+## Installation
+
+### Quick Install
+
+```bash
+npm install -g sona-ai-voice
+```
+
+### Fix Permission Errors (macOS/Linux)
+
+If you see `EACCES: permission denied` errors, configure npm to use a user-owned directory:
+
+```bash
+# 1. Create a directory for global packages
+mkdir -p ~/.npm-global
+
+# 2. Configure npm to use this directory
+npm config set prefix '~/.npm-global'
+
+# 3. Add to your PATH (choose your shell):
+# For zsh (macOS default):
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
+source ~/.zshrc
+
+# For bash:
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
+
+# 4. Install Sona
+npm install -g sona-ai-voice
+
+# 5. Verify installation
+sona --help
+```
+
+**Alternative**: Use `sudo` (not recommended):
+```bash
+sudo npm install -g sona-ai-voice
+```
+
+## Setup
+
+First time setup - enter your OpenAI API key:
+
+```bash
+sona setup
+```
+
+Your API key will be stored securely in `~/.sona/config` with restricted file permissions.
+
+## Usage
+
+### Start a voice conversation
+
+```bash
+# Navigate to any project directory
+cd /path/to/your-project
+
+# Start Sona (indexes current directory)
+sona talk
+```
+
+### Options
+
+```bash
+sona talk              # Full experience with GUI
+sona talk --no-gui     # Terminal only (no particle window)
+sona talk --no-index   # Skip codebase indexing
+```
+
+### Other commands
+
+```bash
+sona setup    # Configure API key
+sona test     # Test API connection
+sona logout   # Remove stored API key
+sona --help   # Show all commands
+```
+
+## How It Works
+
+1. **Indexing**: When you run `sona talk`, it indexes the current directory's source files
+2. **Context**: Sona understands your codebase structure and can answer questions about it
+3. **Voice**: Uses OpenAI's Realtime API for natural voice conversation
+4. **Web Search**: Can search the web for information it doesn't know
+
+## Example Conversations
+
+- "What files are in this project?"
+- "Explain how the authentication works"
+- "What dependencies does this project use?"
+- "Search for the latest React 19 features"
+
+## Security
+
+- API keys are stored in `~/.sona/config` with `600` permissions (owner-only)
+- Keys are obfuscated (not plain text)
+- Never committed to git (`.env.local` is gitignored)
+- You can remove your key anytime with `sona logout`
+
+## Troubleshooting
+
+### "EACCES: permission denied" when installing
+This happens because npm tries to install to `/usr/local` which requires admin access. **Solution**: Configure npm to use a user-owned directory (see Installation section above).
+
+### "sox not found"
+Install sox: `brew install sox` (macOS) or `apt-get install sox` (Linux)
+
+### "API key required"
+Run `sona setup` to configure your OpenAI API key
+
+### "sona: command not found"
+Make sure `~/.npm-global/bin` (or your npm global bin path) is in your PATH. Check with:
+```bash
+npm config get prefix
+which sona
+```
+
+### Sona not responding
+- Check your microphone is working
+- Speak clearly and close to the mic
+- Try `sona test` to verify API connection
+
+## Development
+
+For development, see the [GitHub repository](https://github.com/zerish/Blue).
+
+## License
+
+MIT
+
+## Author
+
+zerish

package/bin/blue

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+/**
+ * Sona CLI - Global Entry Point
+ * This file allows Sona to be run from anywhere
+ */
+
+const path = require('path');
+const { spawn } = require('child_process');
+
+// Get the directory where Sona is installed
+const sonaRoot = path.resolve(__dirname, '..');
+const cliPath = path.join(sonaRoot, 'packages', 'cli', 'dist', 'index.js');
+
+// Run the CLI with all arguments passed through
+const child = spawn('node', [cliPath, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  cwd: process.cwd(), // Use current working directory for indexing
+  env: {
+    ...process.env,
+    SONA_ROOT: sonaRoot,
+  },
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/bin/sona

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+/**
+ * Sona CLI - Global Entry Point
+ * This file allows Sona to be run from anywhere
+ */
+
+const path = require('path');
+const { spawn } = require('child_process');
+
+// Get the directory where Sona is installed
+const sonaRoot = path.resolve(__dirname, '..');
+const cliPath = path.join(sonaRoot, 'packages', 'cli', 'dist', 'index.js');
+
+// Run the CLI with all arguments passed through
+const child = spawn('node', [cliPath, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  cwd: process.cwd(), // Use current working directory for indexing
+  env: {
+    ...process.env,
+    SONA_ROOT: sonaRoot,
+  },
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "sona-ai-voice",
+  "version": "0.1.5",
+  "description": "Voice-to-voice AI CLI companion powered by OpenAI Realtime API",
+  "author": "zerish",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zerish/Blue.git"
+  },
+  "keywords": [
+    "ai",
+    "voice",
+    "openai",
+    "realtime",
+    "cli",
+    "speech-to-speech",
+    "conversational-ai"
+  ],
+  "bin": {
+    "sona": "packages/cli/dist/index.js"
+  },
+  "files": [
+    "packages/*/dist/**/*",
+    "packages/*/package.json",
+    "packages/cli/src/gui/**/*",
+    "bin/**/*"
+  ],
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "build": "bash scripts/build-for-publish.sh",
+    "build:all": "npm run build --workspaces --if-present",
+    "dev": "npm run dev --workspace=packages/cli",
+    "clean": "rm -rf packages/*/dist packages/*/*.tsbuildinfo node_modules/.cache",
+    "test": "npm run test --workspaces --if-present",
+    "lint": "eslint packages --ext .ts,.tsx",
+    "format": "prettier --write \"packages/**/*.{ts,tsx,json,md}\"",
+    "cache:clear": "rm -rf node_modules/.cache .sona-cache",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "dotenv": "^16.0.0",
+    "ws": "^8.19.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "eslint": "^8.54.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-airbnb-typescript": "^17.1.0",
+    "eslint-plugin-import": "^2.29.0",
+    "prettier": "^3.1.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  }
+}

package/packages/audio/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@blue/audio",
+  "version": "0.1.0",
+  "description": "Audio capture, playback, VAD, and endpointing for Blue",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.3.2",
+    "@types/node": "^20.10.0"
+  }
+}

package/packages/cache/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@blue/cache",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Multi-layer caching system for API optimization",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "jest"
+  },
+  "dependencies": {
+    "lru-cache": "^10.1.0",
+    "xxhash-wasm": "^1.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}

package/packages/cli/dist/audio-capture.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Audio Capture Module
+ * Mic capture with pause/resume for echo cancellation
+ */
+import { EventEmitter } from 'events';
+export interface AudioCaptureConfig {
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly bitDepth: number;
+}
+export interface AudioCaptureEvents {
+    'data': (audioBuffer: Buffer) => void;
+    'error': (error: Error) => void;
+    'started': () => void;
+    'stopped': () => void;
+}
+export declare class AudioCapture extends EventEmitter {
+    private micProcess;
+    private isRecording;
+    private isPaused;
+    private config;
+    constructor(config: AudioCaptureConfig);
+    start(): void;
+    private spawnMic;
+    /**
+     * Pause audio capture (for echo cancellation during playback)
+     * Kills the mic process to ensure no audio leaks through
+     */
+    pause(): void;
+    /**
+     * Resume audio capture after playback ends
+     */
+    resume(): void;
+    stop(): void;
+    get recording(): boolean;
+    get paused(): boolean;
+    on<K extends keyof AudioCaptureEvents>(event: K, listener: AudioCaptureEvents[K]): this;
+    emit<K extends keyof AudioCaptureEvents>(event: K, ...args: Parameters<AudioCaptureEvents[K]>): boolean;
+}
+//# sourceMappingURL=audio-capture.d.ts.map

package/packages/cli/dist/audio-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-capture.d.ts","sourceRoot":"","sources":["../src/audio-capture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAKtC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,QAAQ;IAgDhB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd,IAAI,IAAI,IAAI;IAYZ,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAEQ,EAAE,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAC5C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,IAAI;IAIE,IAAI,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAC9C,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACzC,OAAO;CAGX"}

package/packages/cli/dist/audio-capture.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Audio Capture Module
+ * Mic capture with pause/resume for echo cancellation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudioCapture = void 0;
+const child_process_1 = require("child_process");
+const events_1 = require("events");
+class AudioCapture extends events_1.EventEmitter {
+    micProcess = null;
+    isRecording = false;
+    isPaused = false;
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    start() {
+        if (this.isRecording)
+            return;
+        this.spawnMic();
+    }
+    spawnMic() {
+        if (this.micProcess) {
+            try {
+                this.micProcess.kill('SIGKILL');
+            }
+            catch { }
+            this.micProcess = null;
+        }
+        this.micProcess = (0, child_process_1.spawn)('sox', [
+            '-d', // Default audio device
+            '-t', 'raw', // Raw PCM output
+            '-b', '16', // 16-bit
+            '-e', 'signed-integer', // Signed integer
+            '-r', '24000', // 24kHz (required by OpenAI)
+            '-c', '1', // Mono
+            '-q', // Quiet mode
+            '-', // Output to stdout
+        ]);
+        if (!this.micProcess.stdout) {
+            this.emit('error', new Error('Failed to start microphone'));
+            return;
+        }
+        this.micProcess.stdout.on('data', (chunk) => {
+            if (!this.isPaused) {
+                this.emit('data', chunk);
+            }
+        });
+        this.micProcess.stderr?.on('data', (data) => {
+            const msg = data.toString();
+            if (msg.includes('FAIL') || msg.includes('error')) {
+                this.emit('error', new Error(msg));
+            }
+        });
+        this.micProcess.on('error', (error) => {
+            this.emit('error', error);
+        });
+        this.micProcess.on('exit', () => {
+            this.isRecording = false;
+        });
+        this.isRecording = true;
+        this.isPaused = false;
+        this.emit('started');
+    }
+    /**
+     * Pause audio capture (for echo cancellation during playback)
+     * Kills the mic process to ensure no audio leaks through
+     */
+    pause() {
+        if (!this.isRecording || this.isPaused)
+            return;
+        this.isPaused = true;
+        // Kill the mic process to ensure complete silence
+        if (this.micProcess) {
+            try {
+                this.micProcess.kill('SIGKILL');
+            }
+            catch { }
+            this.micProcess = null;
+        }
+    }
+    /**
+     * Resume audio capture after playback ends
+     */
+    resume() {
+        if (!this.isPaused)
+            return;
+        this.isPaused = false;
+        // Restart the mic process
+        this.spawnMic();
+    }
+    stop() {
+        if (!this.isRecording)
+            return;
+        if (this.micProcess) {
+            try {
+                this.micProcess.kill('SIGTERM');
+            }
+            catch { }
+            this.micProcess = null;
+        }
+        this.isRecording = false;
+        this.isPaused = false;
+        this.emit('stopped');
+    }
+    get recording() {
+        return this.isRecording && !this.isPaused;
+    }
+    get paused() {
+        return this.isPaused;
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+}
+exports.AudioCapture = AudioCapture;
+//# sourceMappingURL=audio-capture.js.map

package/packages/cli/dist/audio-capture.js.map

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

package/packages/cli/dist/audio-playback.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Audio Playback Module
+ * Smooth speaker output using sox with buffering to prevent audio cracks
+ */
+import { EventEmitter } from 'events';
+export interface AudioPlaybackConfig {
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly bitDepth: number;
+}
+export interface AudioPlaybackEvents {
+    'started': () => void;
+    'stopped': () => void;
+    'finished': () => void;
+    'error': (error: Error) => void;
+}
+export declare class AudioPlayback extends EventEmitter {
+    private playProcess;
+    private isWritable;
+    private config;
+    private audioBuffer;
+    private isPlaying;
+    private totalBytesQueued;
+    private finishRequested;
+    private drainTimeout;
+    constructor(config: AudioPlaybackConfig);
+    start(): void;
+    private spawnProcess;
+    /**
+     * Queue audio for playback
+     */
+    play(audioBuffer: Buffer): void;
+    /**
+     * Signal that we're done sending audio for this response.
+     */
+    finishPlayback(): void;
+    /**
+     * Reset state for next response
+     */
+    private resetForNextResponse;
+    /**
+     * Immediately stop playback (for barge-in)
+     */
+    stop(): void;
+    get playing(): boolean;
+    on<K extends keyof AudioPlaybackEvents>(event: K, listener: AudioPlaybackEvents[K]): this;
+    emit<K extends keyof AudioPlaybackEvents>(event: K, ...args: Parameters<AudioPlaybackEvents[K]>): boolean;
+}
+//# sourceMappingURL=audio-playback.d.ts.map

package/packages/cli/dist/audio-playback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-playback.d.ts","sourceRoot":"","sources":["../src/audio-playback.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAsB;IAGpC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAA+B;gBAEvC,MAAM,EAAE,mBAAmB;IAKvC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,YAAY;IA+CpB;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAoB/B;;OAEG;IACH,cAAc,IAAI,IAAI;IAqBtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,IAAI,IAAI,IAAI;IA0BZ,IAAI,OAAO,IAAI,OAAO,CAErB;IAEQ,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAC7C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI;IAIE,IAAI,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAC/C,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO;CAGX"}