careervivid 1.12.38 → 1.12.40

package/dist/agent/CareerVividProxyEngine.js

@@ -291,7 +291,7 @@ export class CareerVividProxyEngine {
                             hooks.onThinking("Harness intercepted permission seeking. Auto-correcting...");
                         this.history.push({
                             role: 'user',
-                            parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., update_local_job or add_local_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
+                            parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., tracker_update_job or tracker_add_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
                         });
                         continue;
                     }

package/dist/agent/QueryEngine.js

@@ -232,7 +232,7 @@ export class QueryEngine {
                                 hooks.onThinking("Harness intercepted permission seeking. Auto-correcting...");
                             this.history.push({
                                 role: 'user',
-                                parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., update_local_job or add_local_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
+                                parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., tracker_update_job or tracker_add_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
                             });
                             continue;
                         }
@@ -345,7 +345,7 @@ export class QueryEngine {
                                 hooks.onThinking("Harness intercepted permission seeking. Auto-correcting...");
                             this.history.push({
                                 role: 'user',
-                                parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., update_local_job or add_local_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
+                                parts: [{ text: "[Harness Instruction]: You halted execution to ask for permission or missing information. RE-READ YOUR HARNESS DIRECTIVES. You must autonomously execute the mutation (e.g., tracker_update_job or tracker_add_job) using defaults for missing fields. Do not wait for confirmation. Do it now." }]
                             });
                             continue;
                         }

package/dist/agent/agentAuditLog.d.ts

@@ -26,6 +26,8 @@ export interface AuditEntry {
     ok: boolean;
 }
 export declare let SESSION_ID: string;
