CounselorAI

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'income': {'type': 'string', 'maxLength': 100, 'description': 'Household income, as the family stated it.'}, 'context': {'type': 'string', 'maxLength': 3000, 'description': 'Household situation that affects the estimate.'}, 'schoolCount': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'How many schools are being compared.'}, 'studentName': {'type': 'string', 'maxLength': 100, 'description': 'The student this is about. Used in the output text.'}, 'fafsaContext': {'type': 'string', 'maxLength': 3000, 'description': 'What is already known from the FAFSA, including the SAI if it has come back.'}, 'repayContext': {'type': 'string', 'maxLength': 3000, 'description': 'What the family has said about borrowing and what they can carry.'}, 'schoolSummaries': {'type': 'string', 'maxLength': 3000, 'description': 'One line per school: name, cost of attendance, anything already known about the offer.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['keyDetails'], 'properties': {'length': {'enum': ['short', 'standard', 'detailed'], 'type': 'string', 'default': 'standard', 'description': 'Roughly 330, 440 or 560 words.'}, 'status': {'type': 'array', 'items': {'enum': ['first_gen', 'low_income', 'undocumented', 'foster_youth', 'disability', 'housing_insecure', 'homeless', 'single_parent'], 'type': 'string'}, 'maxItems': 8, 'description': 'Student circumstances the letter should carry without labeling them. homeless and housing_insecure are the same category.'}, 'competing': {'type': 'string', 'maxLength': 3000, 'description': 'A competing offer to cite, if there is one.'}, 'appealType': {'enum': ['changed_circumstances', 'financial_hardship', 'competing_offer', 'special_circumstances', 'error_correction'], 'type': 'string', 'default': 'changed_circumstances', 'description': 'What the appeal rests on. changed_circumstances is income loss or a new expense since the FAFSA, competing_offer is a match request, special_circumstances asks for a Professional Judgment review, error_correction fixes bad data on the original filing. financial_hardship is a legacy alias for changed_circumstances.'}, 'keyDetails': {'type': 'string', 'maxLength': 3000, 'description': "The circumstances, in the counselor or family's own words. This is what the letter is built out of, so specifics beat summaries."}, 'schoolName': {'type': 'string', 'maxLength': 200, 'description': 'The institution the appeal goes to.'}, 'naturalness': {'type': 'integer', 'default': 3, 'maximum': 5, 'minimum': 1, 'description': 'How plainly the letter should read. 1 is formal institutional, 5 is conversational.'}, 'studentName': {'type': 'string', 'maxLength': 100, 'description': 'The student this is about. Used in the output text.'}, 'amountNeeded': {'type': 'string', 'maxLength': 200, 'description': 'The gap being asked for.'}, 'currentAward': {'type': 'string', 'maxLength': 200, 'description': 'What the school offered, as written on the award letter.'}, 'counselorName': {'type': 'string', 'maxLength': 100, 'description': 'Who the letter is from. The counselor stays the author; this tool drafts, it does not sign.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['letter1'], 'properties': {'letter1': {'type': 'string', 'maxLength': 6000, 'minLength': 20, 'description': 'First award letter, pasted as plain text.'}, 'letter2': {'type': 'string', 'maxLength': 6000, 'description': 'Second award letter, to compare against the first.'}, 'letter3': {'type': 'string', 'maxLength': 6000, 'description': 'Third award letter.'}, 'studentName': {'type': 'string', 'maxLength': 100, 'description': 'The student this is about. Used in the output text.'}, 'scorecardData': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 6, 'description': 'Optional College Scorecard lines to ground the comparison: acceptance rate, graduation rate, average net price. Include the original Letter number and school/campus; unverified caller-supplied context.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'grade': {'enum': ['9', '10', '11', '12', 'transfer'], 'type': 'string', 'default': '12', 'description': 'How far out the family is. 12 means act now.'}, 'notes': {'type': 'string', 'maxLength': 3000, 'description': 'Anything else that should shape the output.'}, 'income': {'enum': ['under30', '30to60', '60to100', 'over100', 'unknown'], 'type': 'string', 'default': 'unknown', 'description': 'Household income band. Drives whether Pell is in play.'}, 'schools': {'type': 'string', 'maxLength': 1000, 'description': 'Schools on the list, if known. Deadlines differ by school.'}, 'specials': {'type': 'array', 'items': {'enum': ['divorced', 'stepparent', 'sibling', 'undocumented', 'foster', 'homeless', 'disability', 'income_change'], 'type': 'string'}, 'maxItems': 8, 'description': 'Situations that change the filing rules: divorced or separated parents, a stepparent, a sibling also in college, undocumented status, foster care, housing instability, disability, a mid-year income change.'}, 'timeline': {'type': 'string', 'maxLength': 200, 'description': 'Where they are in the cycle.'}, 'dependency': {'enum': ['dependent', 'independent', 'unsure'], 'type': 'string', 'default': 'dependent', 'description': 'Dependency drives whose income is reported. unsure is a valid answer and changes the checklist.'}, 'studentName': {'type': 'string', 'maxLength': 100, 'description': 'The student this is about. Used in the output text.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 12000, 'minLength': 50, 'description': 'The reader-facing prose to edit.'}, 'audience': {'enum': ['general', 'cold_outreach', 'parent', 'student', 'counselor', 'leadership', 'social'], 'type': 'string', 'default': 'general', 'description': 'Who will read the text. This changes vocabulary and formality, not the facts.'}, 'strength': {'enum': ['light', 'standard', 'aggressive'], 'type': 'string', 'default': 'standard', 'description': 'light makes surface fixes, standard rewrites AI-sounding sentences, aggressive may rebuild paragraph flow.'}, 'preserveFormatting': {'type': 'boolean', 'default': True, 'description': 'Keep headings, lists, paragraph breaks, links, and other formatting.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['letterText'], 'properties': {'focus': {'type': 'string', 'maxLength': 500, 'description': 'A specific thing to look hardest at, if there is one.'}, 'purpose': {'enum': ['rec_college', 'rec_scholarship', 'rec_transfer', 'rec_professional', 'rec_employment', 'rec_program', 'undergraduate', 'graduate', 'scholarship', 'transfer', 'internship', 'other'], 'type': 'string', 'default': 'rec_college', 'description': 'What the letter is for. A scholarship letter is read differently from a transfer letter.'}, 'letterText': {'type': 'string', 'maxLength': 3000, 'minLength': 50, 'description': 'The letter to review, as plain text.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'tags': {'type': 'array', 'items': {'enum': ['first_gen', 'low_income', 'undocumented', 'foster', 'disability', 'rural', 'military', 'hispanic', 'black', 'indigenous', 'asian_pi', 'stem', 'arts', 'public_service'], 'type': 'string'}, 'maxItems': 14, 'description': 'Background categories. Same vocabulary the scholarship tool uses, so a profile feeds straight into it.'}, 'goals': {'type': 'string', 'maxLength': 3000}, 'grade': {'type': 'string', 'maxLength': 20}, 'major': {'type': 'string', 'maxLength': 200}, 'notes': {'type': 'string', 'maxLength': 3000, 'description': 'Anything else that should shape the output.'}, 'school': {'type': 'string', 'maxLength': 200}, 'academics': {'type': 'string', 'maxLength': 3000, 'description': 'Coursework, GPA, testing, academic trajectory.'}, 'strengths': {'type': 'string', 'maxLength': 3000, 'description': 'What the counselor has actually observed, not adjectives.'}, 'activities': {'type': 'string', 'maxLength': 3000}, 'challenges': {'type': 'string', 'maxLength': 3000, 'description': 'What the student has had to work around.'}, 'studentName': {'type': 'string', 'maxLength': 100, 'description': 'The student this is about. Used in the output text.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['tool'], 'properties': {'tool': {'type': 'string', 'description': 'Tool name from tools/list.'}, 'input': {'type': 'object', 'description': 'The input you intend to send. Optional; omit for the default estimate.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['traits'], 'properties': {'major': {'type': 'string', 'maxLength': 200}, 'story': {'type': 'string', 'maxLength': 3000, 'description': 'A specific moment worth telling. The single highest-value field here.'}, 'traits': {'type': 'string', 'maxLength': 3000, 'description': 'Three standout traits. Send prose, not a list of adjectives: the pipeline turns each one into a scene and needs something to work from.'}, 'purpose': {'enum': ['college_general', 'college_honors', 'scholarship', 'transfer', 'professional', 'employment', 'program', 'undergraduate', 'graduate', 'internship', 'other'], 'type': 'string', 'default': 'college_general', 'description': 'What the letter is for. undergraduate, graduate, internship and other are legacy aliases kept working for existing integrations.'}, 'schools': {'type': 'string', 'maxLength': 500, 'description': 'Target school or program.'}, 'profType': {'enum': ['law', 'medical', 'mba', 'dental', 'pharmacy', 'pa', 'nursing', 'socialwork'], 'type': 'string', 'description': 'Only when purpose is professional: which professional school, since each reads for different things.'}, 'recipient': {'type': 'string', 'maxLength': 200, 'description': 'Who receives it, if named.'}, 'resumeText': {'type': 'string', 'maxLength': 3000, 'description': 'Resume or activity list as plain text.'}, 'sampleText': {'type': 'string', 'maxLength': 3000, 'description': "A sample of the counselor's own writing, so the letter lands in their voice rather than a generic one."}, 'selectivity': {'type': 'string', 'maxLength': 100, 'description': 'How selective the target is. Shifts how much evidence the letter has to carry.'}, 'studentName': {'type': 'string', 'maxLength': 100, 'description': 'The student this is about. Used in the output text.'}, 'contribution': {'type': 'string', 'maxLength': 3000, 'description': 'What the student adds to a campus.'}, 'relationship': {'type': 'string', 'maxLength': 3000, 'description': 'How the counselor knows the student, and for how long.'}, 'counselorName': {'type': 'string', 'maxLength': 100, 'description': 'Who the letter is from. The counselor stays the author; this tool drafts, it does not sign.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['currentText', 'instruction'], 'properties': {'currentText': {'type': 'string', 'maxLength': 3000, 'minLength': 50, 'description': 'The letter as it stands.'}, 'instruction': {'type': 'string', 'maxLength': 1000, 'minLength': 3, 'description': 'What to change. One instruction per call gets a cleaner result than a list.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'gpa': {'type': 'string', 'maxLength': 20}, 'grade': {'type': 'string', 'maxLength': 20, 'description': 'Grade level or transfer status.'}, 'major': {'type': 'string', 'maxLength': 200, 'description': 'Intended field. Departmental awards are usually the least contested.'}, 'notes': {'type': 'string', 'maxLength': 3000, 'description': 'Anything else that should shape the output.'}, 'state': {'type': 'string', 'maxLength': 50, 'description': 'State of residence. State and regional awards have far smaller applicant pools than national ones.'}, 'activities': {'type': 'string', 'maxLength': 3000, 'description': 'Extracurriculars and leadership.'}, 'backgrounds': {'type': 'array', 'items': {'enum': ['first_gen', 'low_income', 'undocumented', 'foster', 'disability', 'rural', 'military', 'hispanic', 'black', 'indigenous', 'asian_pi', 'stem', 'arts', 'public_service'], 'type': 'string'}, 'maxItems': 14, 'description': 'Eligibility categories that unlock specific award pools.'}, 'studentName': {'type': 'string', 'maxLength': 100, 'description': 'The student this is about. Used in the output text.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['sourceText', 'targetLang'], 'properties': {'sourceText': {'type': 'string', 'maxLength': 12000, 'minLength': 10, 'description': 'The text to translate. Usually the output of another tool.'}, 'targetLang': {'enum': ['es', 'zh', 'vi', 'ar', 'tl', 'ko', 'pt', 'fr', 'ru', 'hi'], 'type': 'string', 'description': 'Target language code.'}}, 'additionalProperties': False}