careervivid 2.1.12 → 2.1.13

package/dist/commands/agent/repl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/repl.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAK7G,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAwBtF;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9K,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,GAAG,EAAE,GACX,OAAO,CAAC,IAAI,CAAC,CA+oBf"}
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/repl.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO7G,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,QAwBtF;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,WAAW,GAAG,sBAAsB,GAAG,IAAI,EACnD,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9K,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,GAAG,EAAE,GACX,OAAO,CAAC,IAAI,CAAC,CAosBf"}

package/dist/commands/agent/repl.js

@@ -4,8 +4,10 @@ import ora from "ora";
 import { isSafeCommand } from "../../agent/tools/coding.js";
 import { CareerVividProxyEngine } from "../../agent/CareerVividProxyEngine.js";
 import { CV_MODELS } from "./configurator.js";
-import { loadConfig, getProviderKey, setProviderKey } from "../../config.js";
+import { loadConfig, getGeminiKey, getProviderKey, setProviderKey } from "../../config.js";
 import { auditLog, writeSessionSummary, SESSION_ID } from "../../agent/agentAuditLog.js";
+import { runShellEscape } from "../../lib/shell.js";
+import { isVoiceEnabled, setVoiceEnabled, setLastResponse, getLastResponse, speakText, stopPlayback } from "../../lib/tts.js";
 const { prompt } = pkg;
 export function printCreditStatus(remaining, limit = null) {
     if (remaining === null)
@@ -165,6 +167,15 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                     chalk.dim("\n   Then paste the job description, and press Enter twice to submit.\n"));
                 return ask();
             }
+            // ── Subshell escape: input starting with ! runs as a raw shell command ──
+            if (userInput.startsWith("!")) {
+                const shellCmd = userInput.slice(1).trim();
+                if (shellCmd) {
+                    process.stdout.write(chalk.dim(`\n  $ ${shellCmd}\n`));
+                    await runShellEscape(shellCmd);
+                }
+                return ask();
+            }
             // ── Slash commands ──────────────────────────────────────────────
             if (userInput.startsWith("/")) {
                 const [cmd, ...rest] = userInput.slice(1).split(" ");
@@ -173,13 +184,45 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                     console.log(chalk.cyan("\n  Slash commands:"));
                     console.log(chalk.dim("  /model <name>  — Switch to a different model mid-session"));
                     console.log(chalk.dim("  /models        — List all available CareerVivid models"));
+                    console.log(chalk.dim("  /voice on|off  — Toggle automatic TTS for agent responses"));
+                    console.log(chalk.dim("  /speak         — Read the last agent response aloud"));
                     console.log(chalk.dim("  /help          — Show this help message"));
                     console.log(chalk.dim("  exit           — End the session"));
-                    console.log(chalk.cyan("\n  Paste long content (job descriptions, cover letters):"));
+                    console.log(chalk.cyan("\n  Shell escape (run terminal commands without leaving the agent):"));
+                    console.log(chalk.dim("  !<command>     — e.g. !ls -la  or  !git status\n"));
+                    console.log(chalk.cyan("  Paste long content (job descriptions, cover letters):"));
                     console.log(chalk.dim("  <<<            — Open multi-line paste mode; press Enter twice when done"));
                     console.log(chalk.dim("  <<<your text   — Start with text directly after <<<\n"));
                     return ask();
                 }
