careervivid 1.11.5 → 1.12.1

package/README.md

@@ -146,15 +146,24 @@ cv profile export --format gdoc
 
 ### `cv jobs`
 
-Automate your job application tracking.
+Automate your job application tracking with AI.
 
 | Subcommand | Description |
 |---|---|
-| `cv jobs sync-gmail` | Scan Gmail for applications and sync to a Google Sheet |
+| `cv jobs hunt` | AI-powered job search scored against your resume → auto-saves to /job-tracker |
+| `cv jobs update` | Interactively update a job application status on your Kanban board |
+| `cv jobs list` | View your current job tracker board |
+| `cv jobs sync-gmail` | [Legacy] Scan Gmail for applications and sync to a Google Sheet |
 
 ```bash
-# Sync recent applications to Google Sheets
-cv jobs sync-gmail
+# AI-powered job search scored against your resume (uses configuration keys)
+cv jobs hunt --role "Software Engineer" --score 60
+
+# View your job tracking board
+cv jobs list
+
+# Update status of an application
+cv jobs update
 ```
 
 ---
@@ -202,10 +211,16 @@ View and modify CLI configuration stored at `~/.careervividrc.json`.
 | `cv config get <key>` | Print a single config value |
 | `cv config set <key> <value>` | Update a config value |
 
+**Available Keys:**
+- \`apiKey\`: Your CareerVivid API key.
+- \`geminiKey\`: Your Gemini API key for local AI-powered job application tracking and parsing.
+- \`targetCompanies\`: Comma-separated list of target organizations to focus search on ATS boards (used by \`cv jobs hunt\`).
+- \`apiUrl\`: Optional API endpoint override (default: \`https://careervivid.app/api\`).
+
 ```bash
 cv config show
