Render a caller-computed cash position
well_render_cash_positionPut a cash position YOU computed onto the cash card.
This tool measures nothing. It takes the figure and its method as input and returns them for rendering. Call it only after you have totalled the balances yourself and can state every field below from your own work — never to "get" a cash position.
The server derives no cash figure of its own here, which is why every field below is required: the policy behind a number is the only thing that makes it checkable.
Under the number the card draws nothing. It carries the total and the moment it was read. Every other field below, required or optional, reaches no pixel. All of it comes back in this tool's text result, which is what you write the prose from. The card is the measure; the explanation is yours.
REQUIRED, because a figure whose method is not stated cannot be checked:
amountandcurrency— the consolidated total. NEGATIVE is legal: an overdrawn workspace has negative cash, and this tool renders it rather than refusing it.as_of— the moment the reading is valid foraccounts— every account that CONTRIBUTED, each with its native amount and currency, the converted amount, and the rate applied (nullwhen it was already incurrency). Carryinstitution_nameandmasked_account_numberthrough from the balances read as well: your breakdown names each account by its bank, its name and its masked suffix, or by its currency when the bank and the name are bothnull, and never by its id.scope— the account types you counted as cash, and whether you counted an account whose ownership is unsettledexcluded— what fell out, in four named groups: not owned, out-of-scope type, no readable balance, no FX rate. One merged count hides the difference between a rule the reader chose and a defect in the data.partial— whether the total may be a floor (the skills'is_floor), because an account with no readable balance or no rate was left out of it. The result carries the value derived fromexcluded, whatever you state. It never means a cut-short read: that stops before this call.
REFUSED rather than rendered, each because the caller's own figures disagree with each other:
a total that is not the sum of the contributions listed — totalling a different set than you disclose publishes a figure nobody can audit
a converted amount that does not follow from its native amount and stated rate
an account already in
currencythat carries a rate other than one, or whose converted amount differs from its native onean account in another currency that states no rate
the same account contributing twice
a non-zero total with no contributing accounts
an
as_ofin the futurea
scope.account_typesnaming nothinga
balance_historythat repeats a month or runs out of ordera currency outside ISO-4217 — checked against the catalog, not its shape
OPTIONAL:
balance_history— trailing complete month ends, oldest first. Anullamount is a month no stored row covered; send it as a gap rather than dropping it or sending a zero, and never interpolate between two real points.
When the token authorizes one workspace, call this directly — no other tool call is needed first. When it authorizes several, this read will not guess which one you mean: pass workspace_id on the call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | ||
| scope | Yes | ||
| amount | Yes | ||
| partial | Yes | ||
| accounts | Yes | ||
| currency | Yes | ||
| excluded | Yes | ||
| workspace_id | No | Target workspace. Omit when the token authorizes one workspace. Required when it authorizes several: this read reports one workspace's own figures and will not choose which. | |
| balance_history | No | ||
| conversation_id | No | The conversation id returned by the previous Well result, in its meta under well/conversation_id, in its structuredContent, or in its JSON text block. Pass it back on every call in the same conversation, including a call a card makes, so the chosen workspace and the earlier answers still apply. It decides the conversation on its own: nothing the host states about the session replaces it. Omit it only on the first call of a conversation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | ||
| scope | Yes | ||
| amount | Yes | ||
| partial | Yes | ||
| success | Yes | ||
| accounts | Yes | ||
| currency | Yes | ||
| excluded | Yes | ||
| computed_by | Yes | ||
| balance_history | No | ||
| conversation_id | No | The conversation this result belongs to. Pass it back as the conversation_id argument on every later Well call in the same conversation. | |
| resolved_workspace | No | The workspace that answered, when the caller named none and the token authorizes several. | |
| conversation_id_note | No | Present only when the server opened a fresh lane, stating that no choice recorded earlier was read. | |
| conversation_id_source | No | Where the conversation id came from: the host's own request meta, the caller's argument, or a fresh lane the server opened. |