+                if (cmd === "voice") {
+                    if (arg === "on") {
+                        setVoiceEnabled(true);
+                        console.log(chalk.green("\n  🔊 Voice enabled. Agent responses will be spoken aloud.\n"));
+                    }
+                    else if (arg === "off") {
+                        setVoiceEnabled(false);
+                        stopPlayback();
+                        console.log(chalk.yellow("\n  🔇 Voice disabled.\n"));
+                    }
+                    else {
+                        const status = isVoiceEnabled() ? chalk.green("on") : chalk.yellow("off");
+                        console.log(chalk.dim(`\n  Voice is currently ${status}. Usage: /voice on  or  /voice off\n`));
+                    }
+                    return ask();
+                }
+                if (cmd === "speak") {
+                    const last = getLastResponse();
+                    if (!last) {
+                        console.log(chalk.dim("\n  Nothing to speak yet. Ask the agent something first.\n"));
+                    }
+                    else {
+                        const geminiKey = getGeminiKey() || process.env.GEMINI_API_KEY;
+                        speakText(last, geminiKey ?? undefined).catch(() => { });
+                        console.log(chalk.dim("\n  🔊 Speaking last response...\n"));
+                    }
+                    return ask();
+                }
                 if (cmd === "models") {
                     console.log(chalk.cyan("\n  Available CareerVivid models:"));
                     for (const m of CV_MODELS) {
@@ -418,6 +461,7 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
             };
             if (engine) {
                 sessionTurns++;
+                let responseAccumulator = "";
                 const sharedOnChunk = (text) => {
                     if (firstChunk) {
                         thinkingSpinner.stop();
@@ -426,6 +470,7 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                         firstChunk = false;
                     }
                     process.stdout.write(text);
+                    responseAccumulator += text; // Accumulate for TTS
                 };
                 const sharedOnError = (error) => {
                     thinkingSpinner.stop();
@@ -476,6 +521,14 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                         onError: sharedOnError,
                     });
                 }
+                // ── TTS: store last response + auto-speak if voice enabled ──────
+                if (responseAccumulator) {
+                    setLastResponse(responseAccumulator);
+                    if (isVoiceEnabled()) {
+                        const geminiKey = getGeminiKey() || process.env.GEMINI_API_KEY;
+                        speakText(responseAccumulator, geminiKey ?? undefined).catch(() => { });
+                    }
+                }
                 // ── Clean turn separator after every AI reply ─────────────────────────────
                 process.stdout.write("\n" + chalk.dim("─".repeat(48)) + "\n");
             }

package/dist/lib/shell.d.ts

@@ -0,0 +1,13 @@
+/**
+ * shell.ts — Subshell escape for the CareerVivid REPL
+ *
+ * Intercepts user input starting with `!` and spawns it as a raw
+ * shell command. stdout/stderr are piped directly to the terminal.
+ * The agent session and conversation history are never affected.
+ */
+/**
+ * Runs a shell command and streams its output to the terminal.
+ * Returns a promise that resolves when the command exits.
+ */
+export declare function runShellEscape(command: string): Promise<void>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/lib/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/lib/shell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7D"}

package/dist/lib/shell.js

@@ -0,0 +1,30 @@
+/**
+ * shell.ts — Subshell escape for the CareerVivid REPL
+ *
+ * Intercepts user input starting with `!` and spawns it as a raw
+ * shell command. stdout/stderr are piped directly to the terminal.
+ * The agent session and conversation history are never affected.
+ */
+import { spawn } from "child_process";
+/**
+ * Runs a shell command and streams its output to the terminal.
+ * Returns a promise that resolves when the command exits.
+ */
+export function runShellEscape(command) {
+    return new Promise((resolve) => {
+        const child = spawn(command, {
+            shell: true,
+            stdio: "inherit", // pipe stdin/stdout/stderr directly to TTY
+        });
+        child.on("error", (err) => {
+            process.stderr.write(`\n⚠️  Shell error: ${err.message}\n`);
+            resolve();
+        });
+        child.on("close", (code) => {
+            if (code !== 0 && code !== null) {
+                process.stdout.write(`\n  [exit ${code}]\n`);
+            }
+            resolve();
+        });
+    });
+}

