careervivid 2.1.1 → 2.1.13

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/careervivid?color=0ea5e9&label=careervivid)](https://www.npmjs.com/package/careervivid)
 [![License: MIT](https://img.shields.io/badge/license-MIT-brightgreen)](LICENSE)
 [![Node ≥18](https://img.shields.io/badge/node-%3E%3D18-blue)](https://nodejs.org)
-[![v2.1.1](https://img.shields.io/badge/version-2.1.1-6366f1?logo=sparkles)](https://www.npmjs.com/package/careervivid)
+[![v2.1.5](https://img.shields.io/badge/version-2.1.5-6366f1?logo=sparkles)](https://www.npmjs.com/package/careervivid)
 
 ---
 

package/dist/agent/instructions.d.ts

@@ -10,7 +10,8 @@
  *
  * DO NOT scatter instructions across QueryEngine.ts, engineResolver.ts, or anywhere else.
  */
-export declare const BASE_IDENTITY: string;
+/** @deprecated Keep for any external callers that import baseIdentity directly. */
+export declare const baseIdentity: string;
 export declare const RESUME_SECTION: string;
 export declare const CODING_SECTION: string;
 export declare const JOBS_TOOLS_SECTION: string;

package/dist/agent/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agent/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,aAAa,QAalB,CAAC;AAMT,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAqCnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QA0DvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA6CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QAkBtB,CAAC;AAOT;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAkCT"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/agent/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsCH,mFAAmF;AACnF,eAAO,MAAM,YAAY,QAAsB,CAAC;AAMhD,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAqCnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QA0DvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA6CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QAuBtB,CAAC;AAOT;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAqCT"}

package/dist/agent/instructions.js

@@ -11,10 +11,26 @@
  * DO NOT scatter instructions across QueryEngine.ts, engineResolver.ts, or anywhere else.
  */
 import { buildMemoryBlock, MEMORY_SECTION } from "./memory.js";
-export const BASE_IDENTITY = `
+/** Returns today's date as YYYY-MM-DD in the local timezone. */
+function todayStr() {
+    const d = new Date();
+    return [
+        d.getFullYear(),
+        String(d.getMonth() + 1).padStart(2, '0'),
+        String(d.getDate()).padStart(2, '0'),
+    ].join('-');
+}
+/** @internal — call via buildSystemPrompt(), not directly */
+function buildBaseIdentity() {
+    return `
 You are CareerVivid AI — an autonomous career intelligence agent built into the CareerVivid CLI.
 You help users manage their resume, track job applications, find new opportunities, prep for interviews, and grow their career.
 
+## Today's Date
+**TODAY IS: ${todayStr()}**
+Use this exact date whenever you need "today", "now", or the current date.
+NEVER guess, infer, or assume a date — always use the value above.
+
 ## Core Behavioral Rules
 
 1. **ANSWER FIRST** — If the user asks a direct question (e.g., "Did you find X?", "What is Y?"), answer it explicitly and immediately. Do not ignore the question or bury it behind a massive multi-step automated tangent.
@@ -25,6 +41,9 @@ You help users manage their resume, track job applications, find new opportuniti
 6. **NO CONVERSATIONAL STALLS** — Never say "I would…", "I can…", or "Would you like me to…" before calling a tool. Just call it.
 7. **TRANSPARENCY** — If uncertain, list options and your recommendation. Never silently choose.
 `.trim();
+}
+/** @deprecated Keep for any external callers that import baseIdentity directly. */
+export const baseIdentity = buildBaseIdentity();
 // ---------------------------------------------------------------------------
 // §2 — Resume section (appended in --resume and --jobs modes)
 // ---------------------------------------------------------------------------
@@ -215,7 +234,12 @@ When the user sends a generic greeting ("hey", "hi", "hello", "start"), respond
 
 Just tell me what you need!"
 
-If the user says "pick up where we left off" or similar, immediately reference the Recent Session Memory block (if any) and resume the most recent task. If there is no memory yet, say so and offer to start fresh.
+If the user says "pick up where we left off" or similar:
+1. First check the Career Context block below for a "Last session" line and reference it.
+2. If the Career Context block is empty or has no "Last session", do NOT say "I have no memory."
+   Instead, immediately call tracker_list_jobs (or tracker_dashboard) + list_resumes in parallel
+   to reconstruct the user's current state from live data, then summarize what you find.
+3. Only say "nothing saved yet" if BOTH the memory block AND all tool calls return empty results.
 `.trim();
 // ---------------------------------------------------------------------------
 // §7 — Assembled system prompts per mode (the public API)
@@ -226,6 +250,8 @@ If the user says "pick up where we left off" or similar, immediately reference t
  * This is the ONLY function that engineResolver.ts should call.
  */
 export function buildSystemPrompt(options) {
+    // Always build fresh so today's date is injected at call time, not module-load time.
+    const baseIdentity = buildBaseIdentity();
     // Load memory block (empty string if no memory file exists yet)
     const memoryBlock = buildMemoryBlock();
     const memorySections = memoryBlock
@@ -233,7 +259,7 @@ export function buildSystemPrompt(options) {
         : [];
     if (options.jobs) {
         return [
-            BASE_IDENTITY,
+            baseIdentity,
             RESUME_SECTION,
             JOBS_TOOLS_SECTION,
             JOBS_HARNESS,
@@ -243,7 +269,7 @@ export function buildSystemPrompt(options) {
     }
     if (options.resume) {
         return [
-            BASE_IDENTITY,
+            baseIdentity,
             RESUME_SECTION,
             ...memorySections,
             GREETING_PROTOCOL,
@@ -251,7 +277,7 @@ export function buildSystemPrompt(options) {
     }
     // Default: coding / general mode
     return [
-        BASE_IDENTITY,
+        baseIdentity,
         CODING_SECTION,
         ...memorySections,
         GREETING_PROTOCOL,

package/dist/commands/agent/engineResolver.d.ts

@@ -21,5 +21,5 @@ export declare function printBanner(options: {
     resume?: boolean;
     pro?: boolean;
     think?: number;
-}, selectedProvider: string, selectedModel: string, thinkingBudget: number): void;
+}, selectedProvider: string, selectedModel: string, _thinkingBudget: number): void;
 //# sourceMappingURL=engineResolver.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"engineResolver.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/engineResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAE5G;AAED,wBAAgB,WAAW,CACzB,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,OAAO,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,WAAW,GAAG,sBAAsB,GAAG,IAAI,CA2B7C;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9F,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,QAwBvB"}
+{"version":3,"file":"engineResolver.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/engineResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAE5G;AAED,wBAAgB,WAAW,CACzB,gBAAgB,EAAE,WAAW,EAC7B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,OAAO,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,WAAW,GAAG,sBAAsB,GAAG,IAAI,CA2B7C;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9F,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,QAcxB"}

package/dist/commands/agent/engineResolver.js

@@ -40,30 +40,16 @@ export function buildEngine(selectedProvider, selectedModel, systemInstruction,
     }
     return engine;
 }
-export function printBanner(options, selectedProvider, selectedModel, thinkingBudget) {
-    console.log(chalk.bold.cyan("\n🤖 CareerVivid Agent"));
+export function printBanner(options, selectedProvider, selectedModel, _thinkingBudget) {
+    console.log(chalk.bold.hex("#6366f1")("\n  CareerVivid Agent"));
     if (selectedProvider === "careervivid") {
         const cost = MODEL_CREDIT_COST[selectedModel] ?? 1;
         console.log(chalk.dim(`  Model: ${selectedModel}`) +
-            chalk.gray(`  [${cost} credit${cost !== 1 ? "s" : ""}/turn via CareerVivid Cloud]`));
+            chalk.dim(`  [${cost} credit${cost !== 1 ? "s" : ""}/turn via CareerVivid Cloud]`));
     }
     else {
-        console.log(chalk.cyan(`  Provider: ${selectedProvider}  Model: ${selectedModel}  [0 credits]`));
+        console.log(chalk.dim(`  Provider: ${selectedProvider}  ·  Model: ${selectedModel}  [0 credits]`));
     }
-    if (options.coding)
-        console.log(chalk.green("  ✔ Coding mode: file I/O, shell, search tools active"));
-    if (options.jobs) {
-        console.log(chalk.cyan("  ✔ Job mode: search, score, apply_to_job, openings_scan tools active"));
-        console.log(chalk.magenta("  ✔ Browser mode: navigate, click, type, select, scroll, screenshot tools active"));
-        console.log(chalk.yellow("  ✔ Local tracker: tracker_list_jobs · tracker_update_job · tracker_add_job"));
-        console.log(chalk.yellow("               + tracker_rank_priority · tracker_dashboard · tracker_find_stale"));
-        console.log(chalk.yellow("               + tracker_recheck_urls · openings_scan · openings_list (jobs.csv v2)"));
-    }
-    else if (options.resume)
-        console.log(chalk.cyan("  ✔ Resume mode: get_resume tool active"));
-    if (options.pro)
-        console.log(chalk.magenta(`  ✔ Pro mode: ${selectedModel} + thinking (${thinkingBudget} tokens)`));
-    else if (thinkingBudget > 0)
-        console.log(chalk.yellow(`  ✔ Thinking mode: ${thinkingBudget} token budget`));
-    console.log(chalk.gray(`  Type 'exit' to quit  ·  /model to switch models  ·  /help for commands.\n`));
+    const modeLabel = options.jobs ? "Jobs & Applications" : options.resume ? "Resume" : "General";
+    console.log(chalk.dim(`  Mode: ${modeLabel}  ·  Type 'exit' to quit  ·  /help for commands.\n`));
 }

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,CAqlBf"}
+{"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)
@@ -67,65 +69,97 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                 .catch(e => { clearTimeout(timer); reject(e); });
         });
     }
-    const ask = async () => {
+    // ── First-turn menu items ────────────────────────────────────────────────
+    const MENU_ITEMS = [
+        "📄 View or update my resume",
+        "🔍 Search for job opportunities",
+        "📊 Check my job pipeline / tracker",
+        "✉️  Draft a cover letter or tailor my resume",
+        "🎙  Start an AI mock interview (voice or text)",
+        "📈 Get an overview of my job search progress",
+        "🗓️  Pick up where we left off",
+    ];
+    const ask = async (isFirstTurn = false) => {
         try {
-            const promptStartTime = Date.now();
-            const response = await prompt({
-                type: "input",
-                name: "query",
-                message: pasteBuffer.length > 0
-                    ? chalk.dim("... ")
-                    : chalk.bold.cyan("❯") + chalk.dim(" ·"),
-            });
-            const duration = Date.now() - promptStartTime;
-            let userInput = response.query;
-            // ── Multi-line paste mode: user typed <<< (or <<<paste) ─────────────
-            // Allows pasting arbitrarily long content (e.g. full JD) without truncation.
-            if (userInput.trim() === "<<<" || userInput.trim().toLowerCase().startsWith("<<<")) {
-                const prefix = userInput.trim().slice(3).trim(); // text after <<<
-                console.log(chalk.dim("  📋 Multi-line mode: paste your text, then press Enter twice to submit.\n"));
-                const lines = prefix ? [prefix] : [];
-                let emptyCount = 0;
-                while (emptyCount < 1) {
-                    const lineResp = await prompt({
-                        type: "input",
-                        name: "line",
-                        message: chalk.dim("  │"),
-                    });
-                    if (lineResp.line === "") {
-                        emptyCount++;
-                    }
-                    else {
-                        emptyCount = 0;
-                        lines.push(lineResp.line);
-                    }
+            let userInput;
+            if (isFirstTurn) {
+                // ── Hybrid menu: arrow-key select OR free type ─────────────────
+                console.log(chalk.dim("  What would you like to do today?\n"));
+                for (const item of MENU_ITEMS) {
+                    console.log(chalk.dim(`  ${item}`));
                 }
-                userInput = lines.join("\n").trim();
-                pasteBuffer = [];
-            }
-            else if (duration < 150) {
-                // Handle multiline copy & paste: prompt resolves extremely fast if stdin is buffered.
-                // 150ms threshold gives enough headroom for large pastes (long JDs, cover letters).
-                pasteBuffer.push(userInput);
-                return ask();
+                console.log("");
+                const firstResp = await prompt({
+                    type: "autocomplete",
+                    name: "choice",
+                    message: chalk.bold.hex("#6366f1")("❯") + chalk.dim(" ·"),
+                    // @ts-ignore — enquirer autocomplete supports limit
+                    limit: 7,
+                    suggest(input, choices) {
+                        if (!input)
+                            return choices;
+                        return choices.filter((c) => c.value.toLowerCase().includes(input.toLowerCase()));
+                    },
+                    choices: MENU_ITEMS.map(item => ({ name: item, value: item })),
+                    footer: chalk.dim("  ↑↓ to navigate  ·  type to filter  ·  Enter to send"),
+                });
+                userInput = firstResp.choice?.trim() || "";
+                // Strip emoji prefixes so the agent gets clean text
+                userInput = userInput.replace(/^[\p{Emoji}\s]+/u, "").trim() || firstResp.choice?.trim() || "";
             }
             else {
-                if (pasteBuffer.length > 0) {
-                    if (userInput)
-                        pasteBuffer.push(userInput);
-                    userInput = pasteBuffer.join("\n");
-                    // Reset buffer
+                // ── Normal text input for subsequent turns ──────────────────────
+                const promptStartTime = Date.now();
+                const response = await prompt({
+                    type: "input",
+                    name: "query",
+                    message: pasteBuffer.length > 0
+                        ? chalk.dim("... ")
+                        : chalk.bold.hex("#6366f1")("❯") + chalk.dim(" ·"),
+                });
+                userInput = response.query;
+                const duration = Date.now() - promptStartTime;
+                // ── Multi-line paste mode ──────────────────────────────────────
+                if (userInput.trim() === "<<<" || userInput.trim().toLowerCase().startsWith("<<<")) {
+                    const prefix = userInput.trim().slice(3).trim();
+                    console.log(chalk.dim("  📋 Multi-line mode: paste your text, then press Enter twice to submit.\n"));
+                    const lines = prefix ? [prefix] : [];
+                    let emptyCount = 0;
+                    while (emptyCount < 1) {
+                        const lineResp = await prompt({
+                            type: "input",
+                            name: "line",
+                            message: chalk.dim("  │"),
+                        });
+                        if (lineResp.line === "") {
+                            emptyCount++;
+                        }
+                        else {
+                            emptyCount = 0;
+                            lines.push(lineResp.line);
+                        }
+                    }
+                    userInput = lines.join("\n").trim();
                     pasteBuffer = [];
                 }
-            }
+                else if (duration < 150) {
+                    pasteBuffer.push(userInput);
+                    return ask();
+                }
+                else {
+                    if (pasteBuffer.length > 0) {
+                        if (userInput)
+                            pasteBuffer.push(userInput);
+                        userInput = pasteBuffer.join("\n");
+                        pasteBuffer = [];
+                    }
+                }
+            } // end else (non-first turn)
             userInput = userInput.trim();
             if (!userInput)
                 return ask();
             // ── Input length guard ──────────────────────────────────────────
-            // macOS terminal readline has a hard ~4096 char limit per line, meaning
-            // pasting very long job descriptions gets silently truncated mid-word.
-            // Detect this early and guide the user to <<< mode instead.
-            const MAX_INPUT_CHARS = 20_000; // ~3,000 words — safe above typical JD length
+            const MAX_INPUT_CHARS = 20_000;
             if (userInput.length > MAX_INPUT_CHARS) {
                 console.log(chalk.yellow("\n⚠️  Input is too long (" + userInput.length + " chars).") +
                     chalk.dim("\n   Use <<< mode for long job descriptions so nothing gets cut off:") +
@@ -133,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(" ");
@@ -141,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) {
@@ -207,7 +282,9 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
             }
             // Reset per-turn mutation counter at the start of each user message
             turnMutations = 0;
-            process.stdout.write(chalk.dim("\n⏳ Thinking...\n\n"));
+            // ── Clear previous spinner residue then show thinking indicator ──
+            process.stdout.write(chalk.dim("\n"));
+            const thinkingSpinner = ora({ text: chalk.dim("Vivid is thinking…"), color: "cyan", spinner: "dots" }).start();
             let firstChunk = true;
             let currentSpinner = null;
             let trustAllCommands = false;
@@ -255,6 +332,11 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                 get_profile: "👤 Loading profile...",
             };
             const handleToolCall = async (name, args) => {
+                // Stop the thinking spinner the moment we start a tool — prevents duplication
+                if (thinkingSpinner.isSpinning) {
+                    thinkingSpinner.stop();
+                    process.stdout.write("\r\x1b[K"); // clear spinner line
+                }
                 // #9 Circuit breaker: abort if same tool called 5+ times consecutively with same args
                 const argsHash = JSON.stringify(args).slice(0, 100);
                 if (lastToolCall.name === name && lastToolCall.argsHash === argsHash) {
@@ -283,11 +365,9 @@ export async function askLoop(engine, options, selectedProvider, selectedModel,
                         console.log(chalk.yellow(`\n💡 Heads up: ${SESSION_MAX_MUTATIONS - sessionMutations} writes remaining this session.`));
                     }
                 }
-                // Show a clean, user-friendly label — never show raw args
+                // Print compact tool label — no blank lines, stays tight between steps
                 const label = TOOL_LABELS[name] ?? `⚙️  Working...`;
-                process.stdout.write(chalk.dim(`
-${label}
-`));
+                process.stdout.write(chalk.dim(`  ${label}\n`));
                 if (name === "run_command") {
                     if (trustAllCommands || isSafeCommand(args.command)) {
                         return true;
@@ -361,7 +441,7 @@ ${label}
             };
             const handleToolResult = (name, result) => {
                 if (currentSpinner) {
-                    currentSpinner.succeed(chalk.dim(`Done`));
+                    currentSpinner.succeed(chalk.dim("Done"));
                     currentSpinner = null;
                 }
                 if (name === "start_interview") {
@@ -381,14 +461,19 @@ ${label}
             };
             if (engine) {
                 sessionTurns++;
+                let responseAccumulator = "";
                 const sharedOnChunk = (text) => {
                     if (firstChunk) {
-                        process.stdout.write("\r\x1b[K");
+                        thinkingSpinner.stop();
+                        // Print a subtle gutter marker so AI response is visually distinct
+                        process.stdout.write("\n" + chalk.hex("#6366f1")("✦ "));
                         firstChunk = false;
                     }
-                    process.stdout.write(chalk.green(text));
+                    process.stdout.write(text);
+                    responseAccumulator += text; // Accumulate for TTS
                 };
                 const sharedOnError = (error) => {
+                    thinkingSpinner.stop();
                     if (currentSpinner) {
                         currentSpinner.fail("Tool error");
                         currentSpinner = null;
@@ -436,6 +521,16 @@ ${label}
                         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");
             }
             else {
                 sessionTurns++;
@@ -458,10 +553,11 @@ ${label}
                 while (round < 10) {
                     const result = await withTimeout(provider.generate({ model: currentModel, history: byoHistory, userTurn, tools, systemInstruction }), 45_000, "LLM generate()");
                     if (round === 0) {
-                        process.stdout.write("\r\x1b[K"); // clear initial thinking spinner
+                        thinkingSpinner.stop();
+                        process.stdout.write("\n" + chalk.hex("#6366f1")("\u2726 "));
                     }
                     if (result.text) {
-                        console.log(chalk.green(result.text));
+                        process.stdout.write(result.text);
                     }
                     byoHistory.push(userTurn);
                     byoHistory.push({ role: "model", parts: result.rawParts || [{ text: result.text }] });
@@ -479,11 +575,23 @@ ${label}
                         let out;
                         try {
                             // start_interview is an interactive long-running session — never apply a timeout to it.
-                            out = tool
-                                ? fc.name === "start_interview"
-                                    ? await tool.execute(fc.args)
-                                    : await withTimeout(tool.execute(fc.args), 45_000, `tool:${fc.name}`)
-                                : { error: "Tool not found" };
+                            // Also temporarily remove the REPL's SIGINT handler so the interview's own
+                            // Ctrl+C handler can run cleanly (generate report) without racing against
+                            // the REPL's "Goodbye! 👋" / process.exit path.
+                            if (fc.name === "start_interview") {
+                                process.removeListener("SIGINT", handleSigInt);
+                                try {
+                                    out = tool ? await tool.execute(fc.args) : { error: "Tool not found" };
+                                }
+                                finally {
+                                    process.on("SIGINT", handleSigInt); // always restore, even on throw
+                                }
+                            }
+                            else {
+                                out = tool
+                                    ? await withTimeout(tool.execute(fc.args), 45_000, `tool:${fc.name}`)
+                                    : { error: "Tool not found" };
+                            }
                         }
                         catch (e) {
                             if (e.message?.includes("No API key configured")) {
@@ -499,6 +607,8 @@ ${label}
                     userTurn = { role: "user", parts: fnResponses };
                     round++;
                 }
+                // ── Clean turn separator after every AI reply ─────────────────────────────
+                process.stdout.write("\n" + chalk.dim("─".repeat(48)) + "\n");
             }
             return ask();
         }
@@ -571,5 +681,5 @@ ${label}
             return ask();
         }
     };
-    return ask();
+    return ask(true);
 }

package/dist/commands/interview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interview.d.ts","sourceRoot":"","sources":["../../src/commands/interview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkvBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG/D"}
+{"version":3,"file":"interview.d.ts","sourceRoot":"","sources":["../../src/commands/interview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyzBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG/D"}

package/dist/commands/interview.js

@@ -133,7 +133,7 @@ function printReport(report) {
     console.log("\n" + chalk.yellow.bold("  💡 Areas for Improvement"));
     wordWrap(report.areasForImprovement, 72).split("\n").forEach(l => console.log(`     ${chalk.yellow(l)}`));
     console.log("\n" + chalk.dim("  ─────────────────────────────────────────────────────────────"));
-    console.log(chalk.dim("  View full history at: https://careervivid.app/interview"));
+    console.log(chalk.dim("  View full history at: https://careervivid.app/interview-studio"));
     console.log("");
 }
 // ─── sox audio check ──────────────────────────────────────────────────────────
@@ -381,12 +381,17 @@ async function runVoiceSession(opts) {
     const systemInstruction = buildSystemPrompt(role, questions, resumeContext);
     const transcript = [];
     let ended = false;
-    let outputBuf = ""; // accumulates AI transcription
-    let inputBuf = ""; // accumulates user transcription
-    // Half-duplex mute: stop sending mic audio while Vivid is speaking
-    // to prevent the mic picking up speaker output (echo loop).
+    let outputBuf = ""; // accumulates AI output transcription for current turn
+    let inputBuf = ""; // accumulates user input transcription for current turn
+    let streamColPos = 0; // current col position while streaming Vivid's text
     let vividSpeaking = false;
     let muteTimer = null;
+    // Track whether we're currently showing live user speech in the terminal
+    let userSpeechLineActive = false;
+    // Detect END_TOKEN in the raw chunk BEFORE it's stripped from the display buffer.
+    // (outputBuf never contains END_TOKEN because chunkClean strips it, so the
+    //  turnComplete check on outputBuf would never fire without this flag.)
+    let endTokenSeen = false;
     // ── Audio processes ──────────────────────────────────────────────────
     const micProc = startMic(soxPath);
     const speakerProc = startSpeaker(soxPath);
@@ -399,9 +404,14 @@ async function runVoiceSession(opts) {
             model: LIVE_MODEL,
             callbacks: {
                 onopen: () => {
-                    connectSpinner.succeed(chalk.green("✅ Vivid is live — start speaking!"));
-                    process.stdout.write(chalk.green("\n  ● Listening...\r"));
-                    // Pipe mic PCM → Gemini, muted while Vivid is speaking
+                    connectSpinner.succeed(chalk.green("✅ Vivid is ready!"));
+                    // Show a professional prompt so the user knows to speak first
+                    console.log("");
+                    console.log(chalk.bold.white("  🎙  Greet Vivid to begin your interview."));
+                    console.log(chalk.dim('  Say \'Hello\' or \'Hi, I\'m ready\' to get started.'));
+                    console.log("");
+                    process.stdout.write(chalk.green("  ● Listening...\r"));
+                    // Pipe mic PCM → Gemini (muted while Vivid is speaking)
                     micProc.stdout.on("data", (chunk) => {
                         if (ended || chunk.length === 0 || vividSpeaking)
                             return;
@@ -420,48 +430,109 @@ async function runVoiceSession(opts) {
                     // ── Audio output (Vivid speaking) → sox speaker ───
                     const audioPart = msg.serverContent?.modelTurn?.parts?.[0]?.inlineData?.data;
                     if (audioPart) {
-                        // Mute mic: cancel any pending unmute and stay muted
                         vividSpeaking = true;
                         if (muteTimer) {
                             clearTimeout(muteTimer);
                             muteTimer = null;
                         }
-                        process.stdout.write(chalk.blue("  ◈ Vivid speaking...\r"));
                         const pcmBuf = Buffer.from(audioPart, "base64");
                         speakerProc.stdin.write(pcmBuf);
                     }
-                    // ── Output transcription (what Vivid said) ────────
+                    // ── Output transcription (Vivid's words) — stream in real-time ──
                     const outText = msg.serverContent?.outputTranscription?.text;
-                    if (outText)
-                        outputBuf += outText;
-                    // ── Input transcription (what user said) ──────────
+                    if (outText) {
+                        // Detect END_TOKEN in raw chunk BEFORE stripping
+                        if (outText.includes(END_TOKEN))
+                            endTokenSeen = true;
+                        // Phrase-based fallback: model sometimes omits the token
+                        if (outText.toLowerCase().includes("feedback report is being generated"))
+                            endTokenSeen = true;
+                        const chunkClean = outText.replace(END_TOKEN, "");
+                        if (chunkClean) {
+                            if (!outputBuf) {
+                                // First chunk: print the speaker header on a fresh line
+                                process.stdout.write("\n" + chalk.cyan.bold("  Vivid ❯") + "\n");
+                                streamColPos = 0;
+                            }
+                            outputBuf += chunkClean;
+                            // Stream words inline with soft word-wrap
+                            for (const word of chunkClean.split(/(\s+)/)) {
+                                if (!word)
+                                    continue;
+                                const isWhitespace = /^\s+$/.test(word);
+                                if (isWhitespace) {
+                                    if (streamColPos > 0) {
+                                        process.stdout.write(chalk.cyan(' '));
+                                        streamColPos += 1;
+                                    }
+                                }
+                                else {
+                                    if (streamColPos > 0 && streamColPos + word.length > WRAP_WIDTH) {
+                                        process.stdout.write('\n');
+                                        streamColPos = 0;
+                                    }
+                                    const prefix = streamColPos === 0 ? '  ' : '';
+                                    process.stdout.write(chalk.cyan(prefix + word));
+                                    streamColPos += prefix.length + word.length;
+                                }
+                            }
+                        }
+                    }
+                    // ── Input transcription (user's live speech) — stream in real-time ──
                     const inText = msg.serverContent?.inputTranscription?.text;
-                    if (inText)
+                    if (inText) {
+                        if (!userSpeechLineActive) {
+                            // First chunk of user speech: clear the Listening indicator and
+                            // start a "[You] ❯" prefix on a fresh line
+                            process.stdout.write("\r\x1B[2K"); // clear current line
+                            process.stdout.write(chalk.dim("  [You] ❯ ") + chalk.white(""));
+                            userSpeechLineActive = true;
+                        }
                         inputBuf += inText;
+                        // Rewrite the whole user line so far (keeps it clean as chunks arrive)
+                        process.stdout.write("\r\x1B[2K");
+                        process.stdout.write(chalk.dim("  [You] ❯ ") + chalk.white(inputBuf.trim()));
+                    }
                     // ── Turn complete ─────────────────────────────────
                     if (msg.serverContent?.turnComplete) {
                         if (outputBuf.trim()) {
                             const aiText = outputBuf.trim();
-                            printAI(aiText);
-                            transcript.push({ speaker: "ai", text: aiText.replace(END_TOKEN, "").trim() });
-                            if (aiText.includes(END_TOKEN))
+                            // Close the streamed line cleanly
+                            if (streamColPos > 0)
+                                process.stdout.write("\n");
+                            process.stdout.write("\n"); // blank line after Vivid's turn
+                            transcript.push({ speaker: "ai", text: aiText });
+                            // Use the pre-strip flag — NOT aiText.includes(END_TOKEN)
+                            if (endTokenSeen)
                                 ended = true;
                             outputBuf = "";
+                            streamColPos = 0;
+                            endTokenSeen = false; // reset for next turn
                         }
                         if (inputBuf.trim()) {
-                            printUser(inputBuf.trim());
+                            // Finalize the user speech line with a newline
+                            process.stdout.write("\n");
+                            userSpeechLineActive = false;
                             transcript.push({ speaker: "user", text: inputBuf.trim() });
                             inputBuf = "";
                         }
                         if (!ended) {
-                            // Unmute mic after a short delay so the speaker
-                            // tail doesn't get captured (echo suppression buffer)
                             muteTimer = setTimeout(() => {
                                 vividSpeaking = false;
                                 muteTimer = null;
-                                process.stdout.write(chalk.green("  ● Listening...\r"));
+                                if (!userSpeechLineActive) {
+                                    process.stdout.write(chalk.green("\n  ● Listening...\r"));
+                                }
                             }, 800);
                         }
+                        else {
+                            // Interview ended via END_TOKEN — cancel pending mute timer
+                            // so '● Listening...' never appears after the interview concludes
+                            if (muteTimer) {
+                                clearTimeout(muteTimer);
+                                muteTimer = null;
+                            }
+                        }
                     }
                 },
                 onerror: (e) => {
@@ -582,7 +653,10 @@ async function runVoiceSession(opts) {
         log.warn("billing_timeout", { sessionId, sessionDurationMs });
     }
     if (report) {
-        console.log(chalk.dim("\n  💡 Interview context saved. Ask \`cv agent\` to coach you on your answers."));
+        console.log(chalk.dim("\n  💡 Report saved! Continue your prep with:"));
+        console.log(chalk.dim("     • ") + chalk.white("`cv agent`") + chalk.dim(" or ") + chalk.white("`cv agent --jobs`") + chalk.dim(" → coach me on my answers"));
+        console.log(chalk.dim("     • Rewrite resume, draft cover letter, or start another round"));
+        console.log(chalk.dim("     • View report: ") + chalk.cyan("https://careervivid.app/interview-studio"));
     }
     await log.dispose();
 }

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.1",
+  "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"
   },