REPSLog

Attach a file to an existing time log, by id (from list_time_logs or the id returned by create_time_log). Pass exactly one source: `file`, a file the user has put in this chat (a photo, screenshot or PDF), or `upload_id`, a file you uploaded yourself via create_attachment_upload (optionally with `file_name`). Same limits as the REPSLog app: JPEG, PNG or GIF images, PDF, Word or Excel files, up to 10 MB each (HEIC/WebP photos are not supported). It adds the file; nothing existing is changed or removed. Only attach files the user wants on that entry, after confirming which time log each belongs to.

attach_file_to_time_log

Step 1 of attaching a file that YOU (the client) hold, such as a file on disk or in your own storage, to a time log. Returns a private, write-only upload_url valid for 15 minutes. Upload the file bytes with an HTTP PUT to upload_url, sending the returned `headers` exactly as given (max 10 MB), then call attach_file_to_time_log with the time log `id` and this `upload_id`. One upload_id per file; it can be attached once. Do NOT use this for a file the user attached in a ChatGPT chat: pass that file to attach_file_to_time_log directly as `file`.

create_attachment_upload

Create a REPS work time log (task) for the authenticated user. Requires a propertyId, a description, and durationMinutes. propertyId and categoryId come from list_properties / list_categories (built-in default categories and the Unassigned property ids are valid).

create_time_log

Create several REPS work time logs in one call (1 to 50 entries). Use it when the user wants to log many entries at once, such as a whole week; for a single entry use create_time_log. Each entry takes the same fields as create_time_log (propertyId, description, durationMinutes, optional categoryId, performedOn, performedBy), with ids from list_properties / list_categories. Each entry is validated and created independently, so partial success is possible: the result lists what was created (with each entry's index and id) and what failed (index, code, message). Indexes are 0-based positions in the entries array you sent. Report the failures to the user and only retry the failed entries, never the whole batch (code 'not-attempted' entries were skipped after an unexpected error and are safe to retry; for 'internal-server-error' check list_time_logs first). An entry identical to one logged moments ago is not duplicated. Show the user the full list of entries and get their approval before calling.

create_time_logs

Delete a time log by id (from list_time_logs). Removes it from the user's logs immediately. There is no in-app undo, so treat it as permanent and always confirm with the user before calling.

delete_time_log

Aggregate logged hours for a year (defaults to the current year), read from precomputed stats so totals match the REPSLog app exactly. Optionally scope to ONE of property / category / participant, and narrow by propertyType (str|ltr). Returns total/LTR/STR hours + per-property breakdown. For arbitrary date ranges, use list_time_logs.

get_hours_summary

Flexible, precomputed REPS hour stats — use this for ANY aggregation instead of listing entries. Period: a `year` (default current), optionally narrowed to one `month` (1-12), or `allTime`. `groupBy` returns a breakdown by `property`, `category` (year only), `participant`, or `month` (every month of the year); omit for a single total. Optionally scope to one `propertyId` or `participantId`, and narrow STR vs LTR with `propertyType`. Every result is read from precomputed stats (one cheap read). Unsupported combinations (category per-month/all-time, category with a property or participant filter, or any all-time breakdown) are rejected — do NOT fall back to listing time logs for those.

get_stats

Return the whitelisted subset of the user's settings (propertiesType, international properties flag).

get_user_settings

Progress toward the user's REPS hour goal for the year. Adapts to their case: LTR combined (500 material-participation incl. you/spouse split, or 750 total REPS hours) and/or STR per-property (100/500). Renders a goal ring.

get_goal_progress

Break down a year of logged hours by property, category, and participant (defaults to the current year), read from precomputed stats so totals match the REPSLog app. Optional propertyType (str|ltr) filter. Renders a tabbed card with bars and a category pie.

get_breakdown