package/dist/lib/tts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * tts.ts — Text-to-Speech engine for the CareerVivid REPL
+ *
+ * Uses the Gemini API (TTS model) to synthesize speech from text,
+ * writes the result to a temp WAV file, and plays it via the OS
+ * audio player (afplay on macOS, aplay on Linux) without blocking
+ * the main thread.
+ *
+ * Toggle:  /voice on  |  /voice off
+ * Speak:   /speak      (reads the last agent response)
+ */
+export declare function isVoiceEnabled(): boolean;
+export declare function setVoiceEnabled(on: boolean): void;
+export declare function setLastResponse(text: string): void;
+export declare function getLastResponse(): string;
+/**
+ * Stops any currently playing audio immediately.
+ */
+export declare function stopPlayback(): void;
+/**
+ * Synthesizes `text` via Gemini TTS and plays it asynchronously.
+ * Does nothing if voice is disabled. Silently ignores errors so the
+ * REPL is never disrupted by TTS failures.
+ */
+export declare function speakText(text: string, apiKey?: string): Promise<void>;
+//# sourceMappingURL=tts.d.ts.map

package/dist/lib/tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../src/lib/tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,wBAAgB,cAAc,YAA2B;AACzD,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,QAAwB;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,QAA0B;AACtE,wBAAgB,eAAe,WAA2B;AAI1D;;GAEG;AACH,wBAAgB,YAAY,SAK3B;AAoED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}

package/dist/lib/tts.js

