JobSprout

Use this when the user wants JobSprout to turn their resume content (pasted text, an uploaded file, or details gathered in the conversation) into a professionally typeset resume. If the user wants to choose a design, call list_resume_templates first and then WAIT for them to pick before calling this (do not choose a template for them). If the user did not ask to pick a design, omit template_id and a clean default is used (they can switch it afterwards). Never call this in the same turn that you showed the template gallery unless the user has already chosen. For a user with a linked JobSprout account the resume is saved straight into their account (its cvId is returned for follow-up tools like tailor_cv_to_job); otherwise it returns a claim link. Do not use for scoring an existing resume or searching for jobs.

build_resume

Use this when a user with a linked JobSprout account wants to switch one of their saved resumes to a different template or design. Provide the cv_id and the chosen template_id (call list_resume_templates first if they haven't picked one). Changes the template in place; the resume's content is unchanged. Returns links to open and download it. Requires a linked account.

switch_resume_template

Use this when a user with a linked JobSprout account wants a downloadable PDF of one of their saved resumes. Returns a short-lived PDF link. Requires a linked account.

download_resume_pdf

Use this when a user with a linked JobSprout account wants to see, review, or work on one of their saved resumes (call list_my_cvs first if you don't have a cv_id). Shows the resume's first-page preview and returns its structure: its sections and how many items each has, its template, and its language. Does not return the resume's personal content as text. Requires a linked account.

get_cv

Use this when a user with a linked JobSprout account wants to see, pick from, or work on their saved resumes, or when another tool needs a cv_id. Returns their saved resumes with titles, templates, and preview links. Requires a linked account. Do not use for anonymous users or for searching jobs.

list_my_cvs

Use this when the user wants to browse, pick, or ask about JobSprout's professionally typeset resume templates, or asks what designs are available. Filters by photo support, column count, and style. After it renders the gallery, STOP and let the user choose a template (they click 'Use this' on a card or name one) before calling build_resume; do not pick a template for them. Do not use for scoring or reviewing an existing resume.

list_resume_templates

Health check. Returns pong with the locale the client supplied.

ping

Use this when the user wants their resume or CV scored, reviewed, or checked for ATS issues. Scores pasted resume text, an uploaded resume file (PDF, DOCX, or plain text), or — for a user with a linked JobSprout account — one of their saved resumes by cv_id (call list_my_cvs first if you don't have one). Saved-resume scores use the account's own scoring: unchanged content replays the stored score for free, a fresh score uses the free trial or credits, and the score with its suggestions appears in the JobSprout editor. Do not use for job searching or for writing a resume from scratch.

score_resume

Use this when a user with a linked JobSprout account wants one of their saved resumes tailored to a specific job. Provide the resume's cv_id (call list_my_cvs first if you don't have one) and the job description. By default it tailors the resume IN PLACE, exactly like tailoring inside the JobSprout editor — do not ask for permission first, and do not create copies unless the user asks to keep the original, in which case pass mode 'new_copy'. Returns a link and a summary of what changed. Charges JobSprout credits. Requires a linked account.

tailor_cv_to_job

Use this when a user with a linked JobSprout account wants a cover letter for a specific job, based on one of their saved resumes. Provide the resume's cv_id (call list_my_cvs first if you don't have one) and the job description. Creates a cover letter, returns its text plus links to edit and download it. Charges JobSprout credits. Requires a linked account.

generate_cover_letter