How much time off the user has left, per bucket: holidays, paid leave, calendar adjustment hours, and so on. Each entry carries its own unit — some buckets count days and others hours, so never add them together. Every bucket also carries expiresOn and daysUntilExpiry: time left in a bucket is LOST on that date, so when advising the user, always suggest spending the soonest-expiring bucket first. The list comes back in that order. Read-only.

The public holidays ahead on the user's work calendar, roughly a year out. Useful for planning time off: a holiday costs no days from any bucket, and one next to a weekend makes a long weekend. weekend: true means it lands on a Saturday or Sunday and buys no day off. Read-only.

How many days each person on the team is available over a date range, and how many they are off. Built for capacity planning: a PO sizing a sprint needs to know who is away before committing to a load. Per person: workingDays in the range (weekends and public holidays already excluded), daysOff already approved, pendingDaysOff still awaiting approval, and availableDays — working days minus approved time off. Pending days are NOT subtracted from availableDays; they are the risk, so report them separately. availability is the fraction of the range the person is around (1 = fully available). A half-day absence counts as 0.5. People come back least-available first, each with their absences as date ranges. totals carries the team-wide capacity in person-days. Read-only.

The user's time-off requests (holidays, leave...) with their status: pending, approved or denied. Omit status to get all of them. Read-only: this never files a request.

Files a time-off request in Woffu. WRITES to the user's record and their manager sees it. type is the leave type by name, exactly as get_time_off_balance lists it (e.g. "Vacaciones"). Whole-day types take from and optionally to for a range; the day count is whatever Woffu charges after its own weekends and holidays, so a Fri–Mon range may cost two days. Hourly types instead take a single from with startTime and endTime. The balance is checked before anything is filed, and whole-day requests are also validated against Woffu's calendar, so an overdraw, a weekend or a holiday is refused with a reason rather than filed. Half-day requests and types that require a document are not supported here. Before calling, show the user the type, dates and any times, and get their confirmation.

Changes the dates, times or comment of an existing request. WRITES to Woffu. requestId comes from list_time_off_requests. The leave type cannot change here — cancel and file a new one for that. Pass only what changes; anything omitted keeps its current value. A whole-day request takes from/to; an hourly one takes startTime/endTime. Re-validated against Woffu before saving, so a weekend, a holiday or an overdraw is refused. Confirm the change with the user before calling.

Withdraws a time-off request. WRITES to Woffu: a pending request is deleted outright and the balance it held is returned. requestId comes from list_time_off_requests. This cannot be undone, so confirm with the user which request it is — by type and dates — before calling.

Workdays with no hours logged in Woffu, each with the exact time ranges that would be clocked in. Excludes weekends, holidays, absences (leave, adjustment days, sick leave), days already clocked in, and days Woffu will not let the user edit. Read-only. lockedDays are unfilled days Woffu no longer allows editing — report them, they cannot be fixed through this tool. Show the ranges to the user before clocking anything in.

Clocks the given days in Woffu. WRITES to the user's official timesheet. Requires an explicit list of dates: there is no "clock in everything". Before calling this, show the user the dates and their time ranges (from list_pending_days) and get their confirmation. By default each day uses the theoretical schedule Woffu itself proposes, which is almost always what the user wants. Only pass ranges when the user explicitly asks for different hours; it then overrides the schedule on every date in the call, so group dates that share a schedule. Each day is re-validated against Woffu before writing, so an already-clocked day is rejected rather than duplicated.