Gastón

Add an expense to this user's Gastón Inbox for them to confirm. It is not saved until they confirm it in the app, and you must say so. Use it only when the person asks you to record a specific expense.

List this user's budgets that are active today, with how much of each has been spent and how much remains. Use it for any question about budgets, limits, or whether they are on track. Each limit carries its own currency; when that is not their display currency, remaining and over/under are null because the two cannot be compared — say so rather than working it out yourself.

This person's recorded income over a period, beside what they spent over the same days: total and per source (as they named it), spent, saved (income minus spent, negative when they spent more) and savingsRatePct. Use it for any question about income, salary, what came in, savings or saving rate ("¿cuánto ahorré este mes?", "how much did I earn in October"). State saved and savingsRatePct exactly as returned; when they are null, say why (nothing came in, or some rows could not be converted) instead of working it out. Income is personal: in a shared book it returns personal: false and no figures.

Who owes whom in this shared book, and the payments that would settle it. Use it for any question about owing, debts between members, or settling up ("how much do I owe Ana", "who owes who"). Expense totals cannot answer these: only this tool can. Returns shared: false in a personal book.

List this user's active expense categories with their ids. Call it when you need a category id (to filter queryExpenses or to draft an expense) and no category list was given to you.

Query this user's confirmed expenses over a date range, with optional filters, grouped and totalled in their display currency. Use it for every figure you state. Call it more than once when a question compares two periods.