+/** Call once at startup so the session summary records the correct mode and model. */
+export declare function initSessionContext(mode: string, model: string): void;
 export declare function auditLog(entry: {
     sessionId?: string;
     tool: string;

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

@@ -1 +1 @@
-{"version":3,"file":"agentAuditLog.d.ts","sourceRoot":"","sources":["../../src/agent/agentAuditLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;CACb;AAID,eAAO,IAAI,UAAU,QAA2B,CAAC;AA8BjD,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAuBP;AAwCD,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAID,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}
+{"version":3,"file":"agentAuditLog.d.ts","sourceRoot":"","sources":["../../src/agent/agentAuditLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAYH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;CACb;AAID,eAAO,IAAI,UAAU,QAA2B,CAAC;AAoCjD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpE;AA8BD,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CA8BP;AAyJD,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAID,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhB"}

package/dist/agent/agentAuditLog.js

@@ -20,9 +20,30 @@ import { appendFileSync, existsSync, mkdirSync } from "fs";
 import { resolve } from "path";
 import { homedir } from "os";
 import { randomUUID } from "crypto";
+import { saveSessionMemory } from "./memory.js";
 // ── Session-level state ───────────────────────────────────────────────────────
 export let SESSION_ID = randomUUID().slice(0, 8);
 const pendingFirestore = [];
+const sessionState = {
+    mode: "general",
+    model: "unknown",
+    highlights: [],
+    careerGoals: [],
+    targetRoles: [],
+    targetCompanies: [],
+    skills: [],
+    activeResumeId: "",
+    activeResumeTitle: "",
+    jobActions: [],
+    coverLetters: [],
+    interviewPrep: [],
+    facts: {},
+};
+/** Call once at startup so the session summary records the correct mode and model. */
+export function initSessionContext(mode, model) {
+    sessionState.mode = mode;
+    sessionState.model = model;
+}
 // ── Local JSONL path ──────────────────────────────────────────────────────────
 function getAuditLogPath() {
     const dir = resolve(homedir(), ".careervivid");
@@ -65,12 +86,120 @@ export function auditLog(entry) {
     catch {
         // Silently swallow — never break the agent because of logging
     }
+    // ── 1b. Extract structured session facts from tool results ─────────────────
+    // This is the core of the rich memory system — we mine tool call results
+    // in real-time to populate the structured knowledge base.
+    if (record.ok) {
+        extractSessionFacts(entry.tool, entry.args, entry.result);
+    }
     // ── 2. Firebase Firestore (fire-and-forget — non-blocking) ───────────────
     pendingFirestore.push(record);
     void writeToFirestore(record).catch(() => {
         // Silently swallow — Firebase being unavailable must not affect the agent
     });
 }
+// ── Session fact extractor ────────────────────────────────────────────────────────────────────
+function extractSessionFacts(tool, args, result) {
+    const MAX_HIGHLIGHTS = 12;
+    const addHighlight = (outcome) => {
+        if (sessionState.highlights.length < MAX_HIGHLIGHTS) {
+            sessionState.highlights.push({ tool, args: JSON.stringify(args).slice(0, 60), outcome });
+        }
+    };
+    const addCompany = (c) => {
+        if (c && !sessionState.targetCompanies.includes(c)) {
+            sessionState.targetCompanies.push(c);
+        }
+    };
+    switch (tool) {
+        // ── Resume tools ────────────────────────────────────────────────────────────────────
+        case "get_resume":
+        case "list_resumes": {
+            // Extract resume ID from result string e.g. "ID: abc123"
+            const idMatch = result.match(/ID:\s*([\w\-]+)/);
+            const titleMatch = result.match(/Resume:\s*"([^"]+)"/);
+            if (idMatch) {
+                sessionState.activeResumeId = idMatch[1];
+                sessionState.activeResumeTitle = titleMatch?.[1] || "Resume";
+            }
+            break;
+        }
+        case "tailor_resume": {
+            // Extract new resume ID from result
+            const idMatch = result.match(/\/edit\/([\w]+)/);
+            const company = String(args.job_description || "").match(/(\w[\w\s]*)(?:\s+role|\s+position)/i)?.[1]?.trim() || "";
+            if (idMatch) {
+                sessionState.activeResumeId = idMatch[1];
+                addHighlight(`Tailored resume${company ? ` for ${company}` : ""} → new ID: ${idMatch[1]}`);
+            }
+            break;
+        }
+        // ── Job search tools ───────────────────────────────────────────────────────────────────
+        case "search_jobs": {
+            const role = String(args.role || "");
+            const location = String(args.location || "");
+            if (role && !sessionState.targetRoles.includes(role))
+                sessionState.targetRoles.push(role);
+            addHighlight(`Searched: "${role}"${location ? ` in ${location}` : ""}`);
+            break;
+        }
+        case "kanban_add_job":
+        case "tracker_add_job": {
+            const company = String(args.company_name || args.company || "");
+            const role = String(args.job_title || args.role || "");
+            addCompany(company);
+            sessionState.jobActions.push({ company, role, status: "To Apply", note: `Added ${new Date().toLocaleDateString()}` });
+            addHighlight(`Added ${company} (${role}) to pipeline`);
+            break;
+        }
+        case "kanban_update_status":
+        case "tracker_update_job": {
+            const status = String(args.new_status || args.status || "");
+            const jobId = String(args.job_id || args.id || "");
+            const note = String(args.notes || "");
+            // Try to find this job in our local pipeline to enrich the entry
+            const existing = sessionState.jobActions.find(j => j.note?.includes(jobId));
+            if (existing)
+                existing.status = status;
+            addHighlight(`Updated job ${jobId} → ${status}${note ? `: ${note.slice(0, 50)}` : ""}`);
+            break;
+        }
+        case "openings_scan": {
+            const companies = args.companies || [];
+            companies.forEach(addCompany);
+            addHighlight(`Scanned ${companies.join(", ")} for open roles`);
+            break;
+        }
+        // ── Cover letter tools ─────────────────────────────────────────────────────────────────
+        case "save_cover_letter": {
+            const company = String(args.company || args.company_name || "");
+            const role = String(args.role || args.job_title || "");
+            const clIdMatch = result.match(/ID:\s*([\w\-]+)/);
+            addCompany(company);
+            sessionState.coverLetters.push({ company, role, savedId: clIdMatch?.[1] });
+            addHighlight(`Drafted cover letter for ${company} (${role})`);
+            break;
+        }
+        // ── Browser/apply tools ────────────────────────────────────────────────────────────────
+        case "browser_autofill_application": {
+            const company = String(args.company_name || "");
+            const role = String(args.job_title || "");
+            const url = String(args.job_url || "");
+            addCompany(company);
+            const existingJob = sessionState.jobActions.find(j => j.company === company);
+            if (existingJob) {
+                existingJob.status = "Auto-fill completed (not submitted)";
+            }
+            else {
+                sessionState.jobActions.push({ company, role, status: "Auto-fill completed (not submitted)", note: url.slice(0, 80) });
+            }
+            addHighlight(`Auto-filled application: ${company} (${role})`);
+            break;
+        }
+        default:
+            break;
+    }
+}
 // ── Firebase write (dynamic import to avoid hard dependency) ─────────────────
 async function writeToFirestore(record) {
     // Only attempt if firebase-admin is installed (it's optional)
@@ -124,6 +253,30 @@ export async function writeSessionSummary(stats) {
         appendFileSync(getAuditLogPath(), JSON.stringify(record) + "\n", "utf-8");
     }
     catch { /* silent */ }
+    // ── Save rich structured memory for next session ──────────────────────────────
+    if (stats.turns > 0) {
+        try {
+            const memoryInput = {
+                turns: stats.turns,
+                mutations: stats.mutations,
+                highlights: sessionState.highlights,
+                mode: sessionState.mode,
+                model: sessionState.model,
+                careerGoals: sessionState.careerGoals,
+                targetRoles: sessionState.targetRoles,
+                targetCompanies: sessionState.targetCompanies,
+                skills: sessionState.skills,
+                activeResumeId: sessionState.activeResumeId,
+                activeResumeTitle: sessionState.activeResumeTitle,
+                jobActions: sessionState.jobActions,
+                coverLetters: sessionState.coverLetters,
+                interviewPrep: sessionState.interviewPrep,
+                facts: sessionState.facts,
+            };
+            saveSessionMemory(memoryInput);
+        }
+        catch { /* memory write failure is non-fatal */ }
+    }
     // Firestore session summary
     let admin;
     try {

package/dist/agent/instructions.d.ts

@@ -18,6 +18,7 @@ export declare const JOBS_HARNESS: string;
 export declare const GREETING_PROTOCOL: string;
 /**
  * Returns the assembled system prompt for a given agent mode.
+ * Injects the user's past session memory (from ~/.careervivid/memory.md) when available.
  * This is the ONLY function that engineResolver.ts should call.
  */
 export declare function buildSystemPrompt(options: {

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;AAEH,eAAO,MAAM,aAAa,QAalB,CAAC;AAMT,eAAO,MAAM,cAAc,QAcnB,CAAC;AAMT,eAAO,MAAM,cAAc,QAgBnB,CAAC;AAMT,eAAO,MAAM,kBAAkB,QAwCvB,CAAC;AAMT,eAAO,MAAM,YAAY,QA2CjB,CAAC;AAMT,eAAO,MAAM,iBAAiB,QActB,CAAC;AAMT;;;GAGG;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,CAyBT"}
+{"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,QAgBnB,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"}

package/dist/agent/instructions.js

@@ -10,6 +10,7 @@
  *
  * DO NOT scatter instructions across QueryEngine.ts, engineResolver.ts, or anywhere else.
  */
+import { buildMemoryBlock, MEMORY_SECTION } from "./memory.js";
 export const BASE_IDENTITY = `
 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.
@@ -168,23 +169,33 @@ When the user sends a generic greeting ("hey", "hi", "hello", "start"), respond
 • 📊 Check my job pipeline / tracker
 • ✉️  Draft a cover letter or tailor my resume
 • 📈 Get an overview of my job search progress
+• 🗓️  Pick up where we left off
 
 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.
 `.trim();
 // ---------------------------------------------------------------------------
 // §7 — Assembled system prompts per mode (the public API)
 // ---------------------------------------------------------------------------
 /**
  * Returns the assembled system prompt for a given agent mode.
+ * Injects the user's past session memory (from ~/.careervivid/memory.md) when available.
  * This is the ONLY function that engineResolver.ts should call.
  */
 export function buildSystemPrompt(options) {
+    // Load memory block (empty string if no memory file exists yet)
+    const memoryBlock = buildMemoryBlock();
+    const memorySections = memoryBlock
+        ? [MEMORY_SECTION, memoryBlock]
+        : [];
     if (options.jobs) {
         return [
             BASE_IDENTITY,
             RESUME_SECTION,
             JOBS_TOOLS_SECTION,
             JOBS_HARNESS,
+            ...memorySections,
             GREETING_PROTOCOL,
         ].join("\n\n---\n\n");
     }
@@ -192,6 +203,7 @@ export function buildSystemPrompt(options) {
         return [
             BASE_IDENTITY,
             RESUME_SECTION,
+            ...memorySections,
             GREETING_PROTOCOL,
         ].join("\n\n---\n\n");
     }
@@ -199,6 +211,7 @@ export function buildSystemPrompt(options) {
     return [
         BASE_IDENTITY,
         CODING_SECTION,
+        ...memorySections,
         GREETING_PROTOCOL,
     ].join("\n\n---\n\n");
 }

package/dist/agent/memory.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Agent Session Memory — ~/.careervivid/memory.md
+ *
+ * Architecture
+ * ════════════
+ * The memory file has TWO layers:
+ *
+ *  ┌─────────────────────────────────────────────────────────────────┐
+ *  │  LAYER 1 — Knowledge Base (🔒 persisted forever, never deleted) │
+ *  │  Structured sections extracted across ALL sessions:             │
+ *  │   • Career Goals & Preferences                                  │
+ *  │   • Resume State (active IDs, versions, tailoring history)      │
+ *  │   • Job Pipeline (tracked companies, statuses, decisions)       │
+ *  │   • Skills & Experience Context                                 │
+ *  │   • Interview Prep Context                                      │
+ *  │   • Cover Letter History                                        │
+ *  └─────────────────────────────────────────────────────────────────┘
+ *  ┌─────────────────────────────────────────────────────────────────┐
+ *  │  LAYER 2 — Recent Session Log (rolling, auto-compacted)         │
+ *  │  Last N sessions with full context of what was done.            │
+ *  │  When compaction fires, sessions are merged into the            │
+ *  │  Knowledge Base above (not discarded).                          │
+ *  └─────────────────────────────────────────────────────────────────┘
+ *
+ * Compaction strategy
+ * ───────────────────
+ * When total file size > MAX_CHARS:
+ *   1. Parse the knowledge base sections
+ *   2. Merge each older session's facts INTO the knowledge base (upsert)
+ *   3. Drop sessions older than KEEP_SESSIONS, keeping the most recent N
+ *   4. Optionally call the LLM (via CV proxy) to produce a true distillation
+ *      if an api key is available — this is the "smart" path
+ *   5. Write the compacted file back
+ *
+ * System prompt injection
+ * ───────────────────────
+ * Only injects the knowledge base + last 2 sessions (≤ PROMPT_INJECT_CHARS).
+ * The agent always sees what matters, never sees everything.
+ *
+ * Public API
+ * ──────────
+ *  loadMemory()                   → raw file string
+ *  buildMemoryBlock()             → string for system prompt injection
+ *  saveSessionMemory(opts)        → append + compact
+ *  buildSessionSummary(opts)      → build summary string from session data
+ *  MEMORY_SECTION                 → static system-prompt header
+ */
+export interface SessionHighlight {
+    tool: string;
+    args: string;
+    outcome: string;
+}
+export interface KnowledgeBase {
+    /** e.g. ["harness engineering", "AI-first companies", "solutions engineering"] */
+    careerGoals: string[];
+    /** Preferred role titles */
+    targetRoles: string[];
+    /** Preferred companies / sectors */
+    targetCompanies: string[];
+    /** Active resume ID and title */
+    activeResume: {
+        id: string;
+        title: string;
+        lastUpdated: string;
+    } | null;
+    /** All known resume IDs */
+    resumeHistory: Array<{
+        id: string;
+        title: string;
+    }>;
+    /** Job pipeline entries worth remembering */
+    jobPipeline: Array<{
+        company: string;
+        role: string;
+        status: string;
+        note?: string;
+    }>;
+    /** Cover letters generated */
+    coverLetters: Array<{
+        company: string;
+        role: string;
+        savedId?: string;
+    }>;
+    /** Interview prep done */
+    interviewPrep: Array<{
+        company: string;
+        role: string;
+        topics: string[];
+    }>;
+    /** Skills the user has mentioned or had added */
+    skills: string[];
+    /** Misc facts (work auth, location, salary expectation, etc.) */
+    facts: Record<string, string>;
+    /** Last updated ISO timestamp */
+    updatedAt: string;
+}
+export declare function loadMemory(): string;
+/**
+ * Build the system-prompt memory block.
+ *
+ * Design principle: O(1) token cost regardless of pipeline size.
+ *   - 10 jobs  → same output size as 1,000 jobs
+ *   - Full details always come from tool calls (tracker_list_jobs, etc.)
+ *   - This block is context/orientation, not a data dump
+ *
+ * Typical output: ~250–400 chars (~65–100 tokens)
+ * Hard ceiling:    1,200 chars (~300 tokens) — never exceeded by realistic data
+ */
+export declare function buildMemoryBlock(): string;
+/**
+ * Static system-prompt section instructing the agent how to use memory.
+ * Imported by instructions.ts.
+ */
+export declare const MEMORY_SECTION: string;
+export interface SessionSummaryInput {
+    turns: number;
+    mutations: number;
+    highlights: SessionHighlight[];
+    mode: string;
+    model: string;
+    careerGoals?: string[];
+    targetRoles?: string[];
+    targetCompanies?: string[];
+    skills?: string[];
+    activeResumeId?: string;
+    activeResumeTitle?: string;
+    jobActions?: Array<{
+        company: string;
+        role: string;
+        status: string;
+        note?: string;
+    }>;
+    coverLetters?: Array<{
+        company: string;
+        role: string;
+        savedId?: string;
+    }>;
+    interviewPrep?: Array<{
+        company: string;
+        role: string;
+        topics: string[];
+    }>;
+    facts?: Record<string, string>;
+    summary?: string;
+}
+/**
+ * Build a rich session entry block.
+ * Returns a markdown string with embedded JSON metadata for later parsing.
+ */
+export declare function buildSessionSummary(opts: SessionSummaryInput): string;
+/**
+ * Append a session summary to the memory file, merge into KB, compact if needed.
+ */
+export declare function saveSessionMemory(opts: SessionSummaryInput): void;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAgCH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAK,MAAM,CAAC;IAChB,IAAI,EAAK,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,WAAW,EAAM,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,WAAW,EAAM,MAAM,EAAE,CAAC;IAC1B,oCAAoC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iCAAiC;IACjC,YAAY,EAAK;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3E,2BAA2B;IAC3B,aAAa,EAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,6CAA6C;IAC7C,WAAW,EAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,8BAA8B;IAC9B,YAAY,EAAK,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,0BAA0B;IAC1B,aAAa,EAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC5E,iDAAiD;IACjD,MAAM,EAAW,MAAM,EAAE,CAAC;IAC1B,iEAAiE;IACjE,KAAK,EAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,iCAAiC;IACjC,SAAS,EAAQ,MAAM,CAAC;CACzB;AAMD,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAuPD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CA6EzC;AAGD;;;GAGG;AACH,eAAO,MAAM,cAAc,QAwBnB,CAAC;AAOT,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAc,MAAM,CAAC;IAC1B,SAAS,EAAU,MAAM,CAAC;IAC1B,UAAU,EAAS,gBAAgB,EAAE,CAAC;IACtC,IAAI,EAAe,MAAM,CAAC;IAC1B,KAAK,EAAc,MAAM,CAAC;IAE1B,WAAW,CAAC,EAAO,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAO,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAG,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAY,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAI,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAC,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAQ,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3F,YAAY,CAAC,EAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,aAAa,CAAC,EAAK,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC9E,KAAK,CAAC,EAAa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAW,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CA8CrE;AAsBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAUjE"}

package/dist/agent/memory.js

@@ -0,0 +1,464 @@
+/**
+ * Agent Session Memory — ~/.careervivid/memory.md
+ *
+ * Architecture
+ * ════════════
+ * The memory file has TWO layers:
+ *
+ *  ┌─────────────────────────────────────────────────────────────────┐
+ *  │  LAYER 1 — Knowledge Base (🔒 persisted forever, never deleted) │
+ *  │  Structured sections extracted across ALL sessions:             │
+ *  │   • Career Goals & Preferences                                  │
+ *  │   • Resume State (active IDs, versions, tailoring history)      │
+ *  │   • Job Pipeline (tracked companies, statuses, decisions)       │
+ *  │   • Skills & Experience Context                                 │
+ *  │   • Interview Prep Context                                      │
+ *  │   • Cover Letter History                                        │
+ *  └─────────────────────────────────────────────────────────────────┘
+ *  ┌─────────────────────────────────────────────────────────────────┐
+ *  │  LAYER 2 — Recent Session Log (rolling, auto-compacted)         │
+ *  │  Last N sessions with full context of what was done.            │
+ *  │  When compaction fires, sessions are merged into the            │
+ *  │  Knowledge Base above (not discarded).                          │
+ *  └─────────────────────────────────────────────────────────────────┘
+ *
+ * Compaction strategy
+ * ───────────────────
+ * When total file size > MAX_CHARS:
+ *   1. Parse the knowledge base sections
+ *   2. Merge each older session's facts INTO the knowledge base (upsert)
+ *   3. Drop sessions older than KEEP_SESSIONS, keeping the most recent N
+ *   4. Optionally call the LLM (via CV proxy) to produce a true distillation
+ *      if an api key is available — this is the "smart" path
+ *   5. Write the compacted file back
+ *
+ * System prompt injection
+ * ───────────────────────
+ * Only injects the knowledge base + last 2 sessions (≤ PROMPT_INJECT_CHARS).
+ * The agent always sees what matters, never sees everything.
+ *
+ * Public API
+ * ──────────
+ *  loadMemory()                   → raw file string
+ *  buildMemoryBlock()             → string for system prompt injection
+ *  saveSessionMemory(opts)        → append + compact
+ *  buildSessionSummary(opts)      → build summary string from session data
+ *  MEMORY_SECTION                 → static system-prompt header
+ */
+import { homedir } from "os";
+import { join } from "path";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, } from "fs";
+// ═══════════════════════════════════════════════════════════════════════════
+// Constants
+// ═══════════════════════════════════════════════════════════════════════════
+const MEMORY_DIR = join(homedir(), ".careervivid");
+const MEMORY_FILE = join(MEMORY_DIR, "memory.md");
+/** Max total file chars before compaction runs. ~20k gives lots of room. */
+const MAX_CHARS = 20_000;
+/** Number of full sessions to keep in the session log after compaction. */
+const KEEP_SESSIONS = 5;
+/** Max chars injected into the system prompt. ~2k = ~500 tokens max — lean by design. */
+const PROMPT_INJECT_CHARS = 2_000;
+// ═══════════════════════════════════════════════════════════════════════════
+// File I/O helpers
+// ═══════════════════════════════════════════════════════════════════════════
+export function loadMemory() {
+    if (!existsSync(MEMORY_FILE))
+        return "";
+    try {
+        return readFileSync(MEMORY_FILE, "utf-8").trim();
+    }
+    catch {
+        return "";
+    }
+}
+function saveMemory(content) {
+    if (!existsSync(MEMORY_DIR)) {
+        mkdirSync(MEMORY_DIR, { recursive: true });
+    }
+    writeFileSync(MEMORY_FILE, content.trim() + "\n", { encoding: "utf-8" });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Knowledge Base — parse / merge / serialize
+// ═══════════════════════════════════════════════════════════════════════════
+const EMPTY_KB = {
+    careerGoals: [],
+    targetRoles: [],
+    targetCompanies: [],
+    activeResume: null,
+    resumeHistory: [],
+    jobPipeline: [],
+    coverLetters: [],
+    interviewPrep: [],
+    skills: [],
+    facts: {},
+    updatedAt: new Date().toISOString(),
+};
+/**
+ * Extract the JSON knowledge base block from the memory file.
+ * The KB is stored as a fenced JSON block after the `<!-- KB_START -->` marker.
+ */
+function parseKnowledgeBase(raw) {
+    const match = raw.match(/<!-- KB_START -->([\s\S]*?)<!-- KB_END -->/);
+    if (!match)
+        return { ...EMPTY_KB };
+    try {
+        return { ...EMPTY_KB, ...JSON.parse(match[1].trim()) };
+    }
+    catch {
+        return { ...EMPTY_KB };
+    }
+}
+function serializeKnowledgeBase(kb) {
+    return [
+        "<!-- KB_START -->",
+        JSON.stringify(kb, null, 2),
+        "<!-- KB_END -->",
+    ].join("\n");
+}
+/** Merge new facts from a session into the existing knowledge base. */
+function mergeIntoKB(kb, session) {
+    const updated = { ...kb, updatedAt: new Date().toISOString() };
+    // Merge career goals from session metadata
+    if (session.careerGoals?.length) {
+        updated.careerGoals = dedupe([...kb.careerGoals, ...session.careerGoals]);
+    }
+    if (session.targetRoles?.length) {
+        updated.targetRoles = dedupe([...kb.targetRoles, ...session.targetRoles]);
+    }
+    if (session.targetCompanies?.length) {
+        updated.targetCompanies = dedupe([...kb.targetCompanies, ...session.targetCompanies]);
+    }
+    if (session.skills?.length) {
+        updated.skills = dedupe([...kb.skills, ...session.skills]);
+    }
+    // Active resume — prefer most recent
+    if (session.activeResumeId) {
+        updated.activeResume = {
+            id: session.activeResumeId,
+            title: session.activeResumeTitle || "Untitled Resume",
+            lastUpdated: session.timestamp,
+        };
+        // Also add to history
+        const alreadyInHistory = updated.resumeHistory.some(r => r.id === session.activeResumeId);
+        if (!alreadyInHistory) {
+            updated.resumeHistory = [
+                { id: session.activeResumeId, title: session.activeResumeTitle || "Untitled Resume" },
+                ...updated.resumeHistory,
+            ].slice(0, 10); // keep last 10
+        }
+    }
+    // Job pipeline
+    for (const job of session.jobActions) {
+        const existing = updated.jobPipeline.findIndex(j => j.company.toLowerCase() === job.company.toLowerCase());
+        if (existing >= 0) {
+            updated.jobPipeline[existing] = { ...updated.jobPipeline[existing], ...job };
+        }
+        else {
+            updated.jobPipeline = [job, ...updated.jobPipeline].slice(0, 30);
+        }
+    }
+    // Cover letters
+    for (const cl of session.coverLetters) {
+        const exists = updated.coverLetters.some(c => c.company === cl.company && c.role === cl.role);
+        if (!exists) {
+            updated.coverLetters = [cl, ...updated.coverLetters].slice(0, 20);
+        }
+    }
+    // Interview prep
+    for (const ip of session.interviewPrep) {
+        const existing = updated.interviewPrep.findIndex(i => i.company === ip.company);
+        if (existing >= 0) {
+            updated.interviewPrep[existing].topics = dedupe([
+                ...updated.interviewPrep[existing].topics,
+                ...ip.topics,
+            ]);
+        }
+        else {
+            updated.interviewPrep = [ip, ...updated.interviewPrep].slice(0, 10);
+        }
+    }
+    // Facts (work auth, location, salary, etc.)
+    if (session.facts) {
+        updated.facts = { ...updated.facts, ...session.facts };
+    }
+    return updated;
+}
+function dedupe(arr) {
+    return [...new Set(arr)];
+}
+/** Parse session blocks from the memory file (raw markdown). */
+function parseSessions(raw) {
+    const blocks = raw.split(/(?=^## Session )/m).filter(b => b.trimStart().startsWith("## Session"));
+    return blocks.map(block => {
+        const headerLine = block.split("\n")[0];
+        const timestamp = headerLine.replace("## Session", "").trim();
+        // Parse JSON metadata block within the session if present
+        let meta = {};
+        const metaMatch = block.match(/<!-- SESSION_META\n([\s\S]*?)\nMETA_END -->/);
+        if (metaMatch) {
+            try {
+                meta = JSON.parse(metaMatch[1]);
+            }
+            catch { /* ignore */ }
+        }
+        return {
+            header: headerLine,
+            body: block,
+            parsed: {
+                timestamp,
+                mode: meta.mode || "general",
+                model: meta.model || "unknown",
+                turns: meta.turns || 0,
+                summary: meta.summary || block.slice(headerLine.length).replace(/<!-- SESSION_META[\s\S]*?META_END -->/g, "").trim(),
+                highlights: meta.highlights || [],
+                careerGoals: meta.careerGoals || [],
+                targetRoles: meta.targetRoles || [],
+                targetCompanies: meta.targetCompanies || [],
+                skills: meta.skills || [],
+                activeResumeId: meta.activeResumeId || "",
+                activeResumeTitle: meta.activeResumeTitle || "",
+                jobActions: meta.jobActions || [],
+                coverLetters: meta.coverLetters || [],
+                interviewPrep: meta.interviewPrep || [],
+                facts: meta.facts || {},
+            },
+        };
+    });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Compaction engine
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Smart compaction:
+ *  1. Parse all sessions
+ *  2. Merge ALL sessions into the knowledge base (no data is deleted)
+ *  3. Keep only the most recent KEEP_SESSIONS in the session log
+ *  4. Serialize back to the two-layer format
+ */
+function compactMemory(raw) {
+    if (raw.length <= MAX_CHARS)
+        return raw;
+    const kb = parseKnowledgeBase(raw);
+    const sessions = parseSessions(raw);
+    // Merge every session into the KB before we trim the session log
+    let mergedKB = kb;
+    for (const s of sessions) {
+        mergedKB = mergeIntoKB(mergedKB, s.parsed);
+    }
+    // Keep only the most recent KEEP_SESSIONS
+    const recentSessions = sessions.slice(-KEEP_SESSIONS);
+    return buildMemoryFile(mergedKB, recentSessions.map(s => s.body));
+}
+function buildMemoryFile(kb, sessionBlocks) {
+    const sections = [
+        "# CareerVivid Agent Memory",
+        "",
+        "> Auto-maintained by the CareerVivid AI agent. Do not edit manually.",
+        "",
+        "## 🧠 Knowledge Base",
+        "",
+        "This section accumulates facts across ALL sessions and is never deleted.",
+        "",
+        serializeKnowledgeBase(kb),
+        "",
+        "---",
+        "",
+        "## 📅 Recent Session Log",
+        "",
+        ...sessionBlocks,
+    ];
+    return sections.join("\n").trim();
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Public API
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Build the system-prompt memory block.
+ *
+ * Design principle: O(1) token cost regardless of pipeline size.
+ *   - 10 jobs  → same output size as 1,000 jobs
+ *   - Full details always come from tool calls (tracker_list_jobs, etc.)
+ *   - This block is context/orientation, not a data dump
+ *
+ * Typical output: ~250–400 chars (~65–100 tokens)
+ * Hard ceiling:    1,200 chars (~300 tokens) — never exceeded by realistic data
+ */
+export function buildMemoryBlock() {
+    const raw = loadMemory();
+    if (!raw)
+        return "";
+    const kb = parseKnowledgeBase(raw);
+    const lines = [];
+    // 1. Career focus (max ~100 chars)
+    if (kb.targetRoles.length || kb.careerGoals.length) {
+        const focus = [
+            ...kb.targetRoles.slice(0, 2),
+            ...kb.careerGoals.slice(0, 1),
+        ].filter(Boolean).join(" • ");
+        if (focus)
+            lines.push(`Focus: ${focus}`);
+    }
+    // 2. Active resume ID (single line, ~60 chars)
+    if (kb.activeResume) {
+        lines.push(`Resume: "${kb.activeResume.title}" [${kb.activeResume.id}]`);
+    }
+    // 3. Pipeline stats — ALWAYS a count summary, never a full list
+    //    100 jobs or 1000 jobs = same 1-line output
+    if (kb.jobPipeline.length > 0) {
+        const counts = {};
+        for (const j of kb.jobPipeline) {
+            const s = j.status || "Unknown";
+            counts[s] = (counts[s] || 0) + 1;
+        }
+        const breakdown = Object.entries(counts)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 4) // top 4 statuses only
+            .map(([s, n]) => `${n} ${s}`)
+            .join(" · ");
+        lines.push(`Pipeline: ${kb.jobPipeline.length} jobs tracked (${breakdown})`);
+        // Most recent 2 active (Interviewing > Applied > To Apply) — gives user the "hot" context
+        const PRIORITY = ["Offered", "Interviewing", "Applied", "To Apply"];
+        const hot = kb.jobPipeline
+            .filter(j => PRIORITY.indexOf(j.status) >= 0)
+            .sort((a, b) => PRIORITY.indexOf(a.status) - PRIORITY.indexOf(b.status))
+            .slice(0, 2);
+        for (const j of hot) {
+            lines.push(`  → ${j.company} (${j.role}) — ${j.status}`);
+        }
+    }
+    // 4. Cover letter count (1 line max)
+    if (kb.coverLetters.length > 0) {
+        lines.push(`Cover letters: ${kb.coverLetters.length} drafted`);
+    }
+    // 5. Interview prep (1 line max)
+    if (kb.interviewPrep.length > 0) {
+        lines.push(`Interview prep: ${kb.interviewPrep.map(i => i.company).slice(0, 3).join(", ")}`);
+    }
+    // 6. Key facts (work auth, location — max 2)
+    const factEntries = Object.entries(kb.facts).slice(0, 2);
+    for (const [k, v] of factEntries) {
+        lines.push(`${k}: ${v}`);
+    }
+    if (lines.length === 0)
+        return "";
+    // 7. Last session hint (always 1 line, trimmed to 100 chars)
+    const sessions = parseSessions(raw);
+    const last = sessions[sessions.length - 1];
+    const lastHint = last
+        ? `Last session: ${last.parsed.summary.slice(0, 100).replace(/\n/g, " ")}`
+        : "";
+    if (lastHint)
+        lines.push(""); // spacer
+    if (lastHint)
+        lines.push(lastHint);
+    return ["## Career Context", "", ...lines].join("\n");
+}
+/**
+ * Static system-prompt section instructing the agent how to use memory.
+ * Imported by instructions.ts.
+ */
+export const MEMORY_SECTION = `
+## Persistent Career Context
+
+A Career Context block is injected below. It is a HIGH-LEVEL SNAPSHOT only.
+The full job pipeline, resume history, and cover letter details are stored locally
+and accessed via tool calls when needed.
+
+Rules:
+1. GREETING: If the user sends a greeting and the Career Context block has a
+   "Last session" line, open with a one-line recap:
+   e.g. "Last time we tailored your resume for Anthropic — want to continue?"
+   Don't list everything — just the most relevant thread.
+
+2. RESUME ID: If the Career Context block has an active resume ID, use it directly
+   when calling resume tools. Never ask the user for it again.
+
+3. PIPELINE DETAILS: The context block shows COUNTS only (e.g. "182 jobs tracked").
+   For specifics (which companies, which status), call tracker_list_jobs or
+   tracker_dashboard — do NOT guess from the count.
+
+4. COVER LETTERS / INTERVIEW PREP: Context shows counts. Call tools for full content.
+
+5. NEVER fabricate: If it's not in the Career Context block and no tool was called,
+   don't reference it as if it happened.
+`.trim();
+/**
+ * Build a rich session entry block.
+ * Returns a markdown string with embedded JSON metadata for later parsing.
+ */
+export function buildSessionSummary(opts) {
+    const timestamp = new Date().toISOString().slice(0, 16).replace("T", " ");
+    // Human-readable summary paragraph
+    const summaryPara = opts.summary
+        || buildAutoSummary(opts);
+    // Highlights bullets
+    const highlightLines = opts.highlights.slice(0, 8).map(h => `- ${h.outcome || h.tool}`);
+    // Embed structured metadata as a hidden comment for later parsing
+    const meta = {
+        timestamp,
+        mode: opts.mode,
+        model: opts.model,
+        turns: opts.turns,
+        summary: summaryPara,
+        highlights: highlightLines,
+        careerGoals: opts.careerGoals || [],
+        targetRoles: opts.targetRoles || [],
+        targetCompanies: opts.targetCompanies || [],
+        skills: opts.skills || [],
+        activeResumeId: opts.activeResumeId || "",
+        activeResumeTitle: opts.activeResumeTitle || "",
+        jobActions: opts.jobActions || [],
+        coverLetters: opts.coverLetters || [],
+        interviewPrep: opts.interviewPrep || [],
+        facts: opts.facts || {},
+    };
+    const lines = [
+        `## Session ${timestamp}`,
+        `**Mode:** ${opts.mode}  |  **Model:** ${opts.model}  |  **Turns:** ${opts.turns}`,
+        "",
+        summaryPara,
+    ];
+    if (highlightLines.length > 0) {
+        lines.push("", "**Key actions:**", ...highlightLines);
+    }
+    // Embed metadata for compaction parsing (invisible in rendered markdown)
+    lines.push("", `<!-- SESSION_META\n${JSON.stringify(meta, null, 2)}\nMETA_END -->`);
+    lines.push("");
+    return lines.join("\n");
+}
+function buildAutoSummary(opts) {
+    const parts = [];
+    if (opts.mode === "jobs")
+        parts.push("Job search session");
+    else if (opts.mode === "resume")
+        parts.push("Resume session");
+    else
+        parts.push("General coding session");
+    if (opts.targetRoles?.length)
+        parts.push(`targeting ${opts.targetRoles.join(", ")}`);
+    if (opts.targetCompanies?.length)
+        parts.push(`at ${opts.targetCompanies.join(", ")}`);
+    if (opts.activeResumeId)
+        parts.push(`active resume: ${opts.activeResumeId}`);
+    if (opts.coverLetters?.length)
+        parts.push(`drafted ${opts.coverLetters.length} cover letter(s)`);
+    if (opts.interviewPrep?.length)
+        parts.push(`interview prep for ${opts.interviewPrep.map(i => i.company).join(", ")}`);
+    return parts.join(" — ") + ".";
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Save session memory (main entry point called at session end)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Append a session summary to the memory file, merge into KB, compact if needed.
+ */
+export function saveSessionMemory(opts) {
+    if (opts.turns === 0)
+        return;
+    const entry = buildSessionSummary(opts);
+    const existing = loadMemory();
+    const base = existing || buildMemoryFile({ ...EMPTY_KB }, []);
+    const updated = compactMemory(base + "\n" + entry);
+    saveMemory(updated);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"jobOpenings.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/jobOpenings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAgclC,eAAO,MAAM,gBAAgB,EAAE,IA6O9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IA4G9B,CAAC;AAQF,eAAO,MAAM,iBAAiB,EAAE,IA8F/B,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,IAAI,EAIxC,CAAC"}
+{"version":3,"file":"jobOpenings.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/jobOpenings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAkdlC,eAAO,MAAM,gBAAgB,EAAE,IA2O9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IA4G9B,CAAC;AAQF,eAAO,MAAM,iBAAiB,EAAE,IA8F/B,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,IAAI,EAIxC,CAAC"}

package/dist/agent/tools/jobOpenings.js

@@ -14,11 +14,10 @@
  *   Direct      — JSON-LD schema.org/JobPosting + heuristic <a> tag parsing
  */
 import { Type } from "@google/genai";
-import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, renameSync, } from "fs";
+import { readFileSync, writeFileSync, existsSync, copyFileSync, renameSync, } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 import { homedir } from "os";
-const __dirname = dirname(fileURLToPath(import.meta.url));
 // ---------------------------------------------------------------------------
 // CSV Schema — job_openings.csv
 // ---------------------------------------------------------------------------
@@ -40,16 +39,39 @@ const OPENING_HEADERS = [
 // ---------------------------------------------------------------------------
 // File path
 // ---------------------------------------------------------------------------
+/** Resolves the jobs.csv path the same way local-tracker.ts does. */
+function getJobsCsvPath() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirpath = dirname(__filename);
+    // 1. Check dev repo locations (for local development)
+    const devCandidates = [
+        resolve(__dirpath, "../../../../career-ops/data/jobs.csv"),
+        resolve(__dirpath, "../../../../../career-ops/data/jobs.csv"),
+        resolve(process.cwd(), "career-ops/data/jobs.csv"),
+    ];
+    for (const p of devCandidates) {
+        if (existsSync(p))
+            return p;
+    }
+    // 2. Global ~/.careervivid/jobs.csv for installed users
+    return resolve(homedir(), ".careervivid", "jobs.csv");
+}
 function getOpeningsPath() {
-    // Mirror jobs.csv location: career-ops/data/job_openings.csv
-    const careerOpsPath = resolve(__dirname, "..", "..", "..", "..", "career-ops", "data");
-    if (existsSync(careerOpsPath))
-        return resolve(careerOpsPath, "job_openings.csv");
-    // Fallback: ~/.careervivid/
-    const dir = resolve(homedir(), ".careervivid");
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    return resolve(dir, "job_openings.csv");
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirpath = dirname(__filename);
+    // Mirror next to jobs.csv
+    const devCandidates = [
+        resolve(__dirpath, "../../../../career-ops/data/job_openings.csv"),
+        resolve(__dirpath, "../../../../../career-ops/data/job_openings.csv"),
+        resolve(process.cwd(), "career-ops/data/job_openings.csv"),
+    ];
+    for (const p of devCandidates) {
+        if (existsSync(p))
+            return p;
+    }
+    // Fallback: mirror next to jobs.csv
+    const jobsPath = getJobsCsvPath();
+    return resolve(dirname(jobsPath), "job_openings.csv");
 }
 function loadOpenings() {
     const path = getOpeningsPath();
@@ -452,10 +474,8 @@ openings_scan is for drilling into companies the user has already vetted.`,
     },
     execute: async (args) => {
         try {
-            // Load companies from jobs.csv
-            const jobsCsvPath = resolve(__dirname, "..", "..", "..", "..", "career-ops", "data", "jobs.csv");
-            const altPath = resolve(homedir(), ".careervivid", "jobs.csv");
-            const csvPath = existsSync(jobsCsvPath) ? jobsCsvPath : altPath;
+            // Load companies from jobs.csv — use the same path-resolution as local-tracker.ts
+            const csvPath = getJobsCsvPath();
             if (!existsSync(csvPath)) {
                 return "❌ No jobs.csv found. Add some companies to your tracker first with tracker_add_job.";
             }

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

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAmBlC,eAAO,MAAM,cAAc,EAAE,IAmG5B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,IA4EzB,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,IAgE1B,CAAC;AAMF,eAAO,MAAM,mBAAmB,EAAE,IAwDjC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAgC3B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAmE9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAwB9B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,IAyO5B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAAI,EAU/B,CAAC"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAmBlC,eAAO,MAAM,cAAc,EAAE,IAmG5B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,IA4EzB,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,IAgE1B,CAAC;AAMF,eAAO,MAAM,mBAAmB,EAAE,IAwDjC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAgC3B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAmE9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAwB9B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,IAiP5B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAAI,EAU/B,CAAC"}

package/dist/agent/tools/jobs.js

@@ -547,14 +547,20 @@ FILLING RULES:
             return `\u274c browser_sidecar.py not found at expected path: ${sidecarPath}`;
         }
         // ── 5. Resolve LLM config ─────────────────────────────────────────
+        // CV_SESSION_LLM_* env vars are injected at agent startup and reflect
+        // the provider/model the user actually picked — always use them first.
         const { loadConfig, getGeminiKey, getLlmConfig } = await import("../../config.js");
         const cfg = loadConfig();
         const llmCfg = getLlmConfig();
+        const sessionProvider = process.env.CV_SESSION_LLM_PROVIDER;
+        const sessionModel = process.env.CV_SESSION_LLM_MODEL;
+        const sessionApiKey = process.env.CV_SESSION_LLM_APIKEY;
+        const sessionBaseUrl = process.env.CV_SESSION_LLM_BASE_URL;
         const llmConfig = {
-            provider: llmCfg.provider,
-            model: args.model || llmCfg.model || "gemini-3.1-flash-lite-preview",
-            apiKey: llmCfg.apiKey || cfg.geminiKey || cfg.llmApiKey || getGeminiKey() || process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY || "",
-            baseUrl: llmCfg.baseUrl,
+            provider: sessionProvider ?? llmCfg.provider,
+            model: args.model || sessionModel || llmCfg.model || "gemini-3.1-flash-lite-preview",
+            apiKey: sessionApiKey || llmCfg.apiKey || cfg.geminiKey || cfg.llmApiKey || getGeminiKey() || process.env.GOOGLE_API_KEY || process.env.GEMINI_API_KEY || "",
+            baseUrl: sessionBaseUrl || llmCfg.baseUrl,
         };
         // For CareerVivid Cloud, use the CV account key for the proxy — no personal LLM key needed
         if (llmConfig.provider === "careervivid") {

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

package/dist/commands/agent/engineResolver.js

@@ -53,10 +53,11 @@ export function printBanner(options, selectedProvider, selectedModel, thinkingBu
     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, save, list, status update, apply_to_job tools active"));
+        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: list_local_jobs · update_local_job · add_local_job"));
-        console.log(chalk.yellow("               + score_pipeline · get_pipeline_metrics · flag_stale_jobs (jobs.csv v2)"));
+        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"));

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAwHpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QA6IpD"}

package/dist/commands/agent/index.js

@@ -5,6 +5,7 @@ import { runAgentConfig, promptForAgentModel } from "./configurator.js";
 import { getTools } from "./toolRegistry.js";
 import { getSystemInstruction, buildEngine, printBanner } from "./engineResolver.js";
 import { askLoop } from "./repl.js";
+import { initSessionContext } from "../../agent/agentAuditLog.js";
 const { prompt } = pkg;
 export function registerAgentCommand(program) {
     const agentCmd = program
@@ -94,8 +95,28 @@ export function registerAgentCommand(program) {
         }
         const includeThoughts = Boolean(options.verbose);
         const systemInstruction = getSystemInstruction(options);
+        // ── Inject session LLM config into env so sub-tools (e.g. ApplyToJobTool)
+        // always use the provider/model the user selected in this session, not the
+        // stale value from ~/.careervividrc.json.
+        process.env.CV_SESSION_LLM_PROVIDER = selectedProvider;
+        process.env.CV_SESSION_LLM_MODEL = selectedModel;
+        if (options["api-key"]) {
+            process.env.CV_SESSION_LLM_APIKEY = options["api-key"];
+        }
+        else if (geminiApiKey) {
+            process.env.CV_SESSION_LLM_APIKEY = geminiApiKey;
+        }
+        else if (cvApiKey) {
+            process.env.CV_SESSION_LLM_APIKEY = cvApiKey;
+        }
+        if (options["base-url"]) {
+            process.env.CV_SESSION_LLM_BASE_URL = options["base-url"];
+        }
         const engine = buildEngine(selectedProvider, selectedModel, systemInstruction, tools, thinkingBudget, includeThoughts, cvApiKey, geminiApiKey, project);
         printBanner(options, selectedProvider, selectedModel, thinkingBudget);
+        // ── Record session context for memory ────────────────────────────────────────────────
+        const agentMode = options.jobs ? "jobs" : options.resume ? "resume" : "coding";
+        initSessionContext(agentMode, selectedModel);
         await askLoop(engine, options, selectedProvider, selectedModel, cvApiKey, systemInstruction, tools);
     });
     agentCmd.command("config")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "careervivid",
-  "version": "1.12.38",
+  "version": "1.12.40",
   "description": "Official CLI for CareerVivid — publish articles, diagrams, and portfolio updates from your terminal or AI agent",
   "type": "module",
   "bin": {

package/src/apply/browser_sidecar.py

@@ -158,24 +158,56 @@ def get_llm(llm_config: dict):
 
     if provider == "careervivid":
         return ChatCareerVivid(model=model, cv_api_key=api_key)
-    
-    if provider == "openai":
-        from browser_use.llm.openai import ChatOpenAI
-        return ChatOpenAI(model=model, api_key=api_key, base_url=base_url)
-    
+
     if provider == "anthropic":
         from browser_use.llm.anthropic import ChatAnthropic
         return ChatAnthropic(model=model, api_key=api_key)
-    
+
     if provider == "gemini" or provider == "google":
-        from browser_use.llm.google import ChatGoogle
-        return ChatGoogle(model=model, api_key=api_key)
-    
+        try:
+            from browser_use.llm.google import ChatGoogle
+            return ChatGoogle(model=model, api_key=api_key)
+        except ImportError:
+            # Fallback: google-genai via openai-compatible shim
+            from browser_use.llm.openai import ChatOpenAI
+            return ChatOpenAI(
+                model=model,
+                api_key=api_key,
+                base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
+            )
+
     if provider == "openrouter":
-        from browser_use.llm.openrouter import ChatOpenRouter
-        return ChatOpenRouter(model=model, api_key=api_key)
-    
-    raise ValueError(f"Unsupported LLM provider: {provider}")
+        # OpenRouter is OpenAI-compatible — use ChatOpenAI with the OpenRouter base URL.
+        # browser_use.llm.openrouter does NOT exist as a separate module.
+        try:
+            from browser_use.llm.openai import ChatOpenAI
+            return ChatOpenAI(
+                model=model,
+                api_key=api_key,
+                base_url=base_url or "https://openrouter.ai/api/v1",
+            )
+        except ImportError:
+            raise ImportError(
+                "browser_use.llm.openai not found. "
+                "Install: pip install 'browser-use[openai]'"
+            )
+
+    if provider == "openai" or provider == "custom":
+        from browser_use.llm.openai import ChatOpenAI
+        kwargs = dict(model=model, api_key=api_key)
+        if base_url:
+            kwargs["base_url"] = base_url
+        return ChatOpenAI(**kwargs)
+
+    # Last-resort fallback: treat as OpenAI-compatible
+    try:
+        from browser_use.llm.openai import ChatOpenAI
+        kwargs = dict(model=model, api_key=api_key)
+        if base_url:
+            kwargs["base_url"] = base_url
+        return ChatOpenAI(**kwargs)
+    except ImportError:
+        raise ValueError(f"Unsupported LLM provider: {provider}")
 
 
 async def run_agent(