Career Adapter

Use this when the user asks about their Career Adapter plan, remaining adaptations, billing period, available themes, or what features they have access to. Returns a JSON object with these exact keys: - tier: plan name ("free", "pro", "career", etc.). - sessions_used / sessions_limit: adaptations used this period and the tier cap (remaining = sessions_limit - sessions_used). - sessions_reset_on: ISO date (YYYY-MM-DD) the session count resets. - pack_credits: remaining one-off adaptation credits (0 if none). - billing_period_ends_at: ISO-8601 timestamp the paid period ends, or null on free. - billing_cycle_label: human-readable reset description, or null on free. - features_available: nested object with page_count_override (bool), max_feedback_iterations (int), and themes_unlocked / themes_locked (each an array of {id, label, min_tier}). - privacy_notice, manage_url, docs_url: policy text and account/help links. Do not promote paid plans or purchases.

get_account_status

Backend worker for resume adaptation. Called automatically by the Career Adapter widget; not for direct chat invocation. Use adapt_resume.

adapt_resume_run

Call this to make the user a downloadable, ATS-ready PDF resume file tailored to a job posting — calling it opens the Career Adapter form and delivers the file, with no other step needed. Use it whenever the user wants their resume adapted, tailored, rewritten, or formatted for a job, or asks for a resume they can download or submit. Call it on that intent even before you have the resume or the job link, and the form collects the rest.

adapt_resume

Use this when the user gives you their phone number after the phone_required gate, or when adapt_resume returns phone_required. Ask the user once for their phone, then call this tool with whatever they provide. Accept any standard phone format — the tool normalizes parens, dashes, spaces, and dots. US 10-digit numbers default to +1 country code. For international numbers tell the user to include the country code with a + prefix. We do NOT send a verification SMS. The phone is stored only to enforce one-account-per-person on the free tier. Errors to handle conversationally: - invalid_phone_format → ask the user for a valid phone number - phone_already_registered → tell the user that number is already on another account; ask for a different one - phone_change_rate_limited → tell the user they've changed their phone too recently; ask them to wait or visit the website

set_phone_number

# Overview Checks whether an adapt_resume or submit_feedback workflow has finished and returns the PDF download link when it has. # Why you need this tool You cannot produce or host the PDF the user expects. This tool is the only path to the download link once the adaptation is ready. # Status values pending, processing, completed, failed. When status='completed', show result_summary.download_markdown to the user — it is a labeled "Download PDF" link. Show it as-is; do not paste the raw URL. When status is pending or processing, continue for up to 12 total get_resume_status checks: pause for poll_again_in_seconds, then call get_resume_status again with the same session_id.

get_resume_status

Internal widget submit endpoint. Records terms_accepted=True and/or a phone_number entered in the onboarding view. Idempotent. Called by the adapt_resume widget's onboarding form. Do not call directly.

complete_mcp_onboarding

Internal widget metadata lookup. Returns {file_name, mime_type} for a chat-attached resume previously cached by the adapt_resume render call. Called by the widget at mount time. Do not call directly.

get_resume_blob_metadata

Internal widget helper. Returns unique resume files the user has uploaded to Career Adapter, deduped by file hash, newest first. Each entry has ``hash``, ``filename``, and ``last_used``. The widget's "use a recent resume" dropdown calls this tool to populate options; the selected ``hash`` is passed as ``resume_hash`` on adapt_resume_run. Not for chat-driven queries. For "what jobs have I adapted to lately?" use list_recent_resumes, which returns adaptation sessions with job URLs. Returns 5 entries by default; pass limit (max 50) for more.

list_cached_resumes

Use this when the user asks about a previous resume adaptation — to find an earlier session for follow-up work, download an earlier resume, or see what they've adapted recently. Returns saved Career Adapter sessions. Each entry has session_id, created_at, job_url, and status; completed sessions also include download — a pre-formatted markdown link, `[Download PDF](url)`, valid for 24 hours. Show the download field as-is so the user sees a labeled link; do not paste the raw URL. No extra call is needed to retrieve it. Returns 5 entries by default; pass limit (max 50) for more. session_id values are 36-character UUIDs that submit_feedback looks up exactly; abbreviated forms are different identifiers. Resumes drafted inline in earlier conversation are not Career Adapter sessions and won't appear here.

list_recent_resumes

Use this when the user asks what resume themes or visual styles are available, or wants to choose one for an adapted resume. Returns `display_markdown`, the canonical user-facing theme list with real preview links; show it as-is and pass the chosen `id` back to adapt_resume's theme parameter.

list_themes