-cv config get apiKey
-cv config set apiUrl https://careervivid.app/api/publish
+cv config get targetCompanies
+cv config set targetCompanies "OpenAI, Google, Vercel"
 ```
 
 ---

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

@@ -1 +1 @@
-{"version":3,"file":"QueryEngine.d.ts","sourceRoot":"","sources":["../../src/agent/QueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,uBAAuB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AAMrD,eAAO,MAAM,0BAA0B,QA8B/B,CAAC;AAMT,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACzD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAyCD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAyBrC,UAAU,IAAI,OAAO,EAAE;IAIvB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;IAIpC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE;IAW7B,OAAO,CAAC,mBAAmB;YAcb,YAAY;YAOZ,gBAAgB;IA6DjB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IA8E5E;;;;OAIG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CA2EtF"}
+{"version":3,"file":"QueryEngine.d.ts","sourceRoot":"","sources":["../../src/agent/QueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,uBAAuB,EAAE,OAAO,EAAQ,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,IAAI,EAAsB,MAAM,WAAW,CAAC;AAMrD,eAAO,MAAM,0BAA0B,QA8B/B,CAAC;AAMT,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACzD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAyCD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAyBrC,UAAU,IAAI,OAAO,EAAE;IAIvB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;IAIpC,8CAA8C;IACvC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE;IAW7B,OAAO,CAAC,mBAAmB;YAcb,YAAY;YAOZ,gBAAgB;IA6DjB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IA8E5E;;;;OAIG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAqFtF"}

package/dist/agent/QueryEngine.js

@@ -286,8 +286,18 @@ export class QueryEngine {
                 let accumulatedText = '';
                 let accumulatedFunctionCalls = [];
                 for await (const chunk of streamResponse) {
-                    // Text chunk
-                    const chunkText = chunk.text;
+                    // Manually extract text to avoid the SDK's "there are non-text parts" warning
+                    let chunkText = '';
+                    const parts = chunk.candidates?.[0]?.content?.parts || [];
+                    if (parts.length > 0) {
+                        chunkText = parts
+                            .filter(p => p.text && !p.functionCall && !p.thought)
+                            .map(p => p.text)
+                            .join('');
+                    }
+                    else if (chunk.text && !chunk.text.includes('there are non-text parts')) {
+                        chunkText = chunk.text;
+                    }
                     if (chunkText) {
                         accumulatedText += chunkText;
                         if (hooks?.onChunk)

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

@@ -0,0 +1,16 @@
+/**
+ * Job-hunting tools for the CareerVivid Job Agent.
+ *
+ * These tools wrap the existing jobs API methods so the Gemini agent can
+ * autonomously hunt for jobs, save them to the tracker, and update statuses
+ * using natural language instructions from the user.
+ */
+import { Tool } from "../Tool.js";
+export declare const SearchJobsTool: Tool;
+export declare const SaveJobTool: Tool;
+export declare const ListJobsTool: Tool;
+export declare const UpdateJobStatusTool: Tool;
+export declare const GetResumeTool: Tool;
+export declare const ListResumesTool: Tool;
+export declare const ALL_JOB_TOOLS: Tool[];
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +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;AAiBlC,eAAO,MAAM,cAAc,EAAE,IA0F5B,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,IA8B3B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAAI,EAO/B,CAAC"}

package/dist/agent/tools/jobs.js

@@ -0,0 +1,332 @@
+/**
+ * Job-hunting tools for the CareerVivid Job Agent.
+ *
+ * These tools wrap the existing jobs API methods so the Gemini agent can
+ * autonomously hunt for jobs, save them to the tracker, and update statuses
+ * using natural language instructions from the user.
+ */
+import { Type } from "@google/genai";
+import { jobsHunt, jobsCreate, jobsList, jobsUpdate, resumeGet, resumesList, isApiError, } from "../../api.js";
+// ---------------------------------------------------------------------------
+// Tool: search_jobs
+// ---------------------------------------------------------------------------
+export const SearchJobsTool = {
+    name: "search_jobs",
+    description: `Search for jobs that match a given role and location.
+The search automatically scores results against the user's CareerVivid resume.
+Returns a list of scored job opportunities with AI summaries and missing skills.
+Use this when the user asks to "find jobs", "search for roles", "look for positions", etc.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            role: {
+                type: Type.STRING,
+                description: 'The job title or role to search for. Examples: "Software Engineer", "Product Manager", "Data Scientist".',
+            },
+            location: {
+                type: Type.STRING,
+                description: 'Optional. Preferred job location. Examples: "San Francisco, CA", "Remote", "New York". Default is remote-friendly if omitted.',
+            },
+            count: {
+                type: Type.NUMBER,
+                description: "Optional. Number of job results to return. Default is 10. Maximum is 20.",
+            },
+            min_score: {
+                type: Type.NUMBER,
+                description: "Optional. Minimum match score (0-100) to include in results. Use 60 for good matches, 80 for excellent matches only.",
+            },
+            resume_id: {
+                type: Type.STRING,
+                description: "Optional. Specific resume ID to score against. If omitted, uses the user's latest resume.",
+            },
+        },
+        required: ["role"],
+    },
+    execute: async (args) => {
+        // Optionally fetch resume content to include in the scoring request
+        let resumeContent;
+        try {
+            const resumeResult = await resumeGet(args.resume_id);
+            if (!isApiError(resumeResult)) {
+                resumeContent = resumeResult.cvMarkdown;
+            }
+        }
+        catch {
+            // Proceed without resume — backend will use stored resume
+        }
+        const result = await jobsHunt({
+            resumeContent,
+            role: args.role,
+            location: args.location,
+            count: args.count ?? 10,
+            minScore: args.min_score,
+        });
+        if (isApiError(result)) {
+            return `Error searching jobs: ${result.message}`;
+        }
+        if (result.jobs.length === 0) {
+            return `No jobs found matching "${args.role}"${args.location ? ` in ${args.location}` : ""}. Try broadening your search or adjusting the location.`;
+        }
+        const jobList = result.jobs
+            .map((job, i) => {
+            const scoreBar = "█".repeat(Math.round(job.score / 10)) + "░".repeat(10 - Math.round(job.score / 10));
+            const missing = job.missingSkills.length > 0 ? `\n   Missing skills: ${job.missingSkills.join(", ")}` : "";
+            return (`${i + 1}. [${job.scoreLabel.toUpperCase()} ${job.score}/100] ${job.title} @ ${job.company}\n` +
+                `   Score: ${scoreBar} ${job.score}%\n` +
+                `   Location: ${job.location || "Not specified"}${job.salary ? ` | Salary: ${job.salary}` : ""}\n` +
+                `   Summary: ${job.aiSummary}${missing}\n` +
+                `   URL: ${job.url}\n` +
+                `   Job ID: ${job.id}`);
+        })
+            .join("\n\n");
+        return (`Found ${result.total} jobs for "${args.role}"${args.location ? ` in ${args.location}` : ""}.\n` +
+            `Showing top ${result.jobs.length} results:\n\n${jobList}`);
+    },
+};
+// ---------------------------------------------------------------------------
+// Tool: save_job
+// ---------------------------------------------------------------------------
+export const SaveJobTool = {
+    name: "save_job",
+    description: `Save a job to the user's CareerVivid job tracker Kanban board.
+The job will appear in the "To Apply" column of the /job-tracker page.
+Use this after finding interesting jobs via search_jobs, or when the user asks to "save", "add", or "track" a specific job.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            job_title: {
+                type: Type.STRING,
+                description: "The job title / position name.",
+            },
+            company_name: {
+                type: Type.STRING,
+                description: "The name of the company.",
+            },
+            location: {
+                type: Type.STRING,
+                description: "Optional. Job location (city, state, or 'Remote').",
+            },
+            job_url: {
+                type: Type.STRING,
+                description: "Optional. URL to the job posting.",
+            },
+            job_description: {
+                type: Type.STRING,
+                description: "Optional. Brief description or key details of the role.",
+            },
+            ai_score: {
+                type: Type.NUMBER,
+                description: "Optional. AI match score (0-100) from search_jobs results.",
+            },
+            ai_summary: {
+                type: Type.STRING,
+                description: "Optional. AI-generated summary of the job from search_jobs results.",
+            },
+            notes: {
+                type: Type.STRING,
+                description: "Optional. Personal notes about this job opportunity.",
+            },
+        },
+        required: ["job_title", "company_name"],
+    },
+    execute: async (args) => {
+        const result = await jobsCreate({
+            jobTitle: args.job_title,
+            companyName: args.company_name,
+            location: args.location,
+            jobPostURL: args.job_url,
+            jobDescription: args.job_description,
+            aiScore: args.ai_score,
+            aiSummary: args.ai_summary,
+            notes: args.notes,
+        });
+        if (isApiError(result)) {
+            return `Error saving job: ${result.message}`;
+        }
+        return (`✅ Saved "${args.job_title}" at ${args.company_name} to your job tracker!\n` +
+            `   Status: To Apply\n` +
+            `   Job ID: ${result.id}\n` +
+            `   View it at: https://careervivid.app/job-tracker\n\n` +
+            `Agent Instruction: Please tell the user that the job is saved and remind them that they need to apply for it. Also let them know that you can help them update the job application status (To Apply, Applied, Interviewing, Offered, Rejected) whenever they are ready.`);
+    },
+};
+// ---------------------------------------------------------------------------
+// Tool: list_jobs
+// ---------------------------------------------------------------------------
+export const ListJobsTool = {
+    name: "list_jobs",
+    description: `List the user's jobs from their CareerVivid job tracker Kanban board.
+Can filter by status. Use this when the user asks "what jobs do I have?", "show my tracker",
+"what's in my job pipeline?", "check my interviews", etc.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            status: {
+                type: Type.STRING,
+                description: 'Optional. Filter by application status. One of: "To Apply", "Applied", "Interviewing", "Offered", "Rejected". If omitted, returns all jobs.',
+            },
+        },
+    },
+    execute: async (args) => {
+        const validStatuses = [
+            "To Apply", "Applied", "Interviewing", "Offered", "Rejected",
+        ];
+        const status = validStatuses.includes(args.status)
+            ? args.status
+            : undefined;
+        const result = await jobsList(status);
+        if (isApiError(result)) {
+            return `Error fetching job tracker: ${result.message}`;
+        }
+        if (result.jobs.length === 0) {
+            const statusMsg = status ? ` with status "${status}"` : "";
+            return `Your job tracker is empty${statusMsg}. Use search_jobs to find opportunities and save_job to add them!`;
+        }
+        // Group by status for a clear overview
+        const grouped = {};
+        for (const job of result.jobs) {
+            const s = job.applicationStatus;
+            if (!grouped[s])
+                grouped[s] = [];
+            grouped[s].push(job);
+        }
+        const statusOrder = ["To Apply", "Applied", "Interviewing", "Offered", "Rejected"];
+        const lines = [`Your Job Tracker (${result.total} total):\n`];
+        for (const s of statusOrder) {
+            const jobs = grouped[s];
+            if (!jobs || jobs.length === 0)
+                continue;
+            lines.push(`── ${s.toUpperCase()} (${jobs.length}) ──`);
+            for (const job of jobs) {
+                const score = job.aiScore !== null ? ` [${job.aiScore}%]` : "";
+                const updated = job.updatedAt
+                    ? ` | Updated: ${new Date(job.updatedAt).toLocaleDateString()}`
+                    : "";
+                lines.push(`  • ${job.jobTitle} @ ${job.companyName}${score} | ${job.location || "N/A"}${updated}`);
+                lines.push(`    ID: ${job.id} | URL: ${job.jobPostURL || "N/A"}`);
+                if (job.notes)
+                    lines.push(`    Notes: ${job.notes}`);
+            }
+            lines.push("");
+        }
+        return lines.join("\n");
+    },
+};
+// ---------------------------------------------------------------------------
+// Tool: update_job_status
+// ---------------------------------------------------------------------------
+export const UpdateJobStatusTool = {
+    name: "update_job_status",
+    description: `Move a job to a different status on the CareerVivid Kanban board.
+Use this when the user mentions: "I got an interview", "I applied to X", "I got an offer",
+"X rejected me", "move Y to applied", etc. The change will be visible in the /job-tracker UI.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            job_id: {
+                type: Type.STRING,
+                description: "The job ID to update. Get this from list_jobs or from a previous save_job call.",
+            },
+            new_status: {
+                type: Type.STRING,
+                description: 'The new application status. Must be one of: "To Apply", "Applied", "Interviewing", "Offered", "Rejected".',
+            },
+            notes: {
+                type: Type.STRING,
+                description: "Optional. Add or update notes about this status change (e.g. interview date, interviewer name, feedback).",
+            },
+        },
+        required: ["job_id", "new_status"],
+    },
+    execute: async (args) => {
+        const validStatuses = [
+            "To Apply", "Applied", "Interviewing", "Offered", "Rejected",
+        ];
+        if (!validStatuses.includes(args.new_status)) {
+            return (`Invalid status "${args.new_status}". ` +
+                `Valid options are: ${validStatuses.join(", ")}.`);
+        }
+        const result = await jobsUpdate({
+            jobId: args.job_id,
+            status: args.new_status,
+            notes: args.notes,
+        });
+        if (isApiError(result)) {
+            return `Error updating job: ${result.message}`;
+        }
+        const notesMsg = args.notes ? `\n   Notes: "${args.notes}"` : "";
+        return (`✅ Job tracker updated!\n` +
+            `   Job ID: ${result.jobId}\n` +
+            `   New Status: ${result.newStatus}${notesMsg}\n` +
+            `   View your board at: https://careervivid.app/job-tracker`);
+    },
+};
+// ---------------------------------------------------------------------------
+// Tool: get_resume
+// ---------------------------------------------------------------------------
+export const GetResumeTool = {
+    name: "get_resume",
+    description: `Fetch the user's resume from their CareerVivid profile.
+Use this to understand the user's background, skills, and experience when giving
+personalized job advice, tailoring cover letters, or analyzing job fit.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {
+            resume_id: {
+                type: Type.STRING,
+                description: "Optional. Specific resume ID to retrieve. If omitted, fetches the latest resume.",
+            },
+        },
+    },
+    execute: async (args) => {
+        const result = await resumeGet(args.resume_id);
+        if (isApiError(result)) {
+            return `Error fetching resume: ${result.message}`;
+        }
+        const updated = result.updatedAt
+            ? `\nLast updated: ${new Date(result.updatedAt).toLocaleDateString()}`
+            : "";
+        return (`Resume: "${result.title}" (ID: ${result.resumeId})${updated}\n\n` +
+            `--- RESUME CONTENT ---\n${result.cvMarkdown}\n--- END OF RESUME ---`);
+    },
+};
+// ---------------------------------------------------------------------------
+// Tool: list_resumes
+// ---------------------------------------------------------------------------
+export const ListResumesTool = {
+    name: "list_resumes",
+    description: `List all of the user's resumes on CareerVivid.
+Use this when the user asks "how many resumes do I have?", "list my resumes", or "show my resumes".
+This returns lightweight metadata including resume ID and title, which can be useful when calling search_jobs or get_resume.`,
+    parameters: {
+        type: Type.OBJECT,
+        properties: {},
+    },
+    execute: async () => {
+        const result = await resumesList();
+        if (isApiError(result)) {
+            return `Error fetching resumes: ${result.message}`;
+        }
+        if (result.total === 0 || !result.resumes || result.resumes.length === 0) {
+            return "You don't have any resumes uploaded yet. Visit CareerVivid to upload one!";
+        }
+        const lines = [`You have ${result.total} resume(s) on CareerVivid:\n`];
+        for (const res of result.resumes) {
+            const updated = res.updatedAt ? ` (Updated: ${new Date(res.updatedAt).toLocaleDateString()})` : "";
+            lines.push(`- "${res.title}" [ID: ${res.id}]${updated}`);
+        }
+        lines.push("\nUse get_resume with a specific ID to view its content.");
+        return lines.join("\n");
+    },
+};
+// ---------------------------------------------------------------------------
+// All job tools export
+// ---------------------------------------------------------------------------
+export const ALL_JOB_TOOLS = [
+    GetResumeTool,
+    ListResumesTool,
+    SearchJobsTool,
+    SaveJobTool,
+    ListJobsTool,
+    UpdateJobStatusTool,
+];

package/dist/api.d.ts

@@ -72,4 +72,90 @@ export declare function uploadPortfolioAsset(image: string, path: string, mimeTy
     downloadUrl: string;
 } | ApiError>;
 export declare function isApiError(v: unknown): v is ApiError;
+export type ApplicationStatus = "To Apply" | "Applied" | "Interviewing" | "Offered" | "Rejected";
+export interface ScoredJob {
+    id: string;
+    title: string;
+    company: string;
+    location: string;
+    description: string;
+    url: string;
+    salary?: string;
+    score: number;
+    scoreLabel: "Excellent" | "Good" | "Fair" | "Low";
+    aiSummary: string;
+    missingSkills: string[];
+}
+export interface JobTrackerItem {
+    id: string;
+    jobTitle: string;
+    companyName: string;
+    location: string;
+    applicationStatus: ApplicationStatus;
+    aiScore: number | null;
+    jobPostURL: string;
+    updatedAt: string | null;
+    notes: string;
+}
+export interface ResumeResult {
+    resumeId: string;
+    title: string;
+    cvMarkdown: string;
+    updatedAt: string | null;
+}
+export interface ResumesListResult {
+    resumes: {
+        id: string;
+        title: string;
+        updatedAt: string | null;
+    }[];
+    total: number;
+}
+/** Fetch the user's latest resume from CareerVivid via API key */
+export declare function resumeGet(resumeId?: string): Promise<ResumeResult | ApiError>;
+/** Fetch a lightweight list of the user's resumes */
+export declare function resumesList(): Promise<ResumesListResult | ApiError>;
+/** Run an agentic job search scored against the resume */
+export declare function jobsHunt(payload: {
+    resumeContent?: string;
+    role: string;
+    location?: string;
+    count?: number;
+    minScore?: number;
+    targetOrgs?: string[];
+}): Promise<{
+    jobs: ScoredJob[];
+    total: number;
+} | ApiError>;
+/** Add a job to the user's Kanban tracker */
+export declare function jobsCreate(payload: {
+    jobTitle: string;
+    companyName: string;
+    location?: string;
+    jobPostURL?: string;
+    jobDescription?: string;
+    aiScore?: number;
+    aiSummary?: string;
+    notes?: string;
+}): Promise<{
+    success: boolean;
+    id: string;
+    message: string;
+} | ApiError>;
+/** Move a job to a new status on the Kanban board */
+export declare function jobsUpdate(payload: {
+    jobId: string;
+    status: ApplicationStatus;
+    notes?: string;
+}): Promise<{
+    success: boolean;
+    jobId: string;
+    newStatus: string;
+    message: string;
+} | ApiError>;
+/** List jobs currently in the user's tracker */
+export declare function jobsList(status?: ApplicationStatus): Promise<{
+    jobs: JobTrackerItem[];
+    total: number;
+} | ApiError>;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/api.js

@@ -151,3 +151,73 @@ export async function uploadPortfolioAsset(image, path, mimeType) {
 export function isApiError(v) {
     return typeof v === "object" && v !== null && v.isError === true;
 }
+// ── Cloud Function base URL ───────────────────────────────────────────────────
+// The CLI job-hunt endpoints are deployed as standalone Cloud Functions,
+// not via the /api proxy used by publishPost. This mirrors the verifyAuth pattern.
+const CLI_FUNCTIONS_BASE = process.env.CV_FUNCTIONS_URL ||
+    "https://us-west1-jastalk-firebase.cloudfunctions.net";
+async function cfRequest(method, functionName, body, queryParams) {
+    const apiKey = requireApiKey();
+    let url = `${CLI_FUNCTIONS_BASE}/${functionName}`;
+    if (queryParams) {
+        const qs = new URLSearchParams(queryParams).toString();
+        if (qs)
+            url += `?${qs}`;
+    }
+    const response = await fetch(url, {
+        method,
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+            "User-Agent": `careervivid-cli/${CLI_VERSION}`,
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const text = await response.text();
+    let parsed = {};
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        parsed = { message: text };
+    }
+    if (!response.ok) {
+        return {
+            isError: true,
+            statusCode: response.status,
+            message: parsed.error || parsed.message || `HTTP ${response.status}`,
+        };
+    }
+    return parsed;
+}
+// ── Job Hunt API Methods ──────────────────────────────────────────────────────
+/** Fetch the user's latest resume from CareerVivid via API key */
+export async function resumeGet(resumeId) {
+    const params = {};
+    if (resumeId)
+        params.resumeId = resumeId;
+    return cfRequest("GET", "cliResumeGet", undefined, Object.keys(params).length ? params : undefined);
+}
+/** Fetch a lightweight list of the user's resumes */
+export async function resumesList() {
+    return cfRequest("GET", "cliResumesList");
+}
+/** Run an agentic job search scored against the resume */
+export async function jobsHunt(payload) {
+    return cfRequest("POST", "cliJobsHunt", payload);
+}
+/** Add a job to the user's Kanban tracker */
+export async function jobsCreate(payload) {
+    return cfRequest("POST", "cliJobsCreate", payload);
+}
+/** Move a job to a new status on the Kanban board */
+export async function jobsUpdate(payload) {
+    return cfRequest("POST", "cliJobsUpdate", payload);
+}
+/** List jobs currently in the user's tracker */
+export async function jobsList(status) {
+    const params = {};
+    if (status)
+        params.status = status;
+    return cfRequest("GET", "cliJobsList", undefined, Object.keys(params).length ? params : undefined);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyFpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QA2OpD"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2FpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QA2SpD"}