careervivid 2.0.0 → 2.1.1

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.0](https://img.shields.io/badge/version-2.0-6366f1?logo=sparkles)](https://www.npmjs.com/package/careervivid)
+[![v2.1.1](https://img.shields.io/badge/version-2.1.1-6366f1?logo=sparkles)](https://www.npmjs.com/package/careervivid)
 
 ---
 
@@ -94,6 +94,15 @@ cv interview --questions 7                     # custom question count (default
    - 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 |

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,QAgDvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA4CjB,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;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

@@ -135,6 +135,16 @@ NEVER share a link without verifying it first.
   - 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)
@@ -182,7 +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 | start_interview             |
+| 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)

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.map

@@ -1 +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;AA4DlC,eAAO,MAAM,kBAAkB,EAAE,IAwDhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,IAAI,EAAyB,CAAC"}
+{"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

@@ -31,25 +31,46 @@ async function runInterview(args) {
         }
         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) => {
-            if (code === 0) {
+            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 ?? "unknown"}.\n` +
-                    `This is normal if the user pressed Ctrl+C to end early. ` +
+                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}`);
         });
     });
@@ -64,6 +85,19 @@ Use this tool when the user says ANYTHING like:
 - "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.
@@ -103,4 +137,5 @@ DEFAULTS:
         return runInterview(args);
     },
 };
-export const ALL_INTERVIEW_TOOLS = [StartInterviewTool];
+import { FetchInterviewContextTool } from "./fetchInterviewContext.js";
+export const ALL_INTERVIEW_TOOLS = [StartInterviewTool, FetchInterviewContextTool];

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,CAskBf"}
+{"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"}

package/dist/commands/agent/repl.js

@@ -349,6 +349,13 @@ ${label}
                     if (confirm.ok !== "Yes, close it")
                         return false;
                 }
+                // Tools that take over the full terminal must NOT have a spinner running —
+                // the concurrent ora redraw causes constant flashing.
+                if (name === "start_interview") {
+                    // Clear current line so any previous UI is gone, then yield terminal cleanly.
+                    process.stdout.write("\r\x1b[K");
+                    return true;
+                }
                 currentSpinner = ora(`Running ${chalk.bold(name)}...`).start();
                 return true;
             };
@@ -357,6 +364,10 @@ ${label}
                     currentSpinner.succeed(chalk.dim(`Done`));
                     currentSpinner = null;
                 }
