confirm_ranch_change
ChatGPTApply a pending animal, health, breeding, expense, or reminder draft. Call only after the ranch owner explicitly approves the exact action and values shown by the draft tool.
confirm_ranch_reminder
ChatGPTApply a previously drafted reminder. Call only after the ranch owner has confirmed the exact action.
draft_animal_change
ChatGPTDraft adding or editing a cattle record, or archiving an animal. Archiving removes it from active herd lists while preserving its profile and linked history. Nothing changes until confirm_ranch_change is called after the ranch owner approves the exact preview.
draft_animal_photo
ChatGPTAttach a photo to an EXISTING animal, without creating or editing the animal record. First use search_livestock to resolve the correct animalId; ask the user if matches are ambiguous. Use this tool only when the client supplies an OpenAI hosted attachment URL and file ID. If the attachment is a local path or the client cannot supply that hosted reference, use prepare_animal_photo_upload, upload the raw bytes with its returned PUT URL and headers, then call finish_animal_photo_upload. Show the returned animal identity, photo preview, caption and primary-photo choice, then ask for explicit approval before calling confirm_ranch_change. isPrimary defaults to false; set true only when the user wants this to become the profile photo. Drafts expire after 24 hours. Retry interrupted confirmation with the SAME draftId. Never create a duplicate animal to attach a photo.
draft_animal_with_photo
ChatGPTUse this tool only when the client supplies an OpenAI hosted attachment URL and file ID. If the attachment is a local path or the client cannot supply that hosted reference, use prepare_new_animal_photo_upload, upload the raw bytes with its returned PUT URL and headers, then call finish_animal_photo_upload. No animal is created yet. Show the exact returned animal details, photo preview, caption and primary-photo choice, then ask for explicit approval before calling confirm_ranch_change with this draftId. Do not infer animal facts from a photo. Drafts expire in 24 hours. Use review_animal_photo_draft to refresh the preview. On interrupted confirmation, retry the SAME draftId, never create a replacement animal draft.
draft_breeding_record
ChatGPTBull-exposure records require a sire. Before drafting, search_livestock and search_external_animals for the sire. Select the exact ranch bull or external profile. If neither search finds the bull, use sire.kind=create_external_animal to draft creation of a real external sire profile with the breeding record. The profile is rechecked for duplicates, shown in the preview, and created and linked only after confirmation. Never put the bull name in notes or use a free-text sire field. Breeding dates and calving windows use the same calculations as the web interface.
draft_breeding_record_change
ChatGPTDraft editing or permanently deleting an existing cattle breeding record. Updates recalculate expected and normal calving windows. Nothing changes until the owner confirms the exact draft with confirm_ranch_change.
draft_delete_ranch_expense
ChatGPTDraft permanently deleting a ranch expense and its animal allocation rows. The expense remains until the owner confirms the exact draft with confirm_ranch_change.
draft_expense_change
ChatGPTDraft adding or editing an expense. Allocations can cover the whole ranch, selected active cattle, or every active animal in a saved group; animal allocations are split evenly with cent rounding. Confirm the exact animal-by-animal preview with confirm_ranch_change before anything is saved.
draft_group_breeding_records
ChatGPTFor bull exposure, a sire selection is required. First call search_livestock and search_external_animals. If no profile matches, pass sire.kind=create_external_animal with the bull profile details; this drafts an external profile and the group breeding records together. The profile is rechecked for duplicates, shown in the preview, and created and linked only after confirmation. Never put the bull name in notes or use a free-text sire field. This drafts one shared AI or bull-exposure record for every active female in the selected group or animal list, with calculated calving windows and an exact per-cow preview.
draft_group_health_records
ChatGPTPrepare the same health event for every active cattle member of a saved group or an explicit list of animal IDs. The preview lists every animal that will be changed and any group members skipped. Nothing is saved until an authorized ranch member reviews and confirms the entire draft.
draft_health_record
ChatGPTDraft a health event for an active ranch animal. Health records can be added through the web interface; they are never written until the owner confirms the exact draft with confirm_ranch_change.
draft_health_record_change
ChatGPTDraft editing or permanently deleting an existing ranch health record. Updates replace the complete record. Nothing changes until the owner confirms the exact draft with confirm_ranch_change.
draft_ranch_reminder
ChatGPTDraft a care reminder. This does not change ranch records until confirm_ranch_reminder is called with the returned draft ID.
draft_ranch_reminder_change
ChatGPTDraft editing or permanently deleting an open reminder. An update replaces all reminder fields, including clearing an animal, note, or recurrence when set to null. Nothing changes until the owner confirms the exact draft with confirm_ranch_change.
draft_reminder_completion
ChatGPTDraft completing an open reminder. If it repeats, the preview includes the next due date. Nothing changes until the owner confirms with confirm_ranch_change.
finish_animal_photo_upload
ChatGPTCall after uploading the raw photo bytes to the private uploadUrl returned by prepare_animal_photo_upload or prepare_new_animal_photo_upload. This validates and processes the upload, then returns the photo preview. Show the exact animal and photo details and ask for explicit approval before calling confirm_ranch_change with the same draftId.
get_animal_group
ChatGPTRead a group and its current members. Smart group membership is resolved from its saved filters at request time.
get_animal_history
ChatGPTGet one ranch animal with recent health, breeding, direct expense, and allocated expense history.
get_ranch_dashboard
ChatGPTRead active cattle, upcoming calvings, open care reminders, and health follow-ups for the connected ranch.
list_animal_groups
ChatGPTList active manual and smart animal groups in the connected ranch, including the current member count for each group.
list_breeding_records
ChatGPTSearch breeding records by animal, pregnancy status, or expected calving date range. Results are paginated (25 by default, up to 100).
list_care_due
ChatGPTShow upcoming and overdue reminders and health follow-ups through a chosen date (next 30 days by default).
list_health_records
ChatGPTSearch ranch health records by animal, event type, or date range. Results include recorded medication and withdrawal fields and are paginated (25 by default, up to 100). These are stored records, not veterinary advice.
list_medication_inventory
ChatGPTSearch ranch medication inventory by name and optional expiration date. Each item includes its saved quantity, reorder threshold, low-stock indicator, and label withdrawal intervals.
list_ranch_expenses
ChatGPTList up to 100 recent expenses, optionally filtered by dates, category, or animal allocation.
prepare_animal_photo_upload
ChatGPTUse when the attached photo arrives as a local file path or the client cannot provide an OpenAI hosted attachment URL. The client must be able to read the file bytes and make an HTTP PUT request. First get the exact byte length, MIME type, and bytes from the attachment. This creates a photo draft and returns a private uploadUrl with required method and headers. Upload the raw file bytes exactly as instructed, then call finish_animal_photo_upload with the returned draftId. Never pass a local path to The Chute. Nothing is saved to the animal until the user approves the preview and confirm_ranch_change is called.
prepare_new_animal_photo_upload
ChatGPTUse when the attached photo arrives as a local file path or the client cannot provide an OpenAI hosted attachment URL. The client must be able to read the file bytes and make an HTTP PUT request. First get the exact byte length, MIME type, and bytes from the attachment. This creates an animal and photo draft and returns a private uploadUrl with required method and headers. Upload the raw file bytes exactly as instructed, then call finish_animal_photo_upload with the returned draftId. Never pass a local path to The Chute. No animal or photo is saved until the user approves the full preview and confirm_ranch_change is called.
review_animal_photo_draft
ChatGPTRead your animal photo draft and refresh its private photo preview before asking for explicit confirmation. Does not create or change an animal.
search_external_animals
ChatGPTSearch saved outside-ranch animal profiles. Before drafting a breeding record, search both the ranch herd and these profiles for the sire. If neither contains the bull, the breeding draft can create a linked external sire profile for review and confirmation.
search_livestock
ChatGPTFind cattle by name, ear tag, lifecycle status, or animal status flags. Archived animals are excluded by default; use status archived to find them. Returned status is the effective status, with archived taking precedence; lifecycle_status preserves the animal record status. If multiple flags are provided, a record matches any selected flag. Returns at most 50 concise records.