careervivid 1.12.50 → 2.1.0

package/README.md

@@ -1,10 +1,11 @@
 # careervivid · CLI
 
-> **Your AI-powered career terminal — autonomous job applications, resume editing, job pipeline tracking, and portfolio publishing from the command line.**
+> **Your AI-powered career terminal — voice mock interviews, autonomous job applications, resume editing, job pipeline tracking, and portfolio publishing from the command line.**
 
 [![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](https://img.shields.io/badge/version-2.1-6366f1?logo=sparkles)](https://www.npmjs.com/package/careervivid)
 
 ---
 
@@ -12,6 +13,7 @@
 
 - [Quick Start](#quick-start)
 - [Commands](#commands)
+  - [cv interview](#cv-interview) 🎙 **AI Voice Interview**
   - [cv agent](#cv-agent) ⭐ **AI Agent**
   - [cv agent --jobs](#cv-agent---jobs) 🤖 **Autonomous Job Applications**
   - [cv agent --resume](#cv-agent---resume) 📄 **Resume CRUD**
@@ -40,18 +42,20 @@ npm install -g careervivid
 
 # 2. Log in and get your free API key
 cv login
-# → opens careervivid.app/developer in your browser
-# → copy your API key, then:
-cv auth set-key cv_live_YOUR_KEY_HERE
+# → opens careervivid.app in your browser
+# → authenticate once, API key is saved automatically
+
+# 3. Practice an interview with voice AI
+cv interview
 
-# 3. Start the AI agent
+# 4. Start the AI agent
 cv agent
 
-# 4. Or jump straight into job-hunting mode
+# 5. Or jump straight into job-hunting mode
 cv agent --jobs
 ```
 
-> **Free tier includes 100 AI credits/month** — no credit card required.
+> **Free tier includes 10 AI credits/month** — no credit card required.
 
 ---
 
@@ -59,6 +63,59 @@ cv agent --jobs
 
 ---
 
+### `cv interview`
+
+**AI-powered voice mock interview** using the Gemini Live API. Vivid, your AI interviewer, conducts a real-time spoken interview tailored to the role you specify. After the session, you receive an auto-generated feedback report with scores and actionable improvement tips.
+
+```bash
+cv interview                               # interactive role prompt, voice mode
+cv interview --role "Senior Software Engineer"
+cv interview --role "Product Manager" --text   # text-only fallback (no mic needed)
+cv interview --role "SDE" --resume <id>        # load your resume for context
+cv interview --questions 7                     # custom question count (default 5)
+```
+
+**Requirements (voice mode):**
+- `sox` for audio I/O — install once:
+  ```bash
+  # macOS
+  brew install sox
+  # Ubuntu / Debian
+  sudo apt install sox
+  ```
+
+**How it works:**
+
+1. Vivid generates tailored interview questions using your role (and resume, if provided)
+2. A real-time voice session opens — speak your answers naturally
+3. Vivid asks follow-up questions and adapts to your responses
+4. Press **Ctrl+C** at any time to end
+5. A structured feedback report is generated covering:
+   - Overall, communication, confidence, and relevance scores (0–100)
+   - Specific strengths and areas for improvement
+
+**Interview History & Coaching:**
+
+Every session (transcript + report) is automatically persisted to your CareerVivid account. This enables the **AI Agent** to provide post-interview coaching:
+
+1. Complete an interview via `cv interview`.
+2. Start the agent: `cv agent`.
+3. Ask: *"How can I improve my answers from my last interview?"*
+4. The agent retrieves your actual transcript and suggests **STAR-method** improvements for your specific responses.
+
+**Credit cost:** **2 credits/minute** (minimum 2, maximum 60 per session)
+
+| Session length | Credits |
+|---|---|
+| < 1 min | 2 |
+| 5 min | 10 |
+| 10 min | 20 |
+| 30 min+ | 60 (cap) |
+
+> Credits are only charged after the session ends — never upfront.
+
+---
+
 ### `cv agent`
 
 An **autonomous AI agent** that runs interactively in your terminal. Choose from CareerVivid Cloud (credits deducted from your account) or Bring Your Own API Key.
@@ -294,7 +351,7 @@ CV_API_KEY=cv_live_YOUR_KEY_HERE cv publish article.md
 
 ### `cv login`
 
-Open the CareerVivid sign-in page and interactively save your API key.
+Open the CareerVivid sign-in page and automatically save your API key.
 
 ```bash
 cv login
@@ -336,17 +393,20 @@ cv config set llmModel gpt-4o
 
 | Plan | Credits / Month | Price |
 |---|---|---|
-| **Free** | 100 credits | $0 |
+| **Free** | 10 credits | $0 |
 | **Pro** | 1,000 credits | Paid |
 | **Max** | 10,000 credits | Paid |
 
-**Credit costs per agent turn:**
+**Credit costs by feature:**
 
-| Model | Credits |
+| Feature | Credits |
 |---|---|
-| `gemini-3.1-flash-lite-preview` | 0.5 cr |
-| `gemini-2.5-flash` | 1 cr |
+| `cv interview` (voice) | 2 credits/min (min 2, max 60) |
+| `gemini-3.1-flash-lite-preview` agent turn | 0.5 cr |
+| `gemini-2.5-flash` agent turn | 1 cr |
 | `gemini-3.1-pro-preview` (`--pro`) | 2 cr |
+| Resume tailor | 2 cr |
+| Job evaluation | 3 cr |
 
 > **Bring Your Own Key:** Using `--provider openai` (or any non-CareerVivid provider) deducts **zero credits** — you pay your provider directly.
 
@@ -462,12 +522,13 @@ echo "# My Architecture\n\nExplains the new service..." \
 You have access to the `cv` CLI tool.
 
 Available commands:
-- cv publish <file>               Publish an article (private by default, use --public to share)
-- cv agent --resume               Resume CRUD: read, update fields, tailor
-- cv agent --jobs                 Job hunting + autonomous apply
-- cv jobs hunt --role "..."       AI job search
-- cv jobs apply <url>             Autonomous form filling (stops before submit)
-- cv jobs list                    View job tracker
+- cv interview                        AI voice interview (requires sox)
+- cv publish <file>                   Publish an article (private by default, use --public to share)
+- cv agent --resume                   Resume CRUD: read, update fields, tailor
+- cv agent --jobs                     Job hunting + autonomous apply
+- cv jobs hunt --role "..."           AI job search
+- cv jobs apply <url>                 Autonomous form filling (stops before submit)
+- cv jobs list                        View job tracker
 
 Rules:
 1. Never include real API keys in published content.
@@ -500,6 +561,20 @@ cv auth check
 CV_API_KEY=cv_live_YOUR_KEY cv publish article.md
 ```
 
+**`cv interview` — no audio / can't hear Vivid**
+```bash
+# Install sox first:
+brew install sox          # macOS
+sudo apt install sox      # Ubuntu/Debian
+
+# Then retry:
+cv interview
+```
+
+**`cv interview` — hearing echo / Vivid repeating itself**
+
+This can occur if your microphone picks up the speaker output. The CLI uses half-duplex mute suppression (mic is muted while Vivid is speaking). Use headphones for the best experience.
+
 **`browser_sidecar.py not found`**
 ```bash
 # browser-use is not set up. Follow the browser-use Setup section above.

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,QAwCvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA2CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QAiBtB,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;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"}

package/dist/agent/instructions.js

@@ -127,6 +127,24 @@ These tools read/write the Firebase Kanban board at careervivid.app/job-tracker.
 - **verify_url**             — Verify a single link is alive before sharing it.
 - **verify_job_urls**        — Verify all URLs from a search_jobs result batch.
 NEVER share a link without verifying it first.
+
+### 🎙 AI Voice Interview
+- **start_interview** ⭐ — Launch a live AI mock interview session directly in the terminal.
+  - Vivid (the AI interviewer) asks tailored questions based on the role and user's resume.
+  - User speaks answers (voice mode, requires sox) or types them (text mode).
+  - Feedback report auto-generated at the end with scores and improvement tips.
+  - **Credit cost:** 2 credits/minute (min 2, max 60). Text mode ~1 credit flat.
+  - Use when user says: "practice interview", "mock interview", "interview me for [role]", "I have an interview at [company]", etc.
+  - ⚠️  **PRE-FLIGHT REQUIRED:** Before calling this tool, ALWAYS ask the user:
+    1. What role (if not already stated)
+    2. Voice or Text mode? — Never assume. Ask every time unless user already specified.
+- **fetch_interview_context** — Retrieve the user's recent mock interview sessions (transcript + scores) for coaching.
+  - Use when user says: "improve my answers", "review my interview", "how did I do?",
+    "coach me on my [company] interview", "what did I say", "help me with STAR stories",
+    or any post-interview coaching request.
+  - Returns: scores, strengths, areasForImprovement, and the full Q&A transcript.
+  - After fetching, provide specific STAR-method rewrites for weak answers.
+  - ⭐ After start_interview completes, ALWAYS offer: "Would you like me to review your answers and give coaching tips?"
 `.trim();
 // ---------------------------------------------------------------------------
 // §5 — Autonomous execution harness (appended in --jobs mode)
@@ -174,6 +192,8 @@ If it does, call tracker_update_job instead — never create a duplicate row.
 | view saved openings                           | openings_list                  |
 | applied to a specific opening                 | openings_apply                 |
 | find NEW companies/roles not yet in tracker   | get_resume → search_jobs       |
+| practice interview, mock interview, interview me | ask role + voice/text → start_interview |
+| review interview, improve answers, how did I do | fetch_interview_context → STAR coaching |
 `.trim();
 // ---------------------------------------------------------------------------
 // §6 — Greeting protocol (shared across modes)
@@ -189,6 +209,7 @@ When the user sends a generic greeting ("hey", "hi", "hello", "start"), respond
 • 🔍 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
 

package/dist/agent/tools/fetchInterviewContext.d.ts

@@ -0,0 +1,14 @@
+/**
+ * fetch_interview_context tool — retrieves the user's recent CLI interview
+ * sessions (transcript + feedback report) from Firestore via the
+ * cliGetInterviewContext Cloud Function.
+ *
+ * This allows the agent to:
+ *   - Review what the user actually said during a mock interview
+ *   - Identify weak answers by score
+ *   - Suggest STAR-method improvements for specific questions
+ *   - Pick up post-interview coaching without requiring copy-paste
+ */
+import { Tool } from "../Tool.js";
+export declare const FetchInterviewContextTool: Tool;
+//# sourceMappingURL=fetchInterviewContext.d.ts.map

package/dist/agent/tools/fetchInterviewContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchInterviewContext.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/fetchInterviewContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAqFlC,eAAO,MAAM,yBAAyB,EAAE,IAkCvC,CAAC"}

package/dist/agent/tools/fetchInterviewContext.js

@@ -0,0 +1,114 @@
+/**
+ * fetch_interview_context tool — retrieves the user's recent CLI interview
+ * sessions (transcript + feedback report) from Firestore via the
+ * cliGetInterviewContext Cloud Function.
+ *
+ * This allows the agent to:
+ *   - Review what the user actually said during a mock interview
+ *   - Identify weak answers by score
+ *   - Suggest STAR-method improvements for specific questions
+ *   - Pick up post-interview coaching without requiring copy-paste
+ */
+import { Type } from "@google/genai";
+import { getApiKey } from "../../config.js";
+const CLI_CONTEXT_URL = process.env.CV_FUNCTIONS_URL
+    ? `${process.env.CV_FUNCTIONS_URL}/cliGetInterviewContext`
+    : "https://us-west1-jastalk-firebase.cloudfunctions.net/cliGetInterviewContext";
+/** Cap per session to avoid bloating the agent's context window */
+const MAX_TRANSCRIPT_ENTRIES = 40;
+async function fetchInterviewContext(args) {
+    const apiKey = getApiKey();
+    if (!apiKey) {
+        return "❌ Not logged in. Run `cv login` first to access your interview history.";
+    }
+    try {
+        const res = await fetch(CLI_CONTEXT_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ apiKey, limit: args.limit ?? 3 }),
+        });
+        if (res.status === 401) {
+            return "❌ API key invalid or expired. Run `cv login` to re-authenticate.";
+        }
+        if (!res.ok) {
+            return `⚠️  Could not retrieve interview history (HTTP ${res.status}). Try again shortly.`;
+        }
+        const data = await res.json();
+        const sessions = data.sessions ?? [];
+        if (sessions.length === 0) {
+            return "No recent interview sessions found. Run `cv interview` or start one via `cv agent` to build your history.";
+        }
+        // Build a compact, agent-readable context string
+        const parts = [];
+        parts.push(`📋 Found ${sessions.length} recent interview session(s):\n`);
+        for (let i = 0; i < sessions.length; i++) {
+            const s = sessions[i];
+            const date = s.startedAt ? new Date(s.startedAt).toLocaleString() : "Unknown date";
+            const duration = s.durationMinutes != null ? `${s.durationMinutes} min` : "N/A";
+            parts.push(`─── Session ${i + 1}: ${s.role} (${date}, ${duration}) ───`);
+            // Feedback scores
+            if (s.feedbackReport) {
+                const r = s.feedbackReport;
+                parts.push(`Scores: Overall ${r.overallScore}/100 · Communication ${r.communicationScore}/100 · Confidence ${r.confidenceScore}/100 · Relevance ${r.relevanceScore}/100`);
+                parts.push(`Strengths: ${r.strengths}`);
+                parts.push(`Areas for improvement: ${r.areasForImprovement}`);
+            }
+            else {
+                parts.push("(No feedback report available for this session)");
+            }
+            // Transcript (capped)
+            const entries = s.transcript ?? [];
+            if (entries.length > 0) {
+                parts.push("\nTranscript:");
+                const capped = entries.slice(0, MAX_TRANSCRIPT_ENTRIES);
+                for (const e of capped) {
+                    const speaker = e.speaker === "ai" ? "Interviewer" : "Candidate";
+                    parts.push(`  ${speaker}: ${e.text}`);
+                }
+                if (entries.length > MAX_TRANSCRIPT_ENTRIES) {
+                    parts.push(`  ... (${entries.length - MAX_TRANSCRIPT_ENTRIES} more turns not shown)`);
+                }
+            }
+            else {
+                parts.push("(Transcript not yet available for this session — it may still be saving)");
+            }
+            parts.push("");
+        }
+        return parts.join("\n");
+    }
+    catch (err) {
+        return `⚠️  Error fetching interview context: ${err.message}`;
+    }
+}
+export const FetchInterviewContextTool = {
+    name: "fetch_interview_context",
+    description: `Retrieves the user's recent mock interview sessions from the database, including the full transcript and AI feedback scores.
+
+Use this tool when the user:
+- Asks to "improve my answers", "review my interview", "how did I do?"
+- Says anything about their last/recent interview performance
+- Wants coaching, STAR-method help, or answer refinement after an interview
+- Asks what specific questions they were asked or what they said
+
+RETURNS:
+- Scores (overall, communication, confidence, relevance) for each session
+- Strengths and areas for improvement
+- Full transcript of interviewer questions and candidate answers (capped to 40 turns)
+
+After fetching context, provide targeted, STAR-method coaching based on the actual answers given.
+Default: retrieves the 3 most recent sessions.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            limit: {
+                type: Type.INTEGER,
+                description: "Number of recent sessions to fetch (1–10). Default: 3.",
+            },
+        },
+        required: [],
+    },
+    requiresConfirmation: false,
+    execute: async (args) => {
+        return fetchInterviewContext(args);
+    },
+};

package/dist/agent/tools/interview.d.ts

@@ -0,0 +1,13 @@
+/**
+ * start_interview tool — launches a live `cv interview` session
+ * from within the agent REPL.
+ *
+ * The tool spawns the interview subprocess with the terminal attached
+ * (stdio: "inherit") so the user gets the full interactive voice/text
+ * experience without leaving the agent session.  When the interview ends
+ * the agent picks up again and can discuss results, next steps, etc.
+ */
+import { Tool } from "../Tool.js";
+export declare const StartInterviewTool: Tool;
+export declare const ALL_INTERVIEW_TOOLS: Tool[];
+//# sourceMappingURL=interview.d.ts.map

package/dist/agent/tools/interview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interview.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/interview.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAoFlC,eAAO,MAAM,kBAAkB,EAAE,IAqEhC,CAAC;AAIF,eAAO,MAAM,mBAAmB,EAAE,IAAI,EAAoD,CAAC"}

package/dist/agent/tools/interview.js

@@ -0,0 +1,141 @@
+/**
+ * start_interview tool — launches a live `cv interview` session
+ * from within the agent REPL.
+ *
+ * The tool spawns the interview subprocess with the terminal attached
+ * (stdio: "inherit") so the user gets the full interactive voice/text
+ * experience without leaving the agent session.  When the interview ends
+ * the agent picks up again and can discuss results, next steps, etc.
+ */
+import { spawn } from "child_process";
+import { Type } from "@google/genai";
+/** Resolve the `cv` binary that is currently running this process. */
+function getCvBin() {
+    // process.argv[1] is the entry-point JS file.
+    // When installed globally via npm, `cv` is a shell wrapper that calls
+    // the same binary — we can just re-use process.argv[0] (node) + argv[1].
+    // But the cleanest approach is to call the same node + script directly.
+    return process.argv[1]; // absolute path to dist/index.js
+}
+async function runInterview(args) {
+    return new Promise((resolve) => {
+        const argv = [
+            getCvBin(),
+            "interview",
+            "--role", args.role,
+        ];
+        if (args.mode === "text")
+            argv.push("--text");
+        if (args.questions && args.questions > 0) {
+            argv.push("--questions", String(args.questions));
+        }
+        if (args.resume_id)
+            argv.push("--resume", args.resume_id);
+        // Clear current line + move to fresh line before the interview TUI takes over.
+        // This prevents any leftover cursor text from flashing during the session.
+        process.stdout.write("\r\x1b[K\n");
+        // ── SIGINT isolation ─────────────────────────────────────────────────
+        // When the user presses Ctrl+C during the interview:
+        //   - SIGINT is sent to the whole process group (parent agent + child)
+        //   - The child (cv interview) handles it: billing → feedback report → exit 0
+        //   - The parent MUST ignore it, otherwise it terminates and kills the child
+        //     before the report is generated and shown.
+        // We suppress SIGINT on the agent for the lifetime of the subprocess and
+        // restore a default handler once the child exits cleanly.
+        const noop = () => { };
+        process.on("SIGINT", noop); // suppress — child handles it
+        // Inherit the terminal so the full interactive TUI works.
+        const child = spawn(process.execPath, argv, {
+            stdio: "inherit",
+            env: process.env,
+        });
+        const cleanup = () => {
+            // Remove our suppressor so future Ctrl+C in the agent REPL works normally.
+            process.removeListener("SIGINT", noop);
+        };
+        child.on("close", (code) => {
+            cleanup();
+            // code === null means killed by signal (e.g. SIGINT handled by child itself).
+            // The child always does billing + report before exiting, so treat as completed.
+            if (code === 0 || code === null) {
+                resolve(`✅ Interview session for "${args.role}" completed.\n` +
+                    `The user has received their feedback report above.\n` +
+                    `You may now discuss their performance, suggest areas for improvement, ` +
+                    `help them prep specific STAR stories, or start another session.`);
+            }
+            else {
+                resolve(`⚠️  Interview session ended with exit code ${code}.\n` +
+                    `This may mean the session was cut short before the report was generated. ` +
+                    `Ask if they'd like to start another session or discuss their responses.`);
+            }
+        });
+        child.on("error", (err) => {
+            cleanup();
+            resolve(`❌ Failed to launch interview session: ${err.message}`);
+        });
+    });
+}
+export const StartInterviewTool = {
+    name: "start_interview",
+    description: `Launch a live AI mock interview session for the user.
+
+Use this tool when the user says ANYTHING like:
+- "Start an interview", "practice interview", "mock interview"
+- "Interview me for [role]", "prep me for [company] interview"
+- "I have an interview at [company], let's practice"
+- "Start a voice interview", "text interview"
+
+⚠️  MANDATORY PRE-FLIGHT — before calling this tool, you MUST know:
+1. **role** — which job role to interview for (ask if not mentioned)
+2. **mode** — ALWAYS ask the user: "Voice (real-time speech, requires sox) or Text?"
+   Never assume voice. Some users are on servers, don't have a mic, or prefer text.
+   Only skip asking if the user already said 'voice' or 'text' in their message.
+3. **questions** — optional, default 5 (no need to ask unless user wants to customize)
+
+Example pre-flight:
+  User: "Can I take an interview?"
+  You:  "Sure! What role are you interviewing for, and would you prefer Voice or Text mode?"
+  User: "Senior SWE, voice please."
+  You:  → call start_interview(role="Senior Software Engineer", mode="voice")
+
+HOW IT WORKS:
+- Launches the full interactive \`cv interview\` session directly in the terminal.
+- The user speaks (voice mode) or types (text mode) their answers to Vivid, the AI interviewer.
+- At the end, a feedback report with scores and improvement tips is displayed automatically.
+- You (the agent) can then discuss results, coach on weak areas, help build STAR stories, etc.
+
+CREDIT COST: 2 credits/minute (minimum 2, capped at 60). Text mode uses ~1 credit flat.
+
+DEFAULTS:
+- mode defaults to "voice" (requires sox). Suggest "text" if user is on a server / no mic.
+- questions defaults to 5.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            role: {
+                type: Type.STRING,
+                description: "The job role to interview for, e.g. 'Senior Software Engineer', 'Product Manager', 'Data Scientist'.",
+            },
+            mode: {
+                type: Type.STRING,
+                enum: ["voice", "text"],
+                description: "Interview mode. 'voice' = real-time speech (default, requires sox). 'text' = text-only fallback.",
+            },
+            questions: {
+                type: Type.INTEGER,
+                description: "Number of interview questions to generate (1–10). Default: 5.",
+            },
+            resume_id: {
+                type: Type.STRING,
+                description: "Optional. CareerVivid resume ID to load as context. The AI will tailor questions to the user's actual background.",
+            },
+        },
+        required: ["role"],
+    },
+    requiresConfirmation: false,
+    execute: async (args) => {
+        return runInterview(args);
+    },
+};
+import { FetchInterviewContextTool } from "./fetchInterviewContext.js";
+export const ALL_INTERVIEW_TOOLS = [StartInterviewTool, FetchInterviewContextTool];

package/dist/commands/admin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * cv admin — Admin-only commands: log inspection, audit, diagnostics.
+ *
+ * Usage:
+ *   cv admin logs                             Last 100 events across all features
+ *   cv admin logs --feature interview          Interview events only
+ *   cv admin logs --feature interview --level error  Errors only
+ *   cv admin logs --uid <userId>               Events for a specific user
+ *   cv admin logs --since 2025-01-01           Events since a date
+ *   cv admin logs --limit 50                   Custom limit (max 500)
+ *   cv admin logs --json                       Raw JSON output (pipe-friendly)
+ *
+ * Access: requires `role: "admin"` on the caller's Firestore user document.
+ * Feature logs are written by cli/src/lib/logger.ts and stored in Firestore cliLogs.
+ */
+import { Command } from "commander";
+export declare function registerAdminCommand(program: Command): void;
+//# sourceMappingURL=admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/commands/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6FpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoH3D"}