Taco Street Locating

{'type': 'object', 'required': ['question'], 'properties': {'city': {'type': 'string', 'description': 'Metro the question concerns.'}, 'agent': {'type': 'string', 'description': 'Name of the referring assistant/product.'}, 'contact': {'type': 'string', 'description': "The renter's phone/email — strongly recommended: the answer is texted/emailed to them directly, and polling alone can strand it."}, 'question': {'type': 'string', 'maxLength': 1000, 'minLength': 10, 'description': 'The question for the human locator — specifics beat generalities.'}, 'apartments': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5, 'description': 'Buildings the question is about.'}}}

{'type': 'object', 'required': ['question_id', 'status'], 'properties': {'status': {'type': 'string'}, 'guidance': {'type': 'string'}, 'question_id': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['question_id'], 'properties': {'question_id': {'type': 'string', 'description': 'The id returned by ask_a_locator.'}}}

{'type': 'object', 'required': ['question_id', 'status'], 'properties': {'note': {'type': 'string'}, 'answer': {'type': ['string', 'null']}, 'status': {'enum': ['open', 'answered'], 'type': 'string'}, 'guidance': {'type': 'string'}, 'question': {'type': 'string'}, 'answered_at': {'type': ['string', 'null']}, 'question_id': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['apartment_names'], 'properties': {'city': {'enum': ['Austin', 'Dallas', 'Houston'], 'type': 'string', 'description': 'Metro, to disambiguate same-named buildings.'}, 'agent': {'type': 'string', 'description': 'Name of the referring assistant/product.'}, 'apartment_names': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 1, 'description': "Exact building names from search_apartments to save to the renter's list."}}}

{'type': 'object', 'required': ['url', 'apartments'], 'properties': {'url': {'type': 'string'}, 'note': {'type': 'string'}, 'unmatched': {'type': 'array', 'items': {'type': 'string'}}, 'apartments': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}

{'type': 'object', 'required': ['name'], 'properties': {'city': {'enum': ['Austin', 'Dallas', 'Houston'], 'type': 'string', 'description': 'Metro, to disambiguate same-named buildings.'}, 'name': {'type': 'string', 'description': 'Exact building name from search_apartments.'}}}

{'type': 'object', 'required': ['name', 'city', 'pricing', 'guidance'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string'}, 'pets': {'type': 'string'}, 'address': {'type': 'string'}, 'pricing': {'type': 'object', 'additionalProperties': True}, 'building': {'type': 'object', 'additionalProperties': True}, 'guidance': {'type': 'string'}, 'specials': {'type': 'object', 'additionalProperties': True}, 'neighborhood': {'type': 'string'}, 'move_in_costs': {'type': 'object', 'additionalProperties': True}, 'lifestyle_tags': {'type': 'array', 'items': {'type': 'string'}}, 'taco_street_take': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['request_id', 'request_key'], 'properties': {'request_id': {'type': 'string', 'description': 'ID returned by request_apartment_research.'}, 'request_key': {'type': 'string', 'maxLength': 128, 'minLength': 43, 'description': 'The original private request key.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['request_id', 'status', 'guidance'], 'properties': {'report': {'type': 'object'}, 'status': {'type': 'string'}, 'criteria': {'type': 'object'}, 'guidance': {'type': 'string'}, 'duplicate': {'type': 'boolean'}, 'apartments': {'type': 'array', 'items': {'type': 'string'}}, 'request_id': {'type': 'string'}, 'continuation_url': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'title': 'ResearchRequest', 'required': ['request_key', 'shortlist_token', 'city', 'client_name', 'contact', 'consent', 'bedrooms', 'budget_max', 'move_in'], 'properties': {'city': {'enum': ['Austin', 'Dallas', 'Houston'], 'type': 'string', 'title': 'City', 'description': 'Supported search market for this shortlist.'}, 'agent': {'type': 'string', 'title': 'Agent', 'default': '', 'maxLength': 120, 'description': 'Self-reported referring assistant or product; not a verified partner identity.'}, 'notes': {'type': 'string', 'title': 'Notes', 'default': '', 'maxLength': 2000, 'description': 'Renter requirements and questions, not assistant-generated promises.'}, 'consent': {'type': 'boolean', 'title': 'Consent', 'description': 'True only after the renter agrees to share this brief and contact for research and follow-up.'}, 'contact': {'type': 'string', 'title': 'Contact', 'maxLength': 254, 'minLength': 5, 'description': "Renter's email or phone shared with consent for research follow-up."}, 'move_in': {'type': 'string', 'title': 'Move In', 'pattern': '^\\d{4}-\\d{2}(?:-\\d{2})?$', 'description': 'Move-in month YYYY-MM or exact date YYYY-MM-DD. Never invent a day; confirm the year.'}, 'bedrooms': {'type': 'integer', 'title': 'Bedrooms', 'maximum': 4, 'minimum': 0, 'description': 'Bedroom count, 0 for a studio, 1–4 otherwise.'}, 'budget_max': {'type': 'number', 'title': 'Budget Max', 'maximum': 100000, 'description': 'Monthly USD budget; specify its basis and flexibility separately.', 'exclusiveMinimum': 0}, 'client_name': {'type': 'string', 'title': 'Client Name', 'maxLength': 100, 'minLength': 1, 'description': "Renter's name shared with consent."}, 'request_key': {'type': 'string', 'title': 'Request Key', 'pattern': '^[A-Za-z0-9_-]+$', 'maxLength': 128, 'minLength': 43, 'description': 'Generate a fresh cryptographically random URL-safe key (at least 32 random bytes, 43 encoded characters). Keep it private. Reuse it only to retry this identical request and retrieve its status; a different brief needs a new key.'}, 'budget_basis': {'enum': ['base_rent', 'total_monthly', 'unknown'], 'type': 'string', 'title': 'Budget Basis', 'default': 'unknown', 'description': 'base_rent, total_monthly, or unknown when the renter has not specified.'}, 'shortlist_token': {'type': 'string', 'title': 'Shortlist Token', 'maxLength': 128, 'minLength': 8, 'description': 'The s parameter from the create_shortlist URL.'}, 'lease_term_months': {'anyOf': [{'type': 'integer', 'maximum': 36, 'minimum': 6}, {'type': 'null'}], 'title': 'Lease Term Months', 'default': None, 'description': 'Requested lease length if known; omit when unknown.'}, 'budget_flexibility': {'enum': ['hard_max', 'target'], 'type': 'string', 'title': 'Budget Flexibility', 'default': 'target', 'description': 'Defaults to target. Use hard_max only for an explicitly strict ceiling.'}, 'move_in_flexibility': {'enum': ['fixed', 'flexible'], 'type': 'string', 'title': 'Move In Flexibility', 'default': 'flexible', 'description': 'Whether the move-in date is fixed or flexible.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['request_id', 'status', 'guidance'], 'properties': {'report': {'type': 'object'}, 'status': {'type': 'string'}, 'criteria': {'type': 'object'}, 'guidance': {'type': 'string'}, 'duplicate': {'type': 'boolean'}, 'apartments': {'type': 'array', 'items': {'type': 'string'}}, 'request_id': {'type': 'string'}, 'continuation_url': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['contact'], 'properties': {'city': {'type': 'string', 'description': 'Metro the renter is searching (Austin, Dallas or Houston).'}, 'name': {'type': 'string', 'description': "The renter's name, if shared."}, 'note': {'type': 'string', 'description': 'Anything the locator should know.'}, 'agent': {'type': 'string', 'description': 'Name of the referring assistant/product.'}, 'contact': {'type': 'string', 'description': "The renter's phone number or email (with their consent)."}, 'move_in': {'type': 'string', 'description': "Move-in timeline, e.g. 'November'."}, 'bedrooms': {'type': 'string', 'description': 'Bedroom count the renter needs, e.g. 1BR.'}, 'budget_max': {'type': 'integer', 'description': "The renter's max monthly rent in USD."}, 'neighborhoods': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'description': 'Neighborhoods the renter prefers.'}}}

{'type': 'object', 'required': ['success', 'lead_id', 'message'], 'properties': {'lead_id': {'type': 'string'}, 'message': {'type': 'string'}, 'success': {'type': 'boolean'}, 'duplicate': {'type': 'boolean'}}, 'additionalProperties': True}

{'type': 'object', 'title': 'ResearchTourRequest', 'required': ['request_id', 'request_key', 'apartment_names', 'preferred_times', 'consent'], 'properties': {'consent': {'type': 'boolean', 'title': 'Consent', 'description': 'True only after the renter explicitly agrees to tour coordination using their saved contact.'}, 'request_id': {'type': 'string', 'title': 'Request Id', 'maxLength': 100, 'minLength': 1, 'description': 'ID of the approved research request.'}, 'request_key': {'type': 'string', 'title': 'Request Key', 'pattern': '^[A-Za-z0-9_-]+$', 'maxLength': 128, 'minLength': 43, 'description': 'Original private research access key. Never share publicly.'}, 'apartment_names': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Apartment Names', 'maxItems': 10, 'minItems': 1, 'description': 'Exact apartment names from this report to discuss touring.'}, 'preferred_times': {'type': 'string', 'title': 'Preferred Times', 'maxLength': 1000, 'minLength': 1, 'description': 'Renter-provided preferred dates, times and timezone; preferences are not confirmed appointments.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['request_id', 'status', 'guidance'], 'properties': {'report': {'type': 'object'}, 'status': {'type': 'string'}, 'criteria': {'type': 'object'}, 'guidance': {'type': 'string'}, 'duplicate': {'type': 'boolean'}, 'apartments': {'type': 'array', 'items': {'type': 'string'}}, 'request_id': {'type': 'string'}, 'continuation_url': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['city'], 'properties': {'city': {'enum': ['Austin', 'Dallas', 'Houston'], 'type': 'string', 'description': 'Metro to search.'}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'How many scored matches to return (1-10).'}, 'query': {'type': 'string', 'description': "What the renter wants, in plain language (e.g. 'walkable, dog-friendly, near downtown')."}, 'bedrooms': {'enum': ['studio', '1BR', '2BR', '3BR', '4BR'], 'type': 'string', 'description': 'Bedroom count the renter needs.'}, 'budget_max': {'type': 'integer', 'description': 'Max monthly rent in USD.'}, 'neighborhoods': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 8, 'description': 'Preferred neighborhoods, if the renter named any.'}}}

{'type': 'object', 'required': ['city', 'count', 'apartments'], 'properties': {'city': {'type': 'string'}, 'note': {'type': 'string'}, 'count': {'type': 'integer'}, 'apartments': {'type': 'array', 'items': {'type': 'object', 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string'}, 'website': {'type': 'string'}, 'whyChosen': {'type': 'string'}, 'matchScore': {'type': 'number'}, 'neighborhood': {'type': 'string'}, 'pricing_as_of': {'type': 'string'}, 'estimated_price': {'type': ['string', 'number']}, 'is_pet_friendly': {'type': 'boolean'}, 'starting_prices': {'type': 'object', 'additionalProperties': {'type': 'number'}}, 'specials_last_known': {'type': 'string'}}, 'additionalProperties': True}}}, 'additionalProperties': True}