+                if (name === "start_interview") {
+                    // Interview already printed its own output — just add a separator.
+                    console.log(chalk.dim("─".repeat(50)));
+                }
                 // #4 Audit log — record every completed tool call
                 // durationMs is approximate since we don't have exact start time here
                 auditLog({
@@ -467,8 +478,11 @@ ${label}
                         const tool = tools.find((t) => t.name === fc.name);
                         let out;
                         try {
+                            // start_interview is an interactive long-running session — never apply a timeout to it.
                             out = tool
-                                ? await withTimeout(tool.execute(fc.args), 45_000, `tool:${fc.name}`)
+                                ? fc.name === "start_interview"
+                                    ? await tool.execute(fc.args)
+                                    : await withTimeout(tool.execute(fc.args), 45_000, `tool:${fc.name}`)
                                 : { error: "Tool not found" };
                         }
                         catch (e) {

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

@@ -1 +1 @@
-{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/toolRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAyO3C,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,EAAE,CAiDhG"}
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/toolRegistry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAyO3C,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,EAAE,CAoDhG"}

package/dist/commands/agent/toolRegistry.js

@@ -268,6 +268,10 @@ export function getTools(options) {
             if (!tools.find((x) => x.name === t.name))
                 tools.push(t);
         }
+        for (const t of ALL_INTERVIEW_TOOLS) {
+            if (!tools.find((x) => x.name === t.name))
+                tools.push(t);
+        }
         return tools;
     }
     // Default coding mode: file system + publish tools

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;AA4rBpC,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;AAkvBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG/D"}

package/dist/commands/interview.js

@@ -47,6 +47,9 @@ const CLI_TOKEN_URL = process.env.CV_FUNCTIONS_URL
 const CLI_BILL_URL = process.env.CV_FUNCTIONS_URL
     ? `${process.env.CV_FUNCTIONS_URL}/cliInterviewBill`
     : "https://us-west1-jastalk-firebase.cloudfunctions.net/cliInterviewBill";
+const CLI_CONTEXT_URL = process.env.CV_FUNCTIONS_URL
+    ? `${process.env.CV_FUNCTIONS_URL}/cliGetInterviewContext`
+    : "https://us-west1-jastalk-firebase.cloudfunctions.net/cliGetInterviewContext";
 const LIVE_MODEL = "gemini-3.1-flash-live-preview";
 const FEEDBACK_MODEL = "gemini-2.5-flash";
 const END_TOKEN = "<END_INTERVIEW>";
@@ -213,15 +216,22 @@ async function getGeminiToken(role) {
 }
 // ─── Duration Billing ─────────────────────────────────────────────────────────
 /** Call cliInterviewBill at session end. Returns credit summary for display. */
-async function billSession(sessionId) {
+async function billSession(sessionId, payload) {
     const apiKey = getApiKey();
     if (!apiKey || !sessionId)
         return null;
     try {
+        const body = { apiKey, sessionId };
+        if (payload?.transcript && payload.transcript.length > 0) {
+            body.transcript = payload.transcript;
+        }
+        if (payload?.feedbackReport) {
+            body.feedbackReport = payload.feedbackReport;
+        }
         const res = await fetch(CLI_BILL_URL, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ apiKey, sessionId }),
+            body: JSON.stringify(body),
         });
         if (!res.ok)
             return null;
@@ -523,9 +533,37 @@ async function runVoiceSession(opts) {
     await new Promise(r => setTimeout(r, 800));
     const sessionDurationMs = Date.now() - sessionStart;
     // ── Bill session (duration-based, 10s timeout to prevent hang) ──────
+    // We delay billing until AFTER the feedback report is generated so we
+    // can persist the transcript + report in the same request.
+    const userTurns = transcript.filter(t => t.speaker === "user").length;
+    log.info("session_end", { sessionId, userTurns, aiTurns: transcript.filter(t => t.speaker === "ai").length, sessionDurationMs });
+    if (userTurns < 1) {
+        printSystem("Not enough conversation to generate a feedback report.");
+        // Still bill the session (minimum charge applies)
+        const billSpinner = ora(chalk.dim("Calculating session cost...")).start();
+        const bill = await Promise.race([
+            billSession(sessionId),
+            new Promise(r => setTimeout(() => r(null), 10_000)),
+        ]);
+        bill ? billSpinner.succeed(chalk.dim(`${bill.durationMinutes}min · ${bill.creditsCharged} credits`)) : billSpinner.warn("Could not calculate cost.");
+        await log.dispose();
+        return;
+    }
+    console.log(chalk.dim("\n  Generating your personalized feedback report..."));
+    let report = null;
+    try {
+        report = await analyzeTranscript(transcript, role);
+        printReport(report);
+        log.info("feedback_complete", { sessionId, overallScore: report.overallScore });
+    }
+    catch (err) {
+        log.error("feedback_failed", err, { sessionId });
+        console.log(chalk.red(`  Failed to generate feedback: ${err.message}`));
+    }
+    // ── Bill + persist transcript/report together ────────────────────────
     const billSpinner = ora(chalk.dim("Calculating session cost...")).start();
     const bill = await Promise.race([
-        billSession(sessionId),
+        billSession(sessionId, { transcript, feedbackReport: report }),
         new Promise(r => setTimeout(() => r(null), 10_000)),
     ]);
     if (bill) {
@@ -543,27 +581,10 @@ async function runVoiceSession(opts) {
         billSpinner.warn(chalk.dim("Session cost could not be calculated (timeout)."));
         log.warn("billing_timeout", { sessionId, sessionDurationMs });
     }
-    // ── Feedback report ──────────────────────────────────────────────────
-    const userTurns = transcript.filter(t => t.speaker === "user").length;
-    log.info("session_end", { sessionId, userTurns, aiTurns: transcript.filter(t => t.speaker === "ai").length, sessionDurationMs });
-    if (userTurns < 1) {
-        printSystem("Not enough conversation to generate a feedback report.");
-        await log.dispose();
-        return;
-    }
-    console.log(chalk.dim("\n  Generating your personalized feedback report..."));
-    try {
-        const report = await analyzeTranscript(transcript, role);
-        printReport(report);
-        log.info("feedback_complete", { sessionId, overallScore: report.overallScore });
-    }
-    catch (err) {
-        log.error("feedback_failed", err, { sessionId });
-        console.log(chalk.red(`  Failed to generate feedback: ${err.message}`));
-    }
-    finally {
-        await log.dispose();
+    if (report) {
+        console.log(chalk.dim("\n  💡 Interview context saved. Ask \`cv agent\` to coach you on your answers."));
     }
+    await log.dispose();
 }
 // ─── TEXT SESSION (fallback) ──────────────────────────────────────────────────
 async function runTextSession(opts) {
@@ -631,13 +652,33 @@ async function runTextSession(opts) {
         return;
     }
     console.log(chalk.dim("\n  Generating your personalized feedback report..."));
+    let textReport = null;
     try {
-        const report = await analyzeTranscript(transcript, role);
-        printReport(report);
+        textReport = await analyzeTranscript(transcript, role);
+        printReport(textReport);
     }
     catch (err) {
         console.log(chalk.red(`  Failed to generate feedback: ${err.message}`));
     }
+    // Persist transcript + report to Firestore for agent coaching (fire-and-forget)
+    const apiKey = getApiKey();
+    if (apiKey && textReport) {
+        fetch(CLI_BILL_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                apiKey,
+                // Text mode has no billable sessionId — use a stub that won't match
+                // a real session. The function will 404, but the persist path still runs.
+                // A proper text-mode session doc would require cliGetInterviewToken for text too.
+                // For now, persist to a synthetic doc under a well-known pattern.
+                sessionId: `text_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+                transcript,
+                feedbackReport: textReport,
+            }),
+        }).catch(() => { });
+        console.log(chalk.dim("\n  💡 Interview context saved. Ask `cv agent` to coach you on your answers."));
+    }
 }
 // ─── Command Registration ─────────────────────────────────────────────────────
 export function registerInterviewCommand(program) {

package/dist/index.js

@@ -80,7 +80,9 @@ registerResumesCommand(program);
 registerReferralCommand(program);
 registerEvalCommand(program);
 registerInterviewCommand(program);
-registerAdminCommand(program);
+if (process.env.CV_ADMIN === "true") {
+    registerAdminCommand(program);
+}
 // Shortcuts for whiteboard creation
 registerNewCommand(program);
 registerListTemplatesCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "careervivid",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Official CLI for CareerVivid — AI voice interviews, autonomous job applications, resume editing, and portfolio publishing from your terminal",
   "type": "module",
   "bin": {