@@ -0,0 +1,153 @@
+/**
+ * tts.ts — Text-to-Speech engine for the CareerVivid REPL
+ *
+ * Uses the Gemini API (TTS model) to synthesize speech from text,
+ * writes the result to a temp WAV file, and plays it via the OS
+ * audio player (afplay on macOS, aplay on Linux) without blocking
+ * the main thread.
+ *
+ * Toggle:  /voice on  |  /voice off
+ * Speak:   /speak      (reads the last agent response)
+ */
+import { writeFileSync, unlinkSync } from "fs";
+import { spawn } from "child_process";
+import { tmpdir } from "os";
+import { join } from "path";
+import { GoogleGenAI, Modality } from "@google/genai";
+// ── State ────────────────────────────────────────────────────────────────────
+let voiceEnabled = false;
+let lastResponse = "";
+let playbackProcess = null;
+export function isVoiceEnabled() { return voiceEnabled; }
+export function setVoiceEnabled(on) { voiceEnabled = on; }
+export function setLastResponse(text) { lastResponse = text; }
+export function getLastResponse() { return lastResponse; }
+// ── Audio Playback ────────────────────────────────────────────────────────────
+/**
+ * Stops any currently playing audio immediately.
+ */
+export function stopPlayback() {
+    if (playbackProcess && !playbackProcess.killed) {
+        playbackProcess.kill("SIGKILL");
+        playbackProcess = null;
+    }
+}
+/**
+ * Plays a WAV buffer using the OS audio player (non-blocking).
+ * afplay on macOS, aplay on Linux, powershell on Windows.
+ */
+function playWav(wavBuffer) {
+    const tmpFile = join(tmpdir(), `cv-tts-${Date.now()}.wav`);
+    writeFileSync(tmpFile, wavBuffer);
+    const platform = process.platform;
+    let playerCmd;
+    let playerArgs;
+    if (platform === "darwin") {
+        playerCmd = "afplay";
+        playerArgs = [tmpFile];
+    }
+    else if (platform === "linux") {
+        playerCmd = "aplay";
+        playerArgs = ["-q", tmpFile];
+    }
+    else {
+        // Windows fallback via PowerShell
+        playerCmd = "powershell";
+        playerArgs = ["-c", `(New-Object System.Media.SoundPlayer '${tmpFile}').PlaySync()`];
+    }
+    stopPlayback(); // Stop any previous playback
+    const child = spawn(playerCmd, playerArgs, { stdio: "ignore", detached: false });
+    playbackProcess = child;
+    child.on("close", () => {
+        try {
+            unlinkSync(tmpFile);
+        }
+        catch { /* ignore cleanup errors */ }
+        if (playbackProcess === child)
+            playbackProcess = null;
+    });
+    child.on("error", () => {
+        // Silently ignore — player may not be installed
+        try {
+            unlinkSync(tmpFile);
+        }
+        catch { /* ignore */ }
+    });
+}
+// ── WAV Header Builder ────────────────────────────────────────────────────────
+function buildWavHeader(dataLength, sampleRate = 24000, channels = 1, bitsPerSample = 16) {
+    const byteRate = sampleRate * channels * bitsPerSample / 8;
+    const blockAlign = channels * bitsPerSample / 8;
+    const header = Buffer.alloc(44);
+    header.write("RIFF", 0);
+    header.writeUInt32LE(36 + dataLength, 4);
+    header.write("WAVE", 8);
+    header.write("fmt ", 12);
+    header.writeUInt32LE(16, 16);
+    header.writeUInt16LE(1, 20); // PCM
+    header.writeUInt16LE(channels, 22);
+    header.writeUInt32LE(sampleRate, 24);
+    header.writeUInt32LE(byteRate, 28);
+    header.writeUInt16LE(blockAlign, 32);
+    header.writeUInt16LE(bitsPerSample, 34);
+    header.write("data", 36);
+    header.writeUInt32LE(dataLength, 40);
+    return header;
+}
+// ── TTS Synthesis ────────────────────────────────────────────────────────────
+/**
+ * Synthesizes `text` via Gemini TTS and plays it asynchronously.
+ * Does nothing if voice is disabled. Silently ignores errors so the
+ * REPL is never disrupted by TTS failures.
+ */
+export async function speakText(text, apiKey) {
+    if (!text.trim())
+        return;
+    const key = apiKey || process.env.GEMINI_API_KEY;
+    if (!key)
+        return; // No key — silently skip
+    // Strip markdown so the audio sounds natural
+    const cleaned = text
+        .replace(/```[\s\S]*?```/g, "") // code blocks
+        .replace(/`[^`]+`/g, "") // inline code
+        .replace(/\*\*(.*?)\*\*/g, "$1") // bold
+        .replace(/\*(.*?)\*/g, "$1") // italic
+        .replace(/^[#>•\-*]\s*/gm, "") // headings, quotes, bullets
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, 1000); // Cap to ~1000 chars to keep TTS fast
+    if (!cleaned)
+        return;
+    try {
+        const ai = new GoogleGenAI({ apiKey: key });
+        const response = await ai.models.generateContent({
+            model: "gemini-2.5-flash-preview-tts",
+            contents: [{ parts: [{ text: cleaned }] }],
+            config: {
+                responseModalities: [Modality.AUDIO],
+                speechConfig: {
+                    voiceConfig: {
+                        prebuiltVoiceConfig: { voiceName: "Zephyr" },
+                    },
+                },
+            },
+        });
+        const parts = response?.candidates?.[0]?.content?.parts ?? [];
+        const audioParts = [];
+        for (const part of parts) {
+            if (part.inlineData?.data) {
+                audioParts.push(Buffer.from(part.inlineData.data, "base64"));
+            }
+        }
+        if (audioParts.length === 0)
+            return;
+        const pcmData = Buffer.concat(audioParts);
+        const wavHeader = buildWavHeader(pcmData.length);
+        const wavBuffer = Buffer.concat([wavHeader, pcmData]);
+        // Fire and forget — does not block the REPL
+        playWav(wavBuffer);
+    }
+    catch {
+        // Silently swallow TTS errors — never disrupt the agent session
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "careervivid",
-  "version": "2.1.12",
+  "version": "2.1.13",
   "description": "Official CLI for CareerVivid — AI voice interviews, autonomous job applications, resume editing, and portfolio publishing from your terminal",
   "type": "module",
   "bin": {
@@ -31,7 +31,7 @@
     "mermaid": "11.14.0",
     "open": "^10.1.0",
     "ora": "^8.1.0",
-    "playwright-core": "^1.51.0",
+    "playwright-core": "1.59.1",
     "semver": "7.7.4",
     "update-notifier": "^7.3